Java CAPS Sample Documentation


<font color="red">Working with the Oracle Java CAPS Samples for OWSM</font>

Working with the Oracle Java CAPS Samples for Oracle Web Services Manager


This document provides general information about the Java CAPS samples for OWSM. Documentation for Oracle Web Services Manager is available at http://download.oracle.com/docs/cd/E15523_01/web.1111/b32511/toc.htm.


Prerequisites

To work with the samples, you need to have the following installed:

You also need to create a WebLogic domain that is configured for the following:


About the Sample Projects

The OWSM projects include several variations of using Java CAPS JBI applications to call Oracle SOA Suite applications and vice versa. The projects all use OWSM security and provide examples of using username tokens, SAML, and JAX-WS. The following projects are included when you download OWSM_Samples.zip.

WLS_usernameToken

This sample set illustrates a JBI Metro client invoking a WebLogic Server web service with both using username token security. The Java CAPS JBI client BPEL project and Composite Application are located in JBIMetroClient. The WebLogic server projects are located in OracleWLSServer.

SOA_UsernameToken

This sample set illustrates a JBI Metro client invoking an Oracle SOA Suite service, both using username token security . The Java CAPS JBI client BPEL project and Composite Application are located in JBIMetroUSNTokenClient. The SOA Suite server projects are located in OracleUSNTClientServer.

JBI_SAMLServer

This sample set illustrates an Oracle SOA Suite client invoking a Java CAPS JBI service, both using SAML security. The Java CAPS JBI server BPEL project and Composite Application are located in JBISamlAsAService. The SOA Suite client projects are located in JBISAMLServSOAClient.

JBI_UsernameToken

This sample set illustrates an Oracle SOA Suite client invoking a Java CAPS JBI service, both using username token security. The Java CAPS JBI server BPEL project and Composite Application are located in JBIMetroUSNTService. The SOA Suite projects are located in OracleSOAClient.

WLJaxCallingJBISaml

This sample set illustrates a WebLogic Server JAX-WS client invoking a Java CAPS JBI service, which uses SAML security. The Java CAPS JBI server BPEL project and Composite Application are located in JBISamlAsAService. The WebLogic projects are located in WLSJAXClient.

WLJaxCallingJBIUsernameToken

This sample set illustrates a WebLogic Server JAX-WS client invoking a Java CAPS JBI service, which uses username token security. The Java CAPS JBI server BPEL project and Composite Application are located in JBIMetroUSNTokenService. The WebLogic projects are located in OracleJEEWSApps.

Configuring the Environment

These samples require that you configure the keystore and certificate (cawallet.so) as described in the following links. Import the alias into the keystore and truststore of the GlassFish server.


Installing the Sample Projects

The OWSM samples are provided on the Java CAPS Sample Code page. The ZIP file includes several projects for both Java CAPS and Oracle WebLogic and SOA Suite.

  1. Download OWSM_Samples.zip.

    This file is also available from the Java CAPS sample code site under the OWSM tab.

  2. Extract the downloaded file into a temporary directory.

  3. Copy the Java CAPS projects to the location where you store your NetBeans projects and copy the WebLogic and SOA Suite projects to the location where you store your JDeveloper projects.

  4. Do the following to work with the NetBeans projects:

    1. Launch NetBeans.

    2. In the Projects window, right-click and then select Open Project.

    3. Open the Java CAPS projects you want to work with.

      The projects appear in the Projects window.

    4. Update any URLs with the proper hostnames and ports. The projects use localhost and the default port numbers in URLs.

    5. Clean and build the BPEL projects, and then clean and build the Composite Applications. Deploy the Composite Applications.

      The GlassFish server must be started for this step.

  5. Do the following to work with the WebLogic and SOA Suite projects:

    1. Start the WebLogic Server.

    2. Launch JDeveloper.

    3. Open the WebLogic Server or SOA Suite projects you want to work with.

    4. Update any URLs with the proper hostnames and ports. The projects use localhost and the default port numbers in URLs.

    5. Build and deploy the projects.

Note: Make sure the configuration of the WS policy matches the configuration of your environment.