java.rmi
클래스 Naming

java.lang.Object 
  |
  +--java.rmi.Naming

public final class Naming

extends Object

Naming 클래스는 리모트 오브젝트 레지스트리로 리모트 오브젝트에의 참조를 저장해, 취득하기 위한 메소드를 제공합니다. Naming 클래스의 메소드는 그 인수의 1 개로서 URL 형식의 java.lang.String 인 다음과 같은 이름을 취합니다.

    //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 형식의 이름

반환값:

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

예외:

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

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

도입된 버젼:

JDK1. 1