01: /**
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */package org.apache.geronimo.management.geronimo;
17:
18: import org.apache.geronimo.gbean.AbstractName;
19:
20: /**
21: * Main entry point for managing a particular JMS implementation. The manager
22: * has features to access JMS brokers (aka servers or containers) as well as
23: * JMS connectors (aka network listeners). Each manager should handle all
24: * the brokers and connectors for a single JMS implementation; if the Geronimo
25: * server has multiple JMS implementations available then there should be one
26: * JMSManager instance for each.
27: *
28: * @version $Rev: 476049 $ $Date: 2006-11-16 20:35:17 -0800 (Thu, 16 Nov 2006) $
29: */
30: public interface JMSManager extends NetworkManager {
31: /**
32: * Creates a new connector, and returns the ObjectName for it. Note that
33: * the connector may well require further customization before being fully
34: * functional (e.g. SSL settings for a secure connector).
35: *
36: * @param broker The broker to add the connector for
37: * @param uniqueName A name fragment that's unique to this connector
38: * @param protocol The protocol the connector should be configured for
39: * @param host The listen host/IP for the connector
40: * @param port The listen port for the connector
41: *
42: * @return The newly added connector. It will be valid (loaded) but not
43: * started.
44: */
45: public JMSConnector addConnector(JMSBroker broker,
46: String uniqueName, String protocol, String host, int port);
47: }
|