File	Doc	Category	Size	Date	Package
Naming.java	API Doc	Java SE 5 API	9653	Fri Aug 26 14:57:10 BST 2005	java.rmi

Naming

• java.lang.Object

//host:port/name

Fields Summary

Constructors Summary
private Naming() Disallow anyone from creating one of these

Methods Summary
public static void	bind(java.lang.String name, java.rmi.Remote obj) Binds the specified name to a remote object. param name a name in URL format (without the scheme component) param obj a reference for the remote object (usually a stub) exception AlreadyBoundException if name is already bound exception MalformedURLException if the name is not an appropriately formatted URL exception RemoteException if registry could not be contacted exception AccessException if this operation is not permitted (if originating from a non-local host, for example) since JDK1.1 ParsedNamingURL parsed = parseURL(name); Registry registry = getRegistry(parsed); if (obj == null) throw new NullPointerException("cannot bind to null"); registry.bind(parsed.name, obj);
private static java.rmi.registry.Registry	getRegistry(java.rmi.Naming$ParsedNamingURL parsed) Returns a registry reference obtained from information in the URL. return LocateRegistry.getRegistry(parsed.host, parsed.port);
public static java.lang.String[]	list(java.lang.String name) Returns an array of the names bound in the registry. The names are URL-formatted (without the scheme component) strings. The array contains a snapshot of the names present in the registry at the time of the call. param name a registry name in URL format (without the scheme component) return an array of names (in the appropriate format) bound in the registry exception MalformedURLException if the name is not an appropriately formatted URL exception RemoteException if registry could not be contacted. since JDK1.1 ParsedNamingURL parsed = parseURL(name); Registry registry = getRegistry(parsed); String prefix = ""; if (parsed.port > 0 || !parsed.host.equals("")) prefix += "//" + parsed.host; if (parsed.port > 0) prefix += ":" + parsed.port; prefix += "/"; String[] names = registry.list(); for (int i = 0; i < names.length; i++) { names[i] = prefix + names[i]; } return names;
public static java.rmi.Remote	lookup(java.lang.String name) Returns a reference, a stub, for the remote object associated with the specified name. param name a name in URL format (without the scheme component) return a reference for a remote object exception NotBoundException if name is not currently bound exception RemoteException if registry could not be contacted exception AccessException if this operation is not permitted exception MalformedURLException if the name is not an appropriately formatted URL since JDK1.1 ParsedNamingURL parsed = parseURL(name); Registry registry = getRegistry(parsed); if (parsed.name == null) return registry; return registry.lookup(parsed.name);
private static java.rmi.Naming$ParsedNamingURL	parseURL(java.lang.String str) Dissect Naming URL strings to obtain referenced host, port and object name. return an object which contains each of the above components. exception MalformedURLException if given url string is malformed try { URI uri = new URI(str); if (uri.getFragment() != null) { throw new MalformedURLException( "invalid character, '#', in URL name: " + str); } else if (uri.getQuery() != null) { throw new MalformedURLException( "invalid character, '?', in URL name: " + str); } else if (uri.getUserInfo() != null) { throw new MalformedURLException( "invalid character, '@', in URL host: " + str); } String scheme = uri.getScheme(); if (scheme != null && !scheme.equals("rmi")) { throw new MalformedURLException("invalid URL scheme: " + str); } String name = uri.getPath(); if (name != null) { if (name.startsWith("/")) { name = name.substring(1); } if (name.length() == 0) { name = null; } } String host = uri.getHost(); if (host == null) { host = ""; if (uri.getPort() == -1) { /* handle URIs with explicit port but no host * (e.g., "//:1098/foo"); although they do not strictly * conform to RFC 2396, Naming's javadoc explicitly allows * them. */ String authority = uri.getAuthority(); if (authority != null && authority.startsWith(":")) { authority = "localhost" + authority; uri = new URI(null, authority, null, null, null); } } } int port = uri.getPort(); if (port == -1) { port = Registry.REGISTRY_PORT; } return new ParsedNamingURL(host, port, name); } catch (URISyntaxException ex) { throw (MalformedURLException) new MalformedURLException( "invalid URL string: " + str).initCause(ex); }
public static void	rebind(java.lang.String name, java.rmi.Remote obj) Rebinds the specified name to a new remote object. Any existing binding for the name is replaced. param name a name in URL format (without the scheme component) param obj new remote object to associate with the name exception MalformedURLException if the name is not an appropriately formatted URL exception RemoteException if registry could not be contacted exception AccessException if this operation is not permitted (if originating from a non-local host, for example) since JDK1.1 ParsedNamingURL parsed = parseURL(name); Registry registry = getRegistry(parsed); if (obj == null) throw new NullPointerException("cannot bind to null"); registry.rebind(parsed.name, obj);
public static void	unbind(java.lang.String name) Destroys the binding for the specified name that is associated with a remote object. param name a name in URL format (without the scheme component) exception NotBoundException if name is not currently bound exception MalformedURLException if the name is not an appropriately formatted URL exception RemoteException if registry could not be contacted exception AccessException if this operation is not permitted (if originating from a non-local host, for example) since JDK1.1 ParsedNamingURL parsed = parseURL(name); Registry registry = getRegistry(parsed); registry.unbind(parsed.name);