Euro Web Service
I assume you know the Euro web service that I implemented in Delphi 6 Enterprise as well as Kylix 2 Enterprise. This Web Service consists of two methods: FromEuro and ToEuro, both with two arguments: Currency and Amount. The first argument, Currency, is a 3-character string and defines the currency the web service will convert from or to Euros. At this time, 12 countries are ready to start using the Euro as of 1-1-2002, so we have twelve currencies: "FIM", "ITL", "NLG", "ESP", "BEF", "ATS", "LUF", "DEM", "FRF", "IEP", "PTE", and "GRO". The second argument, Amount, is a double that contains the amount of money we want to convert from or to Euros.
The Web Service itself is compiled using Delphi 6 and Kylix 2, and hence deployed on the internet in two different places (hosted by TDMWeb): a Windows 2000 web server using http://www.eBob42.com/cgi-bin/Euro42.exe/wsdl/IEuro or a Linux web server using http://www.drbob42.co.uk/cgi-bin/Euro42/wsdl/IEuro.
We'll be using the Delphi 6 version in this article (for no particular reason - the Kylix 2 version is exactly the same).

JBuilder 6 Enterprise
Now that the preparations are finished, let's start JBuilder 6 Enterprise. I assume you have also installed the Borland Web Services Kit for Java (available for download here), otherwise you'll find that you can't easily work with the WSDL file.
After you've started JBuilder 6, do File | New Project to start a new project. Specify EuroClient as the Name of the new project and click on Finish to create the new EuroClient project.
The first thing you need to do now is to start a new application - the web service client (also called consumer). So do File | New and select Application from the Object Gallery. On the first page of the Application Wizard dialog that follows, you can specify the Package (euroclient) and Class (Application1) for your application (just leave the defaults) and on the next page you can specify some frame class options, such as the Class (Frame1) and Title (I've changed the title from "Frame Title" to "Euro Calculator"). Finally, click on Finish to create the new application and frame.

Importing WSDL
So far so good, but we've only made the skeleton application. We now need to add the IEuro wsdl definition to our project. We can do this in two ways: using an existing WSDL file or using a dynamic WSDL URL.
For the WSDL file, we first have to save the WSDL content we saw in Figure 1, put it inside Euro.wsdl, add it to our project (right-click on the project node and select "Add Files / Packages") and then generate Java classes from it, or we can start the Import WSDL Wizard which can be found in the WebServices tab of the Object Gallery:

  /**
   * IEuro.java
   *
   * This file was auto-generated from WSDL
   * by the Apache Axis Wsdl2java emitter.
   */

  package com.borland.www;

  public interface IEuro extends java.rmi.Remote {
      public double FromEuro(java.lang.String Currency, double Amount)
        throws java.rmi.RemoteException;
      public double ToEuro(java.lang.String Currency, double Amount)
        throws java.rmi.RemoteException;
  }

Euro Conversion
Now that the pieces are in place it's time to start using the Web Service. Go back to the frame, click on the Designer tab, and start dropping some Swing components on it.
Personally, I always start by changing the Layout property of the contentPane of the Frame to XTLayout. After this, I find it easier to drop and position controls. For this example, we need only five controls:

• two jTextFields
• one jComboBox
• two jButtons

  String[] EuroCurr =
    {"FIM", "ITL", "NLG", "ESP", "BEF", "ATS", "LUF", "DEM", "FRF", "IEP", "PTE", "GRO"};
  JComboBox jComboBoxCurr = new JComboBox(EuroCurr);

Using IEuro Web Service
Finally, let's write the actionPerformed event handlers for the jButtonFromEuro and jButtonToEuro controls. We need to start with two import statements, for java.net.* and for com.borland.www.* in order to include the classes we need.
In both event handlers, we need to create binding to the IEurobindingStub, which needs a URL pointing to the http://www.eBob42.com/cgi-bin/Euro42.exe/IEuro in order to create the binding.
Next, in the actionPerformed event handler for the jButtonFromEuro, we can use the stub to call the FromEuro method, taking the contents of the jTextFieldEuro control (converted to a Double) as input, and placing the results back in the jTextFieldCurr control.

  void jButtonFromEuro_actionPerformed(ActionEvent e) {
    try {
      IEurobindingStub stub = new IEurobindingStub(
          new URL("http://www.eBob42.com/cgi-bin/Euro42.exe/soap/IEuro"));
      jTextFieldCurr.setText(String.valueOf(
        stub.FromEuro(EuroCurr[jComboBoxCurr.getSelectedIndex()],
          Double.valueOf(jTextFieldEuro.getText()).doubleValue())));
    }
    catch (Exception ex) {
      ex.printStackTrace();
    }
  }

  void jButtonToEuro_actionPerformed(ActionEvent e) {
    try {
      IEurobindingStub stub = new IEurobindingStub(
          new URL("http://www.eBob42.com/cgi-bin/Euro42.exe/soap/IEuro"));
      jTextFieldEuro.setText(String.valueOf(
        stub.ToEuro(EuroCurr[jComboBoxCurr.getSelectedIndex()],
          Double.valueOf(jTextFieldCurr.getText()).doubleValue())));
    }
    catch (Exception ex) {
    ex.printStackTrace();
    }
  }

JBuilder 6 Web Services
In this article, I hope to have shown you that it's really easy to consume Web Services in JBuilder 6 Enterprise with the Borland Web Services Kit for Java. If you have any comments or feedback, don't hesitate to let me know by e-mail.