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 서브 클래스의 경우, 이 메서드는 생성자가 호출하므로 호출할 필요는 없습니다.

파라미터:

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 메서드를 참조하십시오.

파라미터:

target - 접속 대상의 객체

source - 이미 접속되고 있는 객체

예외:

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