Subversion Repositories WebE

//$Id: OneToMany.java 11282 2007-03-14 22:05:59Z epbernard $

//EJB3 Specification Copyright 2004-2006 Sun Microsystems, Inc.

package javax.persistence;

import java.lang.annotation.Retention;

import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.*;

import static java.lang.annotation.RetentionPolicy.*;

import static javax.persistence.FetchType.*;

/**

 * Defines a many-valued association with one-to-many multiplicity.

 *

 * If the collection is defined using generics to specify the element type,

 * the associated target entity type need not be specified; otherwise the target

 * entity class must be specified.

 *

 * @author Emmanuel Bernard

 */

@Target({METHOD, FIELD}) @Retention(RUNTIME)

public @interface OneToMany {

        /**

         * The entity class that is the target of the association. Optional only if the collection

         * property is defined using Java generics. Must be specified otherwise.

         *

         * Defaults to the parameterized type of the collection when defined using generics.

         */

        Class targetEntity() default void.class;

        /**

         * The operations that must be cascaded to the target of the association.

         *

         * Defaults to no operations being cascaded.

         */

        CascadeType[] cascade() default {};

        /**

         * Whether the association should be lazily loaded or must be eagerly fetched.

         * The EAGER strategy is a requirement on the persistenceprovider runtime that the

         * associatedentities must be eagerly fetched. The LAZY strategy is a hint to the

         * persistence provider runtime.

         */

        FetchType fetch() default LAZY;

        /**

         * The field that owns the relationship. Required unless the relationship is unidirectional.

         */

        String mappedBy() default "";

}