Package org.apache.catalina
Interface Service
-
- All Known Implementing Classes:
Catalina
,Embedded
,EmbeddedWebContainer
,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.2 $ $Date: 2005/12/08 01:27:20 $
- Author:
- Craig R. McClanahan
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description 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.NotificationBroadcasterSupport
getBroadcaster()
Return theNotificationBroadcasterSupport
that sends notification for this Service.Container
getContainer()
Return theContainer
that handles requests for allConnectors
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 theServer
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
setBroadcaster(NotificationBroadcasterSupport broadcaster)
Set theNotificationBroadcasterSupport
that sends notification for this Servicevoid
setContainer(Container container)
Set theContainer
that handles requests for allConnectors
associated with this Service.void
setName(String name)
Set the name of this Service.void
setServer(Server server)
Set theServer
with which we are associated (if any).
-
-
-
Method Detail
-
getContainer
Container getContainer()
Return theContainer
that handles requests for allConnectors
associated with this Service.
-
setContainer
void setContainer(Container container)
Set theContainer
that handles requests for allConnectors
associated with this Service.- Parameters:
container
- The new Container
-
getInfo
String getInfo()
Return descriptive information about this Service implementation and the corresponding version number, in the format<description>/<version>
.
-
getName
String getName()
Return the name of this Service.
-
setName
void setName(String name)
Set the name of this Service.- Parameters:
name
- The new service name
-
getServer
Server getServer()
Return theServer
with which we are associated (if any).
-
setServer
void setServer(Server server)
Set theServer
with which we are associated (if any).- Parameters:
server
- The server that owns this Service
-
getBroadcaster
NotificationBroadcasterSupport getBroadcaster()
Return theNotificationBroadcasterSupport
that sends notification for this Service.
-
setBroadcaster
void setBroadcaster(NotificationBroadcasterSupport broadcaster)
Set theNotificationBroadcasterSupport
that sends notification for this Service- Parameters:
broadcaster
- The new NotificationBroadcasterSupport
-
addConnector
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
Connector[] findConnectors()
Find and return the set of Connectors associated with this Service.
-
removeConnector
void removeConnector(Connector connector) throws LifecycleException
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- Throws:
LifecycleException
-
initialize
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.
-
-