36 Configuring a Relational Direct-to-XMLType Mapping

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

For more information, see the following:

• "Mapping Creation Overview"

• "Direct-to-XMLType Mapping"

Table 36-1 lists the configurable options for a relational direct-to-XMLType mapping.

Relational Direct-to-XMLType Mapping Overview

Table 36-1 lists the configurable options for a relational direct-to-XMLType mapping.

Table 36-1 Configurable Options for Relational Direct-To-XMLType Mapping

Option	Type	TopLink Workbench	Java
"Configuring a Database Field"	Basic
"Configuring Method Accessing"	Advanced
"Configuring Read-Only Mappings"	Advanced
"Configuring Read Whole Document"	Advanced
"Configuring Mapping Comments"	Advanced

Configuring Read Whole Document

When mapping an XML Type to a Document Object Model (DOM), by default TopLink 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.

Using TopLink 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.

   Figure 36-1 DIrect to XML Mapping Property Sheet, Read Whole Document Option

   
   Description of "Figure 36-1 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 TopLink to read the database values.