Oracle Socket Adapter Integration with Mediator Oracle Socket Adapter Integration with Oracle BPEL PM

Oracle JCA Adapter for Sockets 5-3 Figure 5–2 The Adapter Configuration Wizard - Welcome Page This wizard enables you to configure an Oracle Socket Adapter. The Adapter Configuration Wizard then prompts you to enter a service name, as shown in Figure 5–3 . Figure 5–3 The Adapter Configuration Wizard Service Name Page When configuration is complete, a WSDL file of the same name is created in the Application Navigator section of JDeveloper. This WSDL file contains the configuration information you specify in the Adapter Configuration Wizard. 5-4 Oracle Fusion Middleware Users Guide for Technology Adapters The Operation Type page of the Adapter Configuration Wizard prompts you to select an operation to perform. Based on your selection, different Adapter Configuration Wizard pages appear and prompt you for configuration information. For more information about Oracle JCA Adapter integration with Oracle BPEL PM, see Section 3.2, Adapter Integration with Oracle Fusion Middleware.

5.1.4 Oracle Socket Adapter Integration with SOA Composite

A composite is an assembly of services, service components Oracle BPEL PM and Mediator, wires, and references designed and deployed together in a single application. The composite processes the information described in the messages. The details of the composite are stored in the composite.xml file. For more information on integration of the Oracle Socket Adapter with SOA composite, see Section 3.2.4, Oracle SOA Composite Integration with Adapters.

5.2 Oracle Socket Adapter Features

Oracle Socket Adapter enables you to configure a BPEL process or a Mediator service to read and write data over TCPIP sockets. It includes the following features: ■ Allows modeling of standard or nonstandard protocols for communication over TCPIP sockets ■ Supports both inbound and outbound communication ■ Allows you to model complex protocol handshakes declaratively, by using XSL ■ Allows you the option of plugging in custom Java code to model a protocol handshake ■ Provides support for reading and writing native data over sockets as the adapter is integrated with the translator infrastructure NXSD ■ Supports multiple character encoding

5.3 Oracle Socket Adapter Concepts

This section describes the following Oracle Socket Adapter concepts: ■ Section 5.3.1, Communication Modes ■ Section 5.3.2, Mechanisms for Defining Protocols ■ Section 5.3.3, Character Encoding and Byte Order ■ Section 5.3.4, Performance Tuning

5.3.1 Communication Modes

Oracle Socket Adapter supports inbound and outbound communication over sockets that can be unidirectional or bidirectional. The communication modes of Oracle Socket Adapter are discussed in the following sections: ■ Section 5.3.1.1, Inbound Synchronous RequestResponse ■ Section 5.3.1.2, Outbound Synchronous RequestResponse ■ Section 5.3.1.3, Inbound Receive ■ Section 5.3.1.4, Outbound Invoke Oracle JCA Adapter for Sockets 5-5

5.3.1.1 Inbound Synchronous RequestResponse

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 requestresponse scenario. Figure 5–4 BPEL Scenario of Inbound Synchronous RequestResponse

5.3.1.2 Outbound Synchronous RequestResponse

In the case of outbound synchronous requestresponse, 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 requestresponse scenario. Figure 5–5 BPEL Scenario of Outbound Synchronous RequestResponse