java.rmi.server
클래스 UnicastRemoteObject

java.lang.Object 
  java.rmi.server.RemoteObject 
      java.rmi.server.RemoteServer 
          java.rmi.server.UnicastRemoteObject

모든 구현된 인터페이스:

Serializable, Remote

알려진 직계 서브 클래스:

ActivationGroup

public class UnicastRemoteObject
extends RemoteServer 

리모트 객체를 JRMP를 사용해 export 해, 리모트 객체와 통신하는 스텁을 취득하기 위해서 사용됩니다.

생성자 및 static exportObject 메서드의 경우, export 하는 리모트 객체의 스텁는 다음과 같이의해 취득됩니다.

• UnicastRemoteObject.exportObject(Remote) 메서드를 사용해 리모트 객체를 export 하는 경우, 스텁 클래스 (일반적으로 리모트 객체의 클래스로부터 rmic 툴을 사용해 사전에 생성된다)가 로드 되어 그 스텁 클래스의 인스턴스가 다음과 같이의해 구축됩니다.
  • 「루트 클래스」가 다음과 같이 결정됩니다. 리모트 객체의 클래스가 Remote를 확장한 인터페이스를 직접 구현하고 있는 경우, 그 리모트 객체의 클래스가 루트 클래스가 됩니다. 그렇지 않은 경우, 리모트 객체의 클래스의 슈퍼 클래스 가운데, Remote를 확장한 인터페이스를 직접 구현하고 있는 최상정도의 클래스가 루트 클래스가 됩니다.
  • 로드하는 스텁 클래스의 이름을 결정하기 위해서 루트 클래스의 바이너리명과 접미말 「_Stub」가 연결됩니다.
  • 지정한 이름의 스텁 클래스가 루트 클래스의 클래스 로더를 사용해 로드 됩니다. 그 스텁 클래스는 RemoteStub를 확장하고 있어, 한편 RemoteRef 형의 파라미터를 1개 받는 public 생성자를 갖추고 있을 필요가 있습니다.
  • 마지막으로 스텁 클래스의 인스턴스가 RemoteRef를 사용해 구축됩니다.
• 적절한 스텁 클래스가 발견되지 않았던 경우, 스텁 클래스의 로드에 실패했을 경우, 혹은 스텁 인스턴스의 작성시에 문제가 발생했을 경우에는 StubNotFoundException을 발생시킵니다.

• 그 외의 방법으로 export 하는 경우의 순서는 다음과 같습니다.
  • 리모트 객체의 스텁 클래스 (정의는 상기를 참조)를 로드할 수 없었는지, 시스템 프로퍼티 java.rmi.server.ignoreStubClasses가 「true」(대문자/소문자의 구별 없음)로 설정되어 있었을 경우, 다음과 같은 특징을 가지는 Proxy 인스턴스가 구축됩니다.
    • 프록시의 클래스는 리모트 객체의 클래스의 클래스 로더에 의해 정의된다
    • 프록시는 리모트 객체의 클래스가 구현하고 있는 리모트 인터페이스의 모든 것을 구현한다
    • 프록시의 호출 핸들러는 RemoteRef를 사용해 구축된 RemoteObjectInvocationHandler 인스턴스가 된다
    • 프록시를 작성할 수 없었던 경우, StubNotFoundException이 Throw 된다

  • 그렇지 않은 경우, 리모트 객체의 (전술한) 스텁 클래스의 인스턴스가 스텁 로서 사용됩니다.

도입된 버전 :

JDK1. 1

관련 항목:

직렬화 된 형식

필드 개요

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

ref

생성자 개요

