Creating Oracle ADF Data Controls for Web Services

If you use web services as your business service technology, model information will be exposed to the view and controller layers through ADF data control interfaces implemented by thin, Oracle-provided adapter classes.

JDeveloper creates Oracle ADF data controls for a web service by generating a stub or proxy to the service, and creating the data controls from the stub. Any web service is available to be exposed as a data control in JDeveloper as long as the design time can create a stub for that web service. For more information, see About Creating Stubs to Web Services.

You can create data controls for web services that you have created in JDeveloper as part of your application with just one mouse-click. The process of creating data controls for external web services, that is web services somewhere on the Web, is different in that you have to make the WSDL document available in the navigator first. Creating data controls is described for both these cases below:

Creating data controls for web services created in JDeveloper
Creating data controls for external web services

Finally, you can view the business services you have registered for use with your client application.

Creating Data Controls for Web Services Created in JDeveloper

You can incorporate the functionality of a web service that you have created in JDeveloper in your application. This can be either a SOAP web service or a J2EE web service, and in either case the service should be deployed in the usual manner before creating data controls. When you have created a web service in JDeveloper, the web service container is listed in the navigator.

To create data controls for a web service created in JDeveloper:

With the web service deployed, select the web service container in the navigator and choose Create Data Control from the context menu. Alternatively, drag the web service container node to the Data Control Palette.

OR
With the web service container selected in the navigator, select the WSDL in the Structure window and choose Creat e Data Control from the context menu. Alternatively, drag the WSDL node to the Data Control Palette.

Creating Data Controls for External Web Services

When you know the URL of the WSDL document, you need to make the WSDL available in the Application Navigator before you can create data controls for the service. There are two ways to do this:

By creating a new WSDL document and importing the external WSDL document into it
By creating a stub to the web service, and allowing the wizard to add the WSDL document to the navigator

Another way of using an external web service in an Oracle ADF application is to locate the service in a UDDI registry, and create the data controls from the Connection Navigator.

These three cases are described below.

To create data controls for an external web service by creating a new WSDL document:

Create a new WSDL document, accepting the defaults.
In a browser, open the WSDL document of the external web service you want to use as the service provider. View the source of the document, and copy the XML source of the WSDL.
Replace the contents of the WSDL document you have just created with the source from the WSDL document of the web service you want to create data controls for.
Right-click the WSDL document and choose Create Data Control. Alternatively, drag the WSDL node from the navigator to the Data Control Palette.

To create data controls for an external web service using a wizard:

Create a stub to the web service, and paste the WSDL URL into the W SDL Document URL field on the Select Web Service Description page. On the same page, select Import WSDL URL Into Project, and complete the wizard.
With the WSDL document selected, choose Creat e Data Control from the context menu. Alternatively, drag the WSDL node from the navigator to the Data Control Palette.

To create data controls for a web service located in a UDDI registry:

Locate the web service in the UDDI registry. The service is listed in the Connection Navigator under the UDDI registry node.
Right-click the web service and choose Creat e Data Control, as shown in the following figure

To view the business services you have registered for use with your client application:

If the palette is not yet displayed, choose V iew | Data Control Palette.
OR
If the palette is already displayed, right-click in the palette and choose Refresh Palette.