java.rmi
클래스 Naming

java.lang.Object 
  java.rmi.Naming

public final class Naming
extends Object 

Naming 클래스는 리모트 객체 레지스트리내의 리모트 객체에의 참조를 취득 및 포함하기 위한 메서드를 제공합니다. Naming 클래스의 각 메서드는 그 인수의 1개 로서 다음과 같은 java.lang.String 형의 URL 형식 (다만 스킴 요소는 제외하다)의 이름을 취합니다.

 //host:port/name

host는 레지스트리가 있는 (리모트 또는 로컬) 호스트, port는 레지스트리가 호출을 받아들이는 포트 번호, name는 레지스트리에 의해 해석되지 않는 단순한 캐릭터 라인입니다. host 및 port 지정은 생략 가능합니다. host를 생략 하면, 디폴트로 로컬 호스트가 사용됩니다. port를 생략 하면, 포트는 디폴트로 1099가 됩니다. 이것은 RMI 레지스트리 rmiregistry가 사용하는 「잘 알려졌다」포트입니다.

리모트 객체의 이름의 「바인딩」이란 나중에 이 리모트 객체를 검색해 사용할 수 있도록, 리모트 객체에 이름을 관련짓는다, 혹은 등록하는 것을 말합니다. Naming 클래스의 bind 메서드 또는 rebind 메서드를 사용해, 리모트 객체를 이름과 관련지을 수가 있습니다.

리모트 객체가 로컬 호스트로 RMI 레지스트리에 등록 (바인딩)되면, 리모트 (또는 로컬) 호스트의 호출측은 이름으로 리모트 객체를 참조해, 그 참조를 취득해, 그 객체로 리모트 메서드를 호출할 수 있습니다 . 레지스트리는 호스트로 동작하고 있는 모든 서버로 공유할 수 있어 필요한 경우는 개개의 서버 프로세스가 독자적인 레지스트리를 작성 및 사용할 수도 있습니다. 자세한 내용은 java.rmi.registry.LocateRegistry.createRegistry 메서드를 참조하십시오.

도입된 버전 :

JDK1. 1

관련 항목:

Registry, LocateRegistry, LocateRegistry.createRegistry(int)

메서드 개요

static void	bind (String name, Remote obj) 지정된 name를 리모트 객체에 바인드 합니다.
static String []	list (String name) 레지스트리내의 바인드 되고 있는 이름의 배열을 리턴합니다.
static Remote	lookup (String name) 지정된 name에 관련한 리모트 객체의 참조 (스텁)를 리턴합니다.
static void	rebind (String name, Remote obj) 지정된 이름을 새로운 리모트 객체에 바인드 다시 합니다.
static void	unbind (String name) 리모트 객체에 관련한 지정된 이름에 대한 바인딩을 파기합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

메서드의 상세

lookup

public static Remote  lookup(String  name)
                     throws NotBoundException,

                            MalformedURLException,

                            RemoteException 

지정된 name에 관련한 리모트 객체의 참조 (스텁)를 리턴합니다.

파라미터:

name - URL 형식의 이름 (다만 스킴 요소는 제외하다)

반환값:

리모트 객체의 참조

예외:

NotBoundException - 이름이 바인드되어 있지 않은 경우

RemoteException - 레지스트리에 접속할 수 없는 경우

AccessException - 이 조작이 허가되어 있지 않은 경우

MalformedURLException - 이름이 적절한 형식의 URL가 아닌 경우

도입된 버전 :

JDK1. 1

bind

public static void bind(String  name,
                        Remote  obj)
                 throws AlreadyBoundException,

                        MalformedURLException,

                        RemoteException 

지정된 name를 리모트 객체에 바인드 합니다.

파라미터:

name - URL 형식의 이름 (다만 스킴 요소는 제외하다)

obj - 리모트 객체의 참조 (일반적으로 스텁)

예외:

AlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

MalformedURLException - 이름이 적절한 형식의 URL가 아닌 경우

RemoteException - 레지스트리에 접속할 수 없는 경우

AccessException - 이 조작이 허가되어 있지 않은 경우 (예를 들어 로컬이 아닌 호스트로부터 조작하고 있는 경우)

도입된 버전 :

JDK1. 1

unbind

public static void unbind(String  name)
                   throws RemoteException,

                          NotBoundException,

                          MalformedURLException 

리모트 객체에 관련한 지정된 이름에 대한 바인딩을 파기합니다.

파라미터:

name - URL 형식의 이름 (다만 스킴 요소는 제외하다)

예외:

NotBoundException - 이름이 바인드되어 있지 않은 경우

MalformedURLException - 이름이 적절한 형식의 URL가 아닌 경우

RemoteException - 레지스트리에 접속할 수 없는 경우

AccessException - 이 조작이 허가되어 있지 않은 경우 (예를 들어 로컬이 아닌 호스트로부터 조작하고 있는 경우)

도입된 버전 :

JDK1. 1

rebind

public static void rebind(String  name,
                          Remote  obj)
                   throws RemoteException,

                          MalformedURLException 

지정된 이름을 새로운 리모트 객체에 바인드 다시 합니다. 이름에 대한 기존의 바인딩은 옮겨놓을 수 있습니다.

파라미터:

name - URL 형식의 이름 (다만 스킴 요소는 제외하다)

obj - 이름에 관련한 새로운 리모트 객체

예외:

MalformedURLException - 이름이 적절한 형식의 URL가 아닌 경우

RemoteException - 레지스트리에 접속할 수 없는 경우

AccessException - 이 조작이 허가되어 있지 않은 경우 (예를 들어 로컬이 아닌 호스트로부터 조작하고 있는 경우)

도입된 버전 :

JDK1. 1

list

public static String [] list(String  name)
                     throws RemoteException,

                            MalformedURLException 

레지스트리내의 바인드 되고 있는 이름의 배열을 리턴합니다. 이름은 URL 형식 (다만 스킴 요소는 제외하다)의 캐릭터 라인입니다. 배열에는 호출의 시점에서 레지스트리에 존재하는 이름의 snapshot를 포함합니다.

파라미터:

name - URL 형식의 레지스트리명 (다만 스킴 요소는 제외하다)

반환값:

레지스트리내의 바인드 되고 있는 이름 (적절한 형식)의 배열

예외:

MalformedURLException - 이름이 적절한 형식의 URL가 아닌 경우

RemoteException - 레지스트리에 접속할 수 없는 경우

도입된 버전 :

JDK1. 1