Difference between revisions of "EclipseLink/UserGuide/SDO/Using EclipseLink SDO (ELUG)"

Revision as of 11:06, 30 April 2009

This section explains where and how you use EclipseLink SDO to customize your application to meet requirements.

Performing Actions on Data Objects at Run Time

Use the following classes to perform actions on your data objects:

• HelperContext
• DataFactory
• XMLHelper
• DataHelper
• CopyHelper
• EqualityHelper

For more information, see EclipseLink SDO examples.

Using HelperContext

SDO defines a HelperContext interface. You use it to access related SDO helper classes that let you perform common operations such as reading and writing XML documents, defining SDO types from XML Schema, and so on.

To obtain a default context, call the HelperProvider getDefaultContext method.

You can create the local context provided by EclipseLink as follows:

HelperContext helperContext = new SDOHelperContext();

For more information, see the following:

• EclipseLink SDOHelperContext API
• EclipseLink HelperContext examples

What You May Need to Know About Local and Global HelperContext

All the helpers that you can retrieve using accessor methods or instance fields of the global HelperContext have visibility to the global SDO metadata, that is, their scope of execution is global.

The opposite is true for the local HelperContext, such as the SDOHelperContext provided by EclipseLink: you can use it to obtain helpers that have visibility to the local SDO metadata.

Using the EclipseLink SDOHelperContext makeDefaultContext method, you can promote your local context to become the global (default) one.

Using DataFactory

You use the DataFactory to create disconnected instances of a DataObject. That is, the newly created DataObject instances have no set properties and no container.

You can obtain the DataFactory from the HelperContext, and vice versa.

For more information, see the following:

• EclipseLink SDODataFactory API
• EclipseLink DataFactory examples

Using XMLHelper

You use the XMLHelper to convert XML documents into data objects, and vice versa. The two main operations of the XMLHelper are load and save.

You can obtain the default XMLHelper from the INSTANCE field or from the getXMLHelper method of the default HelperContext.

The EclipseLink SDOXMLHelper initializeDescriptor methd allows you to define an XML descriptor for your application.

For more information, see the following:

• EclipseLink SDOXMLHelper API
• EclipseLink XMLHelper examples

Using DataHelper

Information pending

Using CopyHelper

Information pending

Using EqualityHelper

Information pending

Generating Static SDO Classes at Design Time

Information pending

Performing Integration

Information pending

Integrating SDO with JAXB

Information pending

Integrating SDO with JPA

Information pending

Using SDO as a Web Service Binding Layer

Information pending

How to Use Web Service Attachments

Information pending

Executing XPath with XML

Information pending

Copyright Statement