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 @@
* [EMAIL PROTECTED]
org.apache.tuscany.samples.sdo.SdoSampleConstants#PO_XSD_RESOURCE} to
* define types then generates a purchase order DataObject and persists to
* [EMAIL PROTECTED]
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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
