javax.rmi
클래스 PortableRemoteObject

java.lang.Object 
  javax.rmi.PortableRemoteObject

public class PortableRemoteObject
extends Object 

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

생성자 의 개요

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) 지정된 서버 객체의 Stub를 돌려줍니다.
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 의 서브 클래스의 경우, 이 메소드는 생성자 이 호출하므로, 호출할 필요는 없습니다.

파라미터:

obj - export 대상의 서버 객체

예외:

RemoteException - export에 실패했을 경우

toStub

public static Remote  toStub(Remote  obj)
                     throws NoSuchObjectException 

지정된 서버 객체의 Stub를 돌려줍니다.

파라미터:

obj - Stub를 필요로 하는 서버 객체. PortableRemoteObject 의 서브 클래스이든가, 혹은 미리 exportObject(java.rmi.Remote) 호출의 타겟이 되고 있는 것이 필요

반환값:

객체의 최상정도 파생 Stub

예외:

NoSuchObjectException - 지정된 서버 객체에 Stub를 배치할 수 없는 경우

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 메소드를 참조해 주세요.

파라미터:

target - 접속 대상의 객체

source - 벌써 접속되고 있는 객체

예외:

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