Page History

...

helloworld-contribution

This is the simplest a simple SCA contribution. This contribution It describes a composite application with a single component, HelloWorldComponent, implemented in Java. The component's Java implementation provides service "business logic" for saying hello to a person whose name is supplied as input to the service.

...

To build this contribution using Maven do the following:

cd helloworld-contribution
mvn

...

The component is described in a composite called helloworld.composite as follows:

cd helloworld-contribution
mvn tuscany:run

<composite xmlns="http://docs.oasis-open.org/ns/opencsa/sca/200912"
           xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/1.1"
           targetNamespace="http://sample"
           name="helloworld">

    <component name="HelloworldComponent">
        <implementation.java class="sample.HelloworldImpl"/>
    </component>

</composite>

The contribution also contains a composite called helloworldws.composite which describes a component, HelloworldWSComponent, that uses the same implementation but uses a web services binding:

<composite xmlns="http://docs.oasis-open.org/ns/opencsa/sca/200912"
           xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/1.1"
           targetNamespace="http://sample"
           name="helloworldws">

    <component name="HelloworldWSComponent">
        <implementation.java class="sample.HelloworldImpl"/>
        <service name="Helloworld">
           <binding.ws />
        </service>
    </component>

</composite>

This gives us a number of options for interacting with the components in this application.

Firstly there is a JUnit test inside this project called HelloworldTestCase.java. This starts the Tuscany runtime and loads the contribution. It then talks to the HelloworldComponent over the default SCA binding (binding.sca) using a local Java proxy.

Secondly the HelloworldWSComponent exposes a service with a web services binding. You can talk to this component using your favourite web services client. You can retrieve the WSDL for the web service automatically (see later)

cd helloworld-contribution
mvn

This will produce the contribution as follows:

helloworld-contribution/target/helloworld-contribution.jar

As the JUnit test deploys and runs the contribution we can use it as a first simple example of a running SCA application.

Response from helloworld.sayHello("Petra") = Hello Petra

To access the web service that the HelloworldWSComponent exposes we have to keep the runtime runntime running.

cd helloworld-contribution
mvn tuscany:run

Binding.ws JAXWS provider - Service URI: http://localhost:8085/HelloworldWSComponent/Helloworld

http://localhost:8085/HelloworldWSComponent/Helloworld?wsdl

For more information on getting started with the Apache Tuscany SCA Java runtime see the getting started page.

...

This sample is not a contribution in it's own right but demonstrates how to run the helloworld-contribution inside a web application. As it's the same contribution the same two components, HelloworldComponent and HelloworldWSComponnet, will be started.

cd helloworld-webapp
mvn

This will produce a webapp as follows:

helloworld-webapp/target/helloworld.war

You can run this webapp by deploying it to you're favourite webapp container. For example, you can deploy to Tomcat and run as follows:

cp helloworld-webapp/target/helloworld.war my_tomcat_install/webapps
my_tomcat_install/bin/catalina run

Once running point your web browser at:

http://localhost:8080/helloworld/hello.html

You'll see a link there to the WSDL that's automatically generated for the web service binding of the HelloworldWSComponent. Again you can use your favourite web services client to send messages to the service.

...