5 Oracle JCA Adapter for Sockets

5.3.1.1 Inbound Synchronous Request/Response

As part of inbound activation, the Oracle Socket Adapter opens a server socket and waits for incoming connections. The adapter uses the connection to the server socket and reads the request message, which is published to BPEL or Mediator. The Oracle Socket Adapter then uses the same connection to send the response back synchronously.

Figure 5-4 illustrates an inbound synchronous request/response scenario.

Figure 5-4 BPEL Scenario of Inbound Synchronous Request/Response

Description of "Figure 5-4 BPEL Scenario of Inbound Synchronous Request/Response"

5.3.1.2 Outbound Synchronous Request/Response

In the case of outbound synchronous request/response, a request comes from BPEL or Mediator. The Oracle Socket Adapter connects to the server socket to send the request message to the server socket on the output stream. The Oracle Socket Adapter then blocks the response from the server socket on the input stream and publishes the response back to BPEL or Mediator.

Figure 5-5 illustrates an outbound synchronous request/response scenario.

Figure 5-5 BPEL Scenario of Outbound Synchronous Request/Response

Description of "Figure 5-5 BPEL Scenario of Outbound Synchronous Request/Response"

5.3.1.3 Inbound Receive

As part of inbound activation, the Oracle Socket Adapter opens a server socket and waits for incoming connections. The adapter uses the connection to the server socket and reads the request message, which is published to BPEL or Mediator. In this scenario, no reply is sent.

5.3.1.4 Outbound Invoke

In the case of an outbound one way invoke scenario, the request comes from BPEL or Mediator. Oracle Socket Adapter connects to the server socket and sends the request message to the server socket on the output stream without expecting a reply.

5.3.2.1 Protocol with Handshake Mechanism Using Style Sheet

Oracle Socket Adapter can be configured to use a protocol designed with a handshake mechanism, defined using style sheets that use XPath Extension functions exposed by the adapter. This can be granular read and write operation on the socket I/O stream or till the end of the stream. These functions also enable you to use native format constructs for reading and writing data. This handshake mechanism uses XSLT constructs to define operations such as assignments, validations, and control flow.

You can use the XPath Extension functions with the translator infrastructure in the following ways:

• By using StyleReader, which is exposed by the NXSD framework, to read and write from the socket stream using the following methods:

  • socketRead(nxsdStyle:String, nxsdStyleAttributes:String):String

    You can use this method to read from the socket input stream.

  • socketWrite(value:String, nxsdStyle:String, nxsdStyleAttributes:String):String

    You can use this method to write to the socket output stream.

  The XSLT shown in Figure 5-6 demonstrates the usage of extension functions that use StyleReader.

  Figure 5-6 XSLT with Extension Functions That Use StyleReader

  
  Description of "Figure 5-6 XSLT with Extension Functions That Use StyleReader"
  
  

• By annotating the schema, which defines the input and output variables, using NXSD constructs to read and write from the socket stream using the following methods:

  • socketReadWithXlation():DocumentFragment

    You can use this method to read from the socket input stream by using the schema and schema element configured for input.

  • socketWriteWithXlation(xml:NodeList)

    You can use this method to write to the socket output stream by using the schema configured for output.

  The XSD file shown in Figure 5-7 demonstrates the usage of extension functions by annotating the schema, which defines the input and output variables, using NXSD constructs.

  Figure 5-7 XSD with Extension Functions That Do Not Use StyleReader

  
  Description of "Figure 5-7 XSD with Extension Functions That Do Not Use StyleReader"
  
  

To define a handshake using style sheet, you must select Use XSLT to define the handshake and browse to select the XSL file in the Protocol page, as shown in Figure 5-8.

Figure 5-8 Defining a Protocol with Handshake Mechanism By Using a Style Sheet

Description of "Figure 5-8 Defining a Protocol with Handshake Mechanism By Using a Style Sheet"

5.3.2.2 Protocol with Handshake Mechanism Using Custom Java Code

Oracle Socket Adapter can be configured to use a protocol with a customized handshake mechanism, defined by plugging in custom Java code. The custom Java code must implement oracle.tip.pc.services.translation.util.ICustomParser, the ICustomParser interface, provided by Oracle Socket Adapter, which enables custom implementation of handshakes.

The following methods must be implemented based on the appropriate communication paradigm:

• public Element executeOutbound(InputStream in, OutputStream out, Element payLoad) throws Exception;

  The outbound handshake must implement this method.

  Example:

  public Element executeOutbound(InputStream in, OutputStream out, Element payLoad) throws Exception {
      BufferedReader in1 = new BufferedReader(new InputStreamReader(in));
      PrintWriter out1 = new PrintWriter(new OutputStreamWriter(out));
   
      out1.println(payLoad.getFirstChild().getNodeValue());
        
      String retVal = in1.readLine();
    
      StringBuffer strBuf = new StringBuffer();
      strBuf.append("<?xml version='1.0' encoding='" + enc + "' ?>"
              + "<out xmlns='http://xmlns.oracle.com/EchoServer/'>");
          strBuf.append(retVal + "</out>");
   
      DOMParser parser = new DOMParser();
      parser.setValidationMode(DOMParser.NONVALIDATING);
          Element elem = (Element) parser.getDocument().getElementsByTagName(
              "out").item(0);
   
      return elem;
  }
  

• public Element executeInboundRequest(InputStream in) throws Exception;

  The inbound request must implement this method.

  Example:

  public Element executeInboundRequest(InputStream in) throws Exception {
      BufferedReader in1 = new BufferedReader(new InputStreamReader(in));
   
      String input = in1.readLine();
    
      StringBuffer strBuf = new StringBuffer();
      strBuf.append("<?xml version='1.0' encoding='" + enc + "' ?>"
              + "<EchoClientProcessRequest xmlns='http://xmlns.oracle.com/EchoClient'>");
   
          strBuf.append("<input>" + input + "</input></EchoClientProcessRequest>");
   
      DOMParser parser = new DOMParser();
      parser.setValidationMode(DOMParser.NONVALIDATING);
      parser.parse(new InputSource(new StringReader(strBuf.toString())));
      Element elem = (Element) parser.getDocument().getElementsByTagName(
              "EchoClientProcessRequest").item(0);
   
      return elem;
  }
  

• public void executeInboundReply(Element payLoad, OutputStream out) throws Exception;

  The inbound reply must implement this method.

  Example:

  public void executeInboundReply(Element payLoad, OutputStream out) throws Exception {
      PrintWriter out1 = new PrintWriter(new OutputStreamWriter(out));
     
      NodeList list = payLoad.getChildNodes();
      String retVal = null;
      for(int i = 0; i < list.getLength(); i++) {
          Node node = list.item(i);
          NodeList list1 = node.getChildNodes();
          for(int j = 0; j < list1.getLength(); j++) {
              Node node1 = list1.item(j);
              if(node1.getNodeType() == Node.TEXT_NODE) {
                      retVal = node1.getNodeValue();
              }
          }
      }
      out1.println(retVal);
      out1.flush();
  }
  

To use a custom Java code to define a handshake, you must select Use Custom Java Code to define the handshake and specify the Java class implementing the handshake in the Java Class field, as shown in Figure 5-9.

Figure 5-9 Defining a Protocol with Handshake Mechanism By Using Custom Java Code

Description of "Figure 5-9 Defining a Protocol with Handshake Mechanism By Using Custom Java Code"

5.3.2.3 Protocol Without Handshake Mechanism

Oracle Socket Adapter can be configured to use protocols that do not require handshakes involving translation to and from the socket I/O stream.

To use a protocol that does not require a handshake, you must select No Handshake in the Protocol page, as shown in Figure 5-10.

Figure 5-10 Defining a Protocol without a Handshake Mechanism

Description of "Figure 5-10 Defining a Protocol without a Handshake Mechanism"

5.3.4.1 Configuring Oracle Socket Adapter Connection Pooling

One way to optimize Oracle Socket Adapter performance is by using a Connection Pool. You can use a connection pool while the socket server you are connecting to does not close the socket with each interaction. A connection pool lets you use a socket connection repeatedly, avoiding the overhead of creating a new socket for each interaction. You must configure the connection pool for the Oracle Socket Adapter using the Oracle WebLogic Server console.

How to configure Oracle Socket Adapter connection pooling:

1. Log into your Oracle WebLogic Server console. To access the console navigate to http://servername:portnumber/console.

2. Click Deployments in the left pane for Domain Structure. The Summary of Deployments page is displayed.

   Figure 5-12 Oracle WebLogic Server Console - Summary of Deployments Page

   
   Description of "Figure 5-12 Oracle WebLogic Server Console - Summary of Deployments Page"
   
   

3. Click SocketAdapter. The Settings for SocketAdapter page is displayed.

4. Click the Configuration tab.

