Oracle Fusion Middleware Developer's Guide for Oracle TopLink 11g Release 1 (11.1.1) Part Number B32441-03 |
|
|
View PDF |
This chapter describes how to configure an XML mapping.
This chapter includes the following sections:
For information on how to configure TopLink mappings options common to two or more mapping types, see Chapter 121, "Configuring a Mapping".
For information on how to create TopLink mappings, see Chapter 120, "Creating a Mapping".
Table 54-1 lists the types of XML mappings that you can configure and provides a cross-reference to the type-specific chapter that lists the configurable options supported by that type.
Table 54-1 Configuring XML Mappings
For more information, see the following:
Table 54-2 lists the configurable options shared by two or more XML mapping types. In addition to the configurable options described here, you must also configure the options described for the specific XML Mapping Types, as shown in Table 54-1.
Table 54-2 Common Options for XML Mappings
Option | Oracle JDeveloper |
TopLink Workbench | Java |
---|---|---|---|
![]() |
![]() |
![]() |
|
![]() |
![]() |
![]() |
|
![]() |
![]() |
![]() |
|
Section 121.6, "Configuring Method or Direct Field Accessing at the Mapping Level" |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
![]() |
![]() |
|
|
![]() |
![]() |
![]() |
|
![]() |
![]() |
![]() |
|
![]() |
![]() |
![]() |
|
![]() |
![]() |
![]() |
|
![]() |
![]() |
![]() |
|
|
|
![]() |
|
Section 54.5, "Configuring Source to Target Key Field Association" |
![]() |
|
![]() |
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
|
![]() |
For XML attributes that reference other descriptors (instead of a schema element), you may select a specific reference descriptor. If you do not specify a reference descriptor, TopLink uses the xsi:Type
attribute to determine the reference class object.
In TopLink versions prior to 11g (11.1.1.0), the reference class was required.
Table 54-3 summarizes which XML mappings support reference descriptor configuration.
Table 54-3 XML Mapping Support for Reference Descriptor Configuration
To specify a reference descriptor for an XML mapping that references another descriptor (instead of a schema element), use this procedure.
Select the mapped attribute in the Navigator. Its properties appear in the Editor.
Click the General tab. The General tab appears.
Figure 54-1 General Tab, Reference Descriptor Field
If this XML attribute refers to another descriptor (instead of a schema element), use the Reference Descriptor field to select a descriptor in the project.
This attribute applies only to Oracle JDeveloper TopLink Editor and TopLink Workbench. Use this option to solve "No XPath specified" problems (see Section 5.3.5, "How to Use the Problems Window") for an XML mapping that does not need an XPath (see Section 121.4, "Configuring XPath") for it maps to a wildcard.
If the XML mapping is owned by an anyType
descriptor (see Section 52.3, "Configuring for Complex Type of anyType"), it cannot map to a wildcard, and you must specify an XPath.
Table 54-4 summarizes which XML mappings support maps to wildcard configuration.
Table 54-4 XML Mapping Support for Maps to Wildcard Configuration
To specify a map a schema element using the xs:any
declaration, use this procedure.
Select the mapped attribute in the Navigator. Its properties appear in the Editor.
Figure 54-2 Mapping Tab, Maps to Wildcard Option
If the XML mapping is not owned by an anyType
descriptor (see Section 52.3, "Configuring for Complex Type of anyType") and maps to a wildcard, then you do not need to specify an XPath (see Section 121.4, "Configuring XPath"). Select the Maps to Wildcard (uses "any" tag) option to clear the missing XPath neediness message.
If the XML mapping is owned by an anyType
descriptor, it cannot map to a wildcard and you must specify an XPath. Deselect the Maps to Wildcard (Uses "any" tag) option and ensure that you specify an XPath.
This option is applicable to key on source-based mappings. Use this option to add a source and target XPath pair to the map of such key pairs.
Table 54-5 summarizes which XML mappings support source to target key field association configuration.
Table 54-5 XML Mapping Support for Source to Target Key Field Association Configuration
To configure the source to target key field association for your mapping, use the XMLObjectReferenceMapping
method addSourceToTargetKeyFieldAssociation
to add a specified source and target XPath pair to the map.
This option is applicable to key on source-based mappings.
Use this option to define the reference class, whose instances your XML object reference mapping will store in the domain objects.
Table 54-6 summarizes which XML mappings support source to target key field association configuration.
Table 54-6 XML Mapping Support for Reference Class Configuration
To configure a reference class for your mapping, use the AggregateMapping
method setReferenceClass
.
This option is applicable to binary data mappings.
Use this option to define whether or not there should always be inline binary data for this mapping.
Table 54-7 summarizes which XML mappings support the use of inline binary data configuration.
Table 54-7 XML Mapping Support for the Use of Inline Binary Data Configuration
To configure the use of inline binary data for your mapping, use the XMLBinaryDataMapping
or XMLBinaryDataCollectionMapping
method setShouldInlineBinaryData
. If you set it to true
, you disable consideration for attachment handling for this mapping and indicate that you only want inline data.
This option is applicable to binary data mappings.
Use this option to specify that the target node of this mapping is of type xs:swaref
.
Table 54-8 summarizes which XML mappings support the use of SwaRef type configuration.
Table 54-8 XML Mapping Support for the Use of SwaRef Type Configuration
To configure the use of SwaRef type for your mapping, use the XMLBinaryDataMapping
or XMLBinaryDataCollectionMapping
method setSwaRef
. If you set it to true
, you indicate that the target node of this mapping is of type xs:swaref
.
This option is applicable to choice mappings.
Use this option to specify an XPath and the type associated with this XPath.
Table 54-9 summarizes which XML mappings support the choice element configuration.
Table 54-9 XML Mapping Support for the Choice Element Configuration
Use the following XMLChoiceObjectMapping
or XMLChoiceCollectionMapping
methods to add choice element:
addChoiceElement(String xpath, Class elementType)
addChoiceElement(String xpath, String elementTypeName)