|
Apache Tomcat 7.0.0 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Server
A Server
element represents the entire Catalina
servlet container. Its attributes represent the characteristics of
the servlet container as a whole. A Server
may contain
one or more Services
, and the top level set of naming
resources.
Normally, an implementation of this interface will also implement
Lifecycle
, such that when the start()
and
stop()
methods are called, all of the defined
Services
are also started or stopped.
In between, the implementation must open a server socket on the port number
specified by the port
property. When a connection is accepted,
the first line is read and compared with the specified shutdown command.
If the command matches, shutdown of the server is initiated.
NOTE - The concrete implementation of this class should
register the (singleton) instance with the ServerFactory
class in its constructor(s).
Field Summary |
---|
Fields inherited from interface org.apache.catalina.Lifecycle |
---|
AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, DESTROY_EVENT, INIT_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT |
Method Summary | |
---|---|
void |
addService(Service service)
Add a new Service to the set of defined Services. |
void |
await()
Wait until a proper shutdown command is received, then return. |
Service |
findService(String name)
Return the specified Service (if it exists); otherwise return null . |
Service[] |
findServices()
Return the set of Services defined within this Server. |
String |
getAddress()
Return the address on which we listen to for shutdown commands. |
NamingResources |
getGlobalNamingResources()
Return the global naming resources. |
String |
getInfo()
Return descriptive information about this Server implementation and the corresponding version number, in the format <description>/<version> . |
int |
getPort()
Return the port number we listen to for shutdown commands. |
String |
getShutdown()
Return the shutdown command string we are waiting for. |
void |
removeService(Service service)
Remove the specified Service from the set associated from this Server. |
void |
setAddress(String address)
Set the address on which we listen to for shutdown commands. |
void |
setGlobalNamingResources(NamingResources globalNamingResources)
Set the global naming resources. |
void |
setPort(int port)
Set the port number we listen to for shutdown commands. |
void |
setShutdown(String shutdown)
Set the shutdown command we are waiting for. |
Methods inherited from interface org.apache.catalina.Lifecycle |
---|
addLifecycleListener, destroy, findLifecycleListeners, getState, init, removeLifecycleListener, start, stop |
Method Detail |
---|
String getInfo()
<description>/<version>
.
NamingResources getGlobalNamingResources()
void setGlobalNamingResources(NamingResources globalNamingResources)
globalNamingResources
- The new global naming resourcesint getPort()
void setPort(int port)
port
- The new port numberString getAddress()
void setAddress(String address)
address
- The new addressString getShutdown()
void setShutdown(String shutdown)
shutdown
- The new shutdown commandvoid addService(Service service)
service
- The Service to be addedvoid await()
Service findService(String name)
null
.
name
- Name of the Service to be returnedService[] findServices()
void removeService(Service service)
service
- The Service to be removed
|
Apache Tomcat 7.0.0 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |