This preface introduces the new and changed features of Oracle Service Bus and other significant changes that are described in this guide, and provides pointers to additional information. This document is the new edition of the formerly titled Oracle Fusion Middleware Developer's Guide for Oracle Service Bus.
For a list of known issues (release notes), see the "Known Issues for Oracle SOA Products and Oracle AIA Foundation Pack" at
For this release, both the developer's guide and the administrator's guide were changed significantly. All of the development information that was previously in both books was combined, streamlined, and moved into this guide, Developing Services with Oracle Service Bus. Administering Oracle Service Bus was rewritten and only includes tasks you can perform from Oracle Enterprise Manager Fusion Middleware Control and the administrative tasks available on the Oracle Service Bus Console.
For Oracle Service Bus 12c (12.1.3), this guide has been updated to include the following new and changed development features:
New editors in Oracle JDeveloper and the new Oracle Service Bus Console, which are described through this book. Support for JDeveloper is new. See Getting Started with Oracle Service Bus in JDeveloper. The web-based console has been redesigned. See Getting Started with the Oracle Service Bus Console.
The monitoring and runtime management features that were previously in the console are now provided in Oracle Enterprise Manager Fusion Middleware Control. See Administering Oracle Service Bus.
A new Overview Editor in JDeveloper for developing Service Bus services. Similar to the Composite Editor for Oracle SOA Suite, it lets you drag and drop components on to the editor to create services. The editor provides direct creation and editing of JCA adapters, REST bindings, and Service Bus services. See Developing Oracle Service Bus Applications in JDeveloper.
Support for REST services through the REST binding. See Creating REST Services with Oracle Service Bus .
Support for WebLogic Server's new Coherence container for business service result caching. This changes the way Coherence caches are configured and the way out-of-process Coherence caches are set up. See Improving Performance by Caching Business Service Results.
Pipelines are now a separate component from proxy services, and can be created and configured separately. See Working with Oracle Service Bus Pipelines. Additional pipeline enhancements include the following:
Creating pipeline templates on which to base new pipelines, allowing you to re-use your already developed message processing logic. See Working with Pipeline Templates.
Sharing variables among all pipelines in a chain, which allows them to read and modify the same variable. See How to Add Shared Variables to Pipelines in the Console and Adding Shared Variables to Pipelines in JDeveloper.
Sending and receiving attachments with the service callout action. See Using Attachments with Service Callout Messages.
Split-joins are a separate component, and can be created and configured separately. See Improving Service Performance with Split-Join.
Support for Oracle SOA Suite XSLT mappings. See Transforming Data with XSLT. Service Bus also supports dynamic XSLT expressions. See Binding Dynamic XSLT Expressions to Inline XQueries.
Support for all Oracle Web Services Manager (OWSM) policies. Certain policies can also be attached to JCA services and to REST services. See Securing Oracle Service Bus with Oracle Web Services Manager. More information is available in "Determining Which Predefined Policies to Use" in Securing Web Services and Managing Policies with Oracle Web Services Manager.
Support for WebLogic Server security policies is deprecated in this release. You can import services that use WLS9 policies from previous versions of Service Bus, and they will work in the runtime. However, WLS9 policies cannot be attached to new services, and Oracle recommends upgrading all policies to OWSM.
Support for credential mapping for business services with OWSM policies through the association of a service account resource. This allows service account overrides for outbound ID propagation policies.
Support for JDeveloper debugging tools, including setting breakpoints and stepping through message flows. The debugger is integrated with the Service Bus Test Console. See Debugging Oracle Service Bus Applications .
Sharing artifacts with Oracle SOA Suite using the Oracle Metadata Services (MDS) Repository in JDeveloper. See Sharing Data Using the Metadata Services Repository. Artifacts can also be shared from the application server, from the file system, and UDDI registries.
Importing and exporting resources and configurations from both JDeveloper and the Oracle Service Bus Console to either a configuration JAR file or to a WebLogic Server. See Importing and Exporting Resources and Configurations .
Support for the Maven project and build management system. See Using the Oracle Service Bus Development Maven Plug-In.
Several enhancements were made to Service Bus transports, including the following:
Support for all JCA adapters, as well as most JCA features, including streaming large messages. See Using the JCA Transport and JCA Adapters.
Support for JBoss with the EJB transport. See Working with JNDI Provider Resources.
Support for custom authorization for HTTP business services. See Configuring Business Services to Use the HTTP Transport and Using Custom Authentication for Outbound HTTP Security.
Support for retries for non-XA connection factories and for reading the replyTo header in the JMS transport. See Using the JMS Transport, specifically the configuration reference and Access to the JMSReplyTo Property.
The ability to log malformed XML payloads in the
$fault variable through a new
PayloadDetail element. See Fault Variable.
Support for custom MIME headers in the
$attachments variable. See Table A-2.