com.sssw.jms.api
Interface JMQConnection

All Superinterfaces:

Connection

All Known Subinterfaces:

JMQQueueConnection, JMQTopicConnection, JMQXAQueueConnection, JMQXATopicConnection

public interface JMQConnection

extends Connection

The base class for Novell exteNd Messaging Platform JMS connections. The connection inherits its configuration from the connection factory, including username/password, client identifier, and server host/port settings.

See Also:

JMQQueueConnection, JMQXAQueueConnection, JMQTopicConnection, JMQXATopicConnection

Method Summary

byte[][]	getCertificateChain() Get the DER encoded certificate chain of the client.
JMQConnectionFactory	getConnectionFactory() Get the connection factory that created this object.
JMQDestinationAdmin	getDestinationAdmin() Get the destination administration interface
CipherSuite	getNegotiatedCipherSuite() Get the cipher suite negotiated between client and server.
Principal	getPrincipal() Get the identity of the client
JMQSecurityAdmin	getSecurityAdmin() Get the security administration interface

Methods inherited from interface javax.jms.Connection

close, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Method Detail

getPrincipal

public Principal getPrincipal()
                       throws JMSException

Get the identity of the client

Returns:

the Principal who created this connection

Throws:

JMSException - the JMS provider could not execute this method

See Also:

Principal

getConnectionFactory

public JMQConnectionFactory getConnectionFactory()

Get the connection factory that created this object.

Returns:

the connection factory that created this connection

Since:

jBroker MQ 2.0

getSecurityAdmin

public JMQSecurityAdmin getSecurityAdmin()
                                  throws JMSException

Get the security administration interface

Returns:

the connection's JMQSecurityAdmin object

Throws:

JMSSecurityException - if security is enabled in the server, and and the Principal is not an administrator

JMSException

See Also:

getPrincipal(), JMSSecurityException, JMQSecurityAdmin

getDestinationAdmin

public JMQDestinationAdmin getDestinationAdmin()
                                        throws JMSException

Get the destination administration interface

Returns:

the connection's JMQDestinationAdmin object

Throws:

JMSSecurityException - if security is enabled in the server, and and the Principal is not an administrator

JMSException

See Also:

getPrincipal(), JMSSecurityException, JMQDestinationAdmin

getCertificateChain

public byte[][] getCertificateChain()
                             throws JMSException

Get the DER encoded certificate chain of the client. This method is only available when using SSL communication.

Returns:

a DER encoded certificate chain

Throws:

JMSException - if certificate chain could not be obtained

Since:

jBroker MQ 2.1

getNegotiatedCipherSuite

public CipherSuite getNegotiatedCipherSuite()
                                     throws JMSException

Get the cipher suite negotiated between client and server. This method is only available when using SSL communication.

Returns:

a CipherSuite constant

Throws:

JMSException - if cipher suite could not be obtained

Since:

jBroker MQ 2.1