5. Click the Outbound Connection Pools tab, and expand javax.resource.cci.ConnectionFactory to see the configured connection factories, as shown in Figure 5-13:

   Figure 5-13 Oracle WebLogic Server Console - Settings for SocketAdapter Page

   
   Description of "Figure 5-13 Oracle WebLogic Server Console - Settings for SocketAdapter Page"
   
   

6. Click eis/socket/SocketAdapter. The Settings for javax.resource.cci.ConnectionFactory page is displayed.

7. Set the KeepAlive connection factory property to true, as shown in Figure 5-14. The connection pool feature for the Oracle Socket Adapter is enabled.

   Figure 5-14 Oracle WebLogic Server Console - Settings for javax.resource.cci.Connectionfactory Page

   
   Description of "Figure 5-14 Oracle WebLogic Server Console - Settings for javax.resource.cci.Connectionfactory Page"
   
   

8. Click Save. The Settings for javax.resource.cci.ConnectionFactory page is displayed with the message, Deployment plan has been successfully updated, as shown in Figure 5-15.

   Figure 5-15 Oracle WebLogic Server Console - Settings for javax.resource.cci.Connectionfactory Page

   
   Description of "Figure 5-15 Oracle WebLogic Server Console - Settings for javax.resource.cci.Connectionfactory Page"
   
   

5.4.2.1 Modeling an Outbound Handshake

The outbound XSLT uses an input corresponding to the invoked message. The outbound XSLT writes to the socket output stream by using extension functions. The output is dummy for unidirectional or a response for bidirectional communication.

The following example demonstrates the modeling of a Synchronous Request/Response communication paradigm:

<xsl:stylesheet 
...
xmlns:socket="http://www.oracle.com/XSL/Transform/java/oracle.tip.adapter.socket.ProtocolTranslator" />
xmlns:request="http://www.TragetNameSpace.com/Request" >
 
  <xsl:template match="/">
 
    <!–- Write the entire content of "books" element using translator -->
    <xsl:variable name="username" select="socket:socketWriteWithXlation(.)" />
 
    <!–- Read the stream using translator -->
    <xsl:copy-of select="socket:socketReadWithXlation()" />
    
  </xsl:template>
</xsl:stylesheet>

5.4.2.2 Modeling an Inbound Handshake

The inbound XSLT uses a dummy input, reads the socket input stream through extension functions, and constructs the XML record to be published.

The following example demonstrates a handshake in which the client sends across a user identification terminated by a comma (,) and a password terminated by a semicolon (;) for validation, and then sends the message payload:

<xsl:stylesheet 
...
xmlns:socket="http://www.oracle.com/XSL/Transform/java/oracle.tip.adapter.socket.ProtocolTranslator" />
  <xsl:template match="/">
    <!-- Read the user name -->
    <xsl:variable name="username" 
select="socket:socketRead('terminated','terminatedBy=,')" />   
    <!-- Read password if user name is correct -->
    <xsl:if test="normalize-space($username)='user'">
      <xsl:variable name="password" 
select="socket:socketRead('terminated','terminatedBy=;')" />
      <!-- If password is correct proceed to read the payload using translator 
-->
      <xsl:if test="normalize-space($password)='password'">
        <!--  Send an OK -->
        <xsl:variable name="ack1" select="socket:socketWrite('001','','')" />

        <output>
<!--  Wait for the payload -->
          <xsl:copy-of select="socket:socketReadWithXlation()" />
        </output>
 
      </xsl:if>
      <!--  Send an error -->
      <xsl:else><xsl:variable name="ack2" 
select="socket:socketWrite('000','','')" /></xsl:else>
    </xsl:if>
  </xsl:template>
</xsl:stylesheet>

5.4.3.1 Designing XSL for Inbound Synchronous Request/Reply

This section describes the procedure for designing XSL for an inbound synchronous request/reply scenario by using the XSL mapper tool:

Design an SOA Composite

To design an SOA composite, perform the steps described in Section 5.5.1.2, "Designing the SOA Composite."

Create an Inbound Oracle Socket Adapter Service

To create an inbound Oracle Socket Adapter service, perform the following steps:

1. Drag and drop Socket Adapter from the Components Palette to the Exposed Services swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter the service name, HelloWorld in the Service Name field and then click Next. The Adapter Interface page is displayed.

4. Select Define from operation and schema (specified later), as shown in the Figure 5-16, and click Next. The Operation page is displayed.

   Figure 5-16 The Adapter Configuration Wizard - Adapter Interface Page

   
   Description of "Figure 5-16 The Adapter Configuration Wizard - Adapter Interface Page"
   
   

5. Select Inbound Synchronous Request/Reply as the Operation Type and then click Next. The Socket Connection page is displayed.

6. Enter eis/socket/InboundSocketAdapter in the Socket Connection JNDI Name field, as shown in Figure 5-17, and click Next. The Messages page is displayed.

   Figure 5-17 The Adapter Configuration Wizard Socket Connection Page

   
   Description of "Figure 5-17 The Adapter Configuration Wizard Socket Connection Page"
   
   

7. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

8. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessRequest, as shown in Figure 5-18.

   Figure 5-18 The Type Chooser Dialog

   
   Description of "Figure 5-18 The Type Chooser Dialog"
   
   

9. Click OK. The URL field in the Messages page is populated with the HelloWorld.xsd file.

10. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

11. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessResponse.

12. Click OK. The URL fields in the Messages page are populated with the HelloWorld.xsd files, as shown in Figure 5-19.

    Figure 5-19 The Adapter Configuration Wizard File Messages Page

    
    Description of "Figure 5-19 The Adapter Configuration Wizard File Messages Page"
    
    

13. Click Next. The Protocol page is displayed, as shown in Figure 5-20.

    Figure 5-20 The Adapter Configuration Wizard - Protocol Page

    
    Description of "Figure 5-20 The Adapter Configuration Wizard - Protocol Page"
    
    

14. Select Use XSLT to define the handshake.

15. Click the create new xsl file icon that appears at the end of the Xslt field. The Input dialog appears, as shown in Figure 5-21.

    Figure 5-21 The input Dialog of the Protocol Page

    
    Description of "Figure 5-21 The input Dialog of the Protocol Page"
    
    

16. Use the default value, request.xsl, as the name of the XSL file, as shown in Figure 5-21 and click OK.

17. Click the create new xsl file icon that appears at the end of the ReplyXslt field. The Input dialog appears.

18. Use the default value, reply.xsl, as the name of the XSL file, and click OK.

19. Click Finish. The request.xsl and the reply.xsl files are created.

    Figure 5-22 shows the request.xsl page.

    Figure 5-22 The JDeveloper - request.xsl Page

    
    Description of "Figure 5-22 The JDeveloper - request.xsl Page"
    
    

    Note:

    A dummy.xsd file appears in the left Source pane of the request.xsl page, which is used as the source for the XSL mapper tool.

    In an inbound request scenario, Oracle Socket Adapter reads native data that is received by the socket and converts it to an XML format. That is, on the source side there is no XML file. Because the XSLT mapper always needs source and target XSD files, a dummy XSD file appears in the mapper tool.

    Figure 5-23 shows the reply.xsl page.

    Figure 5-23 The JDeveloper - reply.xsl Page

    
    Description of "Figure 5-23 The JDeveloper - reply.xsl Page"
    
    

    Note:

    A dummy.xsd file appears in the right target pane of the reply.xsl page. This dummy.xsd file is used as the target for the XSL mapper tool.

20. Define the request part of the inbound synchronous request/reply operation as follows:

    1. In the request.xsl page, drag and drop socketRead from the Advanced Functions list of the Components Palette to the middle pane, as shown in Figure 5-24.

       Figure 5-24 The JDeveloper - request.xsl Page

       
       Description of "Figure 5-24 The JDeveloper - request.xsl Page"
       
       

    2. Double-click the socketRead advanced function. The Edit Function - socketRead dialog appears.

    3. Enter the function parameters in the nxsdStyle and nxsdStyleAttributes fields, as shown in Figure 5-25.

       Figure 5-25 The Edit Function - socketRead Dialog

       
       Description of "Figure 5-25 The Edit Function - socketRead Dialog"
       
       

       Note:

       The socketRead function reads from the socket input stream by using the StyleReader exposed by the NXSD framework.

    4. Click OK. The request.xsl (XSL mapper tool) page is displayed.

    5. Link the sockRead function in the middle pane to the target input node on the right pane. The request.xsl (XSL mapper tool) with the XSL mapping is displayed, as shown in Figure 5-26.

       Figure 5-26 The JDeveloper - request.xsl Page

       
       Description of "Figure 5-26 The JDeveloper - request.xsl Page"
       
       

