OK, below is an errata based on the points that people have highlighted as
important in this thread. Anything else need to be added? Anyone have any
better words for installing samples from the binary distro in Eclipse or any
words at all for IDEA. Now we have most people's comments in, this is quite
a long list!
Simon
Samples
=======
* Some sample READMEs don't match the code as it stands
calculator-rmi-reference
The README describes how to start client and server processes from this
project. This is now not
the case. This project now only supports the client process. Use the
calculator-rmi-service sample
to start the server using "ant-f build-server.xml run" first and then
run the client here.
calculator-rmi-service
The README describes how to start client and server processes from this
project. This is now not
the case. This project now only supports the server process. Run the
server here first and then
use the calculator-rmi-reference sample to start the client using "ant
-f build-client.xml run".
* The implementation-crud-client sample has the wrong package name for the
test client
In both README and build.xml "crud.CRUDClient" should read "
crud.client.CRUDClient"
* The calculator-web and helloworld-jsonrpc build.xml produces a war that is
not deployable. To fix the build.xml file. Move the line
<include name="sca-api-0.90-incubating-SNAPSHOT.jar"/>
From the <lib> section to the <zipfileset> section.
* At the top of the web page provided by the helloworld-jsonrpc sample there
is the text.
"... to make JSON-RPC requests to the service located at
services/HelloWorldService"
Selecting the link "service/HelloWorldService" causes and error.
* There is no sample for how to use the META_INF/sca-deployables feature in
this release.
Build
=====
* There is a problem building the source distribution on linux with the IBM
JDK 1.5.0. The problem manifests itself
with a problem building the databinding-jaxb module. Maven reports that it
is unable to process the
maven-jaxb-plugin pom. This occurs because this pom has non-UTF8
characters. The manual fix is to remove the
offending characters manually from the pom in your local repo and restart
the build:
.m2/repository/com/sun/tools/xjc/maven2/maven-jaxb-plugin/1.1/maven-
jaxb-plugin-1.1.pom
remove the non-UTF8 characters from this block.
<developer>
<id>MÆlfweald</id>
<name>Malachi de Ælfweald</name>
<email>[EMAIL PROTECTED]</email>
<roles>
<role>Developer</role>
</roles>
</developer>
Documentation
=============
* Java doc for some of the SPI packages listed in the the CHANGES file are
missing from the docs directory
* Java doc for org.osoa.sca.* packages is provided but not included on the
index page
* Java doc to the Tuscany Java SCA APIs is not provided with this release
* Instructions for loading the binary distribution samples into an IDE
without using maven to generate suitable project
files are missing.
For Eclipse - in a new or existing workspace
Create a new java project to represent the sample you want to work on,
e.g.
calculator
Import all of the sample code and resources into this project, e.g.
File, Import and then select
tuscany-sca-0.90-incubating\samples\calculator from the filesystem
Configure the source path to include
src/main/java
src/main/resources
Configure the output folder to be
calculator/target
Configure the build path to include all of the jars provided in
lib
modules
If you select calculator.CalculatorClient.java and run as "Java
Application" you should see
3 + 2=5.0
3 - 2=1.0
3 * 2=6.0
3 / 2=1.5
Other
=====
* Some non-working modules have been included in the distribution and should
be ignored
modules/binding-jms
modules/discovery-jms
modules/implementation-spring
modules/jmx
