Module jakarta.persistence

Package jakarta.persistence

Annotation Interface JoinColumns

@Target({METHOD,FIELD})
@Retention(RUNTIME)
public @interface JoinColumns

Specifies the mapping for composite foreign keys. This annotation groups JoinColumn annotations for the same relationship.

Each JoinColumn annotation must explicit specify both name and referencedColumnName.

Example:

@ManyToOne
@JoinColumns({
    @JoinColumn(name = "ADDR_ID", referencedColumnName = "ID"),
    @JoinColumn(name = "ADDR_ZIP", referencedColumnName = "ZIP")})
public Address getAddress() { return address; }

Since:

1.0

See Also:

• JoinColumn
• ForeignKey

Required Element Summary

Required Elements

Modifier and Type	Required Element	Description
JoinColumn[]	value	The join columns that map the relationship.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
ForeignKey	foreignKey	(Optional) Used to specify or control the generation of a foreign key constraint when table generation is in effect.

Element Details

value

JoinColumn[] value

The join columns that map the relationship.

foreignKey

ForeignKey foreignKey

(Optional) Used to specify or control the generation of a foreign key constraint when table generation is in effect. If both this element and the foreignKey element of any of the JoinColumn elements are specified, the behavior is undefined. If no foreign key annotation element is specified in either location, a default foreign key strategy is selected by the persistence provider.

Since:

2.1

Default:

@jakarta.persistence.ForeignKey(PROVIDER_DEFAULT)