Creating a Web Service Using Top-Down Development

Oracle JDeveloper support multiple ways of creating Web Services. JDeveloper wizards include the ability to create Web Services from EJBs, POJOs (Plain Old Java Objects), Database DML and PL/SQL, JMS and others. In this lab we’ll use what’s often described as a best practice in Service Oriented Architectures: Top-Down development. Using this method we start by using WSDL and let JDeveloper generate the Java Web Service from there. All we have to do from that point is include our service specific code deploy to the application server.

We will be creating a CreditScore service that accepts a Social Security number and returns a score based on certain SSN criteria. For simplicity sake, we will return a score in of “583” if the SSN begins with a 1, “644” if the SSN begins with a 2, and “721” if the SSN begins with 3.

Create the JDeveloper Application and Project

By default in this installation JDeveloper will create workspaces and projects within the /home/oracle/jdevleoper/mywork sub-directory.

Perform the following steps:

  1. If it’s not already started double click on the Start/Stop Weblogic Server(s) Desktop icon or right click on it and select “Open”.

2.  At the pop up click OK to select the default: Start

  1. At the next pop up leave the default and click OK. After 7-9 minutes the server is started.
  1. A status dialog is displayed. When “Starting Admin Server………OK” is displayed click Close.
  1. Verify that all but OSB was started and click Close.
  1. Start JDeveloper by double clicking on the JDeveloper 11g icon on the Desktop OR right-click on the icon and select “Open”:
  1. Create a new Application by selecting FileàNew. This will open up a dialog box.

  1. With the General category selected choose the Generic Application item and click OK.

  1. Set the Application Name to CreditScore and click Next.

  1. At the step 2 dialog, set the Project Name to CreditScore. Under the Project Technologies Tab, select the Web Services technology in the “Available:” box and move it into the “Selected:” box by clicking the right arrow button . The completed dialog should look like:

  1. Click Finish. The Workspace and Project are created.
  1. Right click on the CreditScore project and select New.

  1. In the New Gallery dialog navigate to Web Services under the Business Tier category and select the “Java Web Service from WSDL” item. Click OK.

  1. The Create java Web Service from WSDL wizard comes up. Click Next at step 1.
  1. At step 2 select the default Java EE 1.5 with support for JAX-WS annotations. Click Next.
  1. At step three click the Browse button. We are going to use a WSDL in the /home/oracle/MyFiles directory called CreditScoreService.wsdl.
  1. We are going to use a WSDL in the /home/oracle/MyFiles directory called CreditScoreService.wsdl. Navigate to the MyFiles directory by clicking the Browse button and then select this file. Click Open and then Finish.
  1. At this point JDeveloper generates the java classes based on the WSDL definition. It will be our responsibility to define what the web service will actually do.
  1. From the Application Navigator Projects tab right click on the CreditScorePortImpl.java source file under CreditScoreàApplication Sourcesàcom.example.globalcompanyànsàcreditscoreservice and click Open.
  1. Into this java code we will cut and paste some pre-created source to define what this Web Service does. Minimize JDeveloper and open up a Terminal window from the Desktop by double clicking on the Terminal icon OR right clicking on the icon and selecting Open.
  1. Once the window is opened change directory into the MyFiles directory and type “gedit creditscore.txt”.
  1. Shown below is the simplistic logic used to determine what credit score will be returned based on the first character of the SSN. Select the entire text using EditàSelect All from the Menu bar and then choose EditàCopy.
  1. Go back to JDeveloper and find the “return null;” line in the java source. Highlight this text by a left mouse click and drag over the line. Replace the code by doing an EditàPaste.

The result should look like:

  1. Now right click on the CreditScore project and select “Project Properties”.
  1. Select the Java EE Application property and set both the “Java EE Web Application Name” and the “Java EE Web Context Root” to CreditScore. Click OK.
  1. Save the project by selecting Fileà SaveAll on the JDeveloper Menu Bar or using the icon.

Create the Application Server Connection and Deploy the Web Service

NOTE: Skip to step 7 of this section as an Application Server Connection has already been created for your convenience. The first six steps are for your reference.

1.  Select FileàNew from the Menu Bar.

2.  With the GeneralàConnections category selected choose the Application Server Connection Item and click OK.

3.  In step 1 of the wizard enter LocalAppServer and click Next. Since we are deploying this web service to Weblogic Server 10.3.x the default “Connection Type” is fine.

4.  In step 2 enter the username weblogic and password welcome1. Click Next.

5.  In step 3 the default ports are fine. Change the WLS Domain to domain1. Click Next.

6.  In step 4 click the Test Connection button. You should see a successful result. Click Finish.

7.  Now that there is a connection to an Application Server we can deploy the web service. Right click on the CreditScore project and navigate to DeployàWebServicesàtoàLocalAppServer.

8.  You may receive this diaalog. If you get prompted for a Confirm ReDeploy then select the Yes button, else presson to step 9.

9.  Verify a successful deployment by looking at the “Deployment – Log” window.

Test the Web Service

1.  Bring up the Firefox browser by double clicking on the Desktop icon OR right clicking on the icon and selecting “Open”.

2.  Select the Enterprise Manager FastLink from the tool bar.

3.  Login as weblogic/welcome1. It will take a couple of minutes for the application to instantiate the first time.

4.  When the Farm_domain1 page displays navigate down to Farm_domain1àApplication Deployments and click the CreditScore-CreditScore-context-root (Admin Server) link.

5.  Scroll down to the “Web Services” section and click the Test button.

6.  Scroll down to the Input Arguments section and enter a SSN that begins with a 1. If you recall the code in the web service should return a value of 583 if all is well… Click the Test Web Service button at the bottom of the page.

7.  The response returned is:

8.  Click on the Request Tab and re-test with a SSN that begins with the values 2 and 3 respectively. The results should be 644 and 721 for those submissions.

9.  This Lab is completed. The Web Service will be used in Lab3.

12

SOA 11g Workshop – Lab 1