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 해, 원격 객체와 통신하는 Stub를 취득하기 위해서 사용됩니다.

생성자 및 static exportObject 메소드의 경우, export 하는 원격 객체의 Stub는, 다음과 같이 해 취득됩니다.

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

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

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

도입된 버젼:

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 하는 원격 객체

반환값:

원격 객체 Stub

예외:

RemoteException - export에 실패했을 경우

도입된 버젼:

JDK1. 1

exportObject

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

원격 객체를 export 해, 입접속호의 수신에 사용할 수 있도록(듯이) 합니다. 지정된 포트를 사용합니다.

파라미터:

obj - export 하는 원격 객체

port - 객체의 export처의 포트

반환값:

원격 객체 Stub

예외:

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 - 원격 객체 호출을 수신하는, 서버측 소켓 팩토리

반환값:

원격 객체 Stub

예외:

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