EclipseLink/Examples/SDO/BasicAPI

From Eclipsepedia

Jump to: navigation, search

Contents

HelperContext

TypeHelper - Access Metadata

TypeHelper provides a convenient means of handling SDO metadata.

TypeHelper typeHelper = helperContext.getTypeHelper();

Define Types

Get Types

Define Open Content Properties

Get Open Content Properties

XSDHelper - Access XML Schema Metadata

XSDHelper provides a convenient means of handling XML Schema metadata.

XSDHelper xsdHelper = helperContext.getXSDHelper();

Define

Generate

DataFactory - Create DataObjects

DataFactory provides a convenient means of creating SDO DataObjects.

DataFactory dataFactory = helperContext.getDataFactory();

Create

DataHelper - Convert Simple Values

DataHelper provides a convenient means of converting SDO data type values.

DataHelper dataHelper = helperContext.getDataHelper();

XMLHelper - Handle XML Data as DataObjects

XMLHelper provides a convenient means of handling XML data as DataObjects.

XMLHelper xmlHelper = helperContext.getXMLHelper();

Load

FileInputStream xmlInputStream = new FileInputStream("customer.xml");
XMLDocument xmlDocument = xmlHelper.load(xmlInputStream);

Create Document

XMLDocument xmlDocument = xmlHelper.createDocument(customerDO, "http://www.example.org/customer-example", "customer");
xmlDocument.setSchemaLocation("http://www.example.org/customer-example/customer.xsd");

Save

xmlHelper.save(xmlDocument, System.out, null);
xmlHelper.save(customerDO, "http://www.example.org/customer-example", "customer", System.out);

CopyHelper - Create Copies of DataObjects

CopyHelper provides a convenient means of copying DataObjects.

CopyHelper copyHelper = helperContext.getCopyHelper();

Shallow Copy

Create a new DataObject containing the values of all dataType=true properties (excluding the ChangeSummary property).

DataObject shallowCopy = copyHelper.copyShallow(dataObject);

Deep Copy

Create a copy of the entire tree.

DataObject deepCopy = copyHelper.copy(dataObject);

EqualityHelper - Compare DataObjects

EqualityHelper provides a convenient means of comparing DataObjects.

EqualityHelper equalityHelper = helperContext.getEqualityHelper();

Shallow Equal

Two DataObjects are considered shallow equal if the data objects are of the same type and all the values of all dataType=true properties (excluding the ChangeSummary property) are equal.

boolean isShallowEqual = equalityHelper.equalShallow(dataObject1, dataObject2);

Deep Equal

Two DataObjects are considered deep equal if the data objects and the trees that they belong to are both equal.

boolean isDeepEqual = equalityHelper.equal(dataObject1, dataObject2);