You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by ke...@apache.org on 2006/10/13 12:32:45 UTC
svn commit: r463632 - in /incubator/tuscany/branches/sdo-java-M2/sdo:
distribution/ sample/ sample/src/main/java/org/apache/tuscany/samples/sdo/
sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/
sample/src/main/java/org/apache/tuscany/s...
Author: kelvingoodson
Date: Fri Oct 13 03:32:42 2006
New Revision: 463632
URL: http://svn.apache.org/viewvc?view=rev&rev=463632
Log:
Update release documentation with the fixes suggested on tuscany-dev by Simon Nash
Modified:
incubator/tuscany/branches/sdo-java-M2/sdo/distribution/CHANGES.txt
incubator/tuscany/branches/sdo-java-M2/sdo/distribution/RELEASE_NOTES.txt
incubator/tuscany/branches/sdo-java-M2/sdo/sample/README.txt
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/ExecuteSamples.java
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/CreatePurchaseOrder.java
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/ReadPurchaseOrder.java
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/package.html
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/overview.html
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/package.html
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/package.html
incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specExampleSection/package.html
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/distribution/CHANGES.txt
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/distribution/CHANGES.txt?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/distribution/CHANGES.txt (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/distribution/CHANGES.txt Fri Oct 13 03:32:42 2006
@@ -1,3 +1,8 @@
+
+Please note that this file acts as a place for logging changes to Tuscany SDO for Java and will be used to
+form the core part of the release notes for a Tuscany SDO for Java release. For a fuller description of
+a particular release please see the RELEASE_NOTES.txt file in the release distribution.
+
M2 Changes Relative to M1
1. `java.io.Serializable` support for `DataObject`s including objects not in a `DataGraph` (TUSCANY-22)
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/distribution/RELEASE_NOTES.txt
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/distribution/RELEASE_NOTES.txt?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/distribution/RELEASE_NOTES.txt (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/distribution/RELEASE_NOTES.txt Fri Oct 13 03:32:42 2006
@@ -85,4 +85,43 @@
7. open content creation API (SDO 2.1 enhancement early implementation - see draft 2.1 spec)
* TypeHelper.createOpenContentProperty()
- * TypeHelper.getOpenContentProperty()
\ No newline at end of file
+ * TypeHelper.getOpenContentProperty()
+
+ 8. sample programs
+ * There are currently three groups of samples
+ 8.1. Simple code snippets located throughout the specifiction with comparative methods for acheiving the same results
+ # Create DataObject from XML String
+ # Create DataObject from XSD and XML files
+ # Access DataObject Properties by name
+ # Dynamic "Customer" Type sample
+ # Print Properties of DataObject
+ # Using XPath
+ # Obtaining DataGraph from XML
+ 8.2. Full examples located within Examples section of specification
+ # Access DataObjects using XPath
+ # Accessing DataObjects via Property index
+ # Accessing the contents of a Sequence
+ # Creating DataObject trees from XMLDocuments
+ # Creating XML from DataObjects
+ # Serializing desearializing a DataObject
+ # Using Type and Property with DataObjects
+ 8.3. Other sample sources such as white papers and online articles
+ # Create PurchaseOrder
+ # Read PurchaseOrder
+ # PurchaseOrder command line
+
+ 9. bug fixes
+ * DataObject string accessors were not working for XPath segements with @ prefix, e.g. "@property" (TUSCANY-425)
+ * string accessors fixed to throw IndexOutOfBounds exception for "property[0]" since index starts with 1 (TUSCANY-475)
+ * fixed Date-Type properties (including Day, Date, DateTime, Duration, etc.) that were not working/roundtripping properly (TUSCANY-579/582)
+ * dynamically-created global (open content) properties were not serializing properly (TUSCANY-530/531)
+ * properties created from XSD attributes now appear, in the Type, in the same order as the attributes in the XSD complexType
+ * fixed test harness to allow comments in XML test files (TUSCANY-427)
+ * loading XSDs with nillable elements, of built-in types, caused NPE (TUSCANY-676)
+ * fixed NPE when loading XSD without targetNamespace (TUSCANY-645)
+ * made Type.getProperty(String) implementaion thread safe (TUSCANY-682)
+ * support base64Binary and hexBinary XSD types correctly (TUSCANY-685)
+ * fixed generation of invalid prefixes in XML serialization (TUSCANY-711)
+ * sometimes SDOXMLResourceImpl (instead of XSDResourceImp) was incorrectly used when loading .xsd files (TUSCANY-714)
+ * roundtripping an xsd:anyType via XML using XMLStreamHelper gave wrong kind of DataObject (TUSCANY-755)
+ * cardinality of global elements should be adaptive according to usage context (TUSCANY-115)
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/README.txt
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/README.txt?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/README.txt (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/README.txt Fri Oct 13 03:32:42 2006
@@ -6,7 +6,7 @@
Building the SDO Java Samples Project from this source distribution
-------------------------------------------------------------------
-Note: If you have already build the SDO for Java Implementation source distribution
+Note: If you have already built the SDO for Java Implementation source distribution
then these sample programs are included in that distribution and are built as part
of that process. This distribution archive is provided for building against a
binary distribution of SDO for Java.
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/ExecuteSamples.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/ExecuteSamples.java?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/ExecuteSamples.java (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/ExecuteSamples.java Fri Oct 13 03:32:42 2006
@@ -172,7 +172,7 @@
.println("--------------------------------------------------------------------------------------------------------------------------");
System.out
- .println("The next two samples are based upon Fuhwei Lo's paper http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/");
+ .println("The next two samples are based upon Fuhwei Lwo's paper http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/");
System.out.println(">>>Press Enter to continue");
in.readLine();
CreatePurchaseOrder.main(args);
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/CreatePurchaseOrder.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/CreatePurchaseOrder.java?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/CreatePurchaseOrder.java (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/CreatePurchaseOrder.java Fri Oct 13 03:32:42 2006
@@ -37,7 +37,7 @@
* {@link org.apache.tuscany.samples.sdo.SdoSampleConstants#PO_XSD_RESOURCE} to
* define types then generates a purchase order DataObject and persists to
* {@link org.apache.tuscany.samples.sdo.SdoSampleConstants#PO_XML_GENERATED}. This
- * sample was used to generate valid XML for Fuhwei Lo's paper <A
+ * sample was used to generate valid XML for Fuhwei Lwo's paper <A
* HREF="http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/"
* title="Me" onClick="checkLinks(this)">Create and read an XML document based on XML
* Schema</A>
@@ -113,7 +113,7 @@
System.out.println("***************************************");
System.out.println("SDO Sample CreatePurchaseOrder");
System.out.println("***************************************");
- System.out.println("This sample is based upon Fuhwei Lo's paper "
+ System.out.println("This sample is based upon Fuhwei Lwo's paper "
+ "http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/"
+ " and demonstrates creating a purchaseOrder DataObject from an "
+ " existing XSD and then persisting to disk. Uses previously defined model");
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/ReadPurchaseOrder.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/ReadPurchaseOrder.java?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/ReadPurchaseOrder.java (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/ReadPurchaseOrder.java Fri Oct 13 03:32:42 2006
@@ -32,7 +32,7 @@
import org.apache.tuscany.samples.sdo.SdoSampleConstants;
/**
- * Reads purchase order DataObject from XML, based upon Fuhwei Lo's paper <A
+ * Reads purchase order DataObject from XML, based upon Fuhwei Lwo's paper <A
* HREF="http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/"
* title="Me" onClick="checkLinks(this)">Create and read an XML document based on XML
* Schema</A>. Uses file
@@ -93,7 +93,7 @@
System.out.println("***************************************");
System.out.println("SDO Sample ReadPurchaseOrder");
System.out.println("***************************************");
- System.out.println("This sample is based upon Fuhwei Lo's paper http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/");
+ System.out.println("This sample is based upon Fuhwei Lwo's paper http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/");
System.out.println("previously generated by CreatePurchaseOrder sample to populate purchase order DataObject");
System.out.println("***************************************");
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/package.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/package.html?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/package.html (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/otherSources/package.html Fri Oct 13 03:32:42 2006
@@ -23,16 +23,18 @@
</head>
<body>
-Provides examples from sources other than the specification. These examples are from whitepapers,
+Provides examples from sources other than the SDO specification. These examples are from whitepapers,
or are custom examples designed to show SDO in a more elegant light than the specification. They
- also include basic interactive examples, and usefull scnearios not outlined in the specification.
+ also include basic interactive examples, and useful scenarios not outlined in the specification.
The user is encouraged to modify and execute these code examples.
<h2>Related Documentation</h2>
-For overviews, tutorials, examples, guides, and tool documentation, please see:
+<h2>Related Documentation</h2>
+For overviews, tutorials, examples, guides, and tool documentation, please see
+
<ul>
- <li><a href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/SDO_Specification_Java_V2.01.pdf">SDO Specification</a></li>
+ <li><a href="http://incubator.apache.org/tuscany/java_sdo_overview.html"> SDO Java Overview</a> section of the Tuscany website.</li>
<li><a href="http://www-128.ibm.com/developerworks/webservices/library/ws-sdoxmlschema/">Create and read an XML document based on XML Schema</a></li>
</ul>
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/overview.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/overview.html?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/overview.html (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/overview.html Fri Oct 13 03:32:42 2006
@@ -3,28 +3,28 @@
<title>SDO Sample Overview</title>
</head>
<BODY>
-<h1>Tuscany Service Data Object (SDO) Samples Programs</h1>
+<h1>Tuscany Service Data Object (SDO) Sample Programs</h1>
<h2>Overview</h2>
This sample code is from the <a href="http://incubator.apache.org/tuscany"
target="_blank"> Apache Tuscany</a> project. The samples were written to help users
understand and experiment with SDO. They are grouped into three packages according to the source of the example material. Some are based upon example code contained
within the <a
- href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/SDO_Specification_Java_V2.01.pdf"
- target="_bank">SDO Specification</a>, and are intended to be read alongside the specification. Others are based upon papers and published material (see the documentation for each sample for the reference to the publication),
-<BR>
-and the third category were simply written
- specifically for these samples.<H2>Experimentation</H2>
+ href="http://osoa.org/download/attachments/791/SDO_Specification_Java_V2.01.pdf?version=1"
+ target="_bank">SDO Specification</a>, and are intended to be read alongside the specification. Others are based upon papers and published material
+ (see the documentation for each sample for the reference to the publication),
+ or were simply written specifically for these samples.
+<H2>Experimentation</H2>
The SDO samples are written to be used in conjunction with the specification and other documents. However,
the most important function that these samples provide is a place to begin experimenting with the SDO API
and programming model. Developers are encouraged to extend and experiment with the current set of samples.
If a sample is unclear, is missing documentation or a tutorial, or does not cover a desired area ,
please send feedback to the tuscany mailing lists,
-or better still send us a patch or <BR> join the Tuscany team and contribute back to the
+or better still send us a patch or join the Tuscany team and contribute back to the
<A href="http://incubator.apache.org/tuscany">project</A>.
<h3>Getting Ready to run the Samples</h3>
-The samples depend of the following libraries<UL>
+The samples depend on the following libraries<UL>
<LI>The SDO API and the Tuscany SDO Implementation
<UL>
<LI>sdo-api-{version}.jar - SDO API</LI>
@@ -44,7 +44,7 @@
<LI>xsd-{version}.jar - the XML Schema model</LI></UL></LI></UL>
<P>If you are running these samples from a Tuscany samples distribution you can resolve these dependencies by ensuring that all the jar files in the lib directory of the extracted distribution are on your classpath.<BR>
<BR>
-If you are running these samples as a result of building Tuscany SDO for Java from a Tuscany source distribution using maven then these dependencies will be resolved by having followed the build insrtuctions.<BR>
+If you are running these samples as a result of building Tuscany SDO for Java from a Tuscany source distribution using maven then these dependencies will be resolved by having followed the build instructions.<BR>
<BR>To run these samples against the current Tuscany codebase, follow the instructions at <A
href="http://incubator.apache.org/tuscany/java_sdo_overview.html">Tuscany SDO Java Overview</A>, which describes how to build Tuscany SDO for Java in an Eclipse SDK environment.</P>
<H3>Running the Samples</H3>
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/package.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/package.html?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/package.html (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/package.html Fri Oct 13 03:32:42 2006
@@ -24,9 +24,10 @@
<body>
Provides common constants and a command line java interface for executing samples.
<h2>Related Documentation</h2>
-
-For overviews, tutorials, examples, guides, and tool documentation, please see:
-
+For overviews, tutorials, examples, guides, and tool documentation, please see the
+<a href="http://incubator.apache.org/tuscany/java_sdo_overview.html"> SDO Java Overview
+</a>
+section of the Tuscany website.
</body>
</html>
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/package.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/package.html?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/package.html (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets/package.html Fri Oct 13 03:32:42 2006
@@ -23,20 +23,18 @@
</head>
<body>
-Provides examples containing code snipets located throughout the SDO Specification. In general these samples attempt to use the
-code and comments contained within the specification but allow a certain degree of flexability extend or improve
-upon the code snipets where desireable.
+Provides examples containing code snippets located throughout the SDO Specification. In general these samples attempt to use the
+code and comments contained within the specification but allow a certain degree of flexibility to extend or improve
+upon the code snippets where desirable.
The user is encouraged to modify and execute these code examples.
<h2>Related Documentation</h2>
-For overviews, tutorials, examples, guides, and tool documentation, please see:
-<ul>
- <li>
- <a href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/SDO_Specification_Java_V2.01.pdf">SDO Specification</a>
- </li>
-</ul>
+For overviews, tutorials, examples, guides, and tool documentation, please see the
+<a href="http://incubator.apache.org/tuscany/java_sdo_overview.html"> SDO Java Overview
+</a>
+section of the Tuscany website.
</body>
</html>
Modified: incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specExampleSection/package.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specExampleSection/package.html?view=diff&rev=463632&r1=463631&r2=463632
==============================================================================
--- incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specExampleSection/package.html (original)
+++ incubator/tuscany/branches/sdo-java-M2/sdo/sample/src/main/java/org/apache/tuscany/samples/sdo/specExampleSection/package.html Fri Oct 13 03:32:42 2006
@@ -24,19 +24,16 @@
<body>
Provides samples from the Examples section of the SDO Specification. In general these samples attempt to use the
-code and comments contained within the specification, exceptions to this are noted in comments.
+code and comments contained within the specification; exceptions to this are noted in comments.
The user is encouraged to modify and execute these code examples.
<h2>Related Documentation</h2>
-
-For overviews, tutorials, examples, guides, and tool documentation, please see:
-<ul>
- <li>
- <a href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/SDO_Specification_Java_V2.01.pdf">SDO Specification</a>
- </li>
-</ul>
+For overviews, tutorials, examples, guides, and tool documentation, please see the
+<a href="http://incubator.apache.org/tuscany/java_sdo_overview.html"> SDO Java Overview
+</a>
+section of the Tuscany website.
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org