org.omg.CORBA

Class Context

java.lang.Object

org.omg.CORBA.Context

public abstract class Context
extends Object

一个对象用于 Request操作指定上下文的语境中字符串前必须随请求发送的解决。一个 Context对象包含在 NamedValue对象的形态特征。这些属性表示客户端、环境或请求的情况下的信息，一般都是可能不方便传递参数的属性。

一个Context对象时首先调用ORB方法get_default_context然后调用方法create_child在默认的背景下产生的。

在Context对象的每个属性是由一个NamedValue对象表示。属性名称包含在NamedValue对象的name领域，并与名称相关联的值包含在Any对象被分配到NamedValue对象的value场。

Context性质可以代表一部分客户或应用程序的环境，是传播（和隐式部分）服务器的环境。（例如，可能是一个窗口标识符或用户偏好信息）。一旦服务器被调用（即，在属性传播），服务器可以查询其Context对象对这些特性的使用方法get_values。

当一个操作声明包括上下文条款，存根和骨架将有一个额外的参数，添加背景。当一个操作调用时，球的原因，在IDL中的操作定义，存在于客户的Context对象在Context对象参数提供给调用方法的性质。

Context属性名称（这是字符串）通常有一个OMG IDL标识符或一系列的OMG IDL标识符由句点分隔的形式。上下文属性名称模式要么是一个属性名称，要么是一个由一个单一的“*”所跟踪的属性名称。一个属性名称模式，没有一个尾随的“*”是说，只匹配本身。窗体的属性名称模式“ <名称> *”匹配任何以 <名称> 开头的属性名称，并继续以零或更多的附加字符进行匹配。

属性名称的模式是在一个操作定义上下文条款和作为方法的参数Context.get_values。

Context对象可以“链接”在一起，实现一个特定的违约行为。一个Context对象创建的方法create_child将锁母（创建它的Context对象），这意味着母公司将在一个属性名称搜索后的产物。

属性定义在一个特定的Context对象有效覆盖性能在下一个更高的水平。用于搜索性能的范围可以通过指定起始范围和利用旗CTX_RESTRICT_SCOPE当调用方法get_values限制。

一个Context对象可能被命名为指定开始搜索范围的目的。

从以下版本开始：

支持

构造方法摘要

构造方法

Constructor and Description
Context()

方法摘要

Modifier and Type	Method and Description
abstract String	context_name() Context检索该对象的名称。
abstract Context	create_child(String child_ctx_name) 创建一个与给定的字符串作为它的名字，这 Context对象设置为其母 Context对象。
abstract void	delete_values(String propname) 删除从这个 Context对象的 NamedValue对象（S）的 name场匹配给定的属性名称。
abstract NVList	get_values(String start_scope, int op_flags, String pattern) 检索 NamedValue对象的 name场匹配给定的名称或名称的模式。
abstract Context	parent() 检索该对象的父 Context。
abstract void	set_one_value(String propname, Any propvalue) 创建一个 NamedValue对象并将它添加到该 Context对象。
abstract void	set_values(NVList values) 我设置一个或多个在这 Context对象属性值。

Methods inherited from class java.lang.Object

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

Constructor Detail

Context

public Context()

方法详细信息

context_name

public abstract String context_name()

Context检索该对象的名称。

结果

这 Context对象的名称

parent

public abstract Context parent()

检索该对象的父 Context。

结果

这是这 Context对象的父对象 Context

create_child

public abstract Context create_child(String child_ctx_name)

创建一个与给定的字符串作为它的名字，这 Context对象设置为其母 Context对象。

新Context对象链接到它的父Context对象。这意味着在搜索匹配的属性名称，如果在这种情况下没有找到匹配，搜索将继续在父。如果不成功，搜索将继续在祖父母的，如果有一个，等等。

参数

child_ctx_name - String对象被设置为新的 Context对象的名称

结果

新创建的孩子 Context对象初始化具有指定名称的

set_one_value

public abstract void set_one_value(String propname,
                                   Any propvalue)

创建一个 NamedValue对象并将它添加到该 Context对象。新的 NamedValue对象的 name字段设置为给定的字符串，该 value字段设置为给定的 Any对象，和 flags字段设置为零。

参数

propname -要设置的属性的名称

propvalue - Any对象，该属性的值将被设置。的 Any对象的 value字段包含的值是给定的propname相关；的 kind字段必须设置为 TCKind.tk_string。

set_values

public abstract void set_values(NVList values)

我设置一个或多个在这 Context对象属性值。的 NVList提供此方法包含一个或多个 NamedValue对象。在每个 NamedValue对象，的 name字段包含该属性的名称，和 flags字段必须设置为零。的 NamedValue对象的 value字段包含一个 Any对象，其中，反过来，包含该属性的值。因为该值始终是一个字符串，该 Any对象必须具有其 TypeCode设置 TCKind.tk_string的 kind场。

参数

values - nvlist包含属性名和对应的值被设置

另请参见：

get_values(java.lang.String, int, java.lang.String)， NamedValue， Any

delete_values

public abstract void delete_values(String propname)

删除从这个 Context对象的 NamedValue对象（S）的 name场匹配给定的属性名称。如果 propname提供 String对象有一个尾随通配符（“*”），那么所有的 NamedValue对象的 name场比赛将被删除。搜索范围是有限的这一 Context对象。

如果没有找到匹配的属性，则返回一个异常。

参数

propname名称的属性被删除

get_values

public abstract NVList get_values(String start_scope,
                                  int op_flags,
                                  String pattern)

检索 NamedValue对象的 name场匹配给定的名称或名称的模式。这种方法允许通配符搜索，这意味着可以有多个匹配，因此多个返回值。如果物业不在指定的水平，继续搜索的上下文对象树，直到找到一个匹配或链中的所有对象都被耗尽 Context。

如果没有找到匹配，则返回一个错误，并没有返回属性列表。

参数

start_scope - String指示启动指定的属性搜索的上下文对象的水平（例如，“_user”、“_group”、“_system”）。有效的作用域名称是实现特定的。如果省略了一个作用域名称，则搜索从指定的上下文对象开始。如果未找到指定的作用域名称，则返回异常。

op_flags -操作标志。一个标志，可以指定是 CTX_RESTRICT_SCOPE。如果该标志被指定，搜索限制在指定的 start_scope或这 Context对象。

pattern -属性名的值是要检索。 pattern可能是一个名字或名字后面有个通配符（“*”）。

结果

一个 NVList包含所有属性值（在 NamedValue对象的形式）的相关属性的名称匹配给定的名称或名称的模式

另请参见：

set_values(org.omg.CORBA.NVList)， NamedValue