/*
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*/
/*
*
* Copyright (c) 2006 The Apache Software Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package org.apache.qpid.server;
import javax.management.JMException;
import javax.management.MBeanException;
import javax.management.MalformedObjectNameException;
import javax.management.ObjectName;
import org.apache.commons.configuration.Configuration;
import org.apache.qpid.AMQException;
import org.apache.qpid.framing.AMQShortString;
import org.apache.qpid.server.configuration.Configurator;
import org.apache.qpid.server.configuration.VirtualHostConfiguration;
import org.apache.qpid.server.exchange.Exchange;
import org.apache.qpid.server.exchange.ExchangeFactory;
import org.apache.qpid.server.exchange.ExchangeRegistry;
import org.apache.qpid.server.management.AMQManagedObject;
import org.apache.qpid.server.management.MBeanConstructor;
import org.apache.qpid.server.management.MBeanDescription;
import org.apache.qpid.server.management.ManagedBroker;
import org.apache.qpid.server.management.ManagedObject;
import org.apache.qpid.server.queue.QueueRegistry;
import org.apache.qpid.server.queue.AMQQueue;
import org.apache.qpid.server.queue.AMQQueueFactory;
import org.apache.qpid.server.store.MessageStore;
import org.apache.qpid.server.virtualhost.VirtualHost;
/**
* This MBean implements the broker management interface and exposes the
* Broker level management features like creating and deleting exchanges and queue.
*/
@MBeanDescription("This MBean exposes the broker level management features")
public class AMQBrokerManagerMBean extends AMQManagedObject implements ManagedBroker
{
private final QueueRegistry _queueRegistry;
private final ExchangeRegistry _exchangeRegistry;
private final ExchangeFactory _exchangeFactory;
private final MessageStore _messageStore;
private final VirtualHost.VirtualHostMBean _virtualHostMBean;
@MBeanConstructor("Creates the Broker Manager MBean")
public AMQBrokerManagerMBean(VirtualHost.VirtualHostMBean virtualHostMBean) throws JMException
{
super(ManagedBroker.class, ManagedBroker.TYPE);
_virtualHostMBean = virtualHostMBean;
VirtualHost virtualHost = virtualHostMBean.getVirtualHost();
_queueRegistry = virtualHost.getQueueRegistry();
_exchangeRegistry = virtualHost.getExchangeRegistry();
_messageStore = virtualHost.getMessageStore();
_exchangeFactory = virtualHost.getExchangeFactory();
}
public String getObjectInstanceName()
{
return _virtualHostMBean.getVirtualHost().getName();
}
/**
* Creates new exchange and registers it with the registry.
*
* @param exchangeName
* @param type
* @param durable
* @throws JMException
*/
public void createNewExchange(String exchangeName, String type, boolean durable) throws JMException
{
try
{
synchronized (_exchangeRegistry)
{
Exchange exchange = _exchangeRegistry.getExchange(new AMQShortString(exchangeName));
if (exchange == null)
{
exchange = _exchangeFactory.createExchange(new AMQShortString(exchangeName), new AMQShortString(type),
durable, false, 0);
_exchangeRegistry.registerExchange(exchange);
}
else
{
throw new JMException("The exchange \"" + exchangeName + "\" already exists.");
}
}
}
catch (AMQException ex)
{
throw new MBeanException(ex, "Error in creating exchange " + exchangeName);
}
}
/**
* Unregisters the exchange from registry.
*
* @param exchangeName
* @throws JMException
*/
public void unregisterExchange(String exchangeName) throws JMException
{
// TODO
// Check if the exchange is in use.
// boolean inUse = false;
// Check if there are queue-bindings with the exchange and unregister
// when there are no bindings.
try
{
_exchangeRegistry.unregisterExchange(new AMQShortString(exchangeName), false);
}
catch (AMQException ex)
{
throw new MBeanException(ex, "Error in unregistering exchange " + exchangeName);
}
}
/**
* Creates a new queue and registers it with the registry and puts it
* in persistance storage if durable queue.
*
* @param queueName
* @param durable
* @param owner
* @throws JMException
*/
public void createNewQueue(String queueName, String owner, boolean durable) throws JMException
{
AMQQueue queue = _queueRegistry.getQueue(new AMQShortString(queueName));
if (queue != null)
{
throw new JMException("The queue \"" + queueName + "\" already exists.");
}
try
{
AMQShortString ownerShortString = null;
if (owner != null)
{
ownerShortString = new AMQShortString(owner);
}
queue = AMQQueueFactory.createAMQQueueImpl(new AMQShortString(queueName), durable, ownerShortString, false, getVirtualHost(),
null);
if (queue.isDurable() && !queue.isAutoDelete())
{
_messageStore.createQueue(queue);
}
_queueRegistry.registerQueue(queue);
}
catch (AMQException ex)
{
JMException jme = new JMException(ex.getMessage());
jme.initCause(ex);
throw new MBeanException(jme, "Error in creating queue " + queueName);
}
}
private VirtualHost getVirtualHost()
{
return _virtualHostMBean.getVirtualHost();
}
/**
* Deletes the queue from queue registry and persistant storage.
*
* @param queueName
* @throws JMException
*/
public void deleteQueue(String queueName) throws JMException
{
AMQQueue queue = _queueRegistry.getQueue(new AMQShortString(queueName));
if (queue == null)
{
throw new JMException("The Queue " + queueName + " is not a registerd queue.");
}
try
{
queue.delete();
_messageStore.removeQueue(queue);
}
catch (AMQException ex)
{
JMException jme = new JMException(ex.getMessage());
jme.initCause(ex);
throw new MBeanException(jme, "Error in deleting queue " + queueName);
}
}
public ManagedObject getParentObject()
{
return _virtualHostMBean;
}
// This will have a single instance for a virtual host, so not having the name property in the ObjectName
public ObjectName getObjectName() throws MalformedObjectNameException
{
return getObjectNameForSingleInstanceMBean();
}
} // End of MBean class