SCA Samples

The product offers sample files that support Service Component Architecture (SCA) specifications. You can use these sample SCA files in business-level applications. The sample files are located in app_server_root/samples/SCA and app_server_root/installableApps. SCA services are packaged in Java archive (JAR) files that you import as assets to the product repository and then add as composition units to business-level applications. Each sample includes detailed deployment instructions in a readme.html file in a app_server_root/samples/SCA subdirectory.

Samples installation

To use the Samples, install the Feature Pack for SCA. Installing the feature pack adds SCA sample files to the app_server_root/installableApps directory. If you selected to install Samples during creation of a profile enabled by the feature pack, the product also adds several SCA sample files to the app_server_root/samples/SCA directory. You must deploy SCA sample files as assets of a business-level application to a Version 7.0 server or cluster that is enabled for the Feature Pack for SCA.

Samples description

CandyStore
The CandyStore.jar file uses the default binding, Web service binding, and EJB binding and shows the use of the recursive model, and authentication and authorization over the default binding. The sample shows both the bottom-up (Java to WSDL) and top-down (WSDL to Java) approaches in developing SCA applications.

For a description of the 10 composites in CandyStore and details on deployment, refer to app_server_root/samples/SCA/CandyStore/documentation/readme.html.

HelloJee New or updated for this feature pack
This sample shows how to use SCA annotations within Java Platform, Enterprise Edition (Java EE) components so that these components can consume SCA services. Java EE applications can take advantage of the SCA programming model with little or no change to the application implementation code. The sample uses implementation.jee definitions to enable Java EE archives as SCA component implementations. The sample has a Java EE archive with no SCA artifact in it and a Java EE archive with a composite definition file that defines an SCA composite and components. The components use implementation.ejb and implementation.web definitions. It demonstrates how to expose EJB services as SCA services and access injected values of reference and property annotations in stateless session beans and servlets.

For details on deployment, refer to app_server_root/samples/SCA/HelloJee/documentation/readme.html.

HelloWorldAsync
The helloworld-ws-asynch.jar, helloworld-ws-client-asynch.war, and helloworld-ws-asynchclient.jar files use Web services. One client uses a Java ServerPages (JSP) file to obtain an SCA composite context and invoke the HelloWorldClient service over an SCA default binding. The client service then invokes the HelloWorld service over a Web services binding. After the service is invoked, the service does a callback to the client service. The client JSP waits for 5 seconds for the callback to complete and then displays the callback result.

For a description of the JAR files and details on deployment, refer to app_server_root/samples/SCA/helloworld-ws-asynch/documentation/readme.html. For detailed instructions on deploying the helloworld-ws-asynch.jar file in a business-level application, refer to "Example: Creating an SCA business-level application with the console" and "Example: Creating an SCA business-level application with scripting."

JMS New or updated for this feature pack
The JMS samples show how to invoke an SCA component service using a Java Message Service (JMS) client. There are three JMS binding samples:
  • TwoWay, which provides a two-way method that returns a value
  • TwoWay-OneWay, which provides a two-way method that invokes LoggingService over a one-way method to log the message to the server SystemOut file
  • TwoWay-OneWay-Callback, which provides a one-way method that makes a callback to the HelloServiceComponent POJO component

Also provided with the JMS binding samples are a POJO component and a thin client:

  • HelloServiceComponent, a simple POJO component that receives the JMS message through JMS service binding, runs the POJO component method, and returns the result back to the caller as a response message
  • thinClient, a non-SCA, JMS client packaged within the jms-client.jar file that invokes the POJO HelloService SCA service by sending a JMS message to the JMS message provider

For details on building JMS sample artifacts, creating JMS resources for the samples and deploying the samples, refer to app_server_root/samples/SCA/jms/documentation/readme.html.

JobbankTargetEJBApp
This sample shows how a Java EE client, JobbankClientApp.ear, can invoke an SCA component, jobbankejb.jar, using a remote EJB service binding as well as how a component with an EJB reference binding can invoke a remote external EJB, which is in JobbankTargetEJBApp.ear. The stateless session bean binding is a protocol binding that provides the ability to integrate SCA with EJB based services. The SCA support is in jobbankejb.jar.

For a description of the files and details on deployment, refer to app_server_root/samples/SCA/jobbankejb/documentation/readme.htm.

MultiService
This sample shows service composition using existing services. The MultiService sample wires to several existing samples:
  • Stock Quote, WebServicesSamples.ear
  • HelloWorldAsync, helloworld-ws-asynch.jar
  • JobbankTargetEJBApp, JobbankTargetEJBApp.ear
  • EJB Counter, EJB3CounterSample.ear

You can find the files in app_server_root/installableApps.

For details on deployment, refer to app_server_root/samples/SCA/MultiService/documentation/readme.html.

MyBank
This sample shows how to create an SCA application that uses JAXB following a top-down approach. You use AccountService.wsdl to generate JAXB classes that provide a data binding between XML and Java files. You then use a reference on the client side WAR file to wire to the Account Service over the Web service binding.

For details on deployment, refer to app_server_root/samples/SCA/MyBank/documentation/readme.html.




Related concepts
SCA in WebSphere Application Server: Overview
Related tasks
Example: Creating an SCA business-level application with the console
Example: Creating an SCA business-level application with scripting
Concept topic Concept topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 8:40:09 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=csca_samples
File name: csca_samples.html