FileDocCategorySizeDatePackage
JoinTable.javaAPI DocGlassfish v2 API4537Fri May 04 22:34:06 BST 2007javax.persistence

JoinTable

public class JoinTable
This annotation is used in the mapping of associations. It is specified on the owning side of a many-to-many association, or in a unidirectional one-to-many association.

If the JoinTable annotation is missing, the default values of the annotation elements apply. The name of the join table is assumed to be the table names of the associated primary tables concatenated together (owning side first) using an underscore. 


Example:
@JoinTable(
name="CUST_PHONE",
joinColumns=
@JoinColumn(name="CUST_ID", referencedColumnName="ID"),
inverseJoinColumns=
@JoinColumn(name="PHONE_ID", referencedColumnName="ID")
)
since
Java Persistence 1.0

Fields Summary
Constructors Summary
Methods Summary
java.lang.Stringcatalog()
(Optional) The catalog of the table.

Defaults to the default catalog.

javax.persistence.JoinColumn[]inverseJoinColumns()
(Optional) The foreign key columns
of the join table which reference the
primary table of the entity that does
not own the association (i.e. the
inverse side of the association).


 Uses the same defaults as for {@link JoinColumn}.
javax.persistence.JoinColumn[]joinColumns()
(Optional) The foreign key columns
of the join table which reference the
primary table of the entity owning the
association (i.e. the owning side of
the association).


 Uses the same defaults as for {@link JoinColumn}.
java.lang.Stringname()
(Optional) The name of the join table.


 Defaults to the concatenated names of
the two associated primary entity tables,
separated by an underscore.
java.lang.Stringschema()
(Optional) The schema of the table.

 Defaults to the default schema for user.
javax.persistence.UniqueConstraint[]uniqueConstraints()
(Optional) Unique constraints that are
to be placed on the table. These are
only used if table generation is in effect.

 Defaults to no additional constraints.