1 files changed, 135 insertions, 0 deletions
diff --git a/sdo-java/tags/1.0-incubating-beta1/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/AccessDataObjectUsingValidXPath.java b/sdo-java/tags/1.0-incubating-beta1/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/AccessDataObjectUsingValidXPath.java
new file mode 100644
index 0000000000..7b3b7b05c6
--- /dev/null
+++ b/sdo-java/tags/1.0-incubating-beta1/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/AccessDataObjectUsingValidXPath.java
@@ -0,0 +1,135 @@
+/**
+ *
+ *  Licensed to the Apache Software Foundation (ASF) under one
+ *  or more contributor license agreements.  See the NOTICE file
+ *  distributed with this work for additional information
+ *  regarding copyright ownership.  The ASF licenses this file
+ *  to you under the Apache License, Version 2.0 (the
+ *  "License"); you may not use this file except in compliance
+ *  with the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing,
+ *  software distributed under the License is distributed on an
+ *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *  KIND, either express or implied.  See the License for the
+ *  specific language governing permissions and limitations
+ *  under the License.
+ */
+
+package org.apache.tuscany.samples.sdo.specCodeSnippets;
+
+import org.apache.tuscany.samples.sdo.SdoSampleConstants;
+
+import commonj.sdo.DataObject;
+import commonj.sdo.helper.XMLHelper;
+import commonj.sdo.helper.XSDHelper;
+
+/**
+ * Demonstrates accessing a created DataObject's properties using the SDO XPath like syntax.
+ * 
+ * This sample is from the <a href="http://incubator.apache.org/tuscany"
+ * target="_blank"> Apache Tuscany</a> project. It was written to help users
+ * understand and experiment with SDO. It is based upon code snipets contained
+ * within, and is meant for use with, and reference to the <a
+ * href="http://osoa.org/download/attachments/36/Java-SDO-Spec-v2.1.0-FINAL.pdf?version=1"
+ * target="_bank">SDO Specification</a>. <br>
+ * <p>
+ * <b>Usage:</b> <br>
+ * This sample can easily be run from within Eclipse as a Java Application if tuscany or 
+ * the sample-sdo project is imported into Eclipse as an existing project.
+ * <br><br>
+ * If executing as a standalone application please do the following: 
+ * <br>
+ * <UL>
+ * <LI>Include the following jar files on your classpath :
+ * <UL>
+ * <LI>SDO API and Tuscany Implementation
+ * <UL>
+ * <LI>sdo-api-{version}.jar - SDO API
+ * <LI>tuscany-sdo-impl-{version}.jar - Tuscany SDO implementation
+ * </UL>
+ * </LI>
+ * <LI>EMF dependencies. 
+ * <UL>
+ * <LI>emf-common-{version}.jar - some common framework utility and base classes
+ * <LI>emf-ecore-{version}.jar - the EMF core runtime implementation classes (the Ecore metamodel)
+ * <LI>emf-ecore-change-{version}.jar - the EMF change recorder and framework
+ * <LI>emf-ecore-xmi-{version}.jar - EMF's default XML (and XMI) serializer and loader
+ * <LI>xsd-{version}.jar - the XML Schema model
+ * </UL>
+ * </LI>
+ * </UL>
+ * 
+ * These jar files can be obtained by downloading and unpacking a <a href="http://cwiki.apache.org/TUSCANY/sdo-downloads.html" target="_blank">Tuscany binary distribution</a></LI>
+ * <LI>Execute: java
+ * org.apache.tuscany.samples.sdo.specCodeSnippets.AccessDataObjectUsingValidXPath</LI>
+ */
+public class AccessDataObjectUsingValidXPath {
+
+    /**
+     * Prints a subset of item properties to System.out where the individual item was
+     * accessed using an xPath expression
+     * 
+     * @param purchaseOrder.
+     *            DataObject defined by Types in
+     *            {@link org.apache.tuscany.samples.sdo.SdoSampleConstants#PO_XSD_RESOURCE}
+     */
+    public static void accessDataObjectUsingXPath(DataObject purchaseOrder) {
+
+        System.out.println("Accessing individual item from list using xpath");
+        // TODO: use variety of xpath expressions such as items/item[1]
+        // TODO: add to junit test cases for test cases above
+        DataObject item = purchaseOrder.getDataObject("items/item[1]");
+        System.out.println("Item toString : " + item.toString());
+
+        System.out.println("Item name:" + item.get("productName"));
+        System.out.println("Part num: " + item.get("partNum"));
+
+    }
+
+    /**
+     * Accesses and modifies properties of a purchase order DataObject using xPath(
+     * properties are defined in the xsd
+     * {@link org.apache.tuscany.samples.sdo.SdoSampleConstants#PO_XSD_RESOURCE} and
+     * populated by xml
+     * {@link org.apache.tuscany.samples.sdo.SdoSampleConstants#PO_XML_RESOURCE} )
+     * 
+     * @param args.
+     *            No parameters required.
+     */
+    public static void main(String[] args) {
+
+        // information
+        System.out.println("***************************************");
+        System.out.println("SDO Sample AccessDataObjectUsingValidXPath");
+        System.out.println("***************************************");
+        System.out.println("Demonstrats accessing a created DataObject's properties using xPath.");
+        System.out.println("***************************************");
+
+        // create a DataObejct
+        DataObject purchaseOrder = null;
+        try {
+            XSDHelper.INSTANCE.define(ClassLoader.getSystemResourceAsStream(SdoSampleConstants.PO_XSD_RESOURCE), null);
+            purchaseOrder = XMLHelper.INSTANCE.load(ClassLoader.getSystemResourceAsStream(SdoSampleConstants.PO_XML_RESOURCE)).getRootObject();
+            System.out.println("DataObject created");
+        } catch (Exception e) {
+            System.out.println("Error creating DataObject " + e.toString());
+            e.printStackTrace();
+            return;
+        }
+
+        // start of sample
+        try {
+
+            accessDataObjectUsingXPath(purchaseOrder);
+        } catch (Exception e) {
+            System.out.println("Sorry there was an error accessing properties by name " + e.toString());
+            e.printStackTrace();
+        }
+        System.out.println("GoodBye");
+        // end of sample
+    }
+
+}