In the Applications Navigator, right-click the Applications node and select New Application... from the context menu.

In the Create Application dialog, enter the Application Name WebServicesApp. Notice that as you enter the application name, the directory name changes automatically.

Select the Application Template No Template [All technologies] from the Application Template dropdown list.

Click OK.

In the Create Project dialog, enter the Project Name WebServiceProxy.

Click OK.

The Applications Navigator shows the WebServiceApp application and the new project

In the Applications Navigator, right-click the WebServiceProxy node and select Project Properties... from the context menu.

Select the Compiler node and set the Source and Target dropdown lists to 1.4.

Click OK.

Depending on the version of the JRE you are using with Forms, you will probably have to do this step to ensure that the compiled classes from JDeveloper can be read by the JRE used by Form. Otherwise you would get a "Unsupported major.minor version" error when importing the Java class.

Click Save All or select File | Save All to save your work.

From the main menu, choose Tools then Preferences.

Click Web Browser and Proxy and then select the Use HTTP Proxy Server. Set the Host Name, Port Number and Exceptions as required.

Click OK.

Right-click the new project and select New from the context menu.

In the New Gallery select Web Services under the Business Tier node and then Web Service Proxy.

Click OK

In the Create Web Service Proxy dialog click Next if the Welcome screen is displayed. When prompted for the WSDL Document URL paste the URL of the WSDL file for the SendMessage service. At the time of writing, that URL is currently http://www.esendex.com/secure/messenger/soap/SendService.asmx?wsdl.

click Next then Finish.

JDeveloper will now display a Java client file in the code editor. This is the stub that will call the external web service.

Click Save All or select File | Save All to save your work. Then compile all.

In the SendServiceSoapClient you will see a main method with the comment //Add your own code here. Add the following:

// Add your own code here
MessengerHeader header = new MessengerHeader();
header.setAccount("<your account number>");
header.setUsername("<your username>");
header.setPassword("<your password> ");
myPort.sendMessage("<your phonenumber>","Message from Stub", MessageType.Text,header);

You also need to add code to this class so it knows the correct proxy to use if being run outside of the confines of JDeveloper (which it will be when being called from Forms)

static
{
System.setProperty("http.proxyHost", "yourproxy.uk.oracle.com");
System.setProperty("http.proxyPort", "port number");
System.setProperty("http.nonProxyHosts","|<your machinename>");
}

Note, depending on the proxy, assuming you have one, you may also be required to supply a username and password for the proxy. This would be set in a similar manner to above.

Click Save All or select File | Save All to save your work. Then compile all.

Now that you have tested the main method, you need to update the SendMessage method, since this is the method that will actually be called by Forms.

MessengerHeader header = new MessengerHeader();
header.setAccount("<your account number>");
header.setUsername("<your username>");
header.setPassword("<your password ");
return _port.sendMessage(recipient, body, MessageType.Text, header);

Click Save All or select File | Save All to save your work. Then compile all.

Right-click the new project and select New from the context menu.

In the New Gallery select Deployment Profiles under the General node and then JAR file.

Click OK

You can accept the default name and directory (take a note of them).

Click OK

The JAR Deployment Profile Properties appears.

Click OK

Click Save All or select File | Save All to save your work.

Right -click on the archive file under the Resources node and select Deploy to JAR file. This will deploy the JAR file to the file system

On Windows, click Start, Settings then Control Panel from the context menu.

Double-click on System. Under Advanced click on Enironment Variables. Select CLASSPATH and then Edit or New.

Add the location of the JAR file created above (including the JAR file name)

Click OK.

Download http://download.oracle.com/otn/java/oc4j/101320/wsclient_extended_101320.zip and extract the contained JAR file. Add the location of the JAR file (including the JAR file name) to the CLASSPATH

Click OK on the open dialogs.

The JAR file locations also need to be added to your Forms runtime environment so they can be accessed at runtime. To do this, add both JAR file locations to the CLASSPATH of your default.env (this is the default name) file.

If already running, restart OC4J.

Start the Oracle Forms Builder (note that the Builder must be restarted in order to pick up the new CLASSPATH)

For the chosen Form, from the menu select Program then Import Java Classes...

Note: for the Java Importer Options, you need to uncheck, Generate persistent names check box. Otherwise, the PL/SQL block will throw compilation errors.

Expand the list of Java classes to find the SendServiceSoapClient Java class.

Click Import.

In the Import Classes field enter java.lang.String then click Options and check Include inherited mehtods/fields, click OK then click Import.

Repeat for java.lang.Exception

At the appropriate trigger point add the following code.

DECLARE
jo ora_java.jobject;
xo ora_java.jobject;
rv varchar2(100);
ex ora_java.jobject;
BEGIN
JO := SendServiceSoapClient.new;
RV := SendServiceSoapClient.sendMessage(JO,'you number', 'TXT Message from Forms', xo, xo);

EXCEPTION
WHEN ORA_JAVA.JAVA_ERROR then
message('Unable to call out to Java, ' ||ORA_JAVA.LAST_ERROR);
WHEN ORA_JAVA.EXCEPTION_THROWN then
ex := ORA_JAVA.LAST_EXCEPTION;
message(Exception_.toString(ex));
END;

Compile and run the Form.