Package org.apache.catalina
Interface Service
- All Superinterfaces:
- Lifecycle
- All Known Implementing Classes:
- 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.
- Author:
- Craig R. McClanahan
- 
Nested Class SummaryNested classes/interfaces inherited from interface org.apache.catalina.LifecycleLifecycle.SingleUse
- 
Field SummaryFields inherited from interface org.apache.catalina.LifecycleAFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT
- 
Method SummaryModifier and TypeMethodDescriptionvoidaddConnector(Connector connector) Add a new Connector to the set of defined Connectors, and associate it with this Service's Container.voidaddExecutor(Executor ex) Adds a named executor to the serviceFind and return the set of Connectors associated with this Service.Executor[]Retrieves all executorsgetExecutor(String name) Retrieves executor by name, null if not foundgetName()voidremoveConnector(Connector connector) Remove the specified Connector from the set associated from this Service.voidRemoves an executor from the servicevoidsetContainer(Engine engine) Set theEnginethat handles requests for allConnectorsassociated with this Service.voidSet the name of this Service.voidsetParentClassLoader(ClassLoader parent) Set the parent class loader for this service.voidSet theServerwith which we are associated (if any).Methods inherited from interface org.apache.catalina.LifecycleaddLifecycleListener, destroy, findLifecycleListeners, getState, getStateName, init, removeLifecycleListener, start, stop
- 
Method Details- 
getContainerEngine getContainer()- Returns:
- the Enginethat handles requests for allConnectorsassociated with this Service.
 
- 
setContainerSet theEnginethat handles requests for allConnectorsassociated with this Service.- Parameters:
- engine- The new Engine
 
- 
getNameString getName()- Returns:
- the name of this Service.
 
- 
setNameSet the name of this Service.- Parameters:
- name- The new service name
 
- 
getServerServer getServer()- Returns:
- the Serverwith which we are associated (if any).
 
- 
setServerSet theServerwith which we are associated (if any).- Parameters:
- server- The server that owns this Service
 
- 
getParentClassLoaderClassLoader getParentClassLoader()- Returns:
- the parent class loader for this component. If not set, return
 getServer()Server.getParentClassLoader(). If no server has been set, return the system class loader.
 
- 
setParentClassLoaderSet the parent class loader for this service.- Parameters:
- parent- The new parent class loader
 
- 
getDomainString getDomain()- Returns:
- the domain under which this container will be / has been registered.
 
- 
addConnectorAdd a new Connector to the set of defined Connectors, and associate it with this Service's Container.- Parameters:
- connector- The Connector to be added
 
- 
findConnectorsConnector[] findConnectors()Find and return the set of Connectors associated with this Service.- Returns:
- the set of associated Connectors
 
- 
removeConnectorRemove 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
 
- 
addExecutorAdds a named executor to the service- Parameters:
- ex- Executor
 
- 
findExecutorsExecutor[] findExecutors()Retrieves all executors- Returns:
- Executor[]
 
- 
getExecutorRetrieves executor by name, null if not found- Parameters:
- name- String
- Returns:
- Executor
 
- 
removeExecutorRemoves an executor from the service- Parameters:
- ex- Executor
 
- 
getMapperMapper getMapper()- Returns:
- the mapper associated with this Service.
 
 
-