Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Configuring an XML Mapping (ELUG)
Contents
For information on how to create EclipseLink mappings, see Creating a Mapping.
This table 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.
| Mapping Type | See... |
|---|---|
For more information, see the following:
Configuring Common XML Mapping Options
This table 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 this table:
| Option | EclipseLink Workbench | Java |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
Configuring Method or Direct Field Accessing at the Mapping Level |
|
|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
Configuring Reference Descriptor
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, EclipseLink uses the xsi:Type attribute to determine the reference class object.
This table summarizes which XML mappings support reference descriptor configuration.
XML Mapping Support for Reference Descriptor Configuration
| XML Mapping | Using the Workbench |
Using Java |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
How to Configure a Reference Descriptor Using Workbench
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. 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.
Configuring Maps to Wildcard
This attribute applies only to the Workbench. Use this option to solve "No XPath specified" problems (see How to Use the Problems Window) for an XML mapping that does not need an XPath (see Configuring XPath) for it maps to a wildcard.
If the XML mapping is owned by an anyType descriptor (see Configuring for Complex Type of anyType), it cannot map to a wildcard, and you must specify an XPath.
This table summarizes which XML mappings support maps to wildcard configuration.
XML Mapping Support for Maps to Wildcard Configuration
| XML Mapping | Using the Workbench | Using Java |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
How to Configure Maps to Wildcard Using Workbench
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.
- Mapping Tab, Maps to Wildcard Option
- If the XML mapping is not owned by an anyType descriptor (see Configuring for Complex Type of anyType) and maps to a wildcard, then you do not need to specify an XPath (see 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.