21. Define the reply part of the inbound synchronous request/reply operation as follows:

    1. From the Component Palette list, select Advanced, and then select Advanced Functions. A list of advanced functions are displayed.

    2. In the reply.xsl page, drag and drop socketWrite from the Advanced Functions list of the Component Palette to the middle pane.

    3. Double-click the socketWrite advanced function. The Edit Function - socketWrite dialog appears.

    4. Enter the function parameters in the valueToWrite, nxsdStyle, and nxsdStyleAttributes fields, as shown in Figure 5-27.

       Figure 5-27 The Edit Function - socketWrite Dialog

       
       Description of "Figure 5-27 The Edit Function - socketWrite Dialog"
       
       

       Note:

       The socketWrite function writes to the socket output stream by using the StyleReader exposed by the NXSD framework.

    5. Click OK. The reply.xsl (XSL mapper tool) page is displayed.

    6. Link the sockWrite function in the middle pane to the target input node on the right pane. The reply.xsl (XSL mapper tool) with the XSL mapping is displayed, as shown in Figure 5-28.

       Figure 5-28 The JDeveloper - reply.xsl Page

       
       Description of "Figure 5-28 The JDeveloper - reply.xsl Page"
       
       

22. Click File, Save All. The request.xsl and reply.xsl files for the inbound Oracle Socket Adapter are created.

5.4.3.2 Designing XSL for Outbound Synchronous Request/Reply

This section describes the procedure for designing XSL for an outbound synchronous request/reply scenario by using the XSL mapper tool:

Design an SOA Composite

To design an SOA composite, perform the steps described in Section 5.5.1.2, "Designing the SOA Composite.".

Create an Outbound Oracle Socket Adapter Reference

To create an outbound Oracle Socket Adapter reference, perform the following steps:

1. Drag and drop Socket Adapter from the Components Palette to the External References swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter the service name, HelloWorld in the Service Name field and then click Next. The Adapter Interface page is displayed.

4. Select Define from operation and schema (specified later), as shown in the Figure 5-16 and click Next. The Operation page is displayed.

5. Select Outbound Synchronous Request/Reply as the Operation Type and then click Next. The Socket Connection page is displayed.

6. Enter eis/socket/OutboundSocketAdapter in the Socket Connection JNDI Name field and click Next. The Messages page is displayed.

7. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

8. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessRequest, as shown in Figure 5-18.

9. Click OK. The URL field in the Messages page is populated with the HelloWorld.xsd file.

10. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

11. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessResponse.

12. Click OK. The URL fields in the Messages page are populated with the HelloWorld.xsd files, as shown in Figure 5-19.

13. Click Next. The Protocol page is displayed.

14. Select Use XSLT to define the handshake.

15. Click the create new xsl file icon that appears at the end of the Xslt field. The Input dialog appears.

16. Use the default value, invoke.xsl, as the name of the XSL file and click OK.

17. Click Finish. The invoke.xsl file appears in the XSL mapper tool, as shown in Figure 5-29.

    Figure 5-29 The JDeveloper - invoke.xsl Page

    
    Description of "Figure 5-29 The JDeveloper - invoke.xsl Page"
    
    

18. Right-click the HelloWorldProcessResponse element on the target side. A menu is displayed, as shown in Figure 5-30.

    Figure 5-30 The JDeveloper - invoke.xsl Page

    
    Description of "Figure 5-30 The JDeveloper - invoke.xsl Page"
    
    

19. Click Add Variable.... The Add Variable dialog is displayed, as shown in Figure 5-31.

    Figure 5-31 The Add Variable Dialog

    
    Description of "Figure 5-31 The Add Variable Dialog"
    
    

20. Enter var1 in the Local Name field, and click OK. The var1 variable is added to the target pane of the XSL mapper tool.

21. From the Component Palette list, select Advanced; then, select Advanced Functions. A list of advanced functions is displayed.

22. Define the request part of the outbound synchronous request/reply operation, to write the data to the socket server, as follows:

    1. Drag and drop socketWriteWithXlation from the Advanced Functions list of the Component Palette to the middle pane, as shown in Figure 5-32.

       Figure 5-32 The JDeveloper - invoke.xsl Page

       
       Description of "Figure 5-32 The JDeveloper - invoke.xsl Page"
       
       

    2. Drag the var1 node to the socketWriteWithXlation function. A link is created, as shown in Figure 5-33.

       Figure 5-33 The JDeveloper - invoke.xsl Page

       
       Description of "Figure 5-33 The JDeveloper - invoke.xsl Page"
       
       

    3. Double-click the socketWriteWithXlation advanced function. The Edit Function - socketWriteWithXlation dialog appears.

    4. Enter a dot (.) in the NodeList field, as shown in Figure 5-34.

       Figure 5-34 The Edit Function - socketWriteWithXlation Dialog

       
       Description of "Figure 5-34 The Edit Function - socketWriteWithXlation Dialog"
       
       

       Note:

       The socketWriteWithXlation function writes to the socket output stream using the schema configured for the output.

       The dot (.) specified in the NodeList field signifies writing the HelloWorldProcessRequest to the top level node.

    5. Click OK. A Warning dialog appears.

    6. Click Yes. The invoke.xsl page is displayed. The request part of the Synchronous Request/Reply operation is defined.

23. Define the reply part of the outbound synchronous request/reply operation as follows:

    1. Drag and drop socketReadWithXlation from the Advanced Functions list of the Component Palette to the middle pane, as shown in Figure 5-35.

       Figure 5-35 The JDeveloper - invoke.xsl Page

       
       Description of "Figure 5-35 The JDeveloper - invoke.xsl Page"
       
       

    2. From the Component Palette list, select General; then, select XSLT Constructs. A list of XSLT constructs is displayed.

    3. Drag copy-of from the Component Palette to HelloWorldProcessResponse in the target pane. The Copy-of Type Dialog appears, as shown in Figure 5-36.

       Figure 5-36 The JDeveloper - invoke.xsl Page with Copy-of Type Dialog

       
       Description of "Figure 5-36 The JDeveloper - invoke.xsl Page with Copy-of Type Dialog"
       
       

    4. Click OK. The invoke.xsl (XSL mapper tool) page is displayed with the copy-of XSLT construct added to the target pane, as shown in Figure 5-37.

       Figure 5-37 The JDeveloper - invoke.xsl Page

       
       Description of "Figure 5-37 The JDeveloper - invoke.xsl Page"
       
       

    5. Drag the copy-of XSLT construct to the socketReadWithXlation function. A link is created, as shown in Figure 5-38.

       Figure 5-38 The JDeveloper - invoke.xsl Page

       
       Description of "Figure 5-38 The JDeveloper - invoke.xsl Page"
       
       

24. Click File, Save All. The Outbound Synchronous Request/Reply handshake is defined.

5.5.1.1 Prerequisites

To perform this use case, you require the following files from the artifacts.zip file contained in the Adapters-101SocketAdapterHelloWorld sample:

• artifacts/schemas/HelloWorld.xsd

• artifacts/xsl/request.xsl

• artifacts/xsl/reply.xsl

• artifacts/xsl/invoke.xsl

You can access the Adapters-101SocketAdapterHelloWorld sample on the Oracle SOA Sample Code site.

5.5.1.2 Designing the SOA Composite

You must create a JDeveloper application to contain the SOA composite. To create an application and a project for the use case, perform the following:

1. In Application Navigator of JDeveloper, click New Application. The Create Generic Application - Name your application page is displayed.

2. Enter helloworld-socket in the Application Name field, as shown in Figure 5-39, and then click Next. The Name your project page is displayed.

   Figure 5-39 The Create SOA Application Dialog

   
   Description of "Figure 5-39 The Create SOA Application Dialog"
   
   

3. Click OK. The Name Your Project dialog is displayed.

4. Enter HelloWorldComposite in the Project Name field, and then select SOA under Project Technologies and move it to the Selected box by clicking the right-arrow, as shown in Figure 5-40.

   The HelloWorld application and the HelloWorldComposite project appear in the Application Navigator.

   Figure 5-40 The Create Project Dialog

   
   Description of "Figure 5-40 The Create Project Dialog"
   
   

5. Click Next. The Configure SOA settings dialog appears.

6. Select Composite With BPEL in the Composite Template box, as shown in Figure 5-41, and click Finish. The Create BPEL Process dialog is displayed.

   Figure 5-41 The Configure SOA Settings Dialog

   
   Description of "Figure 5-41 The Configure SOA Settings Dialog"
   
   

7. Enter HelloWorldFlow in the Name field and select Define Service Later from the Template box, as shown in Figure 5-42.

   Figure 5-42 The Create BPEL Process Dialog

   
   Description of "Figure 5-42 The Create BPEL Process Dialog"
   
   

8. Click OK. The HelloWorld application and the HelloWorldComposite project appear in the design area, as shown in Figure 5-43.

   Figure 5-43 The JDeveloper - composite.xml

   
   Description of "Figure 5-43 The JDeveloper - composite.xml"
   
   

