File Doc Category Size Date Package
Service.java API Doc Glassfish v2 API 5153 Fri May 04 22:31:52 BST 2007 org.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: 1.3 $ $Date: 2007/05/05 05:31:51 $

Fields Summary
Constructors Summary
Methods Summary
public void addConnector(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 Connector[] findConnectors()
Find and return the set of Connectors associated with this Service.
public Container getContainer()
Return the Container that handles requests for all Connectors associated with this Service.
public java.lang.String getInfo()
Return descriptive information about this Service implementation and the corresponding version number, in the format <description>/<version>.
public java.lang.String getName()
Return the name of this Service.
public Server getServer()
Return the Server with which we are associated (if any).
public void initialize()
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 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.
param
connector The Connector to be removed
public void setContainer(Container container)
Set the Container that handles requests for all Connectors associated with this Service.
param
container The new Container
public void setName(java.lang.String name)
Set the name of this Service.
param
name The new service name
public void setServer(Server server)
Set the Server with which we are associated (if any).
param
server The server that owns this Service