Google

Service (Catalina Internal API Documentation)

org.apache.catalina
Interface Service

All Known Implementing Classes:
StandardService

public interface Service

A Service is a group of one or more Connectors that share a single Container to process their incoming requests. This arrangement allows, for example, a non-SSL and SSL connector to share the same population of web apps.

A given JVM can contain any number of Service instances; however, they are completely independent of each other and share only the basic JVM facilities and classes on the system class path.

Version:
$Revision: 1.6 $ $Date: 2001/07/22 21:02:46 $
Author:
Craig R. McClanahan

Method Summary
 void addConnector(Connector connector)
          Add a new Connector to the set of defined Connectors, and associate it with this Service's Container.
 Connector[] findConnectors()
          Find and return the set of Connectors associated with this Service.
 Container getContainer()
          Return the Container that handles requests for all Connectors associated with this Service.
 java.lang.String getInfo()
          Return descriptive information about this Service implementation and the corresponding version number, in the format <description>/<version>.
 java.lang.String getName()
          Return the name of this Service.
 void initialize()
          Invoke a pre-startup initialization.
 void removeConnector(Connector connector)
          Remove the specified Connector from the set associated from this Service.
 void setContainer(Container container)
          Set the Container that handles requests for all Connectors associated with this Service.
 void setName(java.lang.String name)
          Set the name of this Service.
 

Method Detail

getContainer


public Container getContainer()
Return the Container that handles requests for all Connectors associated with this Service.


setContainer


public void setContainer(Container container)
Set the Container that handles requests for all Connectors associated with this Service.

Parameters:
container - The new Container

getInfo


public java.lang.String getInfo()
Return descriptive information about this Service implementation and the corresponding version number, in the format <description>/<version>.


getName


public java.lang.String getName()
Return the name of this Service.


setName


public void setName(java.lang.String name)
Set the name of this Service.

Parameters:
name - The new service name

addConnector


public void addConnector(Connector connector)
Add a new Connector to the set of defined Connectors, and associate it with this Service's Container.

Parameters:
connector - The Connector to be added

findConnectors


public Connector[] findConnectors()
Find and return the set of Connectors associated with this Service.


removeConnector


public void removeConnector(Connector connector)
Remove the specified Connector from the set associated from this Service. The removed Connector will also be disassociated from our Container.

Parameters:
connector - The Connector to be removed

initialize


public void initialize()
                throws LifecycleException
Invoke a pre-startup initialization. This is used to allow connectors to bind to restricted ports under Unix operating environments.

Throws:
LifecycleException - If this server was already initialized.


Copyright 2000-2001 Apache Software Foundation. All Rights Reserved.