9. Copy the HelloWorld.xsd file to the xsd directory in your project (see Section 5.5.1.1, "Prerequisites" for the location of this file).

10. Copy the request.xsl, reply.xsl, and invoke.xsl files to the xsl directory in your project (see Section 5.5.1.1, "Prerequisites" for the location of these files).

5.5.1.3 Creating the Inbound Oracle Socket Adapter Service

Perform the following steps to create an inbound Oracle Socket Adapter service:

1. Drag and drop Socket Adapter from the Components Palette to the Exposed Services swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter HelloWorldClient in the Service Name field, as shown in Figure 5-44.

   Figure 5-44 The Adapter Configuration Wizard Service Name Page

   
   Description of "Figure 5-44 The Adapter Configuration Wizard Service Name Page"
   
   

4. Click Next. The Adapter Interface page is displayed.

5. Select Define from operation and schema (specified later), as shown in the Figure 5-45 and click Next. The Operation page is displayed.

   Figure 5-45 The Adapter Configuration Wizard - Adapter Interface Page

   
   Description of "Figure 5-45 The Adapter Configuration Wizard - Adapter Interface Page"
   
   

6. Select Inbound Synchronous Request/Reply as the Operation Type, as shown in Figure 5-46.

   Figure 5-46 The Adapter Configuration Wizard Operation Page

   
   Description of "Figure 5-46 The Adapter Configuration Wizard Operation Page"
   
   

7. Click Next. The Socket Connection page is displayed.

8. Enter eis/socket/InboundSocketAdapter in the Socket Connection JNDI Name field, as shown in Figure 5-47, and click Next. The Messages page is displayed.

   Figure 5-47 The Adapter Configuration Wizard Socket Connection Page

   
   Description of "Figure 5-47 The Adapter Configuration Wizard Socket Connection Page"
   
   

9. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

10. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessRequest, as shown in Figure 5-48.

    Figure 5-48 The Type Chooser Dialog

    
    Description of "Figure 5-48 The Type Chooser Dialog"
    
    

11. Click OK. The URL field in the Messages page is populated with the HelloWorld.xsd file.

12. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

13. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessRequest.

14. Click OK. The URL fields in the Messages page are populated with the HelloWorld.xsd files, as shown in Figure 5-49.

    Figure 5-49 The Adapter Configuration Wizard File Messages Page

    
    Description of "Figure 5-49 The Adapter Configuration Wizard File Messages Page"
    
    

15. Click Next. The Protocol page is displayed.

16. Select Use XSLT to define the handshake.

17. Click Browse to select the XSL file that appears at the end of the Xslt field. The SOA Resource Browser dialog is displayed.

18. Select request.xsl as the file name, as shown in Figure 5-50, and click OK. The Xslt field is populated.

    Figure 5-50 The SOA Resource Browser Dialog

    
    Description of "Figure 5-50 The SOA Resource Browser Dialog"
    
    

19. Click Browse to select the XSL file that appears at the end of the ReplyXslt field. The SOA Resource Browser dialog is displayed.

20. Select reply.xsl as the file name and click OK. The Xslt field is populated, as shown in Figure 5-51.

    Figure 5-51 The Adapter Configuration Wizard Protocol Page

    
    Description of "Figure 5-51 The Adapter Configuration Wizard Protocol Page"
    
    

21. Click Finish. The composite.xml page appears, as shown in Figure 5-52.

    Figure 5-52 The JDeveloper - composite.xml Page

    
    Description of "Figure 5-52 The JDeveloper - composite.xml Page"
    
    

5.5.1.4 Creating the Outbound Oracle Socket Adapter Service

Perform the following steps to create an outbound Oracle Socket Adapter service:

1. Drag and drop Socket Adapter from the Component Palette to the External References swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter HelloWorldServer in the Service Name field.

4. Click Next. The Adapter Interface page is displayed.

5. Select Define from operation and schema (specified later), and click Next. The Operation page is displayed.

6. Select Outbound Synchronous Request/Reply as the operation type, as shown in Figure 5-53.

   Figure 5-53 The Adapter Configuration Wizard Operation Type Page

   
   Description of "Figure 5-53 The Adapter Configuration Wizard Operation Type Page"
   
   

7. Click Next. The Socket Connection page is displayed.

8. Enter eis/socket/OutboundSocketAdapter in the Socket Connection JNDI Name field, as shown in Figure 5-54, and click Next. The Messages page is displayed.

   Figure 5-54 The Adapter Configuration Wizard Socket Connection Page

   
   Description of "Figure 5-54 The Adapter Configuration Wizard Socket Connection Page"
   
   

9. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

10. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessRequest, as shown in Figure 5-48.

11. Click OK. The URL field in the Messages page is populated with the HelloWorld.xsd file.

12. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

13. Click Project Schema Files, HelloWorld.xsd, and HelloWorldProcessResponse.

14. Click OK. The URL fields in the Messages page are populated with the HelloWorld.xsd files, as shown in Figure 5-49.

15. Click Next. The Protocol page is displayed.

16. Select Use XSLT to define the handshake.

17. Click Browse to select the XSL file that appears at the end of the Xslt field. The SOA Resource Browser dialog is displayed.

18. Select invoke.xsl as the file name, as shown in Figure 5-55, and click OK. The Xslt field is populated.

    Figure 5-55 The SOA Resource Browser Dialog

    
    Description of "Figure 5-55 The SOA Resource Browser Dialog"
    
    

19. Click Finish. The Composite.xml page appears, as shown in Figure 5-56.

    Figure 5-56 The JDeveloper - composite.xml Page

    
    Description of "Figure 5-56 The JDeveloper - composite.xml Page"
    
    

5.5.1.5 Wiring Services and Activities

You have to assemble or wire the three components that you have created: Inbound adapter service, BPEL process, Outbound adapter reference. Perform the following steps to wire the components:

1. Drag the small triangle in the HelloWorldClient in the Exposed Services area to the drop zone that appears as a green triangle in the HelloWorldFlow BPEL process in the Components area.

2. Drag the small triangle in the HelloWorldFlow BPEL process in the Components area to the drop zone that appears as a green triangle in the HelloWorldServer in the External References area.

   The JDeveloper composite.xml appears, as shown in Figure 5-57.

   Figure 5-57 The JDeveloper - composite.xml

   
   Description of "Figure 5-57 The JDeveloper - composite.xml"
   
   

3. Click File, Save All.

Add a Receive Activity

1. Double-click HelloWorldFlow. The BPELHelloWorld.bpel page is displayed.

2. Drag and drop a Receive activity from the Component Palette to the design area, as shown in Figure 5-58.

   Figure 5-58 The JDeveloper - HelloWorldFlow.bpel

   
   Description of "Figure 5-58 The JDeveloper - HelloWorldFlow.bpel"
   
   

3. Double-click the Receive activity. The Receive dialog is displayed.

4. Enter ReceiveInput in the Name field, as shown in Figure 5-59.

   Figure 5-59 The Receive Dialog

   
   Description of "Figure 5-59 The Receive Dialog"
   
   

5. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

6. Select HelloWorldClient, as shown in Figure 5-60, and click OK.

   Figure 5-60 The Partner Link Chooser Dialog

   
   Description of "Figure 5-60 The Partner Link Chooser Dialog"
   
   

7. Click the Auto-Create Variable icon to the right of the Variable field in the Receive dialog, as shown in Figure 5-61. The Create Variable dialog is displayed.

   Figure 5-61 The Receive Dialog

   
   Description of "Figure 5-61 The Receive Dialog"
   
   

8. Select the default variable name and click OK. The Variable field is populated with the default variable name.

9. Check Create Instance, and click OK. The JDeveloper HelloWorldFlow.bpel page appears, as shown in Figure 5-62.

   Figure 5-62 The JDeveloper - HelloWorldFlow.bpel

   
   Description of "Figure 5-62 The JDeveloper - HelloWorldFlow.bpel"
   
   

Add an Invoke Activity

1. Drag and drop an Invoke activity after the ReceiveInput activity from the Component Palette to the design area, as shown in Figure 5-63.

   Figure 5-63 The JDeveloper - HelloWorldFlow.bpel

   
   Description of "Figure 5-63 The JDeveloper - HelloWorldFlow.bpel"
   
   

2. Double-click the Invoke activity. The Invoke dialog is displayed.

3. Enter WriteHelloWorld in the Name field, as shown in Figure 5-64.

   Figure 5-64 The JDeveloper - HelloWorldFlow.bpel

   
   Description of "Figure 5-64 The JDeveloper - HelloWorldFlow.bpel"
   
   

4. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

5. Select HelloWorldServer, as shown in Figure 5-65, and click OK.

   Figure 5-65 The Partner Link Chooser Dialog

   
   Description of "Figure 5-65 The Partner Link Chooser Dialog"
   
   

