Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Licensed to the Apache Software Foundation (ASF) under one or more
   * contributor license agreements.  See the NOTICE file distributed with
   * this work for additional information regarding copyright ownership.
   * The ASF licenses this file to You under the Apache License, Version 2.0
   * (the "License"); you may not use this file except in compliance with
   * the License.  You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 
 
 package org.apache.catalina;
 
 
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(s):
Craig R. McClanahan
Version:
$Revision: 1850 $ $Date: 2011-10-12 16:52:10 +0200 (Wed, 12 Oct 2011) $
 
 
 public interface Service {
 
     // ------------------------------------------------------------- Properties
 

    
Return the Container that handles requests for all Connectors associated with this Service.
 
     public Container getContainer();

    
Set the Container that handles requests for all Connectors associated with this Service.

Parameters:
container The new Container
 
     public void setContainer(Container container);

    
Return descriptive information about this Service implementation and the corresponding version number, in the format <description>/<version>.
 
     public String getInfo();

    
Return the Mapper that handles mapping for all Connectors associated with this Service.
 
     public Mapper getMapper();

    
Return the name of this Service.
 
     public String getName();

    
Set the name of this Service.

Parameters:
name The new service name
 
     public void setName(String name);

    
Return the entropy increaser value, or compute a semi-useful value if this String has not yet been set.
 
     public String getEntropy();
    
    
Set the entropy increaser value.

Parameters:
entropy The new entropy increaser value
 
     public void setEntropy(String entropy);
    
    
Return the Server with which we are associated (if any).
 
    public Server getServer();

    
Set the Server with which we are associated (if any).

Parameters:
server The server that owns this Service
    public void setServer(Server server);
    // --------------------------------------------------------- Public Methods


    
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
    public void addConnector(Connector connector);

    
Find and return the set of Connectors associated with this Service.
    public Connector[] findConnectors();

    
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
    public void removeConnector(Connector connector);

    
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.
    public void initialize() throws LifecycleException;

    
Adds a named executor to the service

Parameters:
ex Executor
    public void addExecutor(Executor ex);

    
Retrieves all executors

Returns:
Executor[]
    public Executor[] findExecutors();

    
Retrieves executor by name, null if not found

Parameters:
name String
Returns:
Executor
    public Executor getExecutor(String name);
    
    
Removes an executor from the service

Parameters:
ex Executor
    public void removeExecutor(Executor ex);

    
Get the global secure random that will be used for this service.
    public SecureRandom getRandom();
    
New to GrepCode? Check out our FAQ X