protected	UnicastRemoteObject () 익명 포트를 사용해, 새로운 UnicastRemoteObject 객체의 작성과 export를 실시합니다.
protected	UnicastRemoteObject (int port) 지정된 포트를 사용해, 새로운 UnicastRemoteObject 객체의 작성과 export를 실시합니다.
protected	UnicastRemoteObject (int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 지정된 포트와 소켓 팩토리를 사용해, 새로운 UnicastRemoteObject 객체의 작성과 export를 실시합니다.

메서드 개요

Object	clone () 원의 객체와 명확하게 구별할 수 있는 리모트 객체의 복제를 리턴합니다.
static RemoteStub	exportObject (Remote obj) 리모트 객체를 export 해, 입접속호의 수신에 사용할 수 있도록 합니다.
static Remote	exportObject (Remote obj, int port) 리모트 객체를 export 해, 입접속호의 수신에 사용할 수 있도록 합니다.
static Remote	exportObject (Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 리모트 객체를 export 해, 입접속호의 수신에 사용할 수 있도록 합니다.
static boolean	unexportObject (Remote obj, boolean force) RMI 런타임으로부터 리모트 객체 obj를 삭제합니다.

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

getClientHost, getLog, setLog

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

equals, getRef, hashCode, toString, toStub

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

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

생성자 상세

UnicastRemoteObject

protected UnicastRemoteObject()
                       throws RemoteException 

익명 포트를 사용해, 새로운 UnicastRemoteObject 객체의 작성과 export를 실시합니다.

예외:

RemoteException - 객체의 export가 실패했을 경우

도입된 버전 :

JDK1. 1

UnicastRemoteObject

protected UnicastRemoteObject(int port)
                       throws RemoteException 

지정된 포트를 사용해, 새로운 UnicastRemoteObject 객체의 작성과 export를 실시합니다.

파라미터:

port - 리모트 객체가 호출을 수신하는 포트의 번호. port이 0인 경우는 익명 포트가 사용된다

예외:

RemoteException - 객체의 export가 실패했을 경우

도입된 버전 :

1.2

UnicastRemoteObject

protected UnicastRemoteObject(int port,
                              RMIClientSocketFactory  csf,
                              RMIServerSocketFactory  ssf)
                       throws RemoteException 

지정된 포트와 소켓 팩토리를 사용해, 새로운 UnicastRemoteObject 객체의 작성과 export를 실시합니다.

파라미터:

port - 리모트 객체가 호출을 수신하는 포트의 번호. port이 0인 경우는 익명 포트가 사용되는

csf - 리모트 객체의 호출해에 사용하는 클라이언트측 소켓 팩토리

ssf - 리모트 객체 호출을 수신하는 서버측 소켓 팩토리

예외:

RemoteException - 객체의 export가 실패했을 경우

도입된 버전 :

1.2

메서드의 상세

clone

public Object  clone()
             throws CloneNotSupportedException 

원의 객체와 명확하게 구별할 수 있는 리모트 객체의 복제를 리턴합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

새로운 리모트 객체

예외:

CloneNotSupportedException - 복제가 RemoteException을 위해서 실패했을 경우

도입된 버전 :

JDK1. 1

관련 항목:

Cloneable

exportObject

public static RemoteStub  exportObject(Remote  obj)
                               throws RemoteException 

리모트 객체를 export 해, 입접속호의 수신에 사용할 수 있도록 합니다. 익명 포트를 사용합니다.

파라미터:

obj - export 하는 리모트 객체

반환값:

리모트 객체 스텁

예외:

RemoteException - export에 실패했을 경우

도입된 버전 :

JDK1. 1

exportObject

public static Remote  exportObject(Remote  obj,
                                  int port)
                           throws RemoteException 

리모트 객체를 export 해, 입접속호의 수신에 사용할 수 있도록 합니다. 지정된 포트를 사용합니다.

파라미터:

obj - export 하는 리모트 객체

port - 객체의 export처의 포트

반환값:

리모트 객체 스텁

예외:

RemoteException - export에 실패했을 경우

도입된 버전 :

1.2

exportObject

public static Remote  exportObject(Remote  obj,
                                  int port,
                                  RMIClientSocketFactory  csf,
                                  RMIServerSocketFactory  ssf)
                           throws RemoteException 

리모트 객체를 export 해, 입접속호의 수신에 사용할 수 있도록 합니다. 지정된 소켓 팩토리에 의해 특정된 트랜스폴트를 사용합니다.

파라미터:

obj - export 하는 리모트 객체

port - 객체의 export처의 포트

csf - 리모트 객체의 호출해에 사용하는 클라이언트측 소켓 팩토리

ssf - 리모트 객체 호출을 수신하는 서버측 소켓 팩토리

반환값:

리모트 객체 스텁

예외:

RemoteException - export에 실패했을 경우

도입된 버전 :

1.2

unexportObject

public static boolean unexportObject(Remote  obj,
                                     boolean force)
                              throws NoSuchObjectException 

RMI 런타임으로부터 리모트 객체 obj를 삭제합니다. 삭제가 성공하면, 객체는 RMI 입접속호의 접수를 위해서 사용할 수 없게 됩니다. 파라미터 force가 true 로 설정되어 있으면, 리모트 객체에의 보류 상태의 호출이 있는 경우나, 진행중의 호출이 있는 경우에서도, 객체는 강제적으로 안 export 됩니다. 파라미터 force가 false 로 설정되어 있으면, 객체에의 보류중 또는 진행중의 호출이 없는 경우에게만, 객체가 안 export 됩니다.

파라미터:

obj - export 되고 리모트 객체

force - true인 경우는 보류중 또는 진행중의 호출이 있어도, 객체의 export를 해제한다. false인 경우에는 보류중 또는 진행중의 호출이 없을 때에만, 객체의 export를 해제한다

반환값:

조작이 성공했을 경우는 true, 그렇지 않은 경우는 false

예외:

NoSuchObjectException - 리모트 객체가 현재 export되어 있지 않은 경우

도입된 버전 :

1.2