6. Click the Automatically Create Input Variable icon to the right of the Input variable field in the Invoke dialog. The Create Variable dialog is displayed.

7. Select the default variable name and click OK. The Variable field is populated with the default variable name.

8. Repeat the same for selecting the output variable. The Invoke dialog is displayed, as shown in Figure 5-66.

   Figure 5-66 The Invoke Dialog

   
   Description of "Figure 5-66 The Invoke Dialog"
   
   

9. Click OK. The JDeveloper HelloWorldFlow.bpel page appears, as shown in Figure 5-67.

   Figure 5-67 The JDeveloper - HelloWorldFlow.bpel

   
   Description of "Figure 5-67 The JDeveloper - HelloWorldFlow.bpel"
   
   

Add a Reply Activity

1. Drag and drop a Reply activity from the Component Palette to the design area, as shown in Figure 5-68.

   Figure 5-68 The JDeveloper - HelloWorldFlow.bpel

   
   Description of "Figure 5-68 The JDeveloper - HelloWorldFlow.bpel"
   
   

2. Double-click the Reply activity. The Reply dialog is displayed.

3. Enter Reply in the Name field.

4. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

5. Select HelloWorldClient, as shown in Figure 5-60, and click OK.

6. Click the Auto-Create Variable icon to the right of the Variable field in the Reply dialog. The Create Variable dialog is displayed.

7. Select the default variable name and click OK. The Variable field is populated with the default variable name, as shown in Figure 5-69.

   Figure 5-69 The Reply Dialog

   
   Description of "Figure 5-69 The Reply Dialog"
   
   

8. Click OK. The JDeveloper HelloWorldFlow.bpel page appears, as shown in Figure 5-70.

   Figure 5-70 The JDeveloper - HelloWorldFlow.bpel

   
   Description of "Figure 5-70 The JDeveloper - HelloWorldFlow.bpel"
   
   

Add Assign Activities

1. Drag and drop an Assign activity from the Component Palette in between the Receive and Invoke activities in the design area.

2. Double-click the Assign activity. The Assign dialog is displayed.

3. Click the Copy Operation tab. The Assign dialog is displayed, as shown in Figure 5-71.

   Figure 5-71 The Assign Dialog - Copy Operation Tab

   
   Description of "Figure 5-71 The Assign Dialog - Copy Operation Tab"
   
   

4. Select Copy Operation. The Create Copy Operation dialog is displayed.

5. In the left pane, under the ReceiveInput_InboundRequestReply_InputVariable variable select, ns3:input.

6. In the right pane, under the WriteHelloWorld_OutboundRequestReply_InputVariable variable select, ns3:input, as shown in Figure 5-72.

   Figure 5-72 The Create Copy Operation Dialog

   
   Description of "Figure 5-72 The Create Copy Operation Dialog"
   
   

7. Click OK. The Assign dialog is displayed.

8. Click OK. The JDeveloper HelloWorldFlow.bpel page is displayed.

9. Add another Assign activity in between the Invoke and the Reply activities.

10. Double-click the assign activity.

11. Click the Copy Operation tab, and select Copy Operation.

12. In the left pane, select ns3:result under WriteHelloWorld_OutboundRequestReply_OutputVariable.

13. In the right pane, select ns3:result under Reply_InboundRequestReply_OutputVariable and click OK.

14. Click OK, the JDeveloper HelloWorldFlow.bpel page is displayed, as shown in Figure 5-73.

    Figure 5-73 The JDeveloper - HelloWorldFlow.bpel

    
    Description of "Figure 5-73 The JDeveloper - HelloWorldFlow.bpel"
    
    

15. Click File, Save All.

5.5.1.6 Deploying with JDeveloper

You must deploy the application profile for the SOA project and the application you created in the preceding steps. To deploy the application profile using JDeveloper, perform the following steps:

1. Create an application server connection. For more information, see Section 2.6, "Creating an Application Server Connection for Oracle JCA Adapters."

2. Deploy the application. For more information, see Section 2.7, "Deploying Oracle JCA Adapter Applications from JDeveloper."

5.5.1.7 Monitoring Using the Oracle Enterprise Manager Fusion Middleware Control Console (Fusion Middleware Control Console)

You can monitor the deployed SOA composite using the Fusion Middleware Control Console. Perform the following steps:

1. Navigate to http://servername:portnumber/em. The composite you deployed appears in the application navigator.

2. Click the SOA composite that you deployed. The Dashboard is displayed.

   Note your Instance ID in the Recent Instances area.

3. Click the Instances tab. The Instance IDs of the SOA composite are listed.

4. Click the Instance ID that you noted in Step 2. The Flow Trace page is displayed.

5. Click your BPEL process instance. The Audit Trail of the BPEL process instance is displayed.

6. Expand a payload node to view payload details.

7. Click the Flow tab to view the process flow. Additionally, click an activity (such as invoke, receive) to view the details of an activity.

5.5.2.1 Prerequisites

To perform this use case, you require the following files from the artifacts.zip file contained in the Adapters-102SocketAdapterFlightInformationDisplaySystem sample:

• artifacts/schemas/Airline1.xsd

• artifacts/schemas/Airline2.xsd

• artifacts/schemas/Airline3.xsd

• artifacts/schemas/FIDS.xsd

• artifacts/xsl/request.xsl

• artifacts/xsl/reply.xsl

• artifacts/xsl/invoke.xsl

To obtain the Adapters-102SocketAdapterFlightInformationDisplaySystem sample, access the Oracle SOA Sample Code site.

5.5.2.2 Designing the SOA Composite

You must create a JDeveloper application to contain the SOA composite. To create an application and a project for the use case, perform the following steps:

1. In the Application Navigator of JDeveloper, click New Application. The Create Generic Application - Name your application page is displayed.

2. Enter FIDSApp in the Application Name field, and then click Next. The Name your project page is displayed.

3. Click OK. The Name Your Project dialog is displayed.

4. Enter FIDSComposite in the Project Name field, and then select SOA under Project Technologies and move it to the Selected box by clicking the right-arrow.

   The FIDSApp application and the FIDSComposite project appear in the Application Navigator.

5. Click Next. The Configure SOA Settings dialog appears.

6. Select Composite With BPEL in the Composite Template box, and click Finish. The Create BPEL Process dialog is displayed.

7. Enter BPEL_FIDS in the Name field and select Define Service Later from the Template box.

8. Click OK. The FIDSApp application and the FIDSComposite project appear in the design area, as shown in Figure 5-74.

   Figure 5-74 The JDeveloper - composite.xml

   
   Description of "Figure 5-74 The JDeveloper - composite.xml"
   
   

9. Copy the Airline1.xsd, Airline2.xsd, Airline3.xsd, and FIDS.xsd files to FIDSComposite\xsd under the project FIDSComposite (see Section 5.5.2.1, "Prerequisites" for the location of these files).

10. Copy invoke.xsl, request.xsl, and reply.xsl to FIDSComposite\xsl under the project FIDSComposite (see Section 5.5.2.1, "Prerequisites" for the location of these files).

5.5.2.3 Creating the Inbound Oracle Socket Adapter Service

Perform the following steps to create an inbound Oracle Socket Adapter service that would be used to expose the FIDSApp application:

1. Drag and drop Socket Adapter from the Components Palette to the Exposed Services swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter FIDS in the Service Name field.

4. Click Next. The Adapter Interface page is displayed.

5. Select Define from operation and schema (specified later), and click Next. The Operation page is displayed.

6. Select Inbound Synchronous Request/Reply as the operation type.

7. Click Next. The Socket Connection page is displayed.

8. Enter eis/socket/InboundSocketAdapter in the Socket Connection JNDI Name field and then select Specify Host and Port, as shown in Figure 5-75.

   Figure 5-75 The Adapter Configuration Wizard Socket Connection Page

   
   Description of "Figure 5-75 The Adapter Configuration Wizard Socket Connection Page"
   
   

9. Enter 9000 in the PortNumber field and click Next. The Messages page is displayed.

10. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

11. Click Project Schema Files, FIDS.xsd, and FIDSProcessRequest, as shown in Figure 5-76.

    Figure 5-76 The Type Chooser Dialog

    
    Description of "Figure 5-76 The Type Chooser Dialog"
    
    

12. Click OK. The URL field in the Messages page is populated with the FIDS.xsd file.

13. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

14. Click Project Schema Files, FIDS.xsd, and FIDSProcessReply.

15. Click OK. The URL fields in the Messages page are populated with the FIDS.xsd files, as shown in Figure 5-77.

    Figure 5-77 The Adapter Configuration Wizard - Messages Page

    
    Description of "Figure 5-77 The Adapter Configuration Wizard - Messages Page"
    
    

16. Click Next. The Protocol page is displayed.

17. Select Use XSLT to define the handshake.

