java.rmi.server
인터페이스 RemoteRef

모든 슈퍼 인터페이스:

Externalizable, Serializable

알려진 서브 인터페이스 목록 :

ServerRef

public interface RemoteRef
extends Externalizable 

RemoteRef는 리모트 객체의 핸들을 나타냅니다. RemoteStub는 리모트 참조를 사용해 리모트 객체에의 리모트 메서드 호출을 실행합니다.

도입된 버전 :

JDK1. 1

관련 항목:

RemoteStub

필드 개요

static String	packagePrefix 서버 패키지를 초기화하기 위한 접두사입니다.
static long	serialVersionUID JDK 1.1.x 버전의 클래스와의 호환성을 나타냅니다.

메서드 개요

void	done (RemoteCall call) 추천하지 않습니다. JDK 1.2 형식의 스텁는 이 메서드를 사용하지 않습니다. 리모트 참조로 일련의 메서드 호출 (newCall, invoke 및 done)을 사용하는 대신에 스텁는 리모트 참조로 invoke(Remote, Method, Object[], int) 메서드만을 사용해 파라미터의 정렬화, 리모트 메서드의 실행 및 반환값의 비정렬화를 실행합니다.
String	getRefClass (ObjectOutput out) out 스트림에 직렬화 되는 참조형의 클래스명을 리턴합니다.
void	invoke (RemoteCall call) 추천하지 않습니다. JDK 1.2 형식의 스텁는 이 메서드를 사용하지 않습니다. 리모트 참조로 일련의 메서드 호출 (newCall, invoke 및 done)을 사용하는 대신에 스텁는 리모트 참조로 invoke(Remote, Method, Object[], int) 메서드만을 사용해 파라미터의 정렬화, 리모트 메서드의 실행 및 반환값의 비정렬화를 실행합니다.
Object	invoke (Remote obj, Method method, Object [] params, long opnum) 메서드를 호출합니다.
RemoteCall	newCall (RemoteObject obj, Operation [] op, int opnum, long hash) 추천하지 않습니다. JDK 1.2 형식의 스텁는 이 메서드를 사용하지 않습니다. 스텁 의 리모트 참조로 일련의 메서드 호출 (newCall, invoke 및 done)을 사용하는 대신에 스텁는 리모트 참조로 invoke(Remote, Method, Object[], int) 메서드만을 사용해, 파라미터의 정렬화, 리모트 메서드의 실행 및 반환값의 비정렬화를 실행합니다.
boolean	remoteEquals (RemoteRef obj) 2개의 리모트 객체가 동일한지 어떤지를 비교합니다.
int	remoteHashCode () 리모트 객체에 대한 해시 코드를 리턴합니다.
String	remoteToString () 이 리모트 객체의 참조를 나타내는 캐릭터 라인을 리턴합니다.

인터페이스 java.io. Externalizable 로부터 상속된 메서드

readExternal, writeExternal

필드의 상세

serialVersionUID

static final long serialVersionUID

JDK 1.1.x 버전의 클래스와의 호환성을 나타냅니다.

관련 항목:

정수 필드값

packagePrefix

static final String  packagePrefix

서버 패키지를 초기화하기 위한 접두사입니다. 서버 참조 클래스 (UnicastRef, UnicastServerRef 등)의 구현이, 그 접두사로 정의되고 있는 패키지안에 놓여져 있으면 가정합니다.

관련 항목:

정수 필드값

메서드의 상세

invoke

Object  invoke(Remote  obj,
              Method  method,
              Object [] params,
              long opnum)
              throws Exception 

메서드를 호출합니다. 참조에의 이 형식의 위양 메서드 호출에의해 참조는 리모트 호스트와의 접속의 셋업의 처리, 메서드 및 파라미터의 일부에 대한 표현의 정렬화, 리모트 호스트에 대한 메서드 호출의 통신을 실시할 수 있습니다 . 이 메서드는 리모트 호스트상의 리모트 객체에 대한 메서드 호출의 결과를 돌려주는지, 예외를 Throw 할까의 어느 쪽인지입니다. 호출이 실패했을 경우에는 RemoteException, 리모트 호출이 예외를 Throw 했을 경우에는 어플리케이션 레벨의 예외가 각각 발생 됩니다.

파라미터:

obj - 객체에 대한 RemoteStub 등의 RemoteRef를 가지는 객체

method - 호출되는 메서드

params - 파라미터의 리스트

opnum - 메서드를 표현하기 위해서 사용되는 해시

반환값:

리모트 메서드 호출의 결과

예외:

Exception - 리모트 메서드 호출중에 예외가 발생했을 경우

도입된 버전 :

1.2

newCall

@Deprecated 
RemoteCall  newCall(RemoteObject  obj,
                              Operation [] op,
                              int opnum,
                              long hash)
                   throws RemoteException 

추천하지 않습니다. JDK 1.2 형식의 스텁는 이 메서드를 사용하지 않습니다. 스텁 의 리모트 참조로 일련의 메서드 호출 (newCall, invoke 및 done)을 사용하는 대신에 스텁는 리모트 참조로 invoke(Remote, Method, Object[], int) 메서드만을 사용해, 파라미터의 정렬화, 리모트 메서드의 실행 및 반환값의 비정렬화를 실행합니다.

이 객체상에서 시작되는 새로운 리모트 메서드에 대해서 적절한 호출 객체를 작성합니다. 오퍼레이션 배열과 인덱스를 건네주면, 스텁 제네레이터가 오퍼레이션 인덱스의 할당 및 해석을 실시하는 것이 가능하게 됩니다. 리모트 참조에서는 호출 안에서 encode 하기 위해서 그 오퍼레이션을 필요로 하는 경우가 있습니다.

파라미터:

obj - 호출을 실시하는 리모트 스텁

op - 스텁 오퍼레이션의 배열

opnum - 오퍼레이션 번호

hash - 스텁 또는 스켈레톤 의 인터페이스 해시

반환값:

리모트 호출을 나타내는 호출 객체

예외:

RemoteException - 새로운 리모트 호출의 개시가 실패했을 경우

도입된 버전 :

JDK1. 1

관련 항목:

invoke(Remote, java.lang.reflect.Method, Object[], long)

invoke

@Deprecated 
void invoke(RemoteCall  call)
            throws Exception 

추천하지 않습니다. JDK 1.2 형식의 스텁는 이 메서드를 사용하지 않습니다. 리모트 참조로 일련의 메서드 호출 (newCall, invoke 및 done)을 사용하는 대신에 스텁는 리모트 참조로 invoke(Remote, Method, Object[], int) 메서드만을 사용해 파라미터의 정렬화, 리모트 메서드의 실행 및 반환값의 비정렬화를 실행합니다.

리모트 호출을 실행합니다. invoke는 스텁을 통과해 캐치 되지 않는 모든 「사용자 」예외를 발행합니다. 리모트 호출중에 예외를 발행하는 경우, invoke는 접속을 클린 업 한 후에 「사용자 」또는 리모트 예외를 발행할 필요가 있습니다.

파라미터:

call - 리모트 호출을 나타내는 객체

예외:

Exception - 리모트 메서드중에 예외가 발생했을 경우

도입된 버전 :

JDK1. 1

관련 항목:

invoke(Remote, java.lang.reflect.Method, Object[], long)

done

@Deprecated 
void done(RemoteCall  call)
          throws RemoteException 

추천하지 않습니다. JDK 1.2 형식의 스텁는 이 메서드를 사용하지 않습니다. 리모트 참조로 일련의 메서드 호출 (newCall, invoke 및 done)을 사용하는 대신에 스텁는 리모트 참조로 invoke(Remote, Method, Object[], int) 메서드만을 사용해 파라미터의 정렬화, 리모트 메서드의 실행 및 반환값의 비정렬화를 실행합니다.

리모트 참조에 접속을 클린 업 하는 (또는 재사용한다) 일을 허용합니다. done는 시작이 성공해 (예외가 발생하는 일 없이) 스텁에 돌아오는 경우에만 호출하도록 합니다.

파라미터:

call - 리모트 호출을 나타내는 객체

예외:

RemoteException - 호출의 클린 업중에 에러가 발생했을 경우

도입된 버전 :

JDK1. 1

관련 항목:

invoke(Remote, java.lang.reflect.Method, Object[], long)

getRefClass

String  getRefClass(ObjectOutput  out)

out 스트림에 직렬화 되는 참조형의 클래스명을 리턴합니다.

파라미터:

out - 참조가 직렬화 되는 앞의 출력 스트림

반환값:

참조형의 클래스명 (패키지 수식 없음)

도입된 버전 :

JDK1. 1

remoteHashCode

int remoteHashCode()

리모트 객체에 대한 해시 코드를 리턴합니다. 같은 리모트 객체를 참조하는 2개의 리모트 객체의 스텁는 같은 해시 코드를 가집니다 (해시 테이블의 키로서 리모트 객체를 지원 하기 위해).

반환값:

리모트 객체의 해시 코드

도입된 버전 :

JDK1. 1

관련 항목:

Hashtable

remoteEquals

boolean remoteEquals(RemoteRef  obj)

2개의 리모트 객체가 동일한지 어떤지를 비교합니다. 이 리모트 객체가 지정된 객체와 동등한지 어떤지를 나타내는 boolean 치를 리턴합니다. 이 메서드는 리모트 객체가 해시 테이블에 포함되고 있는 경우에 사용됩니다.

파라미터:

obj - 비교 대상의 객체

반환값:

2개의 Object가 동일한 경우는 true. 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 1

관련 항목:

Hashtable

remoteToString

String  remoteToString()

이 리모트 객체의 참조를 나타내는 캐릭터 라인을 리턴합니다.

반환값:

리모트 객체 참조를 나타내는 캐릭터 라인

도입된 버전 :

JDK1. 1