01: /**
02: * JOnAS: Java(TM) Open Application Server
03: * Copyright (C) 1999 Bull S.A.
04: * Contact: jonas-team@objectweb.org
05: *
06: * This library is free software; you can redistribute it and/or
07: * modify it under the terms of the GNU Lesser General Public
08: * License as published by the Free Software Foundation; either
09: * version 2.1 of the License, or any later version.
10: *
11: * This library is distributed in the hope that it will be useful,
12: * but WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * Lesser General Public License for more details.
15: *
16: * You should have received a copy of the GNU Lesser General Public
17: * License along with this library; if not, write to the Free Software
18: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19: * USA
20: *
21: * Initial developer(s): ____________________________________.
22: * Contributor(s): ______________________________________.
23: *
24: * 01/06/15 Regis Le Brettevillois - Libelis / JOnAS team - Evidian
25: * Creation.
26: *
27: * --------------------------------------------------------------------------
28: * $Id: Service.java 5297 2004-08-23 13:07:03Z sauthieg $
29: * --------------------------------------------------------------------------
30: */package org.objectweb.jonas.service;
31:
32: import javax.naming.Context;
33:
34: /**
35: * This interface defines a Service.
36: * Objects which implement this interface must have a public constructor
37: * with a string parameter which is the name of the service.
38: */
39: public interface Service {
40:
41: /**
42: * Initialize the service
43: * @param ctx configuration of the service
44: * @throws ServiceException when init fails.
45: */
46: void init(Context ctx) throws ServiceException;
47:
48: /**
49: * Start the service
50: * @throws ServiceException when start fails.
51: */
52: void start() throws ServiceException;
53:
54: /**
55: * Stop the service
56: * @throws ServiceException when stop fails.
57: */
58: void stop() throws ServiceException;
59:
60: /**
61: * @return Returns true if the service is started, false otherwise
62: */
63: boolean isStarted();
64:
65: /**
66: * Set the service's name
67: * @param name the service's name
68: */
69: void setName(String name);
70:
71: /**
72: * @return Returns the service's name
73: */
74: String getName();
75: }
|