Home » xml-commons-external-1.4.01-src » javax » xml » messaging » [javadoc | source]
javax.xml.messaging
public interface: ProviderMetaData [javadoc | source] Information about the messaging provider to which a client has a connection.

After obtaining a connection to its messaging provider, a client can get information about that provider. The following code fragment demonstrates how the ProviderConnection object con can be used to retrieve its ProviderMetaData object and then to get the name and version number of the messaging provider.

  ProviderMetaData pmd = con.getMetaData();
  String name = pmd.getName();
  int majorVersion = pmd.getMajorVersion();
  int minorVersion = pmd.getMinorVersion();
The ProviderMetaData interface also makes it possible to find out which profiles a JAXM provider supports. The following line of code uses the method getSupportedProfiles to retrieve an array of String objects naming the profile(s) that the JAXM provider supports.
  String [] profiles = pmd.getSupportedProfiles();
When a JAXM implementation supports a profile, it supports the functionality supplied by a particular messaging specification. A profile is built on top of the SOAP 1.1 and SOAP with Attachments specifications and adds more capabilities. For example, a JAXM provider may support an ebXML profile, which means that it supports headers that specify functionality defined in the ebXML specification "Message Service Specification: ebXML Routing, Transport, & Packaging, Version 1.0".

Support for profiles, which typically add enhanced security and quality of service features, is required for the implementation of end-to-end asynchronous messaging.
Method from javax.xml.messaging.ProviderMetaData Summary:
getMajorVersion,   getMinorVersion,   getName,   getSupportedProfiles
Method from javax.xml.messaging.ProviderMetaData Detail:
 public int getMajorVersion()
    Retrieves an int indicating the major version number of the messaging provider to which the ProviderConnection object described by this ProviderMetaData object is connected.
 public int getMinorVersion()
    Retrieves an int indicating the minor version number of the messaging provider to which the ProviderConnection object described by this ProviderMetaData object is connected.
 public String getName()
    Retrieves a String containing the name of the messaging provider to which the ProviderConnection object described by this ProviderMetaData object is connected. This string is provider implementation-dependent. It can either describe a particular instance of the provider or just give the name of the provider.
 public String[] getSupportedProfiles()
    Retrieves a list of the messaging profiles that are supported by the messaging provider to which the ProviderConnection object described by this ProviderMetaData object is connected.