On 5/24/07, Simon Laws <[EMAIL PROTECTED]> wrote:
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
Listing all these issues like this makes RC1 sound a bit too imperfect IMHO
so I'm now -1 on releasing it.
I've cut a new RC2 which includes all the fixes that have been made in the
0.90 branch, many thanks to all those who've been fixing things there as the
problems have been discovered. It doesn't fix the Javadoc problem, there's a
note in the CHANGES file saying thats incomplete, and it doesn't fix the
Linux build issue, there's a note in the BUILDING file about that, and
there's a couple of other's not fixed as they seemed either to small or
difficult to be worth the risk of the change. Fingers crossed the respin
hasn't introduced any new problems...
I'll start a new vote thread for RC2.
...ant
