ORACLE SERVICE BUS PDF
Discuss several SOA requirements that can be addressed using a Service Bus. • Explain the relationships between WSDL, XPath,. XQuery, and ALSB. November Documentation for developers that describes how to use the. Oracle Service Bus Console and Oracle JDeveloper to create and configure proxy. Oracle Service Bus. Situation. A service oriented architecture must be flexible for changing interfaces, transport protocols and server locations - service clients.
|Language:||English, Spanish, Japanese|
|Genre:||Fiction & Literature|
|ePub File Size:||19.33 MB|
|PDF File Size:||8.21 MB|
|Distribution:||Free* [*Regsitration Required]|
5 3 Getting Started with the Oracle Service Bus Tutorials. You can run the examples to see how Oracle Service Bus operates in the run-time Download pdf. Service Bus 12c - A Hands-on myavr.info - Free ebook download as PDF File . pdf), Text File .txt) or read book online for free. And Oracle Service Bus (OSB). Oracle Service myavr.info - Free download as PDF File .pdf), Text File .txt) or view presentation slides online.
A pipeline is a named sequence of stages containing actions, representing a non-branching one- way processing path. It is used to specify the message flow for service requests and responses. A stage is a user-configured processing step. They can be accessed or modified by actions in the pipeline stages.
Pipeline Pairs Pipeline pairs are request and response pipelines. The request pipeline definition specifies the actions that Oracle Service Bus performs on request messages to the proxy service before invoking a business service or another proxy service. The response pipeline definition specifies the processing that Oracle Service Bus performs on responses from the business or proxy service that the proxy service invokes before returning a response to a client.
Each pipeline consists of a sequence of stages, each stage containing actions. However, a single service-level request pipeline might optionally branch out into operational pipelines you can configure one default operational pipeline at most one per operation. The determination of the operation is done through user-selected criteria. The response processing starts with the relevant operation pipeline which then joins into a single service-level response pipeline.
The following figure illustrates sample operation pipelines in a proxy service. In the tutorials, you will use the console to create the proxy services that interact with the service clients and business services.
As you work through the tutorials, you will: See how Oracle Service Bus uses session management to allow configuration changes locally, and then instantiate the changes in the core environment. Route messages according to XQuery-based policies or callouts to external Web services.
See how Oracle Service Bus manages synchronous and asynchronous messages. Define a transformation on an XML message, based on XQuery, supporting a callout to a Web service to gather additional data for the transformation. See how message processing by Oracle Service Bus is driven by metadata specified as the message flow definition for a proxy service in the Oracle Service Bus Console. Test proxy services and business services.
Gain a better understanding of the concepts underlying Oracle Service Bus. Learn how to navigate through the Oracle Service Bus Console and demonstrate the capabilities of the console. Perform the basic tasks that will help you to configure specific scenarios. You will learn how to configure and use Oracle Service Bus to resolve the business scenarios presented in the specified use cases.
After you complete the Getting Started steps for the tutorials, complete the first tutorial, Routing a loan application, to become familiar with Oracle Service Bus, then proceed to the other tutorials in any order.
The tutorials include: Routing a Loan Application is based on scenarios that demonstrate how Oracle Service Bus facilitates the routing of messages within an enterprise.
Transforming a Loan Application describes how a proxy service is configured with a routing node, transformations, and a Web service callout Service Callout to allow content-based routing and message enrichment through Oracle Service Bus. Validating a Loan Application describes how a Oracle Service Bus proxy service can be configured to validate a message passing from a client to a business service.
This section describes the tasks required to configure the Oracle Service Bus and Oracle WebLogic Server environment to deploy the business cases used in the tutorials. The Oracle Service Bus example suite is used as a basis for instruction in the following tutorials.
This topic consists of the following sections: Scenarios in the Tutorials Setting Up the Tutorials After completing this section, you will know how to deploy a typical Oracle Service Bus environment in which you can define resources and design Web services.
You must complete all the tasks in this section before you start the tutorials. Scenarios in the Tutorials The tutorials are based on a mortgage broker scenario describing a typical loan application process.
A primary mortgage company uses Oracle Service Bus to route loan applications to appropriate business services. The loan applications are routed to different business services depending on qualifying criteria, such as the requested interest rate and the requested principal amount.
In the first tutorial, you will become familiar with the basic functionality of Oracle Service Bus that facilitates Web service mediation, including message routing and Web service resource creation. In subsequent tutorials you will develop and customize Web services for routing, transforming and validating a loan application.
Setting Up the Tutorials Do the following to set up and run the tutorials: Create an Oracle Service Bus Domain 2. Start Oracle Service Bus 3. Log in to Oracle Service Bus Console The files including pre-built business services that support the building of the tutorial solutions are located in the following directory: The tutorial files contain properties that you must set to run the tutorials. In the tutorial, you can use four different business services. Each business service also has a set of files associated with it.
The structure for each of the business services is the same. The directory structure for one of the business services—the NormalLoan business service, is described in Table and Table You can explore the other directories as an exercise.
The example and tutorials are based on using an Admin-only domain. If the tutorial domain you create includes managed servers, you may need to change the port numbers in the services you create to the correct managed server ports.
The following client jars are available: Figure Summary of Deployments 3. Click Install. Click Next to choose the targeting style. Accept the remaining defaults by clicking Next, then click Finish. The application is deployed automatically. Log in to Oracle Service Bus Console Oracle Service Bus Console is a Web services management dashboard that allows you to monitor Web services and servers and perform service management tasks. The console enables you to perform operational tasks such as configuring proxy and business services, setting up security, managing resources, and capturing data for tracking or regulatory auditing.
It provides views to monitor current state and health of the Oracle Service Bus environment by displaying detailed statistics about servers, services, and alerts.
The Oracle Service Bus Console also enables you respond rapidly and effectively to changes in your service-oriented environment. Where to Go from Here After you complete the tasks required to set up the tutorials, you can proceed to 4 Tutorial 1.
Routing a Loan Application which describes how you can configure Oracle Service Bus with the resources required for the loan application routing scenario.
Each of the tutorials include instructions to design and configure the Oracle Service Bus resources, and procedures you can use to test the completed configurations.
Routing a Loan Application Oracle Service Bus enables adaptive message routing between business services in an enterprise environment. Messages can be routed from a client through the Oracle Service Bus intermediary, to the appropriate business service. Oracle Service Bus routes messages to one or more destinations, based on the actions configured in the message processing logic. These routing actions are configured using Oracle Service Bus Console. Routing provides an efficient alternative to building a multitude of static point-to-point Web service connections between pairs of systems.
This section includes the following topics: Tutorial Objectives The objective of this tutorial is to create and test a routing scenario using the graphical environment provided in Oracle Service Bus Console. It includes the following tasks: All other loan applications are routed to the appropriate business service for processing.
Figure summarizes the logical architecture to support this scenario. It illustrates how Oracle Service Bus mediates the messaging between the clients and the business services in your enterprise. The default proxy service has a conditional routing stage that checks the value of the requested interest rate in the loan application document. The target business service returns a response similar to that shown in Figure Tasks in This Tutorial In this tutorial, Oracle Service Bus is used to route a loan application within a mortgage company to a target a Web service depending on the interest rate requested.
Perform the following tasks to design and configure a proxy service and the associated resources in Oracle Service Bus to implement this use case scenario. Prepare the Environment Ensure that Oracle Service Bus is running in the domain that you have created for the tutorial and that you have completed the tasks described in Setting Up the Tutorials.
You can perform system monitoring without initiating a session. However, you must first create an session in the Oracle Service Bus Console to update or delete resources and modify their configuration properties. The Change Center in the console allows you to create and manage sessions.
All updates to the system configuration during the current session are saved as temporary files. These changes effective only when the current session is activated. You must create a session to make changes to the configuration.
You can exit this session using the Exit function, then re- enter it by clicking Edit. Once in the session, you can continue to modify the resources. Edit Enter a session that you previously created and exited. You must activate a session before you can use Edit. Exit Discontinue the session and save the session state. Click Edit to re-enter the discontinued session. Discard End the current session without saving the changes.
Activate Save the current session's configuration to the run time. When you click Activate, the Activate Session page is displayed. In this page, the user and session name of the session are displayed. If required, you can add a description. Click Submit to save the current session's configuration to the run time. It is recommended that you click Create before modifying any system configuration settings on the console.
It is a good practice to save your configuration changes incrementally and enter comments for those changes. To save and activate configuration changes in the current session, you must click Activate after you have completed making a set of changes. On Oracle Service Bus Console, the Project Explorer page displays a default project and the various user defined projects under the Projects folder.
This page allows you to perform all project configuration tasks. Each project is represented by a project folder on the console. You can add new project folders and navigate the project trees. You can collapse and expand folders as required by clicking them. There are pre-defined resources types in the Oracle Service Bus system environment. Each resource type is represented as a sub folder within the Project folder.
You can create and configure resources of different types within the resource type folders. This section describes the tasks to start a session and create a MortgageBroker project under the Projects folder.
For this scenario, you will create three resource folders in the MortgageBroker project to hold each of the following pre-defined resource types: The project explorer opens in the navigation pane and a Project page is displayed on the console. Click Add Project. The WSDLs are the basis on which you create the business services and the proxy service. You subsequently create other folders and resources for this scenario.
To Create a Project Folder 1. In the project explorer, click the MortgageBroker project to open the associated project page. On the Project page, in Folders, enter the folder name in the field provided.
Figure Create a Folders 3. Click Add Folder. Repeat the previous steps to create the following additional folders: ProxyService and BusinessService. When all three folders are created, click Activate, enter a description of the changes you just made, and click Submit to save the project directory structure. Each configuration wizard includes a sequence of pages that prompt you for information about the resource and provide property configuration options.
It is the formal description of a Web service. A WSDL is used to describe what a Web service's interface is, where it resides, and how to invoke it. You create the WSDL resource first since subsequent service registration tasks depend on it. The WSDL is subsequently used to register the business service with the proxy service. In the project explorer, click the WSDL folder you created. Enter normalLoan as the resource name.
Click Browse. Select the WSDL associated with the normal loan process: In Oracle Service Bus Optionally, enter information in the Resource Description field to describe the resource.
The resource is now displayed in the resources pane, as shown in Figure Click Activate in the Change Center to activate the session. Activate the session. Create a Proxy Service In this section, you will create a proxy service. The proxy service is used to route the loan application to the appropriate business service. To Create the Proxy Service 1. In the Project Explorer, select the MortgageBroker project. The project folder is expanded to show the directory structure of the project.
Select the ProxyService folder. Give the proxy service a Service Name of LoanGateway1. The proxy service is based on the WSDL resource that you originally created, hence you must reference the resource here.
Click Submit. Click Next to continue configuring the proxy service. Accept the default protocol, http. The protocol you select on this page determines the format for the endpoint URI that you will specify in the next step.
The assumed default protocol is http since it is used by most services. This is the URI to which the client will send its messages. Click Next. On the Message Handling page, click Next. The Create a Proxy Service — Summary page is displayed. This page shows a summary of configuration settings for the proxy service. The default service is an RPC Web service. As a result, the SOAP body contains the service operation selection information.
If there are multiple public methods accessible to a client, each public method type will have an operation definition in the WSDL. The SOAP header can also specify the operation. However, by convention, the SOAP body defines this. Before registering the proxy service, you can review the configuration settings and change them if necessary, by clicking Edit icon.
After reviewing the proxy service configuration settings, click Save to register the service. The View a Proxy Service page is displayed. The Operational Settings tab, as shown in Figure , has options to enable monitoring for the proxy service.
Click the Operational Settings tab. Select the Enable Pipeline Monitoring check box for the Monitoring setting. Choose an aggregation interval for the service. The aggregation interval is the period over which aggregated statistics related to the service are computed for display in the Oracle Service Bus Console dashboard. You can also accept the default value for the Aggregation Interval, which is set to five minutes.
Click Update. Create the NormalLoan Business Service 1. In the Project Explorer, select the BusinessService folder. Enter a name for the service.
In this case, enter NormalLoan. Select the WSDL and port on which to base the business service: Select none for the Load Balancing Algorithm, since load balancing is relevant only when a service specifies multiple end points. When you specify multiple end points and a load balancing algorithm, if one end point is overloaded or not available at run time, the message can be sent to the next service in the list of end point URIs.
In this case, there is only one service, therefore accepting the default behavior or selecting none does not affect the behavior of the proxy service at run time. Accept the default settings for the remaining options on the page and click Next. In the Message Handling page, click Next. The Create a Business Service-Summary page is displayed. You can now check if all the settings of the business service have been implemented correctly. Click Save to accept the configuration settings. To turn on monitoring for the NormalLoan business service, click the NormalLoan business service in the Resources pane.
The View a Business Service page is displayed. The Operational Settings tab on this page has options to enable monitoring for the business service. To enable monitoring: Select the Enabled check box for the Monitoring field.
Follow the same tasks as described in the previous section on creating the ManagerLoanReview business service, but use the configuration parameters in the following table. Once you have configured the proxy service with a base configuration you can proceed to the next task Configure the LoanGateway1 Proxy Service to complete the configuration of the proxy service by adding the routing behavior for the loan application in the proxy service message flow.
Message flows can include zero or more pipeline pairs: Pipelines can include one or more stages, which in turn include actions. Configure the Routing Behavior of the Message Flow 1. Click LoanGateway1, and select Add Route from the menu options. RouteNode1 is added in the configuration page as shown in Figure Figure Add a Route Node 5.
Click RouteNode1 and select Edit Route from the menu options. The Edit Stage Configuration: Route Node page is displayed as shown in Figure This page contains a single Add an Action link. A stage is an element of a pipeline and also a container for actions defined in a pipeline. Actions are the elements of a pipeline stage that define the handling of messages as they flow through a proxy service at run time.
The Edit Stage Configuration page changes to display routing table configuration page, as shown in the following figure. Figure Routing Table Configuration Page You must configure the routing table to route messages to business services based on the value of the interest rate element in the incoming message. The XQuery Expression Editor is displayed.
In the left pane, click Variable Structures. The Variable Structures pane is displayed. Select body from the Select Structure list. A graphical representation of the structure of the loanRequest document is displayed. At run time, the proxy service makes its routing decision based on the value in the Rate element of the message.
Figure loanRequest Element Click the Rate element. The property appears below the XQuery editor in the Property Inspector field. The following XQuery expression is written in the text box: Rate Note: Click Validate to validate the XQuery. It is a good practice to do this before you submit the expression.
The expression is validated for syntax. If there are errors in the expression, they are displayed directly above the Validate button. Figure XQuery Validation Click Save. The routing table is displayed on the Edit Stage Configuration page. Figure Routing Table View - Expression In the associated text field enter the number 5. If the value in the rate element is less than 5, you must route according to the routing table configuration. Click the Service link to define the service to which you want to route messages when the rate is less than five.
Oracle Service Bus Examples and Tutorials
The Select Service page is displayed. Select the ManagerLoanReview business service. This is the operation on the ManagerLoanReview business service that is invoked at run-time if the rate requested in the loan application is less than 5.
If the rate specified in the loan application is equal to or greater than five percent, then the message is routed to the NormalLoan business service. The next section describes how you can add a condition to the routing table to account for this case which is the default case. The else condition default case is added to the routing table. In the Default else condition, click the Service link. Select the NormalLoan business service. In the Operation list, select the processLoanApp operation for the service.
This step completes the configuration of the message flow in the route node: Click Validate to validate the RouteNode1 routing configuration. In the Change Center, Activate the session. A message is routed to the ManagerLoanReview business service if the rate specified in the loan application is less than 5.
Otherwise the message is routed to the NormalLoan business service. The routing behavior for the proxy service LoanGateway1 in this scenario is based on the interest rate requested in the loan application message. A change in the value of the interest rate results in a change in the routing behavior as follows: A value of 4.
A value of 5. In Oracle Service Bus Console, make sure the current session is activated. Figure Test Console for LoanGateway1 4. Replace the default payload in loanRequest field with the following code: Accept other default settings and click Execute.
The response as in Figure 4- 30 is obtained. Figure Response from the ManagerLoanApplicationReview Service The Invocation Trace section of the test console indicates that the proxy service routed the request to ManagerLoanReview business service because the interest rate requested is 4.
In Oracle Service Bus Console, make sure the session is activated. The response as in Figure is obtained. Where to go From Here After completing Tutorial 1. Routing a Loan Application proceed to 5 Tutorial 2. Transforming a Loan Application. Transforming a Loan Application Data transformation is the mapping of data from one format to another, to make information compatible in heterogeneous system environments.
Oracle Service Bus can be configured to route and transforms messages when necessary, based on specific proxy service configurations.
Oracle Service Bus.pdf
Routing a Loan Application before beginning this tutorial. Tutorial Objectives This tutorial provides the tasks to create and test a routing and transformation scenario developed using the graphical environment provided in Oracle Service Bus Console. Routing a Loan Application to perform the following tasks: Configure content-based routing. Use an XPath expression to change the content in the message body.
Definition of the Scenario A primary mortgage company uses Oracle Service Bus to identify and re-route loan applications that can be sold to secondary loan companies. When Oracle Service Bus receives a loan application meeting these criteria, the applicant's credit rating information is retrieved by making a callout to a Web service.
The credit rating information is added to the loan application. The application is then forwarded to the secondary mortgage company Web service to be processed.
The target business services respond indicating whether the loan application is approved or rejected. Figure illustrates where Oracle Service Bus fits in your enterprise to mediate the messaging between the enterprise services and the business services. It is routed through the Oracle Service Bus proxy service, LoanGateway2, to determine the target business service to process the application.
To fulfill the interface requirements of the secondary loan company service, the message body is transformed by adding the credit rating details. The service returns a response similar to the following: Loan Application Response: The resources required for this scenario are described in the following table.
Tasks in This Tutorial In this tutorial, you will perform the following tasks: Import additional WSDL resources Register new business services and proxy services Configure the routing behavior for the proxy service, by executing the following tasks: Prepare the Environment Ensure that Oracle Service Bus is running in the domain that you created for the tutorial and that you have completed the tasks described in 4 Tutorial 1.
Routing a Loan Application. Create a Session For this tutorial, you need to use the MortgageBroker project folder, and the directory structure that you created in 4 Tutorial 1.
Routing a Loan Application to hold the project artifacts. The project explorer pane is opened in the navigation pane and a project page is displayed in the console. In the project explorer, expand the MortgageBroker project tree to expose the subfolders containing the project artifacts: Complete the following steps to create the necessary resources.
Be sure to Activate your session after creating the resources. WSDL resources are the building blocks for creating the business and proxy services.
However, for this instance, name your resources and base them on the WSDLs listed in the following table. Routing a Loan Application as shown in Figure No units are assigned to the loan amount, but units can be any currency such as US dollars. To create a new proxy service, LoanGateway2, follow the tasks described in Create a Proxy Service For this instance, use the proxy service name and the endpoint URI listed in the following table. Figure Proxy Service Resources Create a Business Service In this scenario, the proxy service is configured to route to one of several different business services, depending on the business requirements as follows: NormalLoan you have already created this — The secondary mortgage company's business service.
Oracle Service Bus 12C: Enabling Attachment Support
CreditRatingService — Returns the customer's credit rating when a loan application meeting specified criteria is received. This is implemented using a Web service callout Service Callout. LoanSaleProcessor — The secondary mortgage company's business service. You created the NormalLoan service in 4 Tutorial 1.
You must configure your services using the names, service types, and endpoint URIs listed in the following two tables. You have also configured the proxy service with a base configuration. In the following three tasks you will configure the proxy service by adding the routing, transformation, and Service Callout behavior for the loan application messages.
Complete the following tasks. Create a Routing Table 1. The Resource Browser pane is opened in the navigation pane and the Summary of Proxy Services page is displayed in the console. Click LoanGateway2, then select Add Route from the menu. In the configuration dialog, RouteNode1 is added.
Click RouteNode1 and select Edit Route from the menu. Figure Add an Action Link 5. The Edit Stage Configuration page changes to display the routing table configuration information. Configure the Routing Expression 1. In the Namespace Definitions pane, click Variable Structures. Select body from the Select Structure list in the Variable Structures pane.
A structural representation of the body element is displayed in the Variable Structures pane. A graphical representation of the structure of the loan application document is displayed. At run time, the proxy service makes its routing decision based on the value in the amount element of the message. Click the Amount element. Amount Note: Select LoanSaleProcessor, and click Submit.
In the Operation list, select the processLoanApp operation. You have now defined the case for routing the loan application to the LoanSaleProcessor business service as shown in Figure The application is then forwarded to the secondary mortgage company's business service to be processed. Configure Routing Request Actions for LoanGateway2 Proxy Service This section describes how to configure the proxy service to do the Service Callout and transform the message appropriately for the target service.
Before adding the Service Callout action, you must configure the Service Callout input parameter by performing the following tasks: Delete the "xsi: The XPath Expression editor is displayed. In the XPath Expression text box, enter the following expression: Click Validate, then Save. You will return to the Edit Stage Configuration page. The configuration for the Delete action is therefore: The XQuery Expression editor is displayed.
This article has multiple issues. Please help improve it or discuss these issues on the talk page. Learn how and when to remove these template messages. This article may contain excessive or inappropriate references to self-published sources.
Please help improve it by removing references to unreliable sources , where they are used inappropriately. March Learn how and when to remove this template message. This article possibly contains original research. Please improve it by verifying the claims made and adding inline citations.
Statements consisting only of original research should be removed. October Learn how and when to remove this template message. This article needs to be updated. Please update this article to reflect recent events or newly available information. April This article uses abbreviations that may be confusing or ambiguous. There might be a discussion about this on the talk page. Please improve this article if you can.Transforming a Loan Application before beginning this tutorial: The next section describes how you can add a condition to the routing table to account for this case which is the default case.
Validate Email element for proper format and return fault on validation failure. Both source and targets have single element CustomerID and finish mapping as shown below.
Click save icon and give file name as SampleCustomerInput.
Next step is to send the file we have retrieved from the FTP server and this part will be some more work. Click List of variables button highlighted above to bring Edit Variable window and select the options as shown below so that sample input will be generated automatically.
Accept the default protocol, http.