/*
* The contents of this file are subject to the terms
* of the Common Development and Distribution License
* (the "License"). You may not use this file except
* in compliance with the License.
*
* You can obtain a copy of the license at
* https://glassfish.dev.java.net/public/CDDLv1.0.html.
* See the License for the specific language governing
* permissions and limitations under the License.
*
* When distributing Covered Code, include this CDDL
* HEADER in each file and include the License file at
* https://glassfish.dev.java.net/public/CDDLv1.0.html.
*
* If applicable add the following below this CDDL HEADER,
* with the fields enclosed by brackets "[]" replaced with
* your own identifying information: Portions Copyright
* [year] [name of copyright owner]
*/
/*
* @(#)QueueConnection.java 1.2 05/02/06
*
* Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
*/
package com.sun.messaging.jms;
import javax.jms.JMSException;
import javax.jms.QueueSession;
/**
* Provide interface to create a MQ NO_ACKNOWLEDGE queue session.
*
* @version 1.0
*/
public interface QueueConnection extends javax.jms.QueueConnection {
/** Creates a <CODE>QueueSession</CODE> object.
*
* @param acknowledgeMode indicates whether the consumer or the
* client will acknowledge any messages it receives;
* Legal values are <code>Session.AUTO_ACKNOWLEDGE</code>,
* <code>Session.CLIENT_ACKNOWLEDGE</code>,
* <code>Session.DUPS_OK_ACKNOWLEDGE</code>, and
* <code>com.sun.messaging.jms.Session.NO_ACKNOWLEDGE</code>
*
* @return a newly created session
*
* @exception JMSException if the <CODE>QueueConnection</CODE> object fails
* to create a session due to some internal error or
* lack of support for the specific transaction
* and acknowledgement mode.
*
* @see Session#AUTO_ACKNOWLEDGE
* @see Session#CLIENT_ACKNOWLEDGE
* @see Session#DUPS_OK_ACKNOWLEDGE
* @see com.sun.messaging.jms.Session#NO_ACKNOWLEDGE
*/
QueueSession
createQueueSession(int acknowledgeMode) throws JMSException;
}
|