KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > exolab > jms > net > orb > RegistryService


1 /**
2  * Redistribution and use of this software and associated documentation
3  * ("Software"), with or without modification, are permitted provided
4  * that the following conditions are met:
5  *
6  * 1. Redistributions of source code must retain copyright
7  * statements and notices. Redistributions must also contain a
8  * copy of this document.
9  *
10  * 2. Redistributions in binary form must reproduce the
11  * above copyright notice, this list of conditions and the
12  * following disclaimer in the documentation and/or other
13  * materials provided with the distribution.
14  *
15  * 3. The name "Exolab" must not be used to endorse or promote
16  * products derived from this Software without prior written
17  * permission of Exoffice Technologies. For written permission,
18  * please contact info@exolab.org.
19  *
20  * 4. Products derived from this Software may not be called "Exolab"
21  * nor may "Exolab" appear in their names without prior written
22  * permission of Exoffice Technologies. Exolab is a registered
23  * trademark of Exoffice Technologies.
24  *
25  * 5. Due credit should be given to the Exolab Project
26  * (http://www.exolab.org/).
27  *
28  * THIS SOFTWARE IS PROVIDED BY EXOFFICE TECHNOLOGIES AND CONTRIBUTORS
29  * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
30  * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
31  * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
32  * EXOFFICE TECHNOLOGIES OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
33  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
34  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
35  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
37  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
38  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
39  * OF THE POSSIBILITY OF SUCH DAMAGE.
40  *
41  * Copyright 2003-2004 (C) Exoffice Technologies Inc. All Rights Reserved.
42  *
43  * $Id: RegistryService.java,v 1.1 2004/11/26 01:51:04 tanderson Exp $
44  */
45 package org.exolab.jms.net.orb;
46
47 import java.rmi.AlreadyBoundException JavaDoc;
48 import java.rmi.NotBoundException JavaDoc;
49 import java.rmi.RemoteException JavaDoc;
50 import java.rmi.server.ObjID JavaDoc;
51
52 import org.exolab.jms.net.proxy.Proxy;
53 import org.exolab.jms.net.registry.LocalRegistry;
54
55
56 /**
57  * The <code>RegistryService</code> provides a simple interface for binding and
58  * retrieving remote object references by name.
59  *
60  * @author <a HREF="mailto:tma@netspace.net.au">Tim Anderson</a>
61  * @version $Revision: 1.1 $ $Date: 2004/11/26 01:51:04 $
62  */
63 class RegistryService implements LocalRegistry {
64
65     /**
66      * The registry implementation
67      */
68     private RegistryImpl _registry = new RegistryImpl();
69
70
71     /**
72      * Construct a new <code>RegistryService</code> and export the registry on
73      * its well known address
74      *
75      * @param orb the orb
76      * @throws RemoteException if the service cannot be exported
77      */
78     public RegistryService(ORB orb) throws RemoteException JavaDoc {
79         if (orb == null) {
80             throw new IllegalArgumentException JavaDoc("Argument 'orb' is null");
81         }
82         orb.exportObject(_registry, new ObjID JavaDoc(ObjID.REGISTRY_ID));
83     }
84
85     /**
86      * Returns a proxy for the remote object associated with the specified name
87      *
88      * @param name the name the proxy is bound under
89      * @return proxy the proxy for the remote object
90      * @throws NotBoundException if <code>name<code> is not bound
91      */
92     public Proxy lookup(String JavaDoc name) throws NotBoundException JavaDoc {
93         return _registry.lookup(name);
94     }
95
96     /**
97      * Binds the specified name to a remote object.
98      *
99      * @param name the name of the binding
100      * @param proxy the proxy for the remote object
101      * @throws AlreadyBoundException if <code>name</code> is already bound
102      */
103     public void bind(String JavaDoc name, Proxy proxy) throws AlreadyBoundException JavaDoc {
104         _registry.doBind(name, proxy);
105     }
106
107     /**
108      * Removes the binding for the specified name
109      *
110      * @param name the name of the binding
111      * @throws NotBoundException if <code>name<code> is not bound
112      */
113     public synchronized void unbind(String JavaDoc name) throws NotBoundException JavaDoc {
114         _registry.doUnbind(name);
115     }
116
117     /**
118      * Set if the registry is read-only
119      *
120      * @param readOnly if <code>true</code>, prevent remote users from modifying
121      * bindings
122      */
123     public void setReadOnly(boolean readOnly) {
124         _registry.setReadOnly(readOnly);
125     }
126
127     /**
128      * Determines if the registry is read-only
129      *
130      * @return <code>true</code> if the registry is read-only
131      */
132     public boolean getReadOnly() {
133         return _registry.getReadOnly();
134     }
135
136 }
137
Popular Tags