KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > geronimo > management > geronimo > JMSManager


1 /**
2  * Licensed to the Apache Software Foundation (ASF) under one or more
3  * contributor license agreements. See the NOTICE file distributed with
4  * this work for additional information regarding copyright ownership.
5  * The ASF licenses this file to You under the Apache License, Version 2.0
6  * (the "License"); you may not use this file except in compliance with
7  * the License. You may obtain a copy of the License at
8  *
9  * 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  */

17 package org.apache.geronimo.management.geronimo;
18
19 import org.apache.geronimo.gbean.AbstractName;
20
21 /**
22  * Main entry point for managing a particular JMS implementation. The manager
23  * has features to access JMS brokers (aka servers or containers) as well as
24  * JMS connectors (aka network listeners). Each manager should handle all
25  * the brokers and connectors for a single JMS implementation; if the Geronimo
26  * server has multiple JMS implementations available then there should be one
27  * JMSManager instance for each.
28  *
29  * @version $Rev: 476049 $ $Date: 2006-11-16 23:35:17 -0500 (Thu, 16 Nov 2006) $
30  */

31 public interface JMSManager extends NetworkManager {
32     /**
33      * Creates a new connector, and returns the ObjectName for it. Note that
34      * the connector may well require further customization before being fully
35      * functional (e.g. SSL settings for a secure connector).
36      *
37      * @param broker The broker to add the connector for
38      * @param uniqueName A name fragment that's unique to this connector
39      * @param protocol The protocol the connector should be configured for
40      * @param host The listen host/IP for the connector
41      * @param port The listen port for the connector
42      *
43      * @return The newly added connector. It will be valid (loaded) but not
44      * started.
45      */

46     public JMSConnector addConnector(JMSBroker broker, String JavaDoc uniqueName, String JavaDoc protocol, String JavaDoc host, int port);
47 }
48
Popular Tags