Util (Java Platform SE 7)

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` をスローできることを除き、`ObjectImpl._is_local` と同じセマンティクスを持ちます。
`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)` 実装メソッドによってスローされた例外をラップします。
`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 がエクスポートされた RMI-IIOP サーバーオブジェクトである場合、Tie が検索されて obj に結び付けられ、続いて out.write_Object(org.omg.CORBA.Object) に書き込まれます。obj が CORBA Object の場合は、out.write_Object(org.omg.CORBA.Object) に書き込まれます。
    
    パラメータ:
    out - オブジェクトを書き込むストリーム。
    obj - 書き込むオブジェクト。
  - writeAbstractObject
```
public static void writeAbstractObject(OutputStream out,
                       Object obj)
```
    java.lang.Object を値または CORBA Object として書き込みます。obj が値オブジェクトまたはスタブオブジェクトの場合は、out.write_abstract_interface(java.lang.Object) に書き込まれます。obj がエクスポートされた 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 - アンエクスポートするオブジェクト。
    
    例外:
    
    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 SE プラットフォームでは、このメソッドは次のように動作します。
    - 呼び出しスタックで、最初の 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 をスローする。
    パラメータ:
    className - クラスの名前。
    remoteCodebase - クラスの検索場所となる空白で区切られた URL のリスト。null も可。
    loader - ほかのメソッドがすべて失敗した場合に、クラスをロードするために使用できる ClassLoader。
    
    戻り値:
    ロードされたクラスを表す Class オブジェクト。
    
    例外:
    
    ClassNotFoundException - クラスをロードできない場合。
  - isLocal
```
public static boolean isLocal(Stub stub)
                       throws RemoteException
```
    isLocal メソッドが RemoteException をスローできることを除き、ObjectImpl._is_local と同じセマンティクスを持ちます。スタブが、特定のオブジェクトがローカルサーバントによって実装され、したがって、ローカル呼び出し API が使用できるかどうかを判定できるように _is_local() が提供されます。
    
    パラメータ:
    stub - テストするスタブ。
    
    戻り値:
    オブジェクトを生成するサーバントがスタブと同じプロセスに置かれ、両方が同じ ORB インスタンスを共有する場合、_is_local() メソッドは true を返す。そうでない場合、_is_local() メソッドは false を返す。_is_local() のデフォルトの動作は「false を返す」。
    
    例外:
    
    RemoteException - Java to IDL 仕様に RemoteException をスローさせる条件が指定されていない。
  - wrapException
```
public static RemoteException wrapException(Throwable orig)
```
    実装メソッドによってスローされた例外をラップします。該当するクライアント側の例外を返します。
    
    パラメータ:
    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 - オブジェクトをコピーまたは接続できない場合。

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス Util

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

メソッドの詳細

mapSystemException

writeAny

readAny

writeRemoteObject

writeAbstractObject

registerTarget

unexportObject

getTie

createValueHandler

getCodebase

loadClass

isLocal

wrapException

copyObjects

copyObject