ServiceHandler


1   /*
2    * The contents of this file are subject to the terms 
3    * of the Common Development and Distribution License 
4    * (the License).  You may not use this file except in
5    * compliance with the License.
6    * 
7    * You can obtain a copy of the license at 
8    * https://glassfish.dev.java.net/public/CDDLv1.0.html or
9    * glassfish/bootstrap/legal/CDDLv1.0.txt.
10   * See the License for the specific language governing 
11   * permissions and limitations under the License.
12   * 
13   * When distributing Covered Code, include this CDDL 
14   * Header Notice in each file and include the License file 
15   * at glassfish/bootstrap/legal/CDDLv1.0.txt.  
16   * If applicable, add the following below the CDDL Header, 
17   * with the fields enclosed by brackets [] replaced by
18   * you own identifying information: 
19   * "Portions Copyrighted [year] [name of copyright owner]"
20   * 
21   * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
22   */
23  
24  package com.sun.enterprise.admin.servermgmt;
25  
26  import java.util.Map  ;
27  
28  /** An interface to handle life cycle of a Service as recognized by an operating
29   * platform.
30   */
31  public interface ServiceHandler {
32      
33      /** Creates an arbitrary service, specified by certain parameters. The implementations
34       * should dictate the mappings in the parameters received. The creation of service is
35       * either successful or not. In other words, the implementations must retain the original
36       * state of the operating platform if the service creation is not successful completely.
37       * @param params a Map between Strings that represents the name value pairs required to create the service
38       * @throws RuntimeException if there is any error is creation of service
39       */
40      public void createService(final Map  <String  , String  > params) throws RuntimeException  ;
41      
42      /** Sets the trace flag. The ServiceHandler is expected to provide trace output if the flag is set.
43       */
44      public void setTrace(final boolean trace);
45  }
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags