ebean/src/main/java/com/avaje/ebean/annotation/Where.java

package com.avaje.ebean.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Add an Literal to add to the where clause when a many property (List, Set or
 * Map) is loaded or refreshed.
 * 
 * <pre class="code">
 * // on a OneToMany property...
 * 
 * &#064;OneToMany
 * &#064;Where(clause = &quot;deleted='y'&quot;)
 * List&lt;Topic&gt; topics;
 * </pre>
 * 
 * <p>
 * Note that you can include "${ta}" as a place holder for the table alias if
 * you need to include the table alias in the clause.
 * </p>
 * 
 * <pre class="code">
 * // ... including the ${ta} table alias placeholder...
 * 
 * &#064;OneToMany
 * &#064;Where(clause = &quot;${ta}.deleted='y'&quot;)
 * List&lt;Topic&gt; topics;
 * </pre>
 * 
 * <p>
 * This will be added to the where clause when lazy loading the OneToMany
 * property or when there is a join to that OneToMany property.
 * </p>
 */
@Target({ ElementType.FIELD, ElementType.METHOD, ElementType.TYPE })
@Retention(RetentionPolicy.RUNTIME)
public @interface Where {

  /**
   * The clause added to the lazy load query.
   * <p>
   * Note that you can include "${ta}" as a place holder for the table alias if
   * you need to include the table alias in the clause.
   * </p>
   */
  String clause();

};