Package jakarta.xml.messaging
Interface ProviderMetaData
-
@Deprecated public interface ProviderMetaDataDeprecated.since 6.2, will be removed without replacementInformation 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
ProviderConnectionobjectconcan be used to retrieve itsProviderMetaDataobject 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();
TheProviderMetaDatainterface also makes it possible to find out which profiles a JAXM provider supports. The following line of code uses the methodgetSupportedProfilesto retrieve an array ofStringobjects 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 Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description intgetMajorVersion()Deprecated.Retrieves anintindicating the major version number of the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject is connected.intgetMinorVersion()Deprecated.Retrieves anintindicating the minor version number of the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject is connected.java.lang.StringgetName()Deprecated.Retrieves aStringcontaining the name of the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject is connected.java.lang.String[]getSupportedProfiles()Deprecated.Retrieves a list of the messaging profiles that are supported by the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject is connected.
-
-
-
Method Detail
-
getName
java.lang.String getName()
Deprecated.Retrieves aStringcontaining the name of the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject 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.- Returns:
- the messaging provider's name as a
String
-
getMajorVersion
int getMajorVersion()
Deprecated.Retrieves anintindicating the major version number of the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject is connected.- Returns:
- the messaging provider's major version number as an
int
-
getMinorVersion
int getMinorVersion()
Deprecated.Retrieves anintindicating the minor version number of the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject is connected.- Returns:
- the messaging provider's minor version number as an
int
-
getSupportedProfiles
java.lang.String[] getSupportedProfiles()
Deprecated.Retrieves a list of the messaging profiles that are supported by the messaging provider to which theProviderConnectionobject described by thisProviderMetaDataobject is connected.- Returns:
- a
Stringarray in which each element is a messaging profile supported by the messaging provider
-
-