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

Interface NamingContextOperations

    • 方法详细信息

      • bind

        void bind​(NameComponent[] n,
                  Object obj)
           throws NotFound,
                  CannotProceed,
                  InvalidName,
                  AlreadyBound
        在命名上下文中创建名称和对象的绑定。 使用绑定绑定的命名上下文在传递化合物名称以解析时不参与名称解析。
        参数
        n - 对象的名称。
        obj - 与给定名称绑定的对象。
        异常
        NotFound - 表示该名称不标识绑定。
        CannotProceed - 表示由于某些原因实施已经放弃了。 然而,客户端可能能够在返回的命名上下文中继续操作。
        InvalidName - 表示该名称无效。
        AlreadyBound - 表示一个对象已经绑定到指定的名称。
      • bind_context

        void bind_context​(NameComponent[] n,
                          NamingContext nc)
                   throws NotFound,
                          CannotProceed,
                          InvalidName,
                          AlreadyBound
        命名一个命名上下文的对象。 使用bind_context()绑定的命名上下文在传递化合物名称以进行解析时参与名称解析。
        参数
        n - 对象的名称。
        nc - 使用给定名称绑定的NamingContect对象。
        异常
        NotFound - 表示名称不标识绑定。
        CannotProceed - 表示实施由于某些原因而放弃了。 然而,客户端可能能够在返回的命名上下文中继续操作。
        InvalidName - 表示该名称无效。
        AlreadyBound - 表示一个对象已经绑定到指定的名称。
      • rebind

        void rebind​(NameComponent[] n,
                    Object obj)
             throws NotFound,
                    CannotProceed,
                    InvalidName
        即使名称已经在上下文中绑定,也可以在命名上下文中创建名称和对象的绑定。 使用rebind绑定的命名上下文在传递化合物名称以进行解析时不参与名称解析。
        参数
        n - 对象的名称。
        obj - 用给定名称重新绑定的对象。
        异常
        NotFound - 表示名称不标识绑定。
        CannotProceed - 表示由于某些原因实施已经放弃了。 然而,客户端可能能够在返回的命名上下文中继续操作。
        InvalidName - 表示该名称无效。
      • rebind_context

        void rebind_context​(NameComponent[] n,
                            NamingContext nc)
                     throws NotFound,
                            CannotProceed,
                            InvalidName
        在命名上下文中创建名称和命名上下文的绑定,即使名称已经在上下文中绑定了。 使用rebind_context()绑定的命名上下文在传递化合物名称以进行解析时参与名称解析。
        参数
        n - 对象的名称。
        nc - 使用给定名称重命名的NamingContect对象。
        异常
        NotFound - 表示名称不标识绑定。
        CannotProceed - 表示实施由于某些原因而放弃了。 然而,客户端可能能够在返回的命名上下文中继续操作。
        InvalidName - 表示该名称无效。
      • resolve

        Object resolve​(NameComponent[] n)
                throws NotFound,
                       CannotProceed,
                       InvalidName
        解析操作是在给定上下文中检索绑定到名称的对象的过程。 给定的名称必须与绑定名称完全匹配。 命名服务不返回对象的类型。 客户负责将对象“缩小”为适当的类型。 也就是说,客户端通常将返回的对象从Object转换为更专用的界面。
        参数
        n - 对象的名称。
        异常
        NotFound - 表示名称不标识绑定。
        CannotProceed - 表示由于某些原因实现已经放弃了。 然而,客户端可能能够在返回的命名上下文中继续操作。
        InvalidName - 表示该名称无效。
      • unbind

        void unbind​(NameComponent[] n)
             throws NotFound,
                    CannotProceed,
                    InvalidName
        解除绑定操作会从上下文中删除名称绑定。
        参数
        n - 对象的名称。
        异常
        NotFound - 表示名称不标识绑定。
        CannotProceed - 表示实施由于某些原因而放弃了。 然而,客户端可能能够在返回的命名上下文中继续操作。
        InvalidName - 表示该名称无效。
      • list

        void list​(int how_many,
                  BindingListHolder bl,
                  BindingIteratorHolder bi)
        列表操作允许客户端在命名上下文中遍历一组绑定。

        列表操作在BindingList bl中最多返回所请求的绑定数量。

        • 如果命名上下文包含其他绑定,则列表操作将返回具有附加绑定的BindingIterator。
        • 如果命名上下文不包含其他绑定,则绑定迭代器是零对象引用。
        参数
        how_many - 返回的绑定的最大数量。
        bl - 返回的绑定列表。
        bi - 返回的绑定迭代器。
      • new_context

        NamingContext new_context​()
        此操作返回与调用操作的上下文相同的命名服务器实现的命名上下文。 新的上下文不限于任何名称。
      • bind_new_context

        NamingContext bind_new_context​(NameComponent[] n)
                                throws NotFound,
                                       AlreadyBound,
                                       CannotProceed,
                                       InvalidName
        此操作创建一个新的上下文并将其绑定到作为参数提供的名称。 新创建的上下文由与其绑定的上下文相同的命名服务器实现(即,实现由除了最后一个组件的名称参数表示的上下文的命名服务器)。
        参数
        n - 对象的名称。
        异常
        NotFound - 表示名称不标识绑定。
        AlreadyBound - 表示一个对象已经绑定到指定的名称。
        CannotProceed - 表示由于某些原因实现已经放弃了。 然而,客户端可能能够在返回的命名上下文中继续操作。
        InvalidName - 表示该名称无效。
      • destroy

        void destroy​()
              throws NotEmpty
        破坏操作会删除命名上下文。 如果命名上下文包含绑定,则引发NotEmpty异常。
        异常
        NotEmpty - 表示命名上下文包含绑定。