javax.rmi
클래스 PortableRemoteObject

java.lang.Object 
  |
  +--javax.rmi.PortableRemoteObject

public class PortableRemoteObject

extends Object

서버 구현 오브젝트는 javax.rmi.PortableRemoteObject 를 계승하든가, 혹은 리모트 인터페이스를 구현해 exportObject 메소드를 사용해 이 오브젝트 자체를 서버 오브젝트로서 등록합니다. toStub 메소드는 서버 구현을 받아, 그 서버 오브젝트에의 액세스에 사용할 수 있는 그루터기를 돌려줍니다. 접속 메소드는 Remote 오브젝트를 리모트 통신 가능한 상태로 합니다. unexportObject 메소드는 서버 오브젝트를 등록 해제해 가베지 콜렉션에 사용됩니다. narrow 메소드는 오브젝트 참조 또는 추상 인터페이스 타입을 수중에 넣어, 그것을 네로우 변환해 지정된 인터페이스에 일치 시키려고 합니다. 조작이 완료하면(자) 지정된 타입의 오브젝트가 되어, 그렇지 않은 경우는 예외가 슬로우 됩니다.

생성자의 개요

protected

PortableRemoteObject () exportObject(this) 를 호출해 오브젝트를 초기화합니다.

메소드의 개요

static void	connect (Remote target, Remote source) 리모트 통신 준비를 할 수 있던 리모트 오브젝트를 작성합니다.
static void	exportObject (Remote obj) 서버 오브젝트가 리모트 호출을 수신할 수 있게 합니다.
static Object	narrow (Object narrowFrom, Class narrowTo) 리모트 인터페이스 또는 추상 인터페이스의 오브젝트를 목적의 타입에 캐스트 할 수 있는 것을 확인합니다.
static Remote	toStub (Remote obj) 지정된 서버 오브젝트의 그루터기를 돌려줍니다.
static void	unexportObject (Remote obj) 서버 오브젝트를 런타임으로부터 등록 해제해, 그 오브젝트가 가베지 콜렉션의 대상이 되도록(듯이) 합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

PortableRemoteObject

protected PortableRemoteObject()
                        throws RemoteException 

exportObject(this) 를 호출해 오브젝트를 초기화합니다.

예외:

RemoteException - export에 실패했을 경우

메소드의 상세

exportObject

public static void exportObject(Remote  obj)
                         throws RemoteException 

서버 오브젝트가 리모트 호출을 수신할 수 있게 합니다. PortableRemoteObject 의 서브 클래스의 경우, 이 메소드는 constructor 이 호출하므로, 호출할 필요는 없습니다.

파라미터:

obj - export 대상의 서버 오브젝트

예외:

RemoteException - export에 실패했을 경우

toStub

public static Remote  toStub(Remote  obj)
                     throws NoSuchObjectException 

지정된 서버 오브젝트의 그루터기를 돌려줍니다.

파라미터:

obj - 그루터기를 필요로 하는 서버 오브젝트. PortableRemoteObject 의 서브 클래스이든가, 혹은 미리 exportObject(java.rmi.Remote) 호출의 타겟이 되고 있는 것이 필요

반환값:

오브젝트의 최상정도 파생 그루터기

예외:

NoSuchObjectException - 지정된 서버 오브젝트에 그루터기를 배치할 수 없는 경우

unexportObject

public static void unexportObject(Remote  obj)
                           throws NoSuchObjectException 

서버 오브젝트를 런타임으로부터 등록 해제해, 그 오브젝트가 가베지 콜렉션의 대상이 되도록(듯이) 합니다.

파라미터:

obj - 안 export 하는 오브젝트

예외:

NoSuchObjectException - 리모트 오브젝트가 현재 export되어 있지 않은 경우

narrow

public static Object  narrow(Object  narrowFrom,
                            Class  narrowTo)
                     throws ClassCastException 

리모트 인터페이스 또는 추상 인터페이스의 오브젝트를 목적의 타입에 캐스트 할 수 있는 것을 확인합니다.

파라미터:

narrowFrom - 체크 대상의 오브젝트

narrowTo - 목적의 타입

반환값:

목적의 타입에 캐스트 할 수 있는 오브젝트

예외:

ClassCastException - narrowFrom 를 narrowTo 에 캐스트 할 수 없는 경우

connect

public static void connect(Remote  target,
                           Remote  source)
                    throws RemoteException 

리모트 통신 준비를 할 수 있던 리모트 오브젝트를 작성합니다. 통상, 리모트 메소드의 호출로 오브젝트가 인수로서 송신 또는 수신되었을 경우에 은근히 통신 가능한 상태가 됩니다만, 상황에 따라서는 명시적으로 호출해 이 동작을 실시하는데 도움이 됩니다. 상세한 것에 대하여는 Stub.connect(org.omg.CORBA.ORB) 메소드를 참조해 주세요.

파라미터:

target - 접속 대상의 오브젝트

source - 벌써 접속되고 있는 오브젝트

예외:

RemoteException - source 가 접속되어 있지 않은 경우, 또는 target 가 source 는 아니고 다른 ORB 에 벌써 접속되고 있는 경우