Message Queue, v4.4 API Specification

com.sun.messaging.jms
Interface Connection

All Superinterfaces:
Connection

public interface Connection
extends Connection

This interafce provides the following API for the MQ applications:

1. Provide API to create a MQ NO_ACKNOWLEDGE session.

2. Provide API to set the connection event listener.

3. Provide API to query broker adress and HA state.


Method Summary
 Session createSession(int acknowledgeMode)
          Creates a Session object.
 java.lang.String getBrokerAddress()
          Get the broker's address that the connection is connected (related) to.
 boolean isConnectedToHABroker()
          Get the current connection state.
 void setEventListener(EventListener listener)
          Set MQ connection event listener to the current connection.
 
Methods inherited from interface javax.jms.Connection
close, createConnectionConsumer, createDurableConnectionConsumer, createSession, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop
 

Method Detail

createSession

Session createSession(int acknowledgeMode)
                      throws JMSException
Creates a Session object.

Parameters:
acknowledgeMode - indicates whether the consumer or the client will acknowledge any messages it receives; Legal values are Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE, and com.sun.messaging.jms.Session.NO_ACKNOWLEDGE
Returns:
a newly created session
Throws:
JMSException - if the Connection object fails to create a session due to some internal error or lack of support for the specific transaction and acknowledgement mode.
JMSException
See Also:
Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE, Session.NO_ACKNOWLEDGE

setEventListener

void setEventListener(EventListener listener)
                      throws JMSException
Set MQ connection event listener to the current connection.

Parameters:
listener - EventListener
Throws:
JMSException
JMSException

getBrokerAddress

java.lang.String getBrokerAddress()
Get the broker's address that the connection is connected (related) to.

Returns:
the broker's address that the connection is connected (related) to.

isConnectedToHABroker

boolean isConnectedToHABroker()
Get the current connection state.

Returns:
true if the connection is connected to a HA broker. false if not connected to a HA broker.

Message Queue, v4.4 API Specification

Copyright 2009 Sun Microsystems, Inc.
4150 Network Circle, Santa Clara, CA 95054, U.S.A. All Rights Reserved.