Departamento de Engenharia Informática. Systems Integration. SOA Adapters Tutorial. 1. Open SQL*Plus in order to run SQL commands.

Transcription

1 Departamento de Engenharia Informática Systems Integration SOA Adapters Tutorial IE 2016 In this tutorial, we shall create a BPEL process that uses two adapters, namely the file adapter and database adapter. Creating a Table in the Oracle Database 1. Open SQL*Plus in order to run SQL commands. 2. Login using the following command: CONNECT system/welcome1; 3. Create a new user with the following command: CREATE USER soa_user IDENTIFIED BY welcome1; 4. Grant connect and resource permission to the user with the following command: GRANT connect, resource TO soa_user; IST/DEI Pág. 1 de 22

2 5. Disconnect the current user (system) with the following command: DISCONNECT; 6. Login with the new user with the following command: CONNECT soa_user/welcome1; 7. Create the table account with the following commands: CREATE TABLE account( account_number varchar(10), branch_name varchar(15), balance numeric(10,2), primary key(account_number) ); INSERT INTO account VALUES('A-101','Downtown',500.00); INSERT INTO account VALUES('A-102','Perryridge',400.00); INSERT INTO account VALUES('A-201','Perryridge',900.00); INSERT INTO account VALUES('A-215','Mianus',700.00); INSERT INTO account VALUES('A-217','Brighton',750.00); INSERT INTO account VALUES('A-222','Redwood',700.00); INSERT INTO account VALUES('A-305','Round Hill',350.00); INSERT INTO account VALUES('A-333','Central',850.00); INSERT INTO account VALUES('A-444','North Town',625.00); IST/DEI Pág. 2 de 22

3 8. Execute the following command to commit the inserts: COMMIT; 9. Use the following command to check if the table was created: SELECT * FROM account; Creating a JDBC Data Source (i.e., a reference to the database) 10. Open the VM Control Center and check if the AdminServer is running. If not, start it. 11. In Firefox, access the WebLogic Server Administration Console with the following URL: Login with the user weblogic and password welcome1 13. Expand Services in the left menu and click on DataSources. 14. Click on the New button and select Generic Data Source. IST/DEI Pág. 3 de 22

4 15. Change the name to Account Data Source 16. Add the following JNDI Name: jdbc/accountdb 17. Select Oracle as the Database type. 18. Click on Next. 19. Use the default Database Driver suggestion. 20. Click on Next. 21. Click on Next in the Transaction Options step. IST/DEI Pág. 4 de 22

5 22. Fill out the form with the following information: Database Name: XE Host Name: localhost Port: 1521 Database User Name: soa_user Password (and Confirm Password): welcome1 23. Click on Next. 24. Click on the Test Configuration button. 25. Click on Next. 26. Select AdminServer as the target server to deploy the data source. 27. Click on Finish. IST/DEI Pág. 5 de 22

6 Creating a Connection Pool (i.e., a reference to the data source) 28. In the left menu of the WebLogic Server Administration Console, click on Deployments. 29. In the Deployments table (right hand side), click on DBAdapter. 30. Click on the Configuration tab. 31. Click on the Outbound Connection Pools tab. IST/DEI Pág. 6 de 22

7 32. Click on the New button. 33. Select 'javax.resource.cci.connectionfactory' and click on the Next button. 34. Add the following JNDI Name: eis/db/mydb 35. Click on the Next button. IST/DEI Pág. 7 de 22

8 36. Click on the Finish button. The following message should appear. 37. In the Outbound Connection Pool Configuration Table, expand 'javax.resource.cci.connectionfactory' 38. Click on 'eis/db/mydb' 39. Edit the property xadatasourcename by clicking on Property Value column. Add the value jdbc/accountdb and press Enter. IST/DEI Pág. 8 de 22

9 40. Click on the Save button. The following message should appear. 41. Click on Deployments again (left menu). 42. In the Deployments table (right hand side), Select DBAdapter. 43. Click on the Update button. 44. The following page should appear. Click on the Finish button IST/DEI Pág. 9 de 22

10 45. The following message should appear. Using the Database Adapter in a BPEL process 46. Create an application and project in JDeveloper with following these steps: In the menu, select File -> New... In the Categories pane, select General. Click on Generic Application and on the OK button. In the Create Generic Application window, change the Application Name to SOAAdaptersExample and click on Next. In Step 2 of the Create Generic Application window, change the Project Name to AdaptersPrj. Within the Project Technologies tab, click on SOA and on the right arrow button (i.e, > ). i. SOA should appear in the Selected pane as shown below. Click on Next. IST/DEI Pág. 10 de 22

11 In Step 3, change the Composite Name to SOAAdaptersExample and select Empty Composite in the Composite Template pane. Click on Finish 47. We will now create the schema for the input and output messages of the BPEL process. In the Application Navigator pane, right-click on the AdaptersPrj node and then click on New Select the All Technologies tab within the New Gallery window. 49. Select General XML in the Categories pane and click on XML Schemas in the Items pane (as shown below). Click on the OK button. 50. In the Create XML schema window, change the File Name to Account.xsd and click OK. 51. Create the following schema (Recall that you have learned how to create schemas in the XML Tutorial). IST/DEI Pág. 11 de 22

