@Target(value={ANNOTATION_TYPE,METHOD,FIELD}) @Retention(value=RUNTIME) public @interface CollectionTable
By default, the columns of the collection table that correspond to the embeddable class or basic type are
derived from the attributes of the embeddable class or from the basic type according to the default values
of the Column
annotation. In the case of a basic type, the column name is derived from the
name of the collection-valued field or property. In the case of an embeddable class, the column names are
derived from the field or property names of the embeddable class.
Column
annotation is used on the collection-valued attribute in addition to the ElementCollection
annotation.
AttributeOverride
and/or
AttributeOverrides
annotations can be used in addition to the ElementCollection
annotation. If the embeddable class contains references to other entities, the default values for the
columns corresponding to those references may be overridden by means of the
AssociationOverride
and/or AssociationOverrides
annotations.
If the CollectionTable
annotation is missing, the default values of the
CollectionTable
annotation elements apply.
Example: @Embeddable public class Address { protected String street; protected String city; protected String state; ... } @Entity public class Person { @Id protected String ssn; protected String name; protected Address home; ... @ElementCollection // use default table (PERSON_NICKNAMES) @Column(name="name", length=50) protected Set<String> nickNames = new HashSet(); ... } @Entity public class WealthyPerson extends Person { @ElementCollection @CollectionTable(name="HOMES") // use default join column name @AttributeOverrides({ @AttributeOverride(name="street", column=@Column(name="HOME_STREET")), @AttributeOverride(name="city", column=@Column(name="HOME_CITY")), @AttributeOverride(name="state", column=@Column(name="HOME_STATE")) }) protected Set<Address> vacationHomes = new HashSet(); ... }
ElementCollection
,
AttributeOverride
,
AssociationOverride
,
Column
Modifier and Type | Optional Element and Description |
---|---|
String |
catalog
(Optional) The catalog of the table.
|
ForeignKey |
foreignKey
(Optional) Used to specify or control the generation of a foreign key constraint for the columns
corresponding to the joinColumns element when table generation is in effect.
|
Index[] |
indexes
(Optional) Indexes for the table.
|
JoinColumn[] |
joinColumns
(Optional) The foreign key columns of the collection table which reference the primary table of the
entity.
|
String |
name
(Optional) The name of the collection table.
|
String |
schema
(Optional) The schema of the table.
|
UniqueConstraint[] |
uniqueConstraints
(Optional) Unique constraints that are to be placed on the table.
|
public abstract String name
public abstract String catalog
public abstract String schema
public abstract JoinColumn[] joinColumns
JoinColumn
(i.e., the concatenation of the following: the name of the entity; "_"; the
name of the referenced primary key column.) However, if there is more than one join column, a
JoinColumn
annotation must be specified for each join column using the
JoinColumns
annotation. In this case, both the name
and the
referencedColumnName
elements must be specified in each such JoinColumn
annotation.public abstract UniqueConstraint[] uniqueConstraints
public abstract Index[] indexes
public abstract ForeignKey foreignKey
Copyright © 2020. All rights reserved.