javax.rmi.CORBA
클래스 Util

java.lang.Object 
  javax.rmi.CORBA.Util

public class Util
extends Object 

공통의 조작을 실행하기 위해서 스텁 및 Tie를 사용할 수 있는 유틸리티 메서드를 제공합니다.

메서드 개요

static Object	copyObject (Object obj, ORB orb) 객체를 카피 또는 접속합니다.
static Object []	copyObjects (Object [] obj, ORB orb) 객체의 배열을 카피 또는 접속합니다.
static ValueHandler	createValueHandler () ValueHandler 인터페이스를 구현하는 클래스의 단독 인스턴스를 리턴합니다.
static String	getCodebase (Class clz) 지정된 클래스의 코드 베이스가 있으면, 그 코드 베이스를 리턴합니다.
static Tie	getTie (Remote target) 지정된 타겟 객체의 Tie가 있으면, 그 Tie를 리턴합니다.
static boolean	isLocal (Stub stub) isLocal 메서드가 RemoteException을 Throw 할 수 있는 것을 제외해, ObjectImpl.
static Class	loadClass (String className, String remoteCodebase, ClassLoader loader) 지정된 클래스의 클래스 인스턴스를 리턴합니다.
static RemoteException	mapSystemException (SystemException ex) SystemException을 RemoteException에 맵 합니다.
static Object	readAny (InputStream in) java.lang.Object를 CORBA Any 형으로서 읽어들입니다.
static void	registerTarget (Tie tie, Remote target) Tie 타겟을 등록합니다.
static void	unexportObject (Remote target) 관련된 Tie를 내부 테이블에서 삭제해, Tie.deactivate()를 호출해 객체를 종료합니다.
static RemoteException	wrapException (Throwable orig) 구현 메서드에 의해 Throw 된 예외를 랩 합니다.
static void	writeAbstractObject (OutputStream out, Object obj) java.lang.Object를 값 또는 CORBA Object 로서 출력합니다.
static void	writeAny (OutputStream out, Object obj) java.lang.Object를 CORBA Any 형으로서 출력합니다.
static void	writeRemoteObject (OutputStream out, Object obj) java.lang.Object를 CORBA Object 로서 출력합니다.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

메서드의 상세

mapSystemException

public static RemoteException  mapSystemException(SystemException  ex)

SystemException을 RemoteException에 맵 합니다.

파라미터:

ex - 맵 하는 SystemException

반환값:

맵 된 예외

writeAny

public static void writeAny(OutputStream  out,
                            Object  obj)

java.lang.Object를 CORBA Any 형으로서 출력합니다.

파라미터:

out - Any 형을 출력하는 스트림

obj - Any 형으로서 출력하는 객체

readAny

public static Object  readAny(InputStream  in)

java.lang.Object를 CORBA Any 형으로서 읽어들입니다.

파라미터:

in - Any 형을 읽어들이는 스트림

반환값:

스트림로부터 읽힌 객체

writeRemoteObject

public static void writeRemoteObject(OutputStream  out,
                                     Object  obj)

java.lang.Object를 CORBA Object 로서 출력합니다. obj가 export 된 RMI-IIOP 서버 객체인 경우, Tie가 검색되어 obj에 연결시킬 수 있어 계속되어 out.write_Object(org.omg.CORBA.Object)에 출력해집니다. obj가 CORBA Object 인 경우, obj는 out.write_Object(org.omg.CORBA.Object)에 출력해집니다.

파라미터:

out - 객체를 출력하는 스트림

obj - 출력하는 객체

writeAbstractObject

public static void writeAbstractObject(OutputStream  out,
                                       Object  obj)

java.lang.Object를 값 또는 CORBA Object 로서 출력합니다. obj가 값객체 또는 스텁 객체인 경우, obj는 out.write_abstract_interface(java.lang.Object)에 출력해집니다. obj가 export 된 RMI-IIOP 서버 객체인 경우, Tie가 검색되어 obj에 연결시킬 수 있어 계속되어 out.write_abstract_interface(java.lang.Object)에 출력해집니다.

파라미터:

out - 객체를 출력하는 스트림

obj - 출력하는 객체

registerTarget

public static void registerTarget(Tie  tie,
                                  Remote  target)

Tie 타겟을 등록합니다. Tie를 내부 테이블에 추가해, Tie 객체의 Tie.setTarget(java.rmi.Remote)를 호출합니다.

파라미터:

tie - 등록하는 Tie

target - Tie 타겟

unexportObject

public static void unexportObject(Remote  target)
                           throws NoSuchObjectException 

관련된 Tie를 내부 테이블에서 삭제해, Tie.deactivate()를 호출해 객체를 종료합니다.

파라미터:

target - 안 export 하는 객체

예외:

NoSuchObjectException

getTie

public static Tie  getTie(Remote  target)

지정된 타겟 객체의 Tie가 있으면, 그 Tie를 리턴합니다.

