©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object org.omg.CORBA.ORB
public abstract class ORB
为 CORBA 对象请求代理 (Object Request Broker) 特性提供 API 的类。ORB
类还提供“可插入 ORB 实现”API,该 API 允许使用另一个供应商的 ORB 实现。
通过连接发送请求的对象(客户端)与响应请求的对象(服务器),ORB 使 CORBA 对象彼此之间能够进行通讯。
ORB
类封装了一些一般的 CORBA 功能,它可执行以下操作:(注意第 5 项和第 6 项,它们包含 ORB
类中的大多数方法,通常与动态调用接口(Dynamic Invocation Interface
,DII)和动态框架接口(Dynamic Skeleton Interface
,DSI)一起使用。开发人员可以直接使用这些接口,但大多数情况下,这些接口常常由 ORB 内部使用,这对于普通程序员是不可见的。)
resolve_initial_references
获取对某些服务的初始对象引用(如 NameService)
TypeCode
Any
NamedValue
Context
Environment
NVList
)
可以使用 ORB
类获取对网络上任意位置实现的对象的引用。
应用程序或 applet 通过使用三个 init
方法之一将其自身初始化为 ORB
,来访问 CORBA 环境。这三个方法中有两个使用下表中所示的属性(名称与值的关联)。
属性名 | 属性值 |
---|---|
org.omg.CORBA.ORBClass | ORB 实现的类名称 |
org.omg.CORBA.ORBSingletonClass | 由 init() 返回的 ORB 的类名称 |
这些属性允许“插入”不同供应商的 ORB
实现。
在创建 ORB 实例时,使用以下标准搜索顺序来定位 ORB 实现的类名称:
注意,Java IDL 提供全功能 ORB 和单件 (Singleton) ORB 的默认实现。当没有为 init
方法提供任何参数时,返回默认单件 ORB。当为 init
方法提供了参数但没有指定 ORB 类时,返回 Java IDL ORB 实现。
以下代码段创建了一个使用默认 ORB 单件初始化的 ORB
对象。此 ORB 有一个受限制的实现,以防止恶意 applet 执行任何创建 typecode 以外的操作。称它为单件 ORB 是因为整个虚拟机中只有一个实例。
ORB orb = ORB.init();
以下代码片段创建用于某个应用程序的 ORB
对象。参数 args
表示提供给应用程序的 main
方法的参数。因为该属性指定了 ORB 类为 "SomeORBImplementation",所以将使用该 ORB 实现初始化新的 ORB。如果 p 为 null,并且参数没有指定 ORB 类,则使用默认 Java IDL 实现初始化新的 ORB。
Properties p = new Properties(); p.put("org.omg.CORBA.ORBClass", "SomeORBImplementation"); ORB orb = ORB.init(args, p);
以下代码片段为作为第一个参数提供的 applet 创建 ORB
对象。如果给定 applet 没有指定 ORB 类,则将使用默认 Java IDL 实现初始化新的 ORB。
ORB orb = ORB.init(myApplet, null);
可以在一个或多个 ORB 中初始化应用程序或 applet。ORB 初始化是进入 CORBA 环境的引导调用。
构造方法摘要 | |
---|---|
ORB()
|
方法摘要 | |
---|---|
void |
connect(Object obj)
将给定 servant 对象(作为服务器实现类的实例的 Java 对象)连接到 ORB。 |
TypeCode |
create_abstract_interface_tc(String id,
String name)
为 IDL 抽象接口创建一个 TypeCode 对象。 |
abstract TypeCode |
create_alias_tc(String id,
String name,
TypeCode original_type)
创建一个表示 IDL alias 的 TypeCode 对象 (typedef )。 |
abstract Any |
create_any()
创建一个 IDL Any 对象,初始化后该对象包含一个 kind 字段被设置为 TCKind.tc_null 的 Typecode 对象。 |
abstract TypeCode |
create_array_tc(int length,
TypeCode element_type)
创建一个表示 IDL array 的 TypeCode 对象。 |
DynAny |
create_basic_dyn_any(TypeCode type)
已过时。 使用新的 DynAnyFactory API 代替 |
abstract ContextList |
create_context_list()
创建一个空的 ContextList 对象。 |
DynAny |
create_dyn_any(Any value)
已过时。 使用新的 DynAnyFactory API 代替 |
DynArray |
create_dyn_array(TypeCode type)
已过时。 使用新的 DynAnyFactory API 代替 |
DynEnum |
create_dyn_enum(TypeCode type)
已过时。 使用新的 DynAnyFactory API 代替 |
DynSequence |
create_dyn_sequence(TypeCode type)
已过时。 使用新的 DynAnyFactory API 代替 |
DynStruct |
create_dyn_struct(TypeCode type)
已过时。 使用新的 DynAnyFactory API 代替 |
DynUnion |
create_dyn_union(TypeCode type)
已过时。 使用新的 DynAnyFactory API 代替 |
abstract TypeCode |
create_enum_tc(String id,
String name,
String[] members)
创建一个表示 IDL enum 的 TypeCode 对象。 |
abstract Environment |
create_environment()
创建一个 Environment 对象。 |
abstract ExceptionList |
create_exception_list()
创建一个空的 ExceptionList 对象。 |
abstract TypeCode |
create_exception_tc(String id,
String name,
StructMember[] members)
创建一个表示 IDL exception 的 TypeCode 对象。 |
TypeCode |
create_fixed_tc(short digits,
short scale)
为 IDL fixed 类型创建一个 TypeCode 对象。 |
abstract TypeCode |
create_interface_tc(String id,
String name)
创建一个表示 IDL interface 的 TypeCode 对象。 |
abstract NVList |
create_list(int count)
为指定数量的 NamedValue 对象分配具有(可能)足够空间的 NVList 。 |
abstract NamedValue |
create_named_value(String s,
Any any,
int flags)
使用给定名称、值和参数模式标志创建一个 NamedValue 对象。 |
TypeCode |
create_native_tc(String id,
String name)
为 IDL native 类型创建一个 TypeCode 对象。 |
NVList |
create_operation_list(Object oper)
创建一个 NVList ,并使用给定 OperationDef 对象中所述操作的参数描述进行初始化。 |
abstract OutputStream |
create_output_stream()
创建一个新的 org.omg.CORBA.portable.OutputStream ,在执行方法调用期间,可在该输出流中对 IDL 方法参数进行编组。 |
Policy |
create_policy(int type,
Any val)
可以调用此方法创建特定类型的新策略对象实例,并且其类型具有指定的初始状态。 |
abstract TypeCode |
create_recursive_sequence_tc(int bound,
int offset)
已过时。 使用 create_recursive_tc 和 create_sequence_tc 的组合替代它 |
TypeCode |
create_recursive_tc(String id)
创建一个递归 TypeCode 对象,在创建包含递归的 TypeCodes 期间,该对象充当具体 TypeCode 的占位符。 |
abstract TypeCode |
create_sequence_tc(int bound,
TypeCode element_type)
创建一个表示 IDL sequence 的 TypeCode 对象。 |
abstract TypeCode |
create_string_tc(int bound)
创建一个表示有界 IDL string 的 TypeCode 对象。 |
abstract TypeCode |
create_struct_tc(String id,
String name,
StructMember[] members)
创建一个表示 IDL struct 的 TypeCode 对象。 |
abstract TypeCode |
create_union_tc(String id,
String name,
TypeCode discriminator_type,
UnionMember[] members)
创建一个表示 IDL union 的 TypeCode 对象。 |
TypeCode |
create_value_box_tc(String id,
String name,
TypeCode boxed_type)
为 IDL value box 类型创建一个 TypeCode 对象。 |
TypeCode |
create_value_tc(String id,
String name,
short type_modifier,
TypeCode concrete_base,
ValueMember[] members)
为 IDL value 类型创建一个 TypeCode 对象。 |
abstract TypeCode |
create_wstring_tc(int bound)
创建一个表示有界 IDL wstring (wide string) 的 TypeCode 对象。 |
void |
destroy()
销毁 ORB,以便可以回收其资源。 |
void |
disconnect(Object obj)
断开给定 servant 对象与 ORB 的连接。 |
Current |
get_current()
已过时。 使用 resolve_initial_references 。
|
abstract Context |
get_default_context()
获取默认 Context 对象。 |
abstract Request |
get_next_response()
获取已接收到响应的下一个 Request 实例。 |
abstract TypeCode |
get_primitive_tc(TCKind tcKind)
检索表示给定基本 IDL 类型的 TypeCode 对象。 |
boolean |
get_service_information(short service_type,
ServiceInformationHolder service_info)
用来获取有关受此 ORB 支持的 CORBA 资源和服务的信息。 |
static ORB |
init()
返回对象 ORB 单件。 |
static ORB |
init(Applet app,
Properties props)
为 applet 创建一个新的 ORB 实例。 |
static ORB |
init(String[] args,
Properties props)
为独立的应用程序创建一个新的 ORB 实例。 |
abstract String[] |
list_initial_services()
返回最初可用 CORBA 对象引用(比如 "NameService" 和 "InterfaceRepository")的列表。 |
abstract String |
object_to_string(Object obj)
将给定 CORBA 对象引用转换为字符串。 |
void |
perform_work()
如果该操作由主线程调用,则执行与实现有关的单元操作。 |
abstract boolean |
poll_next_response()
找出是否已经响应了延迟的(异步)调用。 |
abstract Object |
resolve_initial_references(String object_name)
根据可用初始服务名称集解析特定对象引用。 |
void |
run()
在 ORB 已完成关闭过程前(该过程始于某些线程调用 shutdown 时),此操作将一直阻塞当前线程。 |
abstract void |
send_multiple_requests_deferred(Request[] req)
异步发送多个动态 (DII) 请求。 |
abstract void |
send_multiple_requests_oneway(Request[] req)
异步发送多个动态 (DII) 请求,并且不期望任何响应。 |
protected abstract void |
set_parameters(Applet app,
Properties props)
允许使用给定 applet 和参数初始化 ORB 实现。 |
protected abstract void |
set_parameters(String[] args,
Properties props)
允许使用给定的参数和属性初始化 ORB 实现。 |
void |
shutdown(boolean wait_for_completion)
指示关闭 ORB,这将导致关闭所有对象适配器,以准备销毁。 |
abstract Object |
string_to_object(String str)
将方法 object_to_string 生成的字符串转换回 CORBA 对象引用。 |
boolean |
work_pending()
如果 ORB 需要主线程来执行某些操作,则返回 true ;如果 ORB 不需要主线程,则返回 false 。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public ORB()
方法详细信息 |
---|
public static ORB init()
ORB
单件。此方法总是返回相同的 ORB 实例,该实例是由 org.omg.CORBA.ORBSingletonClass
系统属性所描述的类的实例。
无参数的 init
方法主要用作 TypeCode
对象的工厂,Helper
类使用该对象来实现 type
方法。还可以使用该方法来创建用于描述 union
标签的 Any
对象(作为创建用于 union
的 TypeCode
对象的一部分)。
此方法并不适合由 applet 使用,如果在 applet 环境中调用此方法,则该方法返回的 ORB 是受限制的,即它只能用作 TypeCode
对象的工厂。该方法生成的任何 TypeCode
对象都可以在不受信任的 applet 之间安全地共享。
如果某一 ORB 是使用此方法从 applet 创建的,则将抛出系统异常(如果调用的是用来创建 TypeCode
对象的那些方法以外的方法)。
public static ORB init(String[] args, Properties props)
ORB
实例。此方法只能从应用程序调用,每次调用该方法都会返回一个新的全功能 ORB
对象。
args
- 应用程序的 main
方法的命令行参数,可以为 null
props
- 特定于应用程序的属性,可以为 null
public static ORB init(Applet app, Properties props)
ORB
实例。此方法只能从 applet 调用,每次调用该方法都会返回一个新的全功能 ORB
对象。
app
- applet,可以为 null
props
- 特定于 applet 的属性,可以为 null
protected abstract void set_parameters(String[] args, Properties props)
init
方法调用,以传入其参数。
args
- 应用程序的 main
方法的命令行参数,可以为 null
props
- 特定于应用程序的属性,可以为 null
protected abstract void set_parameters(Applet app, Properties props)
init
方法调用,以传入其参数。
app
- applet,可以为 null
props
- 特定于 applet 的属性,可以为 null
public void connect(Object obj)
ImplBase
类。因此 servant 必须是一个 CORBA 对象引用,并且必须继承自 org.omg.CORBA.Object
。由用户创建的 servant 可在调用 connect
方法之后开始接收远程调用。如果将 servant 作为非本地对象上的 IDL 方法调用中的 IDL 参数传递,也就是说,如果对 servant 对象进行编组并将它发送到进程地址空间以外,则 servant 也可以自动隐式地连接到 ORB。
当 servant 对象已经连接到 ORB 时,调用 connect
方法没有任何效果。
OMG 推荐使用可移植对象适配器 API 取代此方法。
obj
- servant 对象引用public void destroy()
OBJECT_NOT_EXIST
异常。一旦已销毁 ORB,使用相同的 ORBid 再次调用 init
将返回对新建 ORB 的引用。
如果对尚未关闭的 ORB 调用 destroy
,则在销毁该 ORB 之前将启动关闭进程,并且该方法将一直阻塞到关闭 ORB 为止。
如果应用程序在当前正服务于某个调用的线程中调用 destroy
,则将抛出 BAD_INV_ORDER
系统异常,并带有 OMG 次要代码 (minor code) 3,因为阻塞将导致死锁。
为获取最大的可移植性并避免资源泄漏,应用程序应该总是在退出前对所有 ORB 实例调用 shutdown
和 destroy
。
BAD_INV_ORDER
- 如果当前线程正服务于某一调用public void disconnect(Object obj)
org.omg.CORBA.OBJECT_NOT_EXIST
发送回远程客户端。因此,从远程客户端看来,该对象似乎已被销毁。不过要注意的是,使用 servant 直接发布的本地请求不通过 ORB,因此,这些请求将继续由 servant 处理。
如果 servant 没有连接到 ORB,则调用 disconnect
方法没有任何效果。
OMG 推荐使用可移植对象适配器 API 取代此方法。
obj
- 将与 ORB 断开连接的 servant 对象public abstract String[] list_initial_services()
String
对象数组,这些对象表示此 ORB 中最初可用 CORBA 服务的对象引用public abstract Object resolve_initial_references(String object_name) throws InvalidName
object_name
- 字符串形式的初始服务名称
InvalidName
- 如果给定名称不与已知服务关联public abstract String object_to_string(Object obj)
可以使用能够操作 String
对象的任何方式存储所得 String
对象或与它们进行通信。
obj
- 将字符串化的对象引用
public abstract Object string_to_object(String str)
object_to_string
生成的字符串转换回 CORBA 对象引用。
str
- 将转换回对象引用的字符串。它必须是使用 object_to_string
方法将对象引用转换所得到的字符串。
public abstract NVList create_list(int count)
NamedValue
对象分配具有(可能)足够空间的 NVList
。注意,指定的大小只是一个有助于存储分配的提示,并不表示列表的最大大小。
count
- 要分配空间的 NamedValue
对象的建议数量
NVList
NVList
public NVList create_operation_list(Object oper)
NVList
,并使用给定 OperationDef
对象中所述操作的参数描述进行初始化。此 OperationDef
对象是从接口存储库 (Interface Repository) 中获得的。所返回 NVList
对象中参数的顺序与原始 IDL 操作定义中的顺序相同,这使得能够在动态调用请求中使用该列表。
oper
- 将用来创建列表的 OperationDef
对象
NVList
对象,它包含对给定 OperationDef
对象中所述方法的参数描述NVList
public abstract NamedValue create_named_value(String s, Any any, int flags)
NamedValue
对象。
NamedValue
对象可用作 (1) 参数或返回值,或者 (2) 上下文属性。它可以单独使用,也可以作为 NVList
对象中的一个元素使用。
s
- NamedValue
对象的名称any
- 将插入 NamedValue
对象的 Any
值flags
- NamedValue
的参数模式标志:ARG_IN.value
、ARG_OUT.value
或 ARG_INOUT.value
之一。
NamedValue
对象NamedValue
public abstract ExceptionList create_exception_list()
ExceptionList
对象。
ExceptionList
对象public abstract ContextList create_context_list()
ContextList
对象。
ContextList
对象ContextList
,
Context
public abstract Context get_default_context()
Context
对象。
Context
对象Context
public abstract Environment create_environment()
Environment
对象。
Environment
对象Environment
public abstract OutputStream create_output_stream()
org.omg.CORBA.portable.OutputStream
,在执行方法调用期间,可在该输出流中对 IDL 方法参数进行编组。
org.omg.CORBA.portable.OutputStream
对象public abstract void send_multiple_requests_oneway(Request[] req)
req
- 请求对象数组public abstract void send_multiple_requests_deferred(Request[] req)
req
- Request
对象数组public abstract boolean poll_next_response()
true
;否则返回 false
。public abstract Request get_next_response() throws WrongTransaction
Request
实例。
Request
对象
WrongTransaction
- 如果在不同于发送原始请求的事务处理域中调用 get_next_response
方法。有关详细信息,请参阅 OMG 事务服务 (Transaction Service) 规范。public abstract TypeCode get_primitive_tc(TCKind tcKind)
TypeCode
对象。
tcKind
- 对应于所需基本类型的 TCKind
实例
TypeCode
对象public abstract TypeCode create_struct_tc(String id, String name, StructMember[] members)
struct
的 TypeCode
对象。使用给定 id、名称和成员初始化该 TypeCode
对象。
id
- struct
的存储库 idname
- struct
的名称members
- 描述 struct
成员的数组
struct
的新建 TypeCode
对象public abstract TypeCode create_union_tc(String id, String name, TypeCode discriminator_type, UnionMember[] members)
union
的 TypeCode
对象。使用给定 id、名称、鉴别符类型和成员初始化该 TypeCode
对象。
id
- union
的存储库 idname
- union
的名称discriminator_type
- union
鉴别符的类型members
- 描述 union
成员的数组
union
的新建 TypeCode
对象public abstract TypeCode create_enum_tc(String id, String name, String[] members)
enum
的 TypeCode
对象。使用给定 id、名称和成员初始化该 TypeCode
对象。
id
- enum
的存储库 idname
- enum
的名称members
- 描述 enum
成员的数组
enum
的新建 TypeCode
对象public abstract TypeCode create_alias_tc(String id, String name, TypeCode original_type)
alias
的 TypeCode
对象 (typedef
)。使用给定 id、名称和原始类型初始化该 TypeCode
对象。
id
- 别名的存储库 idname
- 别名的名称original_type
- 描述原始类型(该值是其别名)的 TypeCode
对象
alias
的新建 TypeCode
对象public abstract TypeCode create_exception_tc(String id, String name, StructMember[] members)
exception
的 TypeCode
对象。使用给定 id、名称和成员初始化该 TypeCode
对象。
id
- exception
的存储库 idname
- exception
的名称members
- 描述 exception
成员的数组
exception
的新建 TypeCode
对象public abstract TypeCode create_interface_tc(String id, String name)
interface
的 TypeCode
对象。使用给定 id 和名称初始化该 TypeCode
对象。
id
- 接口的存储库 idname
- 接口的名称
interface
的新建 TypeCode
对象public abstract TypeCode create_string_tc(int bound)
string
的 TypeCode
对象。使用给定 bound 初始化该 TypeCode
对象,bound 表示字符串的最大长度。0 指示此类型代码描述的字符串是无界的。
bound
- string
的范围,不能为负
string
的新建 TypeCode
对象
BAD_PARAM
- 如果 bound 为负值public abstract TypeCode create_wstring_tc(int bound)
wstring
(wide string) 的 TypeCode
对象。使用给定 bound 初始化该 TypeCode
对象,bound 表示宽字符串的最大长度。0 指示此类型代码描述的字符串是无界的。
bound
- wstring
的范围,不能为负
wstring
的新建 TypeCode
对象
BAD_PARAM
- 如果 bound 为负值public abstract TypeCode create_sequence_tc(int bound, TypeCode element_type)
sequence
的 TypeCode
对象。使用给定 bound 和元素类型初始化该 TypeCode
对象。
bound
- sequence
的范围,如果无界,则该值为 0element_type
- 描述 sequence
中所包含元素的 TypeCode
对象
sequence
的新建 TypeCode
对象@Deprecated public abstract TypeCode create_recursive_sequence_tc(int bound, int offset)
sequence
的 TypeCode
对象。
对于以下代码片段中的 IDL struct
Node,用来创建其序列的 offset 参数将是 1:
Struct Node { long value; Sequence <Node> subnodes; };
bound
- 序列范围,如果无界,则该值为 0offset
- 描述此序列元素的封闭 TypeCode
对象的索引
TypeCode
对象create_recursive_tc
,
create_sequence_tc
public abstract TypeCode create_array_tc(int length, TypeCode element_type)
array
的 TypeCode
对象。使用给定长度和元素类型初始化该 TypeCode
对象。
length
- array
的长度element_type
- 描述 array
中所包含元素的类型的 TypeCode
对象
array
的新建 TypeCode
对象public TypeCode create_native_tc(String id, String name)
TypeCode
对象。
id
- native 类型的逻辑 id。name
- native 类型的名称。
public TypeCode create_abstract_interface_tc(String id, String name)
TypeCode
对象。
id
- 抽象接口类型的逻辑 id。name
- 抽象接口类型的名称。
public TypeCode create_fixed_tc(short digits, short scale)
TypeCode
对象。
digits
- 指定数字中总的小数位数,必须在从 1 到 31 的闭区间内。scale
- 指定小数点的位置。
public TypeCode create_value_tc(String id, String name, short type_modifier, TypeCode concrete_base, ValueMember[] members)
TypeCode
对象。concrete_base 参数是用于 valuetype(将为其创建 TypeCode)直接具体 valuetype 基的 TypeCode。如果 valuetype 没有 concrete 基,则该值为 null。
id
- 值类型的逻辑 id。name
- 值类型的名称。type_modifier
- 以下值类型修饰符常量之一:VM_NONE、VM_CUSTOM、VM_ABSTRACT 或 VM_TRUNCATABLEconcrete_base
- 描述具体 valuetype 基的 TypeCode
对象members
- 包含 value 类型成员的数组
public TypeCode create_recursive_tc(String id)
TypeCode
对象,在创建包含递归的 TypeCodes 期间,该对象充当具体 TypeCode 的占位符。id 参数指定类型(递归 TypeCode 将充当该类型的占位符)的存储库 id。一旦将递归 TypeCode 正确地嵌入到对应于指定存储库 id 的封闭 TypeCode,该 TypeCode 的作用将与普通 TypeCode 一样。如果在将递归 TypeCode 嵌入封闭 TypeCode 之前对该 TypeCode 执行调用操作,则将导致 BAD_TYPECODE
异常。
例如,以下 IDL 类型声明中包含递归:
Struct Node { Sequence<Node> subnodes; };
要为 struct Node 创建 TypeCode,应调用 TypeCode 创建操作,如下所示:
String nodeID = "IDL:Node:1.0"; TypeCode recursiveSeqTC = orb.create_sequence_tc(0, orb.create_recursive_tc(nodeID)); StructMember[] members = { new StructMember("subnodes", recursiveSeqTC, null) }; TypeCode structNodeTC = orb.create_struct_tc(nodeID, "Node", members);
还要注意的是,以下是一个非法 IDL 类型声明:
Struct Node { Node next; };
递归类型只能出现在可以为空的序列中。当在 Any 数组中传输 struct 数据时,可以通过这种方式避免编码问题。
id
- 所引用类型的逻辑 id
public TypeCode create_value_box_tc(String id, String name, TypeCode boxed_type)
TypeCode
对象。
id
- 值类型的逻辑 idname
- 值类型的名称boxed_type
- 该类型的 TypeCode
public abstract Any create_any()
Any
对象,初始化后该对象包含一个 kind
字段被设置为 TCKind.tc_null
的 Typecode
对象。
Any
对象@Deprecated public Current get_current()
resolve_initial_references
。
Current
对象。Current
接口用于管理由服务使用的特定于线程的信息(比如事务处理和安全)。
Current
对象CORBA
包中有关未实现特性的注释public void run()
shutdown
时),此操作将一直阻塞当前线程。此方法可由关闭 ORB 时获取全部通知的多个线程使用。
public void shutdown(boolean wait_for_completion)
wait_for_completion
参数为 true,则在所有 ORB 处理(包括当前执行请求、对象释放和其他对象适配器操作的处理)已完成之前,此操作一直受阻塞。如果应用程序在当前正服务于某个调用的线程中执行该操作,则将抛出 BAD_INV_ORDER
系统异常,并带有 OMG 次要代码 3,因为阻塞将导致死锁。wait_for_completion
参数为 FALSE
,则可能在返回时还没完成关闭。
当 ORB 处于关闭过程中时,ORB 操作照常,继续为传入和传出的请求服务,直到所有请求完成为止。一旦 ORB 已关闭,则只能对该 ORB(或从中获得的任何对象引用)调用对象引用管理操作。应用程序还可以对 ORB 本身调用 destroy
操作。调用任何其他操作将导致抛出 BAD_INV_ORDER
系统异常,并带有 OMG 次要代码 4。
ORB.run
方法将在调用 shutdown
之后返回。
wait_for_completion
- 如果调用在完成关闭之前应一直受阻塞,则该参数为 true
;如果该调用应立即返回,则该参数为 false
BAD_INV_ORDER
- 如果当前线程正服务于某一调用。public boolean work_pending()
true
;如果 ORB 不需要主线程,则返回 false
。
true
,这意味着 ORB 需要主线程来执行某些操作;如果没有操作处于挂起状态,从而 ORB 不需要主线程,则返回 false
public void perform_work()
work_pending
和 perform_work
方法来实现简单的轮询循环,该循环在 ORB 和其他活动中多路传输主线程。
public boolean get_service_information(short service_type, ServiceInformationHolder service_info)
service_type
- 一个 short
值,指示将为其请求信息的服务类型service_info
- 一个 ServiceInformationHolder
对象,该对象将保存此方法生成的 ServiceInformation
对象
true
;如果对于所请求的服务类型没有可用信息,则返回 false
CORBA
包中有关未实现特性的注释@Deprecated public DynAny create_dyn_any(Any value)
Any
对象创建一个新的 DynAny
对象。
value
- 据以创建新 DynAny
对象的 Any
对象
Any
对象创建的新 DynAny
对象CORBA
包中有关未实现特性的注释@Deprecated public DynAny create_basic_dyn_any(TypeCode type) throws InconsistentTypeCode
TypeCode
对象创建基本 DynAny
对象。
type
- 据以创建新 DynAny
对象的 TypeCode
对象
TypeCode
对象创建新的 DynAny
对象
InconsistentTypeCode
- 如果给定 TypeCode
对象与操作不一致。CORBA
包中有关未实现特性的注释@Deprecated public DynStruct create_dyn_struct(TypeCode type) throws InconsistentTypeCode
TypeCode
对象创建新的 DynStruct
对象。
type
- 据以创建新的 DynStruct
对象的 TypeCode
对象
TypeCode
对象创建新的 DynStruct
对象
InconsistentTypeCode
- 如果给定 TypeCode
对象与操作不一致。CORBA
包中有关未实现特性的注释@Deprecated public DynSequence create_dyn_sequence(TypeCode type) throws InconsistentTypeCode
TypeCode
对象创建新的 DynSequence
对象。
type
- 据以创建新 DynSequence
对象的 TypeCode
对象
TypeCode
对象创建新的 DynSequence
对象
InconsistentTypeCode
- 如果给定 TypeCode
对象与操作不一致。CORBA
包中有关未实现特性的注释@Deprecated public DynArray create_dyn_array(TypeCode type) throws InconsistentTypeCode
TypeCode
对象创建新的 DynArray
对象。
type
- 据以创建新 DynArray
对象的 TypeCode
对象
TypeCode
对象创建新的 DynArray
对象
InconsistentTypeCode
- 如果给定 TypeCode
对象与操作不一致。CORBA
包中有关未实现特性的注释@Deprecated public DynUnion create_dyn_union(TypeCode type) throws InconsistentTypeCode
TypeCode
对象创建新的 DynUnion
对象。
type
- 据以创建新 DynUnion
对象的 TypeCode
对象
TypeCode
对象创建新的 DynUnion
对象
InconsistentTypeCode
- 如果给定 TypeCode
对象与操作不一致。CORBA
包中有关未实现特性的注释@Deprecated public DynEnum create_dyn_enum(TypeCode type) throws InconsistentTypeCode
TypeCode
对象创建新的 DynEnum
对象。
type
- 据以创建新 DynEnum
对象的 TypeCode
对象
TypeCode
对象创建新的 DynEnum
对象
InconsistentTypeCode
- 如果给定 TypeCode
对象与操作不一致。CORBA
包中有关未实现特性的注释public Policy create_policy(int type, Any val) throws PolicyError
type
- 要创建的策略对象的 PolicyTypeval
- 将用来设置被创建的 Policy 对象初始状态的值
org.omg.CORBA.PolicyError
- 当所请求的策略不受支持,或所请求的策略初始状态不受支持时。
PolicyError
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。