18. Click the Browse to select the XSL file icon that appears at the end of the Xslt field. The SOA Resource Browser dialog is displayed.

19. Select request.xsl as the file name and click OK. The Xslt field is populated.

20. Click the Browse to select the XSL file icon that appears at the end of the ReplyXslt field. The SOA Resource Browser dialog is displayed.

21. Select reply.xsl as the file name and click OK. The Xslt field is populated, as shown in Figure 5-78.

    Figure 5-78 The Adapter Configuration Wizard - Protocol Page

    
    Description of "Figure 5-78 The Adapter Configuration Wizard - Protocol Page"
    
    

22. Click Finish. The composite.xml page appears, as shown in Figure 5-79.

    Figure 5-79 The JDeveloper - composite.xml Page

    
    Description of "Figure 5-79 The JDeveloper - composite.xml Page"
    
    

5.5.2.4 Creating Outbound Oracle Socket Adapter Services

Perform the following steps to create an outbound Oracle Socket Adapter service for the Airline1 server socket:

1. Drag and drop Socket Adapter from the Component Palette to the External References swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter Airline1 in the Service Name field.

4. Click Next. The Adapter Interface page is displayed.

5. Select Define from operation and schema (specified later), and click Next. The Operation page is displayed.

6. Select Outbound Synchronous Request/Reply as the Operation Type.

7. Click Next. The Socket Connection page is displayed.

8. Enter eis/socket/OutboundSocketAdapter in the Socket Connection JNDI Name field, as shown in Figure 5-80, and then select Specify Host and Port.

   Figure 5-80 The Adapter Configuration Wizard - Socket Connection Page

   
   Description of "Figure 5-80 The Adapter Configuration Wizard - Socket Connection Page"
   
   

9. Enter the name of the system where the Airline1 socket server program must run in the HostName field and 9001 in the PortNumber field, and click Next. The Messages page is displayed.

10. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

11. Click Project Schema Files, Airline1.xsd, and Source.

12. Click OK. The URL field in the Messages page is populated with the Airline1.xsd file.

13. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

14. Click Project Schema Files, Airline1.xsd, and Flight-Details.

15. Click OK. The URL fields in the Messages page are populated with the Airline1.xsd files, as shown in Figure 5-81.

    Figure 5-81 The Adapter Configuration Wizard - Messages Page

    
    Description of "Figure 5-81 The Adapter Configuration Wizard - Messages Page"
    
    

16. Click Next. The Protocol page is displayed.

17. Select Use XSLT to define the handshake.

18. Click Browse to select the XSL file that appears at the end of the Xslt field. The SOA Resource Browser dialog is displayed.

19. Select invoke.xsl as the file name, as shown in Figure 5-82, and click OK. The Xslt field is populated.

    Figure 5-82 The SOA Resource Browser Dialog

    
    Description of "Figure 5-82 The SOA Resource Browser Dialog"
    
    

20. Click Finish. The composite.xml page appears, as shown in Figure 5-83.

    Figure 5-83 The JDeveloper - composite.xml Page

    
    Description of "Figure 5-83 The JDeveloper - composite.xml Page"
    
    

Perform the following steps to create an outbound Oracle Socket Adapter service for the Airline2 server socket:

1. Drag and drop Socket Adapter from the Component Palette to the External References swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter Airline2 in the Service Name field.

4. Click Next. The Adapter Interface page is displayed.

5. Select Define from operation and schema (specified later), and click Next. The Operation page is displayed.

6. Select Outbound Synchronous Request/Reply as the operation type.

7. Click Next. The Socket Connection page is displayed.

8. Enter eis/socket/OutboundSocketAdapter in the Socket Connection JNDI Name field and then select Specify Host and Port.

9. Enter the name of the system where the Airline2 socket server program must run in the HostName field and 9002 in the PortNumber field, and click Next. The Messages page is displayed.

10. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

11. Click Project Schema Files, Airline2.xsd, and Source.

12. Click OK. The URL field in the Messages page is populated with the Airline2.xsd file.

13. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

14. Click Project Schema Files, Airline2.xsd, and flight-details.

15. Click OK. The URL fields in the Messages page are populated with the Airline2.xsd files.

16. Click Next. The Protocol page is displayed.

17. Select No Handshake.

18. Click Finish. The composite.xml page appears, as shown in Figure 5-84.

    Figure 5-84 The JDeveloper - composite.xml Page

    
    Description of "Figure 5-84 The JDeveloper - composite.xml Page"
    
    

Perform the following steps to create an outbound Oracle Socket Adapter service for the Airline3 server socket:

1. Drag and drop Socket Adapter from the Component Palette to the External References swim lane. The Welcome page of the Adapter Configuration Wizard is displayed.

2. Click Next. The Service Name page is displayed.

3. Enter Airline3 in the Service Name field.

4. Click Next. The Adapter Interface page is displayed.

5. Select Define from operation and schema (specified later), and click Next. The Operation page is displayed.

6. Select Outbound Synchronous Request/Reply as the operation type.

7. Click Next. The Socket Connection page is displayed.

8. Enter eis/socket/OutboundSocketAdapter in the Socket Connection JNDI Name field and then select Specify Host and Port.

9. Enter the name of the system where the Airline3 socket server program must run in the HostName field and 9003 in the PortNumber field, and click Next. The Messages page is displayed.

10. Click Browse For Schema File that appears at the end of the URL field in the Request Message Schema box. The Type Chooser dialog is displayed.

11. Click Project Schema Files, Airline3.xsd, and src.

12. Click OK. The URL field in the Messages page is populated with the Airline3.xsd file.

13. Click Browse For Schema File that appears at the end of the URL field in the Reply Message Schema box. The Type Chooser dialog is displayed.

14. Click Project Schema Files, Airline3.xsd, and airline.

15. Click OK. The URL fields in the Messages page are populated with the Airline3.xsd files.

16. Click Next. The Protocol page is displayed.

17. Select Use Custom Java Code to define the handshake.

18. Enter com.oracle.socket.fids.custom.Airline3Custom in the Java Class field.

19. Click Finish. The composite.xml page appears, as shown in Figure 5-85.

    Figure 5-85 The JDeveloper - composite.xml Page

    
    Description of "Figure 5-85 The JDeveloper - composite.xml Page"
    
    

5.5.2.5 Wiring Services and Activities

You have to assemble or wire the components that you have created: Inbound adapter service, BPEL process, Outbound adapter references. Perform the following steps to wire the components:

1. Drag the small triangle in the FIDS client in the Exposed Services area to the drop zone that appears as a green triangle in the BPEL_FIDS process in the Components area.

2. Drag the small triangle in the BPEL_FIDS process in the Components area to the drop zone that appears as a green triangle in the Airline1, Airline2, and Airline3 servers in the External References area.

   The JDeveloper composite.xml file appears, as shown in Figure 5-86.

   Figure 5-86 The JDeveloper - composite.xml

   
   Description of "Figure 5-86 The JDeveloper - composite.xml"
   
   

3. Click File, Save All.

Add a Receive Activity

1. Double-click BPEL_FIDS. The BPELFIDS.bpel page is displayed.

2. Drag and drop a Receive activity from the Component Palette to the design area.

3. Double-click the Receive activity. The Receive dialog is displayed.

4. Retain the default name Receive_1 in the Name field.

5. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

6. Select FIDS, as shown in Figure 5-87, and click OK.

   Figure 5-87 The Partner Link Chooser Dialog

   
   Description of "Figure 5-87 The Partner Link Chooser Dialog"
   
   

7. Click the Auto-Create Variable icon to the right of the Variable field in the Receive dialog, as shown in Figure 5-88. The Create Variable dialog is displayed.

   Figure 5-88 The Receive Dialog

   
   Description of "Figure 5-88 The Receive Dialog"
   
   

8. Select the default variable name and click OK. The Variable field is populated with the default variable name.

9. Check Create Instance, and click OK. The JDeveloper BPEL_FIDS.bpel page appears, as shown in Figure 5-89.

   Figure 5-89 The JDeveloper - BPEL_FIDS.bpel

   
   Description of "Figure 5-89 The JDeveloper - BPEL_FIDS.bpel"
   
   

Add a Reply Activity

1. Drag and drop an Reply activity from the Component Palette to the design area, as shown in Figure 5-90.

   Figure 5-90 The JDeveloper - BPEL_FIDS.bpel

   
   Description of "Figure 5-90 The JDeveloper - BPEL_FIDS.bpel"
   
   

2. Double-click the Reply activity. The Reply dialog is displayed.

3. Retain the default name Reply_1 in the Name field.

4. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

5. Select FIDS, as shown in Figure 5-87, and click OK.

6. Click the Auto-Create Variable icon to the right of the Variable field in the Reply dialog. The Create Variable dialog is displayed.

