Services

A client usually first instantiates a service locator and calls its get method to get the stub.

The locator is derived from the service clause in the WSDL. For example, this WSDL

<service name="AddressBookService">
  <port name="AddressBook" binding="tns:AddressBookSOAPBinding">
 <soap:address location="http://localhost:8080/axis/services/AddressBook"/>
  </port>
</service>

gets turned into this service interface (by WSDL2Java)

public interface AddressBookService extends javax.xml.rpc.Service {
 public String getAddressBookAddress();

 public AddressBook getAddressBook() throws javax.xml.rpc.ServiceException;

 public AddressBook getAddressBook(URL portAddress)
  throws javax.xml.rpc.ServiceException;
}

and this locator class

public class AddressBookServiceLocator extends org.apache.axis.client.Service
            implements AddressBookService {
 ...
}

A client looks like

public class Tester
{
 public static void main(String [] args) throws Exception {
  // Make a service
  AddressBookService service = new AddressBookServiceLocator();
 
  // Now use the service to get a stub which implements the SDI.
  AddressBook port = service.getAddressBook();
 
  // Make the actual call
  Address address = new Address(...);
  port.addEntry("Russell Butek", address);
 }
}