NetworkManager.java

/**
 *
 * Copyright 2003-2004 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.geronimo.management.geronimo;

/**
 * Base management interface for a network technology with associated
 * containers and connectors.  Examples might be Web, EJB, JMS (all
 * of which have the concept of containers and connectors).  The container
 * would be the Web Container, EJB Container, or JMS Broker.  The connectors
 * would be the services that expose those containers over the network, via
 * HTTP, RMI, TCP, etc.
 *
 * @version $Rev$ $Date$
 */
public interface NetworkManager {
    /**
     * Gets the network containers.
     */
    public String[] getContainers();

    /**
     * Gets the protocols which this container can configure connectors for.
     */
    public String[] getSupportedProtocols();

    /**
     * Removes a connector.  This shuts it down if necessary, and removes it
     * from the server environment.  It must be a connector that uses this
     * network technology.
     */
    public void removeConnector(String objectName);

    /**
     * Gets the ObjectNames of any existing connectors for this network
     * technology for the specified protocol.
     *
     * @param protocol A protocol as returned by getSupportedProtocols
     */
    public String[] getConnectors(String protocol);

    /**
     * Gets the ObjectNames of any existing connectors associated with this
     * network technology.
     */
    public String[] getConnectors();

    /**
     * Gets the ObjectNames of any existing connectors for the specified
     * container for the specified protocol.
     *
     * @param protocol A protocol as returned by getSupportedProtocols
     */
    public String[] getConnectorsForContainer(String containerObjectName, String protocol);

    /**
     * Gets the ObjectNames of any existing connectors for the specified
     * container.
     */
    public String[] getConnectorsForContainer(String containerObjectName);
}