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) 메소드만을 사용해 파라미터의 정렬화, 리모트 메소드의 실행, 및 반환값의 비정렬화를 실행합니다. JDK 1.2 의 그루터기는 rmic -v1. 2 를 사용해 생성됩니다. 디폴트에서는 rmic 는 JDK 1.1 및 Java 2 SDK 와 호환성이 있는 그루터기를 생성합니다. 호환성이 있는 그루터기는 rmic -vcompat 를 사용해도 생성할 수 있습니다.
String	getRefClass (ObjectOutput out) out 스트림에 직렬화 되는 참조형의 클래스명을 돌려줍니다.
void	invoke (RemoteCall call) 추천 되고 있지 않습니다. JDK 1.2 형식의 그루터기는 이 메소드를 사용하지 않습니다. 리모트 참조로 일련의 메소드 호출 (newCall,invoke, 및 done)을 사용하는 대신에, 그루터기는 리모트 참조로 invoke(Remote, Method, Object[], int) 메소드만을 사용해 파라미터의 정렬화, 리모트 메소드의 실행, 및 반환값의 비정렬화를 실행합니다. JDK 1.2 의 그루터기는 rmic -v1. 2 를 사용해 생성됩니다. 디폴트에서는 rmic 는 JDK 1.1 및 Java 2 SDK 와 호환성이 있는 그루터기를 생성합니다. 호환성이 있는 그루터기는 rmic -vcompat 를 사용해도 생성할 수 있습니다.
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) 메소드만을 사용해, 파라미터의 정렬화, 리모트 메소드의 실행, 및 반환값의 비정렬화를 실행합니다. JDK 1.2 의 그루터기는 rmic -v1. 2 를 사용해 생성됩니다. 디폴트에서는 rmic 는 JDK 1.1 및 Java 2 SDK 와 호환성이 있는 그루터기를 생성합니다. 호환성이 있는 그루터기는 rmic -vcompat 를 사용해도 생성할 수 있습니다.
boolean	remoteEquals (RemoteRef obj) 2 개의 리모트 오브젝트가 동일한지 어떤지를 비교합니다.
int	remoteHashCode () 리모트 오브젝트에 대한 해시 코드를 돌려줍니다.
String	remoteToString () 이 리모트 오브젝트의 참조를 나타내는 캐릭터 라인을 돌려줍니다.

인터페이스 java.io. Externalizable 에서 상속받은 메소드

readExternal , writeExternal

필드의 상세

serialVersionUID

public static final long serialVersionUID

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

관련 항목:

정수 필드치

packagePrefix

public static final String  packagePrefix

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

관련 항목:

정수 필드치

메소드의 상세

invoke

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

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

파라미터:

obj - 오브젝트에 대한 RemoteStub 등의 RemoteRef 를 가지는 오브젝트

method - 불려 가는 메소드

params - 파라미터의 리스트

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

반환값:

리모트 메소드 호출의 결과

예외:

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

도입된 버젼:

1.2

newCall

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

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

JDK 1.2 의 그루터기는 rmic -v1. 2 를 사용해 생성됩니다. 디폴트에서는 rmic 는 JDK 1.1 및 Java 2 SDK 와 호환성이 있는 그루터기를 생성합니다. 호환성이 있는 그루터기는 rmic -vcompat 를 사용해도 생성할 수 있습니다.

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

파라미터:

obj - 호출을 실시하는 리모트 그루터기

op - 그루터기 오퍼레이션의 배열

opnum - 오퍼레이션 번호

hash - 그루터기 또는 스켈리턴의 인터페이스 해시

반환값:

리모트 호출을 나타내는 호출 오브젝트

예외:

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

도입된 버젼:

JDK1. 1

관련 항목:

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

invoke

public void invoke(RemoteCall  call)
            throws Exception 

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

JDK 1.2 의 그루터기는 rmic -v1. 2 를 사용해 생성됩니다. 디폴트에서는 rmic 는 JDK 1.1 및 Java 2 SDK 와 호환성이 있는 그루터기를 생성합니다. 호환성이 있는 그루터기는 rmic -vcompat 를 사용해도 생성할 수 있습니다.

리모트 호출을 실행합니다. invoke 는 그루터기를 통과해 버려 캐치 되지 않는 모든 「유저」예외를 시작합니다. 리모트 호출중에 예외가 일어섰을 경우에는 invoke 는 「유저」또는 리모트 예외를 시작하기 전에 접속을 클린 업 하는 작업을 실시할 필요가 있습니다.

파라미터:

call - 리모트 호출을 나타내는 오브젝트

예외:

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

도입된 버젼:

JDK1. 1

관련 항목:

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

done

public void done(RemoteCall  call)
          throws RemoteException 

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

JDK 1.2 의 그루터기는 rmic -v1. 2 를 사용해 생성됩니다. 디폴트에서는 rmic 는 JDK 1.1 및 Java 2 SDK 와 호환성이 있는 그루터기를 생성합니다. 호환성이 있는 그루터기는 rmic -vcompat 를 사용해도 생성할 수 있습니다.

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

파라미터:

call - 리모트 호출을 나타내는 오브젝트

예외:

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

도입된 버젼:

JDK1. 1

관련 항목:

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

getRefClass

public String  getRefClass(ObjectOutput  out)

out 스트림에 직렬화 되는 참조형의 클래스명을 돌려줍니다.

파라미터:

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

반환값:

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

도입된 버젼:

JDK1. 1

remoteHashCode

public int remoteHashCode()

리모트 오브젝트에 대한 해시 코드를 돌려줍니다. 같은 리모트 오브젝트를 참조하는 2 개의 리모트 오브젝트의 그루터기는 같은 해시 코드를 가집니다 (해시 테이블의 키로서 리모트 오브젝트를 서포트하기 위해(때문에)).

반환값:

리모트 오브젝트의 해시 코드

도입된 버젼:

JDK1. 1

관련 항목:

Hashtable

remoteEquals

public boolean remoteEquals(RemoteRef  obj)

2 개의 리모트 오브젝트가 동일한지 어떤지를 비교합니다. 이 리모트 오브젝트가 지정된 오브젝트와 동등한지 어떤지를 나타내는 boolean 치를 돌려줍니다. 이 메소드는 리모트 오브젝트가 해시 테이블에 저장되고 있는 경우에 사용됩니다.

파라미터:

obj - 비교 대상의 오브젝트

반환값:

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

도입된 버젼:

JDK1. 1

관련 항목:

Hashtable

remoteToString

public String  remoteToString()

이 리모트 오브젝트의 참조를 나타내는 캐릭터 라인을 돌려줍니다.

반환값:

리모트 오브젝트 참조를 나타내는 캐릭터 라인

도입된 버젼:

JDK1. 1