Java Web Services in a Nutshell

Name

ProviderConnection

Synopsis

public interface ProviderConnection {
// Public Instance Methods
    public abstract void close(  ) throws JAXMException; 
    public abstract javax.xml.soap.MessageFactory createMessageFactory(String profile) throws JAXMException; 
    public abstract ProviderMetaData getMetaData( ) throws JAXMException;
    public abstract void send(javax.xml.soap.SOAPMessage message) throws JAXMException;
}

A ProviderConnection object represents a connection path between a JAXM client and a JAXM provider. An instance of this class can be obtained using the createConnection( ) method of ProviderConnectionFactory, as described in the reference section for that class. Here’s a typical example:

ProviderConnectionFactory pcf = ProviderConnectionFactory.newInstance(  );
ProviderConnection conn = pcf.createConnection(  );

All JAXM clients work with a JAXM message profile, which constructs SOAP messages according to agreed rules. A JAXM client can use the getMetaData( ) method to obtain a ProviderMetaData object that can be used to get the names of the profiles that the provider supports. In practice, however, a JAXM client has to be written with knowledge of the classes that implement a particular profile; therefore, this mechanism will probably only be used to verify that the required profile is available.

The createMessageFactory( ) method returns an object that can create messages formed according to the rules of the profile whose name is provided as its argument. The set of profiles supported ...