7. Select the default variable name and click OK. The Variable field is populated with the default variable name, as shown in Figure 5-91.

   Figure 5-91 The Reply Dialog

   
   Description of "Figure 5-91 The Reply Dialog"
   
   

8. Click OK. The JDeveloper BPEL_FIDS.bpel page appears, as shown in Figure 5-92.

   Figure 5-92 The JDeveloper - BPEL_FIDS.bpel

   
   Description of "Figure 5-92 The JDeveloper - BPEL_FIDS.bpel"
   
   

Add a Flow Activity

1. Drag and drop a Flow activity from the Component Palette in between the Receive and the Reply activities in the design area, as shown in Figure 5-93.

   Figure 5-93 The JDeveloper - BPEL_FIDS.bpel

   
   Description of "Figure 5-93 The JDeveloper - BPEL_FIDS.bpel"
   
   

2. Expand the Flow_1 activity. This displays a screen to create sequences.

Design the Flow for Airline1 Server

1. Drag and drop a Switch activity from the Component Palette to Sequence_1, as shown in Figure 5-94.

   Figure 5-94 The JDeveloper - BPEL_FIDS.bpel Page

   
   Description of "Figure 5-94 The JDeveloper - BPEL_FIDS.bpel Page"
   
   

2. Expand the Switch activity. This displays a screen to enter the values for <case> and <otherwise>.

3. In the <case> section, click the View Condition Expression icon, as shown in Figure 5-95. The Condition Expression pop-up window is displayed.

   Figure 5-95 The JDeveloper - BPEL_FIDS.bpel Page

   
   Description of "Figure 5-95 The JDeveloper - BPEL_FIDS.bpel Page"
   
   

4. Click the Xpath Expression Builder icon in the pop-up window. The Expression Builder dialog is displayed.

5. Enter boolean(bpws:getVariableData('Receive_1_InboundRequestReply_InputVariable','FIDSProcessRequest','/ns5:FIDSProcessRequest/ns5:AirlineName')='Airline1') as the expression, as shown in Figure 5-96, and click OK. The screen returns to the Condition Expression pop-up window.

   Note:

   This expression ensures that this flow is executed only when information for Airline1 is requested.

   Figure 5-96 The Expression Builder Dialog

   
   Description of "Figure 5-96 The Expression Builder Dialog"
   
   

6. Add an invoke activity to the <case> section.

   1. Drag and drop an Invoke activity in the <case> section.

   2. Double-click the Invoke activity. The Invoke dialog is displayed.

   3. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

   4. Select Airline1, and click OK.

   5. Click the Automatically Create Input Variable and the Automatically Create Output Variable icons to the right of the Input and Output Variable fields in the Invoke dialog. The Create Variable dialogs are displayed.

   6. Select the default variable names and click OK. The Variable fields are populated with the default variable name. The Invoke dialog is displayed.

   7. Click OK. The JDeveloper BPEL_FIDS.bpel page is displayed, as shown in Figure 5-97.

   Figure 5-97 The JDeveloper - BPEL_FIDS.bpel

   
   Description of "Figure 5-97 The JDeveloper - BPEL_FIDS.bpel"
   
   

7. Add an assign activity to the <case> section.

   1. Drag and drop an Assign activity from the Component Palette before the Invoke_1 activity in the <case> section.

   2. Double-click the Assign_1 activity. The Assign dialog is displayed.

   3. Click the Copy Operation tab. The Assign dialog is displayed.

   4. Select Copy Operation. The Create Copy Operation dialog is displayed.

   5. Create the copy operation between the source from the input variable of the Receive_1 activity and the source from the input variable of the Invoke_1 activity, as shown in Figure 5-98.

      Figure 5-98 The Create Copy Operation Dialog

      
      Description of "Figure 5-98 The Create Copy Operation Dialog"
      
      

   6. Click OK in the Create Copy Operation dialog.

   7. Click OK.

   The BPEL_FIDS.bpel page is displayed, as shown in Figure 5-99.

   Figure 5-99 The JDeveloper - BPELFIDS.bpel

   
   Description of "Figure 5-99 The JDeveloper - BPELFIDS.bpel"
   
   

8. Add a Transform activity to the <case> section.

   1. Drag and drop a Transform activity in the <case> section, after the Invoke_1 activity.

   2. Double-click the Transform activity.

   3. Click the Transformation tab.

   4. Click the Create...(Alt+N) icon. The Source Variable dialog is displayed.

   5. Select Invoke_1_OutboundRequestReply_OutputVariable from the Source Variable list and click OK.

   6. Select Reply_1_InboundRequestReply_OutputVariable from the Target Variable list.

   7. Click OK. The XSL mapper tool is displayed.

   8. Link the tns:Flight node from the source, on the left pane to the target FlightDetails node on the right pane. The Auto Map Preferences dialog appears.

   9. Click OK. The Transformation_1.xsl (XSL mapper tool) is displayed, as shown in Figure 5-100.

      Figure 5-100 The JDeveloper - Transformation_1.XSL Page

      
      Description of "Figure 5-100 The JDeveloper - Transformation_1.XSL Page"
      
      

9. Click File, Save All. The BPEL_FIDS.bpel page is displayed, as shown in Figure 5-101, with the flow defined for the Airline1 server.

   Figure 5-101 The JDeveloper - BPEL_FIDS.bpel

   
   Description of "Figure 5-101 The JDeveloper - BPEL_FIDS.bpel"
   
   

Design the Flow for Airline2 Server

1. Double-click the empty Sequence activity and enter Sequence_2 in the Name field.

2. Drag and drop a Switch activity from the Component Palette to Sequence_2.

3. Expand the Switch activity. This displays a screen to enter the values for <case> and <otherwise>.

4. In the <case> section, click the View Condition Expression icon. The Condition Expression pop-up window is displayed.

5. Click the Xpath Expression Builder icon in the pop-up window. The Expression Builder dialog is displayed.

6. Enter boolean(bpws:getVariableData('Receive_1_InboundRequestReply_InputVariable','FIDSProcessRequest','/ns5:FIDSProcessRequest/ns5:AirlineName')='Airline2') as the expression, and click OK. The screen returns to the Condition Expression pop-up window.

   Note:

   This expression ensures that this flow is executed only when information for Airline2 is requested.

7. Add an invoke activity to the <case> section.

   1. Drag and drop an Invoke activity in the <case> section.

   2. Double-click the Invoke_2 activity. The Invoke dialog is displayed.

   3. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

   4. Select Airline2, and click OK.

   5. Click the Automatically Create Input Variable and the Automatically Create Output Variable icons to the right of the Input and Output Variable fields in the Invoke dialog. The Create Variable dialogs are displayed.

   6. Select the default variable names and click OK. The Input and Output Variable fields are populated with the default variable names. The Invoke dialog is displayed.

   7. Click OK. An Invoke activity is added to the JDeveloper BPEL_FIDS.bpel page under Sequence_2.

8. Add an assign activity to the <case> section.

   1. Drag and drop an Assign activity from the Component Palette before the Invoke activity in the <case> section.

   2. Double-click the Assign_2 activity. The Assign dialog is displayed.

   3. Click the Copy Operation tab. The Assign dialog is displayed.

   4. Select Copy Operation. The Create Copy Operation dialog is displayed.

   5. Create the copy operation between the source from the input variable of the Receive_1 activity and the source from the input variable of the Invoke_2 activity, as shown in Figure 5-102.

      Figure 5-102 The Create Copy Operation Dialog

      
      Description of "Figure 5-102 The Create Copy Operation Dialog"
      
      

   6. Click OK in the Create Copy Operation dialog.

   7. Click OK.

9. Create a temporary variable and add a Transform activity to the <case> section.

   Note:

   The temporary variable is used for storing flight details from the Airline2 server, which would later be appended to the reply variable.

   1. Click the Variables... icon represented by (x). The Variables dialog is displayed, as shown in Figure 5-103.

      Figure 5-103 The Variables Dialog

      
      Description of "Figure 5-103 The Variables Dialog"
      
      

   2. Click the Create... icon. The Create Variable dialog is displayed, as shown in Figure 5-104.

      Figure 5-104 The Create Variable Dialog

      
      Description of "Figure 5-104 The Create Variable Dialog"
      
      

   3. Select Message Type as the variable type.

   4. Click the Browse Message Types icon at the end of the Message Type field. The Type Chooser dialog is displayed.

   5. Click Message Types, Partner Links, FIDS, FIDS.wsdl, Message Types, and then FIDSProcessReply_msg_reply, as shown in Figure 5-105.

      Figure 5-105 The Type Chooser Dialog

      
      Description of "Figure 5-105 The Type Chooser Dialog"
      
      

   6. Click OK. The Message type field in the Create Variable dialog is populated with the FIDSProcessReply_msg_reply partner link.

   7. Click OK. A variable, Variable_1, of type Message Type is added to the Variables list in the Variable dialog.

   8. Click OK to return to the BPEL_FIDS.bpel page.

   9. Drag and drop a Transform activity in the <case> section, after the Invoke_2 activity.

   10. Double-click the Transform_2 activity.

   11. Click the Transformation tab.

   12. Click the Create... icon. The Source Variable dialog is displayed.

   13. Select Invoke_2_OutboundRequestReply_OutputVariable from the Source Variable list and click OK.

   14. Select Variable_1 from the Target Variable list.

   15. Click OK. The XSL mapper tool is displayed.

   16. Link the tns:flight node from the source, on the left pane to the target FlightDetails node on the right pane. The Auto Map Preferences dialog appears, as shown in Figure 5-106.

       Figure 5-106 The Transformation_2.XSL Page With Auto Map Preference Dialog

       
       Description of "Figure 5-106 The Transformation_2.XSL Page With Auto Map Preference Dialog"
       
       

   17. Click OK. The Transformation_2.xsl (XSL mapper tool) file with the XSL mapping is displayed.

