Calling a Web Service using a Web Service Data Control

This tutorial shows you how you can build a simple java class (HelloWorld), expose that class as a
Web Service, and using a Web Service Data Control, to consume this web service from your ADF
Web Application.

For the purpose of this tutorial, I am using Oracle JDeveloper 11g Version 11.1.1.3.0. You can
download it from Oracle Technology Network.

Create a Java Class and Expose it as a Web Service

1. In the Applications Navigator, click New Application. Another option is to use the File-
>New... menu option to create a new application.

2. In the Create Application dialog box, specify the Application Name to be JavaWebService.
Notice that the directory changes to match the new name. You can change the
C:\JDeveloper\mywork part of the path to create your files in another location.

In the Application Package Prefix field set the value to be demo. In the Application
Templates choose the Generic Application and click Next.
3. In step 2 of the Create Application Wizard, specify the Project Name to be HelloWorld and
click Finish.

4. Right click the HelloWorld project and select New.

5. Under the General category, select Java Class.

6. In the Create Java Class , specify the Name to be HelloWorld and uncheck the “Constructors
from Superclass” and “Implement Abstract Methods” options and click OK.
 7. In the HelloWorld.java class, copy and paste the following code:
public String sayHello(String firstname, String lastname){
return "Hello " + firstname + " " + lastname;
}

8. Right click the HelloWorld.java class and select Create Web Service.
 9. This initiates the Create Java Web Service Wizard. In the Select Deployment Platform, leave
the default platform selected (Java EE 1.5 with support for JAX-WS Annotations) and click Next.

10. In the Generation Option, leave the defaults and click Next.
11. In the Message Format, select SOAP Bindings 1.2 and click Next.

12. In the Methods, make sure that the sayHelo method is selected and click Finish.
13. If you open HelloWorld.java, you will notice that the wizard appended some annotations to
the class to expose it as a Web Service. Right click HelloWorld.java and choose Run to
deploy it to the Integrated WebLogic Server.

14. Once deployed, you will notice in the WebLogic console a Target URL. This is the url of the
deployed HellWorld Web Service. JDeveloper provides you with a Web Service Test Client,
so if you click on the url, it will open the test client, allowing you to test the web service.
15. If you enter your name and surname and click Send Request, the web service should respond
with a message “Hello name surname”, where name is the name that you have specified and
surname is the surname that you have specified in the web service call.

16. Before proceeding to the next step and creating our Fusion ADF Web Application that will
consume this web service that we have just created, please make sure that you have copied the
target url of the deployed web service as this will be needed in the next steps.
Create an ADF Fusion Application and a Web Service Data Control to
Consume the HelloWorld Web Service
1. In the Applications Navigator, click New Application.
2. In the Create Application dialog box, specify the Application Name to be
ADFHelloWorldJava. Notice that the directory changes to match the new name. You can
change the C:\JDeveloper\mywork part of the path to create your files in another location.

In the Application Package Prefix field set the value to be demo. In the Application
Templates choose the Fusion Web Application (ADF) and click Finish.

3. In the Application Navigator you'll see two new projects now, one called Model and the other
called ViewController. Right click the model project and select New.
4. Under the Business Tier category, select Web Services and then from the items select Web
Service Data Control.

5. In the Create Web Service Data Control Wizard, specify the name for the Data Control to be
HelloWorld and the URL to be the url that you have copied before. Please note that at the
end of the url, you need to append ?wsdl to specify the WSDL file of the Web Service, and
click Next.
6. In the Data Control Operations, shuttle the HelloWorldService to the selected pane and click
Finish.

7. Right click the ViewController project and select New.

8. Under the Web Tier category, select JSF and then from the items select JSF Page.

9. In the Create JSF page, specify the File Name to be HelloWorld.jspx and make sure that the
“Create as XML Document(*.jspx)” option is checked. Under Initial Page Layout and
Content select Blank Page and click OK.
10. Expand the Data Control section and drag the sayHello method onto the HelloWorld.jspx
page as an ADF Parameter Form.

11. On the Edit Form Fields, just click OK.

12. As you can see, ADF automatically created an ADF form based on the method’s input
parameters and included a submit button to call the web service.

13. The HelloWorld Web Service returns a String. To display the output of the web service, just
drag the String output from the Data Control below the sayHello button as an ADF Output
Text.
14. Right click the page and choose Run.

15. Provide a value for sayHello_arg0 (Firstname) and a value for sayHello_arg1 (Lastname) and
click the sayHello button.
17. The HelloWorld Web Service is called and returns a message “Hello name surname”, where
name is the name that you have specified and surname is the surname that you have specified
in the web service call.