| /* Naming.java -- |
| Copyright (c) 1996, 1997, 1998, 1999, 2004 Free Software Foundation, Inc. |
| |
| This file is part of GNU Classpath. |
| |
| GNU Classpath is free software; you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 2, or (at your option) |
| any later version. |
| |
| GNU Classpath is distributed in the hope that it will be useful, but |
| WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with GNU Classpath; see the file COPYING. If not, write to the |
| Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA |
| 02111-1307 USA. |
| |
| Linking this library statically or dynamically with other modules is |
| making a combined work based on this library. Thus, the terms and |
| conditions of the GNU General Public License cover the whole |
| combination. |
| |
| As a special exception, the copyright holders of this library give you |
| permission to link this library with independent modules to produce an |
| executable, regardless of the license terms of these independent |
| modules, and to copy and distribute the resulting executable under |
| terms of your choice, provided that you also meet, for each linked |
| independent module, the terms and conditions of the license of that |
| module. An independent module is a module which is not derived from |
| or based on this library. If you modify this library, you may extend |
| this exception to your version of the library, but you are not |
| obligated to do so. If you do not wish to do so, delete this |
| exception statement from your version. */ |
| |
| |
| package java.rmi; |
| |
| import java.net.MalformedURLException; |
| import java.net.URL; |
| import java.rmi.registry.LocateRegistry; |
| import java.rmi.registry.Registry; |
| |
| public final class Naming { |
| /** |
| * This class isn't intended to be instantiated. |
| */ |
| private Naming() {} |
| |
| /** |
| * Looks for the remote object that is associated with the named service. |
| * Name and location is given in form of a URL without a scheme: |
| * |
| * <pre> |
| * //host:port/service-name |
| * </pre> |
| * |
| * The port is optional. |
| * |
| * @param name the service name and location |
| * @return Remote-object that implements the named service |
| * @throws NotBoundException if no object implements the service |
| * @throws MalformedURLException |
| * @throws RemoteException |
| */ |
| public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException { |
| // hack to accept "rmi://host:port/service" strings |
| if(name.startsWith("rmi:")){ name = name.substring(4); } |
| URL u = new URL("http:" + name); |
| String filename = u.getFile(); |
| |
| // If the filename begins with a slash we must cut it for |
| // name resolution. |
| if (filename.charAt(0) == '/') |
| return (getRegistry(u).lookup(filename.substring(1))); |
| else |
| return (getRegistry(u).lookup(filename)); |
| } |
| |
| /** |
| * Try to bind the given object to the given service name. |
| * @param name |
| * @param obj |
| * @throws AlreadyBoundException |
| * @throws MalformedURLException |
| * @throws RemoteException |
| */ |
| public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException { |
| URL u = new URL("http:" + name); |
| String filename = u.getFile(); |
| // If the filename begins with a slash we must cut it for |
| // name resolution. |
| if (filename.charAt(0) == '/') |
| getRegistry(u).bind(filename.substring(1), obj); |
| else |
| getRegistry(u).bind(filename, obj); |
| } |
| |
| /** |
| * Remove a binding for a given service name. |
| * @param name |
| * @throws RemoteException |
| * @throws NotBoundException |
| * @throws MalformedURLException |
| */ |
| public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException { |
| URL u = new URL("http:" + name); |
| String filename = u.getFile(); |
| // If the filename begins with a slash we must cut it for |
| // name resolution. |
| if (filename.charAt(0) == '/') |
| getRegistry(u).unbind(filename.substring(1)); |
| else |
| getRegistry(u).unbind(filename); |
| } |
| |
| /** |
| * Forces the binding between the given Remote-object and the given service name, even |
| * if there was already an object bound to this name. |
| * @param name |
| * @param obj |
| * @throws RemoteException |
| * @throws MalformedURLException |
| */ |
| public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException { |
| URL u = new URL("http:" + name); |
| String filename = u.getFile(); |
| // If the filename begins with a slash we must cut it for |
| // name resolution. |
| if (filename.charAt(0) == '/') |
| getRegistry(u).rebind(filename.substring(1), obj); |
| else |
| getRegistry(u).rebind(filename, obj); |
| } |
| |
| /** |
| * Lists all services at the named registry. |
| * @param name url that specifies the registry |
| * @return list of services at the name registry |
| * @throws RemoteException |
| * @throws MalformedURLException |
| */ |
| public static String[] list(String name) throws RemoteException, MalformedURLException { |
| return (getRegistry(new URL("http:" + name)).list()); |
| } |
| |
| private static Registry getRegistry(URL u) throws RemoteException { |
| if (u.getPort() == -1) { |
| return (LocateRegistry.getRegistry(u.getHost())); |
| } |
| else { |
| return (LocateRegistry.getRegistry(u.getHost(), u.getPort())); |
| } |
| } |
| |
| } |