libjava/java/rmi/Naming.java

   1 /*
   2   Copyright (c) 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
   3
   4 This file is part of GNU Classpath.
   5
   6 GNU Classpath is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU Classpath is distributed in the hope that it will be useful, but
  12 WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU Classpath; see the file COPYING.  If not, write to the
  18 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  19 02111-1307 USA.
  20
  21 Linking this library statically or dynamically with other modules is
  22 making a combined work based on this library.  Thus, the terms and
  23 conditions of the GNU General Public License cover the whole
  24 combination.
  25
  26 As a special exception, the copyright holders of this library give you
  27 permission to link this library with independent modules to produce an
  28 executable, regardless of the license terms of these independent
  29 modules, and to copy and distribute the resulting executable under
  30 terms of your choice, provided that you also meet, for each linked
  31 independent module, the terms and conditions of the license of that
  32 module.  An independent module is a module which is not derived from
  33 or based on this library.  If you modify this library, you may extend
  34 this exception to your version of the library, but you are not
  35 obligated to do so.  If you do not wish to do so, delete this
  36 exception statement from your version. */
  37
  38 package java.rmi;
  39
  40 import java.net.MalformedURLException;
  41 import java.net.URL;
  42 import java.rmi.registry.Registry;
  43 import java.rmi.registry.LocateRegistry;
  44
  45 public final class Naming {
  46
  47 /** <pre>
  48  * Looks for the remote object that is associated with the named service.
  49  * Name and location is given in form of a URL without a scheme:
  50  *
  51  *   //host:port/service-name
  52  *
  53  * The port is optional.
  54  * </pre>
  55  * @param name the service name and location
  56  * @return Remote-object that implements the named service
  57  * @throws NotBoundException if no object implements the service
  58  * @throws MalformedURLException
  59  * @throws RemoteException
  60  */
  61 public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException {
  62         // hack to accept "rmi://host:port/service" strings
  63         if(name.startsWith("rmi:")){ name = name.substring(4); }
  64         URL u = new URL("http:" + name);
  65         return (getRegistry(u).lookup(u.getFile().substring(1)));
  66 }
  67
  68 /**
  69  * Try to bind the given object to the given service name.
  70  * @param name
  71  * @param obj
  72  * @throws AlreadyBoundException
  73  * @throws MalformedURLException
  74  * @throws RemoteException
  75  */
  76 public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException {
  77         URL u = new URL("http:" + name);
  78         getRegistry(u).bind(u.getFile().substring(1), obj);
  79 }
  80
  81 /**
  82  * Remove a binding for a given service name.
  83  * @param name
  84  * @throws RemoteException
  85  * @throws NotBoundException
  86  * @throws MalformedURLException
  87  */
  88 public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException {
  89         URL u = new URL("http:" + name);
  90         getRegistry(u).unbind(u.getFile().substring(1));
  91 }
  92
  93 /**
  94  * Forces the binding between the given Remote-object and the given service name, even
  95  * if there was already an object bound to this name.
  96  * @param name
  97  * @param obj
  98  * @throws RemoteException
  99  * @throws MalformedURLException
 100  */
 101 public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException {
 102         URL u = new URL("http:" + name);
 103         getRegistry(u).rebind(u.getFile().substring(1), obj);
 104 }
 105
 106 /**
 107  * Lists all services at the named registry.
 108  * @param name url that specifies the registry
 109  * @return list of services at the name registry
 110  * @throws RemoteException
 111  * @throws MalformedURLException
 112  */
 113 public static String[] list(String name) throws RemoteException, MalformedURLException {
 114         return (getRegistry(new URL("http:" + name)).list());
 115 }
 116
 117 private static Registry getRegistry(URL u) throws RemoteException {
 118         if (u.getPort() == -1) {
 119                 return (LocateRegistry.getRegistry(u.getHost()));
 120         }
 121         else {
 122                 return (LocateRegistry.getRegistry(u.getHost(), u.getPort()));
 123         }
 124 }
 125
 126 }