FileDocCategorySizeDatePackage
Service.javaAPI DocApache Tomcat 6.0.144573Fri Jul 20 04:20:34 BST 2007org.apache.catalina

Service

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.

author
Craig R. McClanahan
version
$Revision: 520968 $ $Date: 2007-03-21 19:00:39 +0100 (mer., 21 mars 2007) $

Fields Summary
Constructors Summary
Methods Summary
public voidaddConnector(org.apache.catalina.connector.Connector connector)
Add a new Connector to the set of defined Connectors, and associate it with this Service's Container.

param
connector The Connector to be added

public voidaddExecutor(Executor ex)
Adds a named executor to the service

param
ex Executor

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

public Executor[]findExecutors()
Retrieves all executors

return
Executor[]

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

public ExecutorgetExecutor(java.lang.String name)
Retrieves executor by name, null if not found

param
name String
return
Executor

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

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

public ServergetServer()
Return the Server with which we are associated (if any).

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

exception
LifecycleException If this server was already initialized.

public voidremoveConnector(org.apache.catalina.connector.Connector connector)
Remove the specified Connector from the set associated from this Service. The removed Connector will also be disassociated from our Container.

param
connector The Connector to be removed

public voidremoveExecutor(Executor ex)
Removes an executor from the service

param
ex Executor

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

param
container The new Container

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

param
name The new service name

public voidsetServer(Server server)
Set the Server with which we are associated (if any).

param
server The server that owns this Service