Util

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.rmi.CORBA
类 Util

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

public class Util
extends Object
extends Object

提供可以由 stub 和 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（如果存在）。
`static boolean`	`isLocal(Stub stub)` `isLocal` 方法与 `ObjectImpl._is_local` 方法具有相同的语义，否则可能抛出 `RemoteException`。
`static Class`	`loadClass(String className, String remoteCodebase, ClassLoader loader)` 为指定的类返回一个类实例。
`static RemoteException`	`mapSystemException(SystemException ex)` 将 SystemException 映射到 RemoteException。
`static Object`	`readAny(InputStream in)` 作为 CORBA any 读取 java.lang.Object。
`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)` 将 any 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)

将 any java.lang.Object 作为 CORBA any 写入。

参数：: out - 要写入 any 的流。; obj - 要写入为 any 的对象。

readAny

public static Object readAny(InputStream in)

作为 CORBA any 读取 java.lang.Object。

参数：: in - 从中读取 any 的流。
返回：: 从流读取的 Object。

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 - 要将 Object 写入的流。; obj - 要写入的对象。

writeAbstractObject

public static void writeAbstractObject(OutputStream out,
                                       Object obj)

将 java.lang.Object 作为一个值或 CORBA Object 写入。如果 obj 是一个值对象或者是一个 stub 对象，则将其写入到 out.write_abstract_interface(java.lang.Object)。如果 obj 是导出的 RMI-IIOP 服务器对象，则查找 tie 并传递到 obj，然后写入到 out.write_abstract_interface(java.lang.Object)。

参数：: out - 要写入 Object 的流。; 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，则返回 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 到 IDL 语言的映射关系”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。

参数：
className - 类名。
remoteCodebase - 可能从中发现类的空格分隔的 URL 列表。可以为 null。
loader - 在所有其他方法失败时可以用来加载类的 ClassLoader。
返回：
表示加载的类的 Class 对象。
抛出：
ClassNotFoundException - 如果不能加载类。

isLocal

public static boolean isLocal(Stub stub)
                       throws RemoteException

isLocal 方法与 ObjectImpl._is_local 方法具有相同的语义，否则可能抛出 RemoteException。如果通过本地伺服器实现特定对象，并因此使用本地调用 API，则提供 _is_local() 方法以便能够确定 stub。

参数：: stub - 要测试的 stub。
返回：: 如果具体化对象的伺服器与 stub 位于同一个进程，并且它们共享同一个 ORB 实例，则 _is_local() 方法返回 true。否则，_is_local() 方法返回 false。_is_local() 的默认行为是返回 false。
抛出：: RemoteException - 如果 Java 到 IDL 的规范没有指定导致抛出 RemoteException 的条件。

wrapException

public static RemoteException wrapException(Throwable orig)

包装由实现方法抛出的异常。它返回相应的客户端异常。

参数：: orig - 要包装的异常。
返回：: 包装的异常。

copyObjects

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

复制或连接一个对象数组。由本地 stub 使用以复制任意数量的实际参数，根据需要保留共享的交叉参数以支持 RMI 语义。

参数：: obj - 要复制或连接的对象。; orb - 该 ORB。
返回：: 复制或连接的对象。
抛出：: RemoteException - 如果不能复制或连接任何对象。

copyObject

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

复制或连接一个对象。由本地 stub 使用，以复制实际参数、结果对象或异常。

参数：: obj - 要复制的对象。; orb - 该 ORB。
返回：: 复制或连接的对象。
抛出：: RemoteException - 如果不能复制或连接该对象。

概述