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 형식의 Stub는, 이 메소드를 사용하지 않습니다. 원격 참조로 일련의 메소드 호출 (newCall,invoke, 및 done)을 사용하는 대신에, Stub는 원격 참조로 invoke(Remote, Method, Object[], int) 메소드만을 사용해 파라미터의 정렬화, 원격 메소드의 실행, 및 반환값의 비정렬화를 실행합니다.
String	getRefClass (ObjectOutput out) out 스트림에 직렬화 되는, 참조형의 클래스명을 돌려줍니다.
void	invoke (RemoteCall call) 추천 되고 있지 않습니다. JDK 1.2 형식의 Stub는, 이 메소드를 사용하지 않습니다. 원격 참조로 일련의 메소드 호출 (newCall,invoke, 및 done)을 사용하는 대신에, Stub는 원격 참조로 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 형식의 Stub는, 이 메소드를 사용하지 않습니다. Stub의 원격 참조로 일련의 메소드 호출 (newCall,invoke, 및 done)을 사용하는 대신에, Stub는 원격 참조로 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 했을 경우에는 어플리케이션 레벨의 예외가 각각 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 형식의 Stub는, 이 메소드를 사용하지 않습니다. Stub의 원격 참조로 일련의 메소드 호출 (newCall,invoke, 및 done)을 사용하는 대신에, Stub는 원격 참조로 invoke(Remote, Method, Object[], int) 메소드만을 사용해, 파라미터의 정렬화, 원격 메소드의 실행, 및 반환값의 비정렬화를 실행합니다.

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

파라미터:

obj - 호출을 실시하는 원격 Stub

op - Stub 오퍼레이션의 배열

opnum - 오퍼레이션 번호

hash - Stub 또는 스켈리턴의 인터페이스 해시

반환값:

원격 호출을 나타내는 호출 객체

예외:

RemoteException - 새로운 원격 호출의 개시가 실패했을 경우

도입된 버젼:

JDK1. 1

관련 항목:

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

invoke

@Deprecated 
void invoke(RemoteCall  call)
            throws Exception 

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

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

파라미터:

call - 원격 호출을 나타내는 객체

예외:

Exception - 원격 메소드중에 예외가 발생했을 경우

도입된 버젼:

JDK1. 1

관련 항목:

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

done

@Deprecated 
void done(RemoteCall  call)
          throws RemoteException 

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

원격 참조에 접속을 클린 업 하는 (또는 재사용한다) 일을 허가합니다. done 는, 기동이 성공해 (예외가 발생하는 일 없이) Stub에 돌아오는 경우에만 호출하도록(듯이) 합니다.

파라미터:

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 개의 원격 객체의 Stub는, 같은 해시 코드를 가집니다 (해시 테이블의 키로서 원격 객체를 지원하기 위해(때문에)).

반환값:

원격 객체의 해시 코드

도입된 버젼:

JDK1. 1

관련 항목:

Hashtable

remoteEquals

boolean remoteEquals(RemoteRef  obj)

2 개의 원격 객체가 동일한지 어떤지를 비교합니다. 이 원격 객체가 지정된 객체와 동등한지 어떤지를 나타내는 boolean 치를 돌려줍니다. 이 메소드는, 원격 객체가 해시 테이블에 포함되고 있는 경우에 사용됩니다.

파라미터:

obj - 비교 대상의 객체

반환값:

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

도입된 버젼:

JDK1. 1

관련 항목:

Hashtable

remoteToString

String  remoteToString()

이 원격 객체의 참조를 나타내는 캐릭터 라인을 돌려줍니다.

반환값:

원격 객체 참조를 나타내는 캐릭터 라인

도입된 버젼:

JDK1. 1