6.3.9 Elements under embeddable

The following elements and attributes apply only to the embeddable class that is the target of the elements and attributes:

Organization of this subsection
(1) <embeddable>
(2) <basic>
(3) <transient>

(1) <embeddable>

The embeddable element defines the embeddable class of the persistence unit.

For details about the functionality and attributes, see section 2.7 javax.persistence package in the manual uCosminexus Application Server API Reference Guide.

The following table lists the specifiable attributes:

Table 6-50 Attributes of <embeddable>

Attribute nameTypeOptional/RequiredDescription
classxsd:stringRequiredClass name of the embeddable class.
accessorm:access-typeOptionalThe access attribute defines the access type of the embeddable class. The access attribute overwrites the access type specified in the persistence-unit-defaults element (default element) and entity-mappings element (element valid for the entire persistence unit) provided to the embeddable class.#1
metadata-complete#2xsd:booleanOptionalIf the metadata-complete attribute is specified in the embeddable element, the annotations specified in the embeddable class and in the fields and properties of the embeddable class are ignored.
If metadata-complete is specified in the embeddable element and if the XML element is omitted, the default value is enabled.

#1 Specify PROPERTY or FIELD as the specified value. For details on specifying how to access the entity class fields, see 6.12.3 Specifying how to access the entity class fields in the manual uCosminexus Application Server Common Container Functionality Guide.

#2 If you specify this element when an annotation is specified, the KDJE55532-W message is output.


(2) <basic>

The basic element overwrites the mapping specified in fields and properties.

For details about the functionality and attributes, see section 2.7 javax.persistence package in the manual uCosminexus Application Server API Reference Guide.

The following table lists the specifiable attributes:

Table 6-51 Attributes of <basic>

Attribute nameTypeOptional/RequiredDescription
namexsd:stringRequiredMethods or fields that map the type.
fetchorm:fetch-typeOptionalSee the fetch attribute in 2.7.5 @Basic in the manual uCosminexus Application Server API Reference Guide.
optionalxsd:booleanOptionalSee the optional attribute in 2.7.5 @Basic in the manual uCosminexus Application Server API Reference Guide.

(3) <transient>

The transient element overwrites the mapping specified in fields and properties.

For details about the functionality and attributes, see section 2.7 javax.persistence package in the manual uCosminexus Application Server API Reference Guide.

The following table lists the specifiable attributes:

Table 6-52 Attributes of <transient>

Attribute nameTypeOptional/RequiredDescription
namexsd:stringRequiredProperty or field that is non-persistent.