반환값:

Tie, 또는 지정된 타겟으로 등록되어 있는 Tie가 없는 경우는 null

createValueHandler

public static ValueHandler  createValueHandler()

ValueHandler 인터페이스를 구현하는 클래스의 단독 인스턴스를 리턴합니다.

반환값:

ValueHandler 인터페이스를 구현하는 클래스

getCodebase

public static String  getCodebase(Class  clz)

지정된 클래스의 코드 베이스가 있으면, 그 코드 베이스를 리턴합니다.

파라미터:

clz - 코드 베이스를 얻는 클래스

반환값:

스페이스에서 단락지어진 URL 리스트, 또는 null

loadClass

public static Class  loadClass(String  className,
                              String  remoteCodebase,
                              ClassLoader  loader)
                       throws ClassNotFoundException 

지정된 클래스의 클래스 인스턴스를 리턴합니다.

이 메서드의 사양은 「Java to IDL language mapping」(ptc/00-01-06)에 규정되고 있습니다.

Java 2 플랫폼에서는 이 메서드는 다음과 같이 동작합니다.

• 호출 스택으로 최초의 null 이외의 ClassLoader를 검출해, 이 ClassLoader를 사용해 클래스의 로드를 시행한다
• 최초의 스텝이 실패했을 경우 및 remoteCodebase가 null 이외로 useCodebaseOnly가 false인 경우, java.rmi.server.RMIClassLoader.loadClass(remoteCodebase, className)를 호출한다
• remoteCodebase가 null 또는 useCodebaseOnly가 true인 경우, java.rmi.server.RMIClassLoader.loadClass(className)를 호출한다
• 클래스가 스텝 1, 2, 또는 3에 의해 정상적으로 로드 되지 않고, loader가 null 이외의 경우, loader.loadClass(className)를 호출한다
• 클래스가 스텝 1, 2, 3, 또는 4에 의해 정상적으로 로드 되지 않는 경우, 로드 된 클래스를 돌려주는지, 또는 ClassNotFoundException을 Throw 한다

  파라미터:

  className - 클래스의 이름

  remoteCodebase - 클래스를 검색하는 스페이스에서 단락지어진 URL 리스트. null인 경우도 있는

  loader - 다른 메서드가 모두 실패했을 경우에 클래스를 로드하기 위해서 사용하는 ClassLoader

  반환값:

  로드 된 클래스를 나타내는 Class 객체

  예외:

  ClassNotFoundException - 클래스를 로드할 수 없는 경우

isLocal

public static boolean isLocal(Stub  stub)
                       throws RemoteException 

isLocal 메서드가 RemoteException을 Throw 할 수 있는 것을 제외해, ObjectImpl. _is_local와 같은 시멘틱스를 가집니다. _is_local() 메서드가 제공되고 있는 것은 특정의 객체가 로컬 서번트에 의해 구현되어 거기에 따라 로컬 호출의 API를 사용할 수 있을지 어떨지를 스텁 로 판정할 수 있도록 하기 때문에입니다.

파라미터:

stub - 테스트하는 스텁

반환값:

객체를 생성하는 서번트가 스텁와 같은 프로세스에 놓여져 양쪽 모두가 같은 ORB 인스턴스를 공유하는 경우, _is_local() 메서드는 true를 리턴합니다. 그렇지 않은 경우, _is_local() 메서드는 false를 리턴합니다. _is_local() 디폴트의 동작은 「false를 돌려준다」입니다.

예외:

RemoteException - IDL 사양의 Java는 RemoteException을 Throw 되도록 하는 조건을 지정하지 않습니다.

wrapException

public static RemoteException  wrapException(Throwable  orig)

구현 메서드에 의해 Throw 된 예외를 랩 합니다. 해당하는 클라이언트측의 예외를 리턴합니다.

파라미터:

orig -감싸는 예외

반환값:

랩 된 예외

copyObjects

public static Object [] copyObjects(Object [] obj,
                                   ORB  orb)
                            throws RemoteException 

객체의 배열을 카피 또는 접속합니다. 로컬 스텁이 실제의 파라미터를 임의의 수카피하는데 사용해, 필요에 따라서 파라미터간에 공유해 RMI 시멘틱스를 지원 합니다.

파라미터:

obj - 카피 또는 접속 대상의 객체

orb - ORB

반환값:

카피 또는 접속된 객체

예외:

RemoteException - 카피 또는 접속할 수 있는 객체가 없는 경우

copyObject

public static Object  copyObject(Object  obj,
                                ORB  orb)
                         throws RemoteException 

객체를 카피 또는 접속합니다. 로컬 스텁이 실제의 파라미터, 결과 객체, 또는 예외를 카피하는데 사용합니다.

파라미터:

obj - 복제 대상의 객체

orb - ORB

반환값:

카피 또는 접속된 객체

예외:

RemoteException - 객체를 카피 또는 접속할 수 없는 경우