Service (JBoss Web 8.0.0.Alpha1 API)

All Known Implementing Classes:

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: 1850 $ $Date: 2011-10-12 16:52:10 +0200 (Wed, 12 Oct 2011) $

Author:

Craig R. McClanahan

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`addConnector(Connector connector)` Add a new Connector to the set of defined Connectors, and associate it with this Service's Container.
`void`	`addExecutor(Executor ex)` Adds a named executor to the service
`Connector[]`	`findConnectors()` Find and return the set of Connectors associated with this Service.
`Executor[]`	`findExecutors()` Retrieves all executors
`Container`	`getContainer()` Return the `Container` that handles requests for all `Connectors` associated with this Service.
`String`	`getEntropy()` Return the entropy increaser value, or compute a semi-useful value if this String has not yet been set.
`Executor`	`getExecutor(String name)` Retrieves executor by name, null if not found
`String`	`getInfo()` Return descriptive information about this Service implementation and the corresponding version number, in the format `<description>/<version>`.
`Mapper`	`getMapper()` Return the `Mapper` that handles mapping for all `Connectors` associated with this Service.
`String`	`getName()` Return the name of this Service.
`SecureRandom`	`getRandom()` Get the global secure random that will be used for 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`	`removeExecutor(Executor ex)` Removes an executor from the service
`void`	`setContainer(Container container)` Set the `Container` that handles requests for all `Connectors` associated with this Service.
`void`	`setEntropy(String entropy)` Set the entropy increaser value.
`void`	`setName(String name)` Set the name of this Service.
`void`	`setServer(Server server)` Set the `Server` with which we are associated (if any).

- Method Detail
  - getContainer
```
Container getContainer()
```
    Return the Container that handles requests for all Connectors associated with this Service.
  - setContainer
```
void setContainer(Container container)
```
    Set the Container that handles requests for all Connectors 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>.
  - getMapper
```
Mapper getMapper()
```
    Return the Mapper that handles mapping for all Connectors associated with this Service.
  - 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
  - getEntropy
```
String getEntropy()
```
    Return the entropy increaser value, or compute a semi-useful value if this String has not yet been set.
  - setEntropy
```
void setEntropy(String entropy)
```
    Set the entropy increaser value.
    
    Parameters:
    
    entropy - The new entropy increaser value
  - getServer
```
Server getServer()
```
    Return the Server with which we are associated (if any).
  - setServer
```
void setServer(Server server)
```
    Set the Server with which we are associated (if any).
    
    Parameters:
    
    server - The server that owns this Service
  - 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)
```
    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
  - 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.
  - addExecutor
```
void addExecutor(Executor ex)
```
    Adds a named executor to the service
    
    Parameters:
    
    ex - Executor
  - findExecutors
```
Executor[] findExecutors()
```
    Retrieves all executors
    
    Returns:
    
    Executor[]
  - getExecutor
```
Executor getExecutor(String name)
```
    Retrieves executor by name, null if not found
    
    Parameters:
    
    name - String
    
    Returns:
    
    Executor
  - removeExecutor
```
void removeExecutor(Executor ex)
```
    Removes an executor from the service
    
    Parameters:
    
    ex - Executor
  - getRandom
```
SecureRandom getRandom()
```
    Get the global secure random that will be used for this service.

Interface Service

Method Summary

Method Detail

getContainer

setContainer

getInfo

getMapper

getName

setName

getEntropy

setEntropy

getServer

setServer

addConnector

findConnectors

removeConnector

initialize

addExecutor

findExecutors

getExecutor

removeExecutor

getRandom