diff options
-rw-r--r-- | sca-java-2.x/trunk/samples/README | 154 |
1 files changed, 0 insertions, 154 deletions
diff --git a/sca-java-2.x/trunk/samples/README b/sca-java-2.x/trunk/samples/README deleted file mode 100644 index 15736845da..0000000000 --- a/sca-java-2.x/trunk/samples/README +++ /dev/null @@ -1,154 +0,0 @@ -The Apache Tuscany SCA Samples -============================== - -Welcome to the Apache Tuscany SCA Java runtime. You can find more general -documentation about the runtime at: - -http://tuscany.apache.org/documentation-2x/ - -Here we give a short overview of what you can find in the samples directory. -More detail on the individual sample contributions can be found at: - -http://tuscany.apache.org/documentation-2x/20-beta-samples-documentation.html - -There are several samples subdirectories in the distribution; - -getting-started -=============== - -This is a good place to start if you've not tried Tuscany SCA Java before. This -directory contains a number of simple "SCA Contributions" that can be run using -the Tuscany SCA runtime. An SCA Contribution is the way that SCA composite -applications are packaged so they can be run. For general information on SCA -see http://tuscany.apache.org/documentation-2x/sca-introduction.html - -learning-more -============= - -This directory contains many more SCA Contributions that you can try with -the Tuscany SCA Java runtime. Some demonstrate particular features of the -runtime, or example, the contributions under the async directory demonstrate -the asynchronous programming model that the runtime supports. - -SCA is extensible. You can plug in extensions to support many different types -of technology. The Tuscany SCA Java runtime comes with lots of extensions -and the majority of contributions here demonstrate these extensions. They are -organized under directories following the name of the extension, for example, -contributions that demonstrate the web services binding in operation can -be found in the binding-ws directory. When you want to use the web service -binding with an SCA service a reference it appears in the composite XML in -the following way: - -<service> - <binding.ws/> -</service> - -Hence it should be easy to map between extensions, as they appear in -composite files and other samples that demonstrate various features of the -extension. - -The contributions here can be run with using the approach that you find -most convenient from the running-tuscany directory. - -running-tuscany -=============== - -The Tuscany SCA Java runtime can be used directly from the command line. It can -also be embedded in other programs. As such there are many different ways that -you can start the Tuscany SCA runtime and deploy contributions to it. Each -directory here describes a different way of running Tuscany. In most cases these -different approaches can be used to run any of the contributions from the -getting-started or learning-more directories. - -applications -============ - -The contributions here demonstrate more fully formed applications when -compared to the contributions found the getting-started or learning-more -directories. - -extending-tuscany -================= - -Once you're familiar with Tuscany and SCA you're likely to find that to -implement you're application you need particular bindings, implementation -types, policies or databindings. The examples in this directory show you -how to extend the Tuscany runtime to include the technologies you need to use. - -Running samples ---------------- - -Running a samples contribution involves 3 basic steps - -1) build the contribution - -Using ant, maven or eclipse (see below) - -2) launch the contribution - -Using one of the approaches described in the running-tuscany directory - -3) send a test message to the a component service - -When you want to exercise an SCA composite application you have to send a -message to a component service. There are several ways of doing this depending -on how the sample contribution has been configured. For example, you could -send a SOAP message using the Web Services explorer in Eclipse, you could -use a separate client program that uses the SCA client API, the sample -contribution itself may even include initialization code that sends a test -message when the contribution is started. The documentation for each sample -describes what to do to send a test message. - -Building the sample contributions using Ant --------------------------------------------- -Most sample contributions are provided with a build.xml file. When you see one -you can build it using Ant. - -These build.xml files are designed to work with the Tuscany SCA Java binary -distribution and build a classpath that, by various means, refers to the -jars that are shipped in the modules directory. For them to work properly -they should be run from the directory in which you find the build.xml file. - -cd <sampledir> -ant - -The result of this process will be the built contribution (a jar file) in the -target subdirectory of the sample contribution directory. - -Once the sample is built you have the option of running the sample in whatever -way best suits you. - -Building SCA Samples Using Maven --------------------------------- -All sample contributions are provided with a pom.xml Maven build file. The -Maven build process will work from both source and binary distributions. - -cd <sampledir> -mvn - -This will take a little while to complete. Experience with Maven tells us that -sometimes there are problems downloading the dependencies that Apache Tuscany -SCA requires. If Maven reports that it cannot download required dependencies -try running the Maven build again. - -When using Maven the samples are unit tested using JUnit test cases and so you -will sometimes see test output during the build process. - -The result of this process will be the built contribution (a jar file) in the -target subdirectory of the sample contribution directory. - -Once the sample is built you have the option of running the sample in whatever -way best suits you. - -Building Samples In An IDE ---------------------------- - -The easiest way to use the samples in an IDE is to use Maven to generate all -of the IDE project files for you automatically. You don't have to do this -though and can use a series of manual steps in order to import the Tuscany -samples into an IDE. - -Both approaches to importing SCA contribution projects into Eclipse are -documented at: - -http://tuscany.apache.org/import-existing-tuscany-sca-projects-into-eclipse.html |