root/trunk/Chapter09/Poker-WS/README.txt

This project is the Poker web-service example from Chapter 9 of Spring
in Action, 2nd Edition. However...

I very stupidly used a SNAPSHOT version of Spring-WS when building the
original application contained in the book. The problem with SNAPSHOT
version is that they're volatile and likely to change. Guess what?
Spring-WS changed.

Consequently, the original Poker-WS application in the book and
distributed with the main SiA source code distribution won't work and
won't build. That's the risk of working with a pre-1.0 release.

This version of the Poker-WS project builds against Spring-WS
1.0.2. The good news is that what you're looking at is the latest and
greatest and works against a post-1.0 version of Spring-WS. The bad
news, however, is that some of the code contained herein (especially
the client code) will be different than what's in the book.

There's also another good news side to this story: I've reworked the
client examples to run as an integration test (see the code in
src/test/java/com/springinaction/poker/itest). And, I've tweaked
pom.xml so that you can run the web service and the integration test
from Maven.

For example, to start a Jetty server with the poker web service
deployed, run this at the command line:

    % mvn package cargo:start

To prove this works, point your browser at
http://localhost:8080/Poker-WS/poker.wsdl. You should see the
WSDL for the poker web service. 

Optionally, you can start the web service in Jetty *and* execute the
integration tests against it with the following command line:

    % mvn integration-test

This will compile the code, run the unit tests, start the Jetty
server, deploy the service, execute the integration test, then stop
the Jetty server.

Again, sorry for the confusion that may have been caused by my poor
decision to use a SNAPSHOT release of Spring-WS. Hopefully the
improvements I've made in the example will in some way make amends.

Enjoy,
Craig