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 번 포트를 사용해, 지정된 host 상에서 동작하는, 원격 객체 Registry 에의 참조를 돌려줍니다.
static Registry	getRegistry (String host, int port) 지정된 port 를 사용해, 지정된 host 상에서 동작하는, 원격 객체 Registry 에의 참조를 돌려줍니다.
static Registry	getRegistry (String host, int port, RMIClientSocketFactory csf) 지정된 port 를 사용해, 지정된 host 상에서 동작하는 원격 객체 Registry 에의, 로컬에 작성된 원격 참조를 돌려줍니다.

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

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

메소드의 상세

getRegistry

public static Registry  getRegistry()
                            throws RemoteException 

디폴트의 레지스트리 포트인 1099 번 포트를 사용하는 로컬 호스트용의 원격 객체 Registry 에의 참조를 돌려줍니다.

반환값:

원격 객체 레지스트리에의 참조 (Stub)

예외:

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

도입된 버젼:

JDK1. 1

getRegistry

public static Registry  getRegistry(int port)
                            throws RemoteException 

지정된 port 를 사용하는 로컬 호스트용의 원격 객체 Registry 에의 참조를 돌려줍니다.

파라미터:

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

반환값:

원격 객체 레지스트리에의 참조 (Stub)

예외:

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

도입된 버젼:

JDK1. 1

getRegistry

public static Registry  getRegistry(String  host)
                            throws RemoteException 

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

파라미터:

host - 원격 레지스트리의 호스트

반환값:

원격 객체 레지스트리에의 참조 (Stub)

예외:

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

도입된 버젼:

JDK1. 1

getRegistry

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

지정된 port 를 사용해, 지정된 host 상에서 동작하는, 원격 객체 Registry 에의 참조를 돌려줍니다. host 가 null 의 경우는, 로컬 호스트가 사용됩니다.

파라미터:

host - 원격 레지스트리의 호스트

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

반환값:

원격 객체 레지스트리에의 참조 (Stub)

예외:

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

도입된 버젼:

JDK1. 1

getRegistry

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

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

파라미터:

host - 원격 레지스트리의 호스트

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

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

반환값:

원격 레지스트리에의 참조 (Stub)

예외:

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