Split-Joins let you send message invocations in parallel (in addition to sequentially) and to aggregate the responses. To learn more about Split-Joins, see "Improving Service Performance with Split-Join" in the Oracle Fusion Middleware Administrator's Guide for Oracle Service Bus. See also, "Working with Split-Join" and the "Split-Join User Interface Reference" in the Oracle Fusion Middleware Developer's Guide for Oracle Service Bus.
You access Split-Joins through Flow transport-typed business services. For more information, see the Section 19.2.10, "Flow Transport Configuration Page."
To locate Split-Joins:
Do either of the following:
Select Project Explorer to display the Projects View page or the Project/Folder View page. Then navigate through projects and folders to find the Split-Join.
Select Resource Browser > Split-Joins. The Summary of Split-Joins page displays the information shown in Table 10-1. For a more detailed description of the properties, see Section 10.3, "Editing Split-Joins."
To restrict the number of items in the list, you can filter by name, path, or both. In the Name and Path fields, enter the name and path of the search target(s), then click Search.
Click View All to remove the search filters and display all Split-Joins.
| Property | Description |
|---|---|
|
Split-Join Name |
The name assigned to the Split-Join. The name is a link to the Split-Join Configuration page. See Section 10.3, "Editing Split-Joins." |
|
Path |
The path is the project name and the name of the folder in which the Split-Join resides. It is a link to the project or folder that contains this resource. See Section 4.1.1, "Qualifying Resource Names Using Projects and Folders." |
|
Options |
Click the Delete icon to delete a specific Split-Join. See Section 10.4, "Deleting Split-Joins." |
Before you begin
Split-Joins require a .flow file which is created when you create a Split-Join using the Oracle Service Bus plug-ins for Eclipse or when you import a Split-Join configuration JAR into the plug-in. The .flow file might have references to proxy services, business services, or to external WSDL resources. Resources on which the Split-Join depends must be present on the server before activating the Split-Join.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."
Select Project Explorer, then select a project or folder in which to add the Split-Join. The Project/Folder View page is displayed.
From the Create Resource list, select Split-Join to display the Create a New Split-Join Resource page.
Specify the parameters shown in Table 10-2.
Table 10-2 Split-Join Parameters
| Property | To create or edit... |
|---|---|
|
Resource Name |
Enter a unique name for this Split-Join. Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance. |
|
Resource Description |
Enter a description for the Split-Join. |
|
Split-Join |
Click Browse to locate a .flow file on your system, typically located under MW_HOME\user_projects\workspaces\your_workspace. |
|
Dispatch Policy |
Select the instance of WebLogic Server Work Manager used to create threads (parallel branches) to execute the Split-Join. The default Work Manager is used if no other Work Manager exists. For information about Work Managers, see:
|
Click Save. The Split-Join is created and saved in the current session.
Note:
Resources on which the Split-Join depends must be present before activating the Split-Join.To end the session and deploy the configuration to the run time, click Activate under Change Center.
To modify Split-Join properties:
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."
Locate the Split-Join, as described in Section 10.1, "Locating Split-Joins."
Click the Split-Join name.
The View a Split-Join - Configuration page displays the information shown in Table 10-3.
| Property | Description |
|---|---|
|
Last Modified By |
The user who created this Split-Join or imported it into the configuration. |
|
Last Modified On |
The date and time that the user created this Split-Join or imported it into the configuration. Click the date and time link to view the change history of this resource. See Section 4.23, "View Change History Page." |
|
References |
The number of objects that this Split-Join references. If such references exist, click the numeric link to view a list of the objects. See Section 4.22, "Viewing References to Resources." |
|
Referenced by |
The number of objects that reference this Split-Join. If such references exist, click the numeric link to view a list of the objects. See Section 4.22, "Viewing References to Resources." |
|
Description |
A description of this Split-Join, if one exists. |
You can make the following operational settings to a Split-Join:
Click Update to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
To delete a Split-Join:
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."
Select Resource Browser > Split-Joins to display the Summary of Split-Joins page.
Click the Delete icon in the Options field of the Split-Join you want to delete. The Split-Join is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
To end the session and deploy the configuration to the run time, click Activate under Change Center.