10. Click File, Save All.

    The BPEL_FIDS.bpel page is displayed, as shown in Figure 5-107, with the flow defined for the Airline2 server.

    Figure 5-107 The JDeveloper - BPEL_FIDS.bpel

    
    Description of "Figure 5-107 The JDeveloper - BPEL_FIDS.bpel"
    
    

Design the Flow for Airline3 Server

1. Right-click the Flow_1 activity. Click Add Sequence from the menu. Sequence_3 is added.

2. Drag and drop a Switch activity from the Component Palette to Sequence_3.

3. Expand the Switch activity. This displays a screen to enter the values for <case> and <otherwise>.

4. In the <case> section, click the View Condition Expression icon. The Condition Expression pop-up window is displayed.

5. Click the Xpath Expression Builder icon in the pop-up window. The Expression Builder dialog is displayed.

6. Enter boolean(bpws:getVariableData('Receive_1_InboundRequestReply_InputVariable','FIDSProcessRequest','/ns5:FIDSProcessRequest/ns5:AirlineName')='Airline3') as the expression, and click OK. The screen returns to the Condition Expression pop-up window.

   Note:

   This expression ensures that this flow is executed only when information for Airline3 is requested.

7. Add an invoke activity to the <case> section.

   1. Drag and drop an Invoke activity in the <case> section.

   2. Double-click the Invoke_3 activity. The Invoke dialog is displayed.

   3. Click Browse Partner Links at the end of the Partner Link field. The Partner Link Chooser dialog is displayed.

   4. Select Airline3, and click OK.

   5. Click the Automatically Create Input Variable and Automatically Create Output Variable icon to the right of the Input and Output Variable field in the Invoke dialog. The Create Variable dialogs are displayed.

   6. Select the default variable names and click OK. The Input and Output Variable fields are populated with the default variable names. The Invoke dialog is displayed.

   7. Click OK. An Invoke activity is added to JDeveloper BPEL_FIDS.bpel page under Sequence_3.

8. Add an assign activity to the <case> section.

   1. Drag and drop an Assign activity from the Component Palette before the Invoke activity in the <case> section.

   2. Double-click the Assign_3 activity. The Assign dialog is displayed.

   3. Click the Copy Operation tab. The Assign dialog is displayed.

   4. Select Copy Operation. The Create Copy Operation dialog is displayed.

   5. Create the copy operation between the source from the input variable of the Receive_1 activity and the source from the input variable of the Invoke_3 activity, as shown in Figure 5-108.

      Figure 5-108 The Create Copy Operation Dialog

      
      Description of "Figure 5-108 The Create Copy Operation Dialog"
      
      

   6. Click OK in the Create Copy Operation dialog.

   7. Click OK.

9. Create a temporary variable and add a Transform activity to the <case> section.

   Note:

   The temporary variable is used for storing flight details from the Airline3 server, which would later be appended to the reply variable.

   1. Click the Variables... icon represented by (x). The Variables dialog is displayed, as shown in Figure 5-109.

      Figure 5-109 The Variables Dialog

      
      Description of "Figure 5-109 The Variables Dialog"
      
      

   2. Click the Create... icon. The Create Variable dialog is displayed.

   3. Select Message Type as the variable type.

   4. Click the Browse Message Types icon at the end of the Message Type field. The Type Chooser dialog is displayed.

   5. Click Message Types, Partner Links, FIDS, FIDS.wsdl, Message Types, and then FIDSProcessReply_msg_reply, as shown in Figure 5-105.

   6. Click OK. The Message type field in the Create Variable dialog is populated with the FIDSProcessReply_msg_reply partner link.

   7. Click OK. A variable, Variable_2, of type Message Type is added to the Variables list in the Variable dialog.

   8. Click OK to return to the BPEL_FIDS.bpel page.

   9. Drag and drop a Transform activity in the <case> section, after the Invoke_3 activity.

   10. Double-click the Transform_3 activity.

   11. Click the Transformation tab.

   12. Click the Create... icon. The Source Variable dialog is displayed.

   13. Select Invoke_3_OutboundRequestReply_OutputVariable from the Source Variable list and click OK.

   14. Select Variable_2 from the Target Variable list.

   15. Click OK. The XSL mapper tool is displayed.

   16. Link the tns:flight node from the source, on the left pane to the target FlightDetails node on the right pane. The Auto Map Preferences dialog appears.

   17. Click OK. The Transformation_3.xsl (XSL mapper tool) file with the XSL mapping is displayed, as shown in Figure 5-110.

       Figure 5-110 The Transformation_3.XSL Page

       
       Description of "Figure 5-110 The Transformation_3.XSL Page"
       
       

10. Click File, Save All. The BPEL_FIDS.bpel page is displayed, as shown in Figure 5-111, with the flow defined for the Airline3 server.

    Figure 5-111 The JDeveloper - BPEL_FIDS.bpel

    
    Description of "Figure 5-111 The JDeveloper - BPEL_FIDS.bpel"
    
    

Add an Assign Activity

1. Drag and drop an Assign activity from the Component Palette in between the Reply and Receive activities in the design area.

2. Double-click the Assign_4 activity. The Assign dialog is displayed.

3. Click the Copy Operation tab. The Assign dialog is displayed, as shown in Figure 5-112.

   Figure 5-112 The Assign Dialog - Copy Operation Tab

   
   Description of "Figure 5-112 The Assign Dialog - Copy Operation Tab"
   
   

4. Select Append Operation. The Create Append Operation dialog is displayed.

5. Create an append operation to append the information stored in the temporary variable, Variable_1, to the reply variable, Reply_1_InboundRequestReply_OutputVariable, as shown in Figure 5-113.

   Figure 5-113 The Create Append Operation Dialog

   
   Description of "Figure 5-113 The Create Append Operation Dialog"
   
   

6. Click OK. The Assign dialog is displayed.

7. Select Append Operation. The Create Append Operation dialog is displayed.

8. Create another append operation to append the information stored in the temporary variable, Variable_2, to the reply variable, Reply_1_InboundRequestReply_OutputVariable, as shown in Figure 5-114.

   Figure 5-114 The Create Append Operation Dialog

   
   Description of "Figure 5-114 The Create Append Operation Dialog"
   
   

9. Click OK. The Assign dialog is displayed.

10. Click OK. The JDeveloper BPEL_FIDS.bpel page is displayed, as shown in Figure 5-115.

    Figure 5-115 The JDeveloper - HelloWorldFlow.bpel

    
    Description of "Figure 5-115 The JDeveloper - HelloWorldFlow.bpel"
    
    

11. Click File, Save All.

5.5.2.6 Deploying with JDeveloper

You must deploy the application profile for the SOA project and the application you created in the preceding steps. To deploy the application profile using JDeveloper, perform the following steps:

1. Create an application server connection. For more information, see Section 2.6, "Creating an Application Server Connection for Oracle JCA Adapters."

2. Deploy the application. For more information, see Section 2.7, "Deploying Oracle JCA Adapter Applications from JDeveloper."

You must run the Server and Client java programs to test the application. For more information, see the associated README file.

5.5.2.7 Monitoring Using the Fusion Middleware Control Console

You can monitor the deployed SOA composite using the Fusion Middleware Control Console. Perform the following steps:

1. Navigate to http://servername:portnumber/em. The composite you deployed appears in the application navigator.

2. Click the SOA composite that you deployed. The Dashboard is displayed.

   Note your Instance ID in the Recent Instances area.

3. Click the Instances tab. The Instance IDs of the SOA composite are listed.

4. Click the Instance ID that you noted in Step 2. The Flow Trace page is displayed.

5. Click your BPEL process instance. The Audit Trail of the BPEL process instance is displayed.

6. Expand a payload node to view payload details.

7. Click the Flow tab to view the process flow. Additionally, click an activity (such as invoke, receive) to view the details of an activity.