Package jakarta.xml.messaging
Interface ProviderMetaData
-
@Deprecated public interface ProviderMetaData
Deprecated.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
ProviderConnection
objectcon
can be used to retrieve itsProviderMetaData
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();
TheProviderMetaData
interface also makes it possible to find out which profiles a JAXM provider supports. The following line of code uses the methodgetSupportedProfiles
to retrieve an array ofString
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 Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description int
getMajorVersion()
Deprecated.Retrieves anint
indicating the major version number of the messaging provider to which theProviderConnection
object described by thisProviderMetaData
object is connected.int
getMinorVersion()
Deprecated.Retrieves anint
indicating the minor version number of the messaging provider to which theProviderConnection
object described by thisProviderMetaData
object is connected.java.lang.String
getName()
Deprecated.Retrieves aString
containing the name of the messaging provider to which theProviderConnection
object described by thisProviderMetaData
object is connected.java.lang.String[]
getSupportedProfiles()
Deprecated.Retrieves a list of the messaging profiles that are supported by the messaging provider to which theProviderConnection
object described by thisProviderMetaData
object is connected.
-
-
-
Method Detail
-
getName
java.lang.String getName()
Deprecated.Retrieves aString
containing the name of the messaging provider to which theProviderConnection
object described by thisProviderMetaData
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.- Returns:
- the messaging provider's name as a
String
-
getMajorVersion
int getMajorVersion()
Deprecated.Retrieves anint
indicating the major version number of the messaging provider to which theProviderConnection
object described by thisProviderMetaData
object is connected.- Returns:
- the messaging provider's major version number as an
int
-
getMinorVersion
int getMinorVersion()
Deprecated.Retrieves anint
indicating the minor version number of the messaging provider to which theProviderConnection
object described by thisProviderMetaData
object 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 theProviderConnection
object described by thisProviderMetaData
object is connected.- Returns:
- a
String
array in which each element is a messaging profile supported by the messaging provider
-
-