/*
* JORAM: Java(TM) Open Reliable Asynchronous Messaging
* Copyright (C) 2001 - 2008 ScalAgent Distributed Technologies
* Copyright (C) 1996 - 2000 Dyade
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
* USA.
*
* Initial developer(s): Frederic Maistre (INRIA)
* Contributor(s): ScalAgent Distributed Technologies
*/
package org.objectweb.joram.client.jms;
import javax.jms.JMSException;
import javax.jms.JMSSecurityException;
import org.objectweb.joram.shared.client.TempDestDeleteRequest;
import org.objectweb.util.monolog.api.BasicLevel;
/**
* Implements the <code>javax.jms.TemporaryQueue</code> interface.
*/
public class TemporaryQueue extends Queue implements javax.jms.TemporaryQueue {
/** define serialVersionUID for interoperability */
private static final long serialVersionUID = 1L;
/** The connection the queue belongs to, <code>null</code> if not known. */
private Connection cnx;
// Used by jndi2 SoapObjectHelper
public TemporaryQueue() {}
/**
* Constructs a temporary queue.
*
* @param agentId Identifier of the queue agent.
* @param cnx The connection the queue belongs to, <code>null</code> if
* not known.
*/
public TemporaryQueue(String agentId, Connection cnx) {
super(agentId, (byte) (QUEUE_TYPE | TEMPORARY));
this.cnx = cnx;
}
/** Returns a String image of the queue. */
public String toString() {
return "TemporaryQueue" + agentId;
}
/**
* API method.
*
* @exception IllegalStateException If the connection is closed or broken.
* @exception JMSException If the request fails for any other reason.
*/
public void delete() throws JMSException {
if (cnx == null)
throw new JMSSecurityException("Forbidden call as this TemporaryQueue does not belong to this connection.");
if (logger.isLoggable(BasicLevel.DEBUG))
logger.log(BasicLevel.DEBUG, "--- " + this + ": deleting...");
// Checking the connection's receivers:
cnx.checkConsumers(agentId);
// Sending the request to the server:
cnx.syncRequest(new TempDestDeleteRequest(agentId));
if (logger.isLoggable(BasicLevel.DEBUG))
logger.log(BasicLevel.DEBUG, this + ": deleted.");
}
/**
* Returns the connection this temporary queue belongs to,
* <code>null</code> if not known.
*/
public Connection getCnx() {
return cnx;
}
}