Java Web Services in a Nutshell

Name

Stub

Synopsis

public interface Stub {
// Public Constants
    public static final String ENDPOINT_ADDRESS_PROPERTY;
               // ="javax.xml.rpc.service.endpoint.address”
    public static final String PASSWORD_PROPERTY;
               // ="javax.xml.rpc.security.auth.password”
    public static final String SESSION_MAINTAIN_PROPERTY;
               // ="javax.xml.rpc.session.maintain”
    public static final String USERNAME_PROPERTY;
               // ="javax.xml.rpc.security.auth.username”
                  // Public Instance Methods
    public abstract Object _getProperty( String name); 
    public abstract Iterator _getPropertyNames(  ); 
    public abstract void _setProperty(String name, Object value); 
}

Stub is an interface implemented by all client-side stub classes generated by the wscompile tool or a vendor-specific equivalent. The task of a Stub object is to marshall the parameters for a remote method call made on the client into a SOAP message, to unmarshall the reply to create the return value from the call, if there is one, and to update any output parameters supplied in the form of Holder objects. The code for a stub class is entirely generated by wscompile; the only methods that are of interest to application code are declared in the Stub interface.

A Stub contains a collection of properties that application code can set to control the operation of the JAX-RPC runtime when invoking the remote method. To set a property, use the _setProperty( ) method. Use the _getProperty( ) method to retrieve the value of a named property and the _getPropertyNames( ) method to get ...