Module org.eclipse.persistence.core

Package org.eclipse.persistence.annotations

Annotation Type BasicMap

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

Deprecated.

A BasicMap is used to map an org.eclipse.persistence.mappings.DirectMapMapping, which stores a collection of key-value pairs of simple types (String, Number, Date, etc.). It is used in conjunction with a CollectionTable which stores the key, the value and a foreign key to the source object.

Since:

Oracle TopLink 11.1.1.0.0

See Also:

• A converter may be used if the desired object type and the data type do not match. This applied to both the key and value of the map.
• Convert
• Converter
• ObjectTypeConverter
• A BasicMap can be specified within an Entity, MappedSuperclass and Embeddable class.
• ElementCollection

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
FetchType	fetch	Deprecated. (Optional) Defines whether the value of the field or property should be lazily loaded or must be eagerly fetched.
Column	keyColumn	Deprecated. (Optional) The name of the data column that holds the direct map key.
Convert	keyConverter	Deprecated. (Optional) Specify the key converter.
Column	valueColumn	Deprecated. (Optional) The name of the data column that holds the direct collection data.
Convert	valueConverter	Deprecated. (Optional) Specify the value converter.

Element Details

fetch

FetchType fetch

Deprecated.

(Optional) Defines whether the value of the field or property should be lazily loaded or must be eagerly fetched. The EAGER strategy is a requirement on the persistence provider runtime that the value must be eagerly fetched. The LAZY strategy is a hint to the persistence provider runtime. If not specified, defaults to LAZY.

Default:

LAZY

keyColumn

Column keyColumn

Deprecated.

(Optional) The name of the data column that holds the direct map key. If the name on the key column is "", the name will default to: the name of the property or field; "_KEY".

Default:

@jakarta.persistence.Column

keyConverter

Convert keyConverter

Deprecated.

(Optional) Specify the key converter. Default is equivalent to specifying @Convert("none"), meaning no converter will be added to the direct map key.

Default:

@org.eclipse.persistence.annotations.Convert

valueColumn

Column valueColumn

Deprecated.

(Optional) The name of the data column that holds the direct collection data. Defaults to the property or field name.

Default:

@jakarta.persistence.Column

valueConverter

Convert valueConverter

Deprecated.

(Optional) Specify the value converter. Default is equivalent to specifying @Convert("none"), meaning no converter will be added to the value column mapping.

Default:

@org.eclipse.persistence.annotations.Convert