org.apache.catalina
Interface Service
- Catalina, Embedded, StandardService
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:
- Craig R. McClanahan
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.
|
String | getInfo() - Return descriptive information about this Service implementation and
the corresponding version number, in the format
<description>/<version> .
|
String | getName() - Return the name of this Service.
|
Server | getServer() - Return the
Server with which we are associated (if any).
|
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(String name) - Set the name of this Service.
|
void | setServer(Server server) - Set the
Server with which we are associated (if any).
|
addConnector
public void addConnector(Connector connector)
Add a new Connector to the set of defined Connectors, and associate it
with this Service's Container.
connector
- The Connector to be added
findConnectors
public Connector[] findConnectors()
Find and return the set of Connectors associated with this Service.
getContainer
public Container getContainer()
Return the Container
that handles requests for all
Connectors
associated with this Service.
getInfo
public String getInfo()
Return descriptive information about this Service implementation and
the corresponding version number, in the format
<description>/<version>
.
getName
public String getName()
Return the name of this Service.
getServer
public Server getServer()
Return the Server
with which we are associated (if any).
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.
LifecycleException
- If this server was already initialized.
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.
connector
- The Connector to be removed
setContainer
public void setContainer(Container container)
Set the Container
that handles requests for all
Connectors
associated with this Service.
container
- The new Container
setName
public void setName(String name)
Set the name of this Service.
name
- The new service name
setServer
public void setServer(Server server)
Set the Server
with which we are associated (if any).
server
- The server that owns this Service
Copyright B) 2000-2003 Apache Software Foundation. All Rights Reserved.