当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

Util (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.rmi.CORBA
类 Util

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

---

public class Util
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 - 如果不能复制或连接该对象。

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。