java.rmi.registry
인터페이스 Registry

모든 슈퍼 인터페이스:

Remote

public interface Registry
extends Remote 

Registry는 단순한 리모트 객체 레지스트리에 대한 리모트 인터페이스로 임의의 캐릭터 라인명에 바인드 된 리모트 객체 참조를 포함 및 취득하기 위한 메서드를 제공합니다. bind, unbind 및 rebind 메서드는 레지스트리내의 네임 바인딩을 변경할 경우에 사용해, lookup 및 list 메서드는 현재의 네임 바인딩을 조회할 경우에 사용합니다.

Registry는 보통, RMI 클라이언트의 bootstrap를 유효하게 합니다. 클라이언트는 리모트 객체에의 초기 참조를 시작시에 취득합니다. 이 때문에 레지스트리의 리모트 객체 구현은 보통, 기존의 주소 (기존의 ObjID 등) 및 TCP 포트 번호 (디폴트는 1099 )와 함께 export 됩니다.

LocateRegistry 클래스에서는 리모트 주소에 있는 Registry에 의 bootstrap 참조를 구축하는 API (static getRegistry 메서드를 참조)와 현재의 VM에 Registry를 작성해 특정의 로컬 주소에 export 하는 API (static createRegistry 메서드를 참조)를 이용할 수 있습니다.

Registry 구현에서는 일부 또는 모든 메서드에 대한 액세스를 제한할 수 있습니다. 예를 들어 레지스트리의 바인딩을 변경하는 메서드는 로컬 호스트로부터의 호출에 제한할 수 있습니다. 특정의 Registry 메서드가 특정의 호출의 액세스를 거부했을 경우, AccessException을 발생시킵니다. 이 예외는 RemoteException 확장이기 때문에 리모트 클라이언트에 캐치 되면 ServerException에 랩 됩니다.

Registry로 바인딩에 사용하는 이름은 순수한 캐릭터 라인으로 해석되지 않습니다. Registry에 서비스에의 리모트 참조를 포함할 때는 레지스트리내에서의 이름의 중복을 줄이기 위해서 네임 바인딩의 접두사로서 패키지명을 사용하는 것을 추천합니다.

도입된 버전 :

JDK1. 1

관련 항목:

LocateRegistry

필드 개요

static int

REGISTRY_PORT 레지스트리에 자주 사용되는 포트입니다.

메서드 개요

void	bind (String name, Remote obj) 리모트 참조를, 이 레지스트리내의 특정의 name에 바인드 합니다.
String []	list () 이 레지스트리내에 바인드 된 이름의 배열을 리턴합니다.
Remote	lookup (String name) 이 레지스트리내의 특정의 name에 바인드 되고 있는 리모트 참조를 리턴합니다.
void	rebind (String name, Remote obj) 이 레지스트리내의 특정의 name에 의 바인딩을 특정의 리모트 참조에 옮겨놓습니다.
void	unbind (String name) 이 레지스트리의 특정의 name에 의 바인딩을 삭제합니다.

필드의 상세

REGISTRY_PORT

static final int REGISTRY_PORT

레지스트리에 자주 사용되는 포트입니다.

관련 항목:

정수 필드값

메서드의 상세

lookup

Remote  lookup(String  name)
              throws RemoteException,

                     NotBoundException,

                     AccessException 

이 레지스트리내의 특정의 name에 바인드 되고 있는 리모트 참조를 리턴합니다.

파라미터:

name - 검색하는 리모트 참조의 이름

반환값:

리모트 객체에의 참조

예외:

NotBoundException - name가 바인드되어 있지 않은 경우

RemoteException - 레지스트리와의 리모트 통신에 실패했을 경우. AccessException을 포함한 ServerException 예외의 경우, 레지스트리는 이 조작을 실행하는 호출측 액세스를 거부한다

AccessException - 로컬 레지스트리가 이 조작을 실행하는 호출측 액세스를 거부했을 경우

NullPointerException - name가 null인 경우

bind

void bind(String  name,
          Remote  obj)
          throws RemoteException,

                 AlreadyBoundException,

                 AccessException 

리모트 참조를, 이 레지스트리내의 특정의 name에 바인드 합니다.

파라미터:

name - 리모트 참조에 관련짓는 이름

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

예외:

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

RemoteException - 레지스트리와의 리모트 통신에 실패했을 경우. AccessException을 포함한 ServerException 예외의 경우, 레지스트리는 이 조작을 실행하는 호출측 액세스를 거부한다 (로컬이 아닌 호스트로부터 액세스 하려고 했을 경우 등)

AccessException - 로컬 레지스트리가 이 조작을 실행하는 호출측 액세스를 거부했을 경우

NullPointerException - name가 null, 또는 obj가 null인 경우

unbind

void unbind(String  name)
            throws RemoteException,

                   NotBoundException,

                   AccessException 

이 레지스트리의 특정의 name에 의 바인딩을 삭제합니다.

파라미터:

name - 삭제하는 바인딩의 이름

예외:

NotBoundException - name가 바인드되어 있지 않은 경우

RemoteException - 레지스트리와의 리모트 통신에 실패했을 경우. AccessException을 포함한 ServerException 예외의 경우, 레지스트리는 이 조작을 실행하는 호출측 액세스를 거부한다 (로컬이 아닌 호스트로부터 액세스 하려고 했을 경우 등)

AccessException - 로컬 레지스트리가 이 조작을 실행하는 호출측 액세스를 거부했을 경우

NullPointerException - name가 null인 경우

rebind

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

                   AccessException 

이 레지스트리내의 특정의 name에 의 바인딩을 특정의 리모트 참조에 옮겨놓습니다. 그 name에 이미 바인딩이 설정되어 있는 경우는 파기됩니다.

파라미터:

name - 리모트 참조에 관련짓는 이름

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

예외:

RemoteException - 레지스트리와의 리모트 통신에 실패했을 경우. AccessException을 포함한 ServerException 예외의 경우, 레지스트리는 이 조작을 실행하는 호출측 액세스를 거부한다 (로컬이 아닌 호스트로부터 액세스 하려고 했을 경우 등)

AccessException - 로컬 레지스트리가 이 조작을 실행하는 호출측 액세스를 거부했을 경우

NullPointerException - name가 null, 또는 obj가 null인 경우

list

String [] list()
              throws RemoteException,

                     AccessException 

이 레지스트리내에 바인드 된 이름의 배열을 리턴합니다. 배열에는 이 메서드를 호출한 시점에서 레지스트리내에 바인드 되고 있는 이름의 snapshot가 포함됩니다.

반환값:

이 레지스트리내에 바인드 된 이름의 배열

예외:

RemoteException - 레지스트리와의 리모트 통신에 실패했을 경우. AccessException을 포함한 ServerException 예외의 경우, 레지스트리는 이 조작을 실행하는 호출측 액세스를 거부한다

AccessException - 로컬 레지스트리가 이 조작을 실행하는 호출측 액세스를 거부했을 경우