Subversion Repositories WebE

//$Id: JoinColumn.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.*;

/**
 * Is used to specify a mapped column for joining an entity association.
 *
 * @author Emmanuel Bernard
 */
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface JoinColumn {
        /**
         * The name of the foreign key column.
         * The table in which it is found depends upon the context. If the join is for a OneToOne
         * or Many- ToOne mapping, the foreign key column is in the table of the source entity.
         * If the join is for a ManyToMany, the foreign key is in a join table. Default (only applies
         * if a single join column is used): The concatenation of the following: the name of the referencing
         * relationship property or field of the referencing entity; "_"; the name of the referenced primary
         * key column. If there is no such referencing relationship property or field in the entity, the join
         * column name is formed as the concatenation of the following: the name of the entity; "_"; the name
         * of the referenced primary key column.
         */
        String name() default "";
        /**
         * The name of the column referenced by this foreign key column. When used with relationship mappings,
         * the referenced column is in the table of the target entity. When used inside a JoinTable annotation,
         * the referenced key column is in the entity table of the owning entity, or inverse entity if the join
         * is part of the inverse join definition. Default (only applies if single join column is being used):
         * The same name as the primary key column of the referenced table.
         */
        String referencedColumnName() default "";
        /**
         * Whether the property is a unique key. This is a shortcut for the UniqueConstraint annotation at the
         * table level and is useful for when the unique key constraint is only a single field. It is not
         * necessary to explicitly specify this for a join column that corresponds to a primary key that is part
         * of a foreign key.
         */
        boolean unique() default false;
        /**
         * Whether the foreign key column is nullable
         */
        boolean nullable() default true;
        /**
         * Whether the column is included in SQL INSERT statements generated by the persistence provider
         */
        boolean insertable() default true;
        /**
         * Whether the column is included in SQL UPDATE statements generated by the persistence provider
         */
        boolean updatable() default true;
        /**
         * The SQL fragment that is used when generating the DDL for the column.
         * Defaults to the generated SQL for the column.
         */
        String columnDefinition() default "";
        /**
         * The name of the table that contains the column. If a table is not specified, the column is
         * assumed to be in the primary table of the applicable entity
         */
        String table() default "";
}