12 52. Select SOAAdaptersExample (composite.xml) in the Design view. This is the Composite Application Diagram which currently contains no service components. 53. Drag-and-drop the BPEL process to the Components lane. 54. The Create BPEL Process should open automatically. Change the following information: Select BPEL 2.0 Specification Name: AdaptersProcess Template: Synchronous BPEL Process The checkbox Expose as a SOAP service should be selected 55. In the Create BPEL Process window, click on the Browse Input Elements as shown below. 56. In the Type Chooser window, expand Project Schema Files and Account.xsd. Click on the Request. Click on the OK button. 57. In the Create BPEL Process window, click on the Browse Output Elements (under the Browse Input Elements). IST/DEI Pág. 12 de 22

13 58. In the Type Chooser window, expand Project Schema Files and Account.xsd. Click on the Response. Click on the OK button. 59. In the Create BPEL Process window, Click on the OK button. 60. We will now add a Database adapter to the Composite Application Diagram. Drag and drop the Database Adapter in the Component Palette to the External References lane. 61. The Adapter Configuration Wizard window opens automatically. Click on the Next button. IST/DEI Pág. 13 de 22

14 62. Add AccountDB as the Service Name. Click on the Next button. 63. Create a new Database connection by click on the + symbol as shown below. 64. The Create Database Connection window opens. Change the Connection Name to ConncetionDB. Add the Username (soa_user) and Password (welcome1). Click on the Test Connection button. If a Success! message appears, click on the OK button. IST/DEI Pág. 14 de 22

15 65. In the Step 3 of the Wizard, change the JNDI Name so that it matches the name of the connection pool that was created in this tutorial (eis/db/mydb). Click on the Next button. 66. In Step 4 of the Wizard, select Perform an Operation on a Table and only Select By Primary Key. Click on the Next button. 67. In Step 5 of the Wizard, click on the Import Tables button. IST/DEI Pág. 15 de 22

16 68. In Import Tables window, click on the Query button. Click on the ACCONT table in the Available box and then click on the >> button (the ACCOUNT table should appear in the Selected box as shown below). Click on the OK button. 69. In Step 5 of the Wizard, click on the Next button. 70. In Step 6 of the Wizard, there are no relationships with the selected table. Hence, click on the Next button. 71. In Step 7 of the Wizard, select all the attributes of the table. Click on the Next button. IST/DEI Pág. 16 de 22

17 72. In Step 8 of the Wizard, we will use the default values for the Advanced Options. Hence, click on the Next button. 73. In Step 9 of the Wizard, click on the Finish button. 74. In the Composite Application Diagram, add a wire from the BPEL process to the Database Adapter as shown below. 75. Open the AdaptersProcess.bpel in the Application Navigator (recall that you can also open the AdaptersProcess.bpel by double-clicking the BPEL service component on the composite application diagram). 76. Add an Assign activity between the receiveinput and replyoutput. 77. Add an Invoke activity below the Assign activity. 78. Add a wire from the Invoke activity to the AccountDB in the Partner Links lane. Configure the Invoke and do not forget to set the input and output variables. 79. Configure the Assign activity to copy the account number from the input variable of the BPEL process to the input variable of the Invoke activity. 80. Add a Transform activity (in Oracle Extensions within the Component Palette) below the Invoke activity. Double click the Transform activity. IST/DEI Pág. 17 de 22

18 81. In the Edit Transform window, add a source variable by clicking on the + as shown above. 82. In the Source Variable window, select the output variable of the Invoke activity as shown below. Click on the OK button. 83. In the Edit Transform window, select the output variable of the BPEL process from the options in the Target Variable as shown below. Click on the OK button. 84. In the xsl file, add a wire from accountnumber to AcountNumber, from branchname to BranchName, and from balance to Balance as shown below. 85. Save all your files. IST/DEI Pág. 18 de 22

19 86. Your diagram should look like this: 87. Deploy the application to the server. 88. Test the application with the Enterprise Manager 11g. Using the File Adapter in a BPEL process 89. We will now add a File Adapter to the Composite Application Diagram. Drag and drop the File Adapter in the Component Palette to the External References lane. 90. The File Adapter Configuration Wizard window opens automatically. Click on the Next button. IST/DEI Pág. 19 de 22

20 91. In Step 2 of the Wizard, add the following Service Name: FileService. Click on the Next button. 92. In Step 3 of the Wizard, select the option Define from operation and schema (specified later). Click on the Next button. 93. In Step 4 of the Wizard, select the Write file option. Click on the Next button. 94. In Step 5 of the Wizard, click on the Browse button in order to define a physical location of the outgoing file. Add the name infoaccount_%seq%.txt for the File Naming Convention text field. Click on the Next button. 95. In Step 6 of the Wizard, click on browse for schema file icon as shown below. IST/DEI Pág. 20 de 22

21 96. In the Type Chooser window, expand Account.xsd and select the Response element. Click on the OK Button 97. In Step 6 of the Wizard, click on the Next button. 98. In Step 7 of the Wizard, click on the Finish button. 99. In the Composite Application Diagram, add a wire from the BPEL process to the File Adapter as shown below Open the AdaptersProcess.bpel Add a Transform and Invoke activity above the Reply activity Add a wire from the Invoke activity to the FileService in the Partner Links lane. Configure the Invoke and do not forget to set the input variable Configure the Transform activity in order to copy the information from the output of the Database service to the input variable of the File service (see example below). IST/DEI Pág. 21 de 22

22 104. Your diagram should look like this: 105. Deploy the application to the server Test the application with the Enterprise Manager 11g. IST/DEI Pág. 22 de 22