java.rmi.registry
클래스 LocateRegistry

java.lang.Object 
  java.rmi.registry.LocateRegistry

public final class LocateRegistry
extends Object 

LocateRegistry는 로컬 호스트등의 특정의 호스트상에 있는 bootstrap용 리모트 객체 레지스트리에의 참조를 취득하거나 특정의 포트에의 호출을 받아들이는 리모트 객체 레지스트리를 작성하거나 하기 위해서 사용됩니다.

getRegistry 호출은 리모트 호스트에게로의 접속을 확립하는 것은 아닙니다. 실제로는 리모트 레지스트리에의 로컬 참조가 작성되는 것만으로 있어, 이것은 리모트 호스트상에서 레지스트리가 실행되어 있지 않은 경우에서도 행해집니다. 따라서, 이 메서드에 의해 리턴된 리모트 레지스트리를 호출하는 후속의 메서드는 실패하는 경우도 있습니다.

도입된 버전 :

JDK1. 1

관련 항목:

Registry

메서드 개요

static Registry	createRegistry (int port) 로컬 호스트상에 지정된 port로 요구를 받아들이는 Registry인스턴스를 작성해 export 합니다.
static Registry	createRegistry (int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 커스텀 소켓 팩토리를 사용해 그 인스턴스와의 통신을 실시하는 Registry인스턴스를, 로컬 호스트상에서 작성 및 export 합니다.
static Registry	getRegistry () 디폴트의 레지스트리 포트인 1099 번 포트를 사용하는 로컬 호스트용의 리모트 객체 Registry에 의 참조를 리턴합니다.
static Registry	getRegistry (int port) 지정된 port를 사용하는 로컬 호스트용의 리모트 객체 Registry에 의 참조를 리턴합니다.
static Registry	getRegistry (String host) 디폴트 레지스트리 포트인 1099 번 포트를 사용해, 지정된 호스트상에서 동작하는 리모트 객체 Registry에 의 참조를 리턴합니다.
static Registry	getRegistry (String host, int port) 지정된 port를 사용해, 지정된 호스트상에서 동작하는 리모트 객체 Registry에 의 참조를 리턴합니다.
static Registry	getRegistry (String host, int port, RMIClientSocketFactory csf) 지정된 port를 사용해, 지정된 호스트상에서 동작하는 리모트 객체 Registry에 의 로컬에 작성된 참조를 리턴합니다.

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

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

메서드의 상세

getRegistry

public static Registry  getRegistry()
                            throws RemoteException 

디폴트의 레지스트리 포트인 1099 번 포트를 사용하는 로컬 호스트용의 리모트 객체 Registry에 의 참조를 리턴합니다.

반환값:

리모트 객체 레지스트리에의 참조 (스텁)

예외:

RemoteException - 참조를 작성할 수 없었던 경우

도입된 버전 :

JDK1. 1

getRegistry

public static Registry  getRegistry(int port)
                            throws RemoteException 

지정된 port를 사용하는 로컬 호스트용의 리모트 객체 Registry에 의 참조를 리턴합니다.

파라미터:

port - 레지스트리가 요구를 받아들이는 포트

반환값:

리모트 객체 레지스트리에의 참조 (스텁)

예외:

RemoteException - 참조를 작성할 수 없었던 경우

도입된 버전 :

JDK1. 1

getRegistry

public static Registry  getRegistry(String  host)
                            throws RemoteException 

디폴트 레지스트리 포트인 1099 번 포트를 사용해, 지정된 호스트상에서 동작하는 리모트 객체 Registry에 의 참조를 리턴합니다. host이 null인 경우는 로컬 호스트가 사용됩니다.

파라미터:

host - 리모트 레지스트리의 호스트

반환값:

리모트 객체 레지스트리에의 참조 (스텁)

예외:

RemoteException - 참조를 작성할 수 없었던 경우

도입된 버전 :

JDK1. 1

getRegistry

public static Registry  getRegistry(String  host,
                                   int port)
                            throws RemoteException 

지정된 port를 사용해, 지정된 호스트상에서 동작하는 리모트 객체 Registry에 의 참조를 리턴합니다. host이 null인 경우는 로컬 호스트가 사용됩니다.

파라미터:

host - 리모트 레지스트리의 호스트

port - 레지스트리가 요구를 받아들이는 포트

반환값:

리모트 객체 레지스트리에의 참조 (스텁)

예외:

RemoteException - 참조를 작성할 수 없었던 경우

도입된 버전 :

JDK1. 1

getRegistry

public static Registry  getRegistry(String  host,
                                   int port,
                                   RMIClientSocketFactory  csf)
                            throws RemoteException 

지정된 port를 사용해, 지정된 호스트상에서 동작하는 리모트 객체 Registry에 의 로컬에 작성된 참조를 리턴합니다. 이 리모트 레지스트리와의 통신에는 건네받은 RMIClientSocketFactory csf를 사용해, 리모트 host port 상에 Socket 접속을 작성합니다.

파라미터:

host - 리모트 레지스트리의 호스트

port - 레지스트리가 요구를 받아들이는 포트

csf - 레지스트리에의 접속을 확립하기 위한 클라이언트측 Socket 팩토리. csf가 null인 경우는 레지스트리 스텁 내에서 디폴트의 클라이언트측 Socket 팩토리가 사용된다

반환값:

리모트 레지스트리에의 참조 (스텁)

예외:

RemoteException - 참조를 작성할 수 없었던 경우

도입된 버전 :

1.2

createRegistry

public static Registry  createRegistry(int port)
                               throws RemoteException 

로컬 호스트상에 지정된 port로 요구를 받아들이는 Registry인스턴스를 작성해 export 합니다.

Registry인스턴스와 지정된 port를 인수로 지정해 static 메서드 UnicastRemoteObject.exportObject를 호출했을 경우와 같게, Registry인스턴스가 export 됩니다. 다만, 이 Registry인스턴스의 export의 경우, 값 ObjID.REGISTRY_ID를 사용해 구축된 기존의 객체 식별자인 ObjID 인스턴스가 사용되는 점이 다릅니다.

파라미터:

port - 레지스트리가 요구를 받아들이는 포트

반환값:

레지스트리

예외:

RemoteException - 참조를 export 할 수 없었던 경우

도입된 버전 :

JDK1. 1

createRegistry

public static Registry  createRegistry(int port,
                                      RMIClientSocketFactory  csf,
                                      RMIServerSocketFactory  ssf)
                               throws RemoteException 

커스텀 소켓 팩토리를 사용해 그 인스턴스와의 통신을 실시하는 Registry인스턴스를, 로컬 호스트상에서 작성 및 export 합니다. 작성된 레지스트리는 지정된 port 상에서 지정된 RMIServerSocketFactory로 부터 작성된 ServerSocket를 사용해, 요구의 수신에 대비해 대기합니다.

Registry인스턴스, 지정된 port, 지정된 RMIClientSocketFactory 및 지정된 RMIServerSocketFactory를 인수로 지정해 static 메서드 UnicastRemoteObject.exportObject를 호출했을 경우와 같게, Registry인스턴스가 export 됩니다. 다만, 이 Registry인스턴스의 export의 경우, 값 ObjID.REGISTRY_ID를 사용해 구축된 기존의 객체 식별자인 ObjID 인스턴스가 사용되는 점이 다릅니다.

파라미터:

port - 레지스트리가 요구를 받아들이는 포트

csf - 레지스트리에의 접속을 확립하기 위한 클라이언트측 Socket 팩토리

ssf - 레지스트리에의 접속을 받아들이기 위한 서버측 ServerSocket 팩토리

반환값:

레지스트리

예외:

RemoteException - 참조를 export 할 수 없었던 경우

도입된 버전 :

1.2