Base file: X:\carol_checkin_archive\carol-429\src\org\objectweb\carol\jndi\ns\NameService.java

Modified file: X:\carol_checkin_archive\carol-430\src\org\objectweb\carol\jndi\ns\NameService.java

 
1:  /**
2:   * Copyright (C) 2002,2005 - INRIA (www.inria.fr)
3:   *
4:   * CAROL: Common Architecture for RMI ObjectWeb Layer
5:   *
6:   * This library is developed inside the ObjectWeb Consortium,
7:   * http://www.objectweb.org
8:   *
9:   * This library is free software; you can redistribute it and/or
10:  * modify it under the terms of the GNU Lesser General Public
11:  * License as published by the Free Software Foundation; either
12:  * version 2.1 of the License, or any later version.
13:  *
14:  * This library is distributed in the hope that it will be useful,
15:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17:  * Lesser General Public License for more details.
18:  *
19:  * You should have received a copy of the GNU Lesser General Public
20:  * License along with this library; if not, write to the Free Software
21:  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
22:  * USA
23:  *
24:  * --------------------------------------------------------------------------
25:  * $Id: NameService.java 388 2005-02-17 16:48:44Z430 2005-03-10 12:21:46Z benoitf $
26:  * --------------------------------------------------------------------------
27:  */
28: package org.objectweb.carol.jndi.ns;
29: 
30: import java.util.Properties;
31: 
32: /**
33:  * Interface <code> NameService </code> is the CAROL Name Service generic
34:  * interface. This is the carol SPI for a Name Service
35:  * @author Guillaume Riviere (Guillaume.Riviere@inrialpes.fr)
36:  * @author Florent Benoit (Add methods for fixing firewall issues)
37:  */
38: public interface NameService {
39: 
40:     /**
41:      * start Method, Start a new NameService or do nothing if the name service
42:      * is all ready start
43:      * @throws NameServiceException if a problem occure
44:      */
45:     void start() throws NameServiceException;
46: 
47:     /**
48:      * stop Method, Stop a NameService or do nothing if the name service is all
49:      * ready stop
50:      * @throws NameServiceException if a problem occure
51:      */
52:     void stop() throws NameServiceException;
53: 
54:     /**
55:      * isStarted Method, check if a name service is started
56:      * @return boolean true if the name service is started
57:      */
58:     boolean isStarted();
59: 
60:     /**
61:      * set port method, set the port for the name service
62:      * @param p port number
63:      */
64:     void setPort(int p);
65: 
66:     /**
67:      * get port method, get the port for the name service
68:      * @return int port number
69:      */
70:      int getPort();
71: 
72:     /**
73:      * Set the address to use for bind
74:      * @param host hostname/ip address
75:      */
76:     void setHost(String host);
77: 
78:     /**
79:      * @return hostname/ip to use
80:      */
81:      String getHost();
82: 
83:      /**
84:       * Set the configuration properties of the protocol
85:       * @param p configuration properties
86:       */
87:      void setConfigProperties(Properties p);
88: }