java.rmi.server
클래스 RemoteObjectInvocationHandler

java.lang.Object 
  java.rmi.server.RemoteObject 
      java.rmi.server.RemoteObjectInvocationHandler

모든 구현된 인터페이스:

Serializable, InvocationHandler, Remote

public class RemoteObjectInvocationHandler
extends RemoteObject 
implements InvocationHandler 

Java 리모트 메서드 호출 (Java RMI)로 사용되는 InvocationHandler인터페이스 구현입니다. 이 호출 핸들러와 동적 프록시 인스턴스와의 편성은 사전 생성된 스텁 클래스의 대신으로서 사용할 수 있습니다.

어플리케이션이 이 클래스를 직접 사용하는 것은 상정되지 않습니다. UnicastRemoteObject 또는 Activatable를 사용해 동적 프록시로서 export 된 리모트 객체는 이 클래스의 인스턴스를 그 프록시의 호출 핸들러로서 포함합니다.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

필드 개요

클래스 java.rmi.server. RemoteObject 로부터 상속된 필드

ref

생성자 개요

RemoteObjectInvocationHandler (RemoteRef ref)
지정된 RemoteRef를 사용해 새로운 RemoteObjectInvocationHandler를 작성합니다.

메서드 개요

Object

invoke (Object proxy, Method method, Object [] args) 이 객체를 캡슐화하고 있는 프록시 인스턴스 proxy 상에서 발행된 메서드 호출을 처리해, 그 결과를 리턴합니다.

클래스 java.rmi.server. RemoteObject 로부터 상속된 메서드

equals, getRef, hashCode, toString, toStub

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

생성자 상세

RemoteObjectInvocationHandler

public RemoteObjectInvocationHandler(RemoteRef  ref)

지정된 RemoteRef를 사용해 새로운 RemoteObjectInvocationHandler를 작성합니다.

파라미터:

ref - 리모트 참조

예외:

NullPointerException - ref가 null인 경우

메서드의 상세

invoke

public Object  invoke(Object  proxy,
                     Method  method,
                     Object [] args)
              throws Throwable 

이 객체를 캡슐화하고 있는 프록시 인스턴스 proxy 상에서 발행된 메서드 호출을 처리해, 그 결과를 리턴합니다.

RemoteObjectInvocationHandler에 서는 이 메서드는 다음과 같이 구현되고 있습니다.

method가 다음의 메서드의 언젠가인 경우, 그것들은 다음과 같이 처리됩니다.

• Object.hashCode : 프록시의 해시 코드값을 돌려준다
• Object.equals : 인수 (args[0])가 동적 프록시 클래스의 인스턴스이며, 한편 그 인수의 호출 핸들러가 이 호출 핸들러와 동일한 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 돌려준다
• Object.toString : 프록시의 캐릭터 라인 표현을 돌려준다

그렇지 않은 경우, 리모트 호출이 다음과 같이의해 실행됩니다.

• proxy가 인터페이스 Remote 인스턴스가 아닌 경우, IllegalArgumentException이 Throw 된다
• 그렇지 않은 경우는 이 호출 핸들러의 RemoteRef 상에서 invoke 메서드가 불려 간다. 그 때, 인수로서 proxy, method, args 및 method에 대한 메서드 해시 ( 「Java Remote Method Invocation (RMI) 사양」의 섹션 8.3 으로 정의되고 있다)가 건네받는다. 그리고, 그 결과가 리턴된다
• RemoteRef.invoke로 부터 예외가 Throw 되어 한편 그 예외가proxy 클래스에서 구현되고 있는 메서드의 throws 절로 지정된 어느 예외에도 할당할 수 없는 체크되는 예외였을 경우, 그 예외가 UnexpectedException 내에 랩 되어 그 랩이 끝난 예외가 Throw 된다. 그렇지 않은 경우는 invoke에 의해 Throw 된 예외가 이 메서드에 의해 Throw 된다

이 호출 핸들러를 포함한 유효한 동적 프록시 클래스의 인스턴스에 의해 인수가 생성되어 있지 않았던 경우, 이 메서드의 시멘틱스는 불명이 됩니다.

정의:

인터페이스 InvocationHandler 내의 invoke

파라미터:

proxy - 메서드가 호출되는 프록시 인스턴스

method - 프록시 인스턴스상에서 불려 간 인터페이스 메서드에 대응하는 Method인스턴스

args - 프록시 인스턴스상에서의 메서드 호출시로 지정된 인수의 값을 포함한 객체 배열. 인수를 취하지 않는 메서드의 경우는 null

반환값:

프록시 인스턴스상에서의 메서드 호출로부터 리턴된 값

예외:

Throwable - 프록시 인스턴스상에서의 메서드 호출로부터 Throw 된 예외

관련 항목: