[TUSCANY-2333] demos/samples/tutorials in "Java SCA Documentation" do not work (3 of them all fail, on Linux, at least)

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: Java-SCA-1.2
• Fix Version/s: Java-SCA-1.x
• Component/s: Java SCA Documentation
• Environment: Fedora 9; Eclipse Europa EE version 3.3.2; java-1.6.0-openjdk-1.6.0.0
• Assignee: Luciano Resende
• Reporter: Eric Herget
• Created: 21/May/08 21:33
• Updated: 19/Sep/10 11:28
• Resolved: 29/Aug/08 03:16

Description

On the Java SCA Document page (for version 1.2) the last 3 of the 4 links in the User Guide section point to tutorial/sample/demo documents that describes steps/sample/tutorial which fail to work as described. I didn't try the document behind the first link. The 3 other documents are identified below with specific issues in each listed.

Based on the fact that none of the 3 documents I tried to use to help me learn more about Tuscany actually worked, I suspect there is a greater, underlying problem. That being that no one is keeping the sample/demo/tutorial docs in sync with new releases, or at least not checking that these documents describe steps that work on linux/Fedora/openjdk/java 1.6/eclipse3.3.2/etc

The documents and their specific problems are:

Getting Started with Tuscany using a Tuscany Distribution In Eclipse

• it describes using version 1.1, not 1.2 of Tuscany
• when creating ShoppingCartImpl, two imports from this package don't exist: org.apache.tuscany.sca.binding.feed.collection... there is no ...binding.feed... package, but there is ...binding.rss... and ...binding.atom...

Getting Started with Tuscany using the Tuscany Eclipse plugin

• is just a slightly modified version of the non-plugin document above
• it says add "Tuscany Library" to project libraries (this is correct), but screen shot shows "TUSCANY" and not "Tuscany Library" (this is incorrect and probably left from original, non-eclipse document)
• none of the org.apache.tuscany.sca.binding.... imports can be found
• none of the com.sun.syndication... imports can be found

First Steps - Building your first web services using Tuscany

• In step where running helloworld.composite as Tuscany, console shows 2 different exceptions:
  • first, early exception is "SEVERE: IOException while loading persisted sessions: java.io.EOFException
  • later exception is (while trying to start helloworld composite) "SEVERE: Could not start composite org.osoa.sca.ServiceRuntimeException: javax.xml.stream.XMLStreamException: Non-default namespace can not map to empty URI (as per Namespace 1.0 # 2) in XML 1.0 documents