Module  java.corba
软件包  org.omg.CORBA

Class Context



  • public abstract class Context
    extends Object
    Request操作中使用的对象,用于指定在发送请求调用之前必须解析上下文字符串的上下文对象。 Context对象包含的形式属性的列表NamedValue对象。 这些属性表示有关客户端,环境或请求的情况的信息,通常是可能不方便作为参数传递的属性。

    通过首先调用ORB方法get_default_context然后在默认上下文中调用方法create_child创建一个Context对象。

    Context对象中的每个属性由一个NamedValue对象表示。 属性名称包含在NamedValue对象name场,并与名称关联的值包含在Any这是分配给对象NamedValue对象value场。

    Context属性可以表示客户端或应用程序的环境的一部分,该部分意图传播到服务器的环境(并使其成为隐含的部分)。 (示例可能是窗口标识符或用户偏好信息)。 一旦调用了服务器(即在传播属性之后),服务器可以使用方法get_values查询其Context对象的这些属性。

    当操作声明包含一个上下文子句时,存根和骨架将为上下文添加一个附加参数。 当操作调用发生时,ORB会导致在IDL中的操作定义中命名的属性,并且客户端的Context对象中存在的属性将在调用方法的Context对象参数中提供。

    Context属性名称(它们是字符串)通常具有以句点分隔的OMG IDL标识符或一系列OMG IDL标识符的形式。 上下文属性名称模式是属性名称或属性名称,后跟单个“*”。 没有尾随“*”的属性名称模式称为仅匹配本身。 表单“<name> *”的属性名称模式匹配以<name>开头的任何属性名称,并继续添加零个或多个其他字符。

    属性名称模式在操作定义的上下文子句中用作方法Context.get_values的参数。

    Context对象可以“链接在一起”以实现特定的默认行为。 使用方法create_child创建的一个Context对象将被链接到其父(创建它的Context对象),这意味着在搜索属性名称后,该子Context将被搜索。

    在特定的Context对象中定义的属性有效地覆盖了下一个更高级别的属性。 在搜索属性时使用的范围可能会通过指定起始范围并在调用方法get_values时使用标志CTX_RESTRICT_SCOPE来限制。

    为了指定起始搜索范围,可以命名Context对象。

    从以下版本开始:
    JDK1.2
    • 构造方法详细信息

      • 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对象必须具有kind的领域TypeCode设置为TCKind.tk_string
        参数
        values - 包含要设置的属性名称和关联值的 values
        另请参见:
        get_values(java.lang.String, int, java.lang.String)NamedValueAny
      • delete_values

        public abstract void delete_values​(String propname)
        从此Context删除对象,其NamedValue对象的name字段与给定的属性名称匹配。 如果String为供给对象propname具有后通配符(“*”),则所有NamedValue对象,它们的name字段匹配将被删除。 搜索范围始终限于此Context对象。

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

        参数
        propname - 要删除的属性的名称
      • get_values

        public abstract NVList get_values​(String start_scope,
                                          int op_flags,
                                          String pattern)
        检索其name字段与给定名称或名称模式匹配的NamedValue对象。 该方法允许通配符搜索,这意味着可以有多个匹配,因此返回多个值。 如果在指定级别找不到属性,搜索将继续上下文对象树,直到找到匹配或链中所有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