Skip to main content

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.

Jump to: navigation, search

Configuring a Relational Direct-to-XMLType Mapping (ELUG)

Revision as of 11:49, 26 November 2007 by Rick.sapir.oracle.com (Talk | contribs) (New page: <div style="float:right;border:1px solid #000000;padding:5px">__TOC__ Related Topics</div> This section describes the...)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


This section describes the various components that you must configure in order to use a relational direct-to-XMLType mapping.

For information on how to configure EclipseLink mappings options common to two or more mapping types, see Configuring a Mapping.

For information on how to create EclipseLink mappings, see Creating a Mapping.

Configurable Options for Relational Direct-To-XMLType Mapping lists the configurable options for a relational direct-to-XMLType mapping.


Introduction to Relational Direct-to-XMLType Mapping

This table lists the configurable options for a relational direct-to-XMLType mapping.


Configurable Options for Relational Direct-To-XMLType Mapping

Option to Configure Workbench Java

Database field (see Configuring a Database Field)

Supported

Supported

Method or direct field access (see Configuring a Type Conversion Converter)

Supported

Supported

Read-only (see Configuring Read-Only Mappings)

Supported

Supported

Read whole document (see Configuring Read Whole Document)

Supported

Supported

Mapping comments (see Configuring Mapping Comments)

Supported

Supported


For more information, see the following:


Configuring Read Whole Document

When mapping an XML Type to a Document Object Model (DOM), by default EclipseLink uses the database representation of the DOM. This allows for lazy loading of the XML data from the database.

However, if you require the entire DOM, (or if you require the DOM to be available in a disconnected fashion from the database connection) use the Read Whole option to retrieve the entire DOM from the database.


How to Configure Read Whole Document Using Workbench

To specify that this mapping reads the whole XML document, use this procedure:

  1. Select the mapping in the Navigator. Its properties appear in the Editor.
  2. Click General. The General tab appears.
    Direct to XML Mapping Property Sheet, Read Whole Document Option
    Direct to XML Mapping Property Sheet, Read Whole Document Option

Choose the Read Whole Document option to read the whole XML document. If you do not select this option, the connection must remain open for EclipseLink to read the database values.

See Also

#Configuring Read Whole Document

How to Configure Read Whole Document Using Java

Use the following DirectToXMLTypeMapping methods:

  • setShouldReadWholeDocument
  • shouldReadWholeDocument

For more information about the available methods for DirectToXMLTypeMapping, see the EclipseLink API Reference.



Copyright Statement

Back to the top