This text describes how to use the CellID service from Java using Apache AXIS. Other web-service toolkits should also work.
To be able to use the service a HTTP header named "WASP_APPLICATION" with the aplication name that you should have received. The easiest way of doing this is described in the following steps:
  1. Add the file SimpleHTTPSender.java to your project and replace the "%your_package_name%" string with a valid package name.
  2. Provide a file named "client-config.wsdd" in a directory on the classpath, containing these lines:
    <?xml version="1.0" encoding="UTF-8"?>
    <deployment name="defaultClientConfig" 
            xmlns="http://xml.apache.org/axis/wsdd/"
            xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
      	<transport name="http" pivot="java:%your_package_name%.SimpleHTTPSender"/>
      	<transport name="local" pivot="java:org.apache.axis.transport.local.LocalSender"/>
    </deployment>
    
    This makes sure that all web-service requests are handled by the SimpleHTTPSender class.
  3. Use the AXIS wsdl2java tool to generate java stubs for a service.
  4. In your client code, instantiate a stub and set your credentials:
    someService = new SomeServiceLocator().getSomeServiceSoap();
    ((Stub)commonService).setCredentials(applicationName, null);
     
    someService.doSomething(...)
    
    Note: the SimpleHTTPSender can also be used with webservices that require Basic or Digest authentication (like Microsoft MapPoint). In that case you should supply both a username and a password with the setCredentials call.