summaryrefslogtreecommitdiff
path: root/java/broker/src/main/java/org/apache/qpid/server/management/ManagedBroker.java
blob: a38931a0d87c97fe3529e8cf6300207a94d9d0c0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/*
 *
 * 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.management;

import javax.management.JMException;
import javax.management.MBeanOperationInfo;
import java.io.IOException;

/**
 * The ManagedBroker is the management interface to expose management
 * features of the Broker.
 *
 * @author   Bhupendra Bhardwaj
 * @version  0.1
 */
public interface ManagedBroker
{
    static final String TYPE = "BrokerManager";

    /**
     * Creates a new Exchange.
     * @param name
     * @param type
     * @param durable
     * @param passive
     * @throws IOException
     * @throws JMException
     */
    @MBeanOperation(name="createNewExchange", description="Creates a new Exchange",
                         impact= MBeanOperationInfo.ACTION)
    void createNewExchange(@MBeanOperationParameter(name="name", description="Name of the new exchange")String name,
                           @MBeanOperationParameter(name="excahnge type", description="Type of the exchange")String type,
                           @MBeanOperationParameter(name="durable", description="true if the Exchang should be durable")boolean durable,
                           @MBeanOperationParameter(name="passive", description="true of the Exchange should be passive")boolean passive)
        throws IOException, JMException;

    /**
     * unregisters all the channels, queuebindings etc and unregisters
     * this exchange from managed objects.
     * @param exchange
     * @throws IOException
     * @throws JMException
     */
    @MBeanOperation(name="unregisterExchange",
                         description="Unregisters all the related channels and queuebindings of this exchange",
                         impact= MBeanOperationInfo.ACTION)
    void unregisterExchange(@MBeanOperationParameter(name="exchange name", description="Name of the exchange")String exchange)
        throws IOException, JMException;

    /**
     * Create a new Queue on the Broker server
     * @param queueName
     * @param durable
     * @param owner
     * @param autoDelete
     * @throws IOException
     * @throws JMException
     */
    @MBeanOperation(name="createQueue", description="Create a new Queue on the Broker server",
                         impact= MBeanOperationInfo.ACTION)
    void createQueue(@MBeanOperationParameter(name="queue name", description="Name of the new queue")String queueName,
                     @MBeanOperationParameter(name="durable", description="true if the queue should be durable")boolean durable,
                     @MBeanOperationParameter(name="owner", description="Owner name")String owner,
                     @MBeanOperationParameter(name="autoDelete", description="true if the queue should be auto delete") boolean autoDelete)
        throws IOException, JMException;

    /**
     * Unregisters the Queue bindings, removes the subscriptions and unregisters
     * from the managed objects.
     * @param queueName
     * @throws IOException
     * @throws JMException
     */
    @MBeanOperation(name="deleteQueue",
                         description="Unregisters the Queue bindings, removes the subscriptions and deletes the queue",
                         impact= MBeanOperationInfo.ACTION)
    void deleteQueue(@MBeanOperationParameter(name="queue name", description="Name of the queue")String queueName)
        throws IOException, JMException;
}