Context (Java Platform SE 8 )

All Known Subinterfaces:

DirContext ， EventContext ， EventDirContext ， LdapContext

所有已知实现类：

InitialContext ， InitialDirContext ， InitialLdapContext
```
public interface Context
```
该接口表示一个命名上下文，它由一组名称对对象绑定组成。它包含检查和更新这些绑定的方法。
名字
传递给Context方法的参数的每个名称都是相对于该上下文。空的名称用于命名上下文本身。名称参数可能永远不为空。
大多数方法都有超载版本，一个使用一个Name参数，一个采用String 。这些重载版本是等效的，因为如果Name和String参数只是相同名称的不同表示，那么相同方法的重载版本行为相同。在下面的方法描述中，只有一个版本被完整记录。第二个版本代替了第一个链接：相同的文档适用于两者。

对于支持联合的系统，String个名称参数Context个方法是复合名称。名称是CompositeName实例被看作是复合名称，而Name个参数不属于的CompositeName实例为化合物名称治疗（其可能是CompoundName实例或化合物名称的其它实施方式）的参数。这样可以将NameParser.parse()的结果用作Context方法的参数。在JNDI 1.2之前，所有的名称参数被视为复合名称。

此外，对于支持联合的系统， NamingEnumeration从list()和listBindings()返回的所有名称都是以字符串表示的复合名称。有关名称的字符串语法，请参阅CompositeName 。

对于不支持联合的系统，名称参数（在Name或String表单中）和NamingEnumeration中返回的名称可能是其自己的命名空间中的名称，而不是复合命名空间中的名称，由服务提供商决定。

例外
此接口中的所有方法都可以抛出一个NamingException或其任何子类。有关每个异常的详细信息，请参阅NamingException及其子类。
并发访问
上下文实例不能保证与多个线程的并发访问同步。需要同时访问单个上下文实例的线程应在其间同步并提供必要的锁定。每个操作不同Context实例的多个线程不需要同步。请注意， lookup方法在传递一个空名时将返回一个表示相同命名上下文的新Context实例。
为了并发控制的目的，返回NamingEnumeration的上下文操作在枚举仍在使用中或者仍然遵循该操作生成的任何引用时，不被认为已经完成。

参数
传递给Context界面或它的子接口中的一个的任何方法A Name参数将不会由服务提供者进行修改。服务提供商可以在操作期间保留对其的引用，包括方法结果的任何枚举以及生成的任何引用的处理。呼叫者在此期间不应修改对象。由任何此类方法返回的A Name由调用者拥有。呼叫者可以随后修改它; 服务提供商可能不会。
环境属性

JNDI应用程序需要一种方式来传达定义访问命名和目录服务的环境的各种首选项和属性。例如，上下文可能需要指定安全凭据才能访问该服务。另一个上下文可能需要提供服务器配置信息。这些被称为上下文的环境。 Context接口提供检索和更新此环境的方法。

随着上下文方法从一个上下文进入下一个环境，环境是从父上下文继承的。对一个环境的环境的改变不会直接影响其他环境的环境。

当环境属性被使用和/或验证有效性时，它是实现依赖的。例如，服务提供商使用某些与安全性相关的属性来“登录”目录。此登录过程可能会在上下文创建时发生，或者在上下文首次调用方法时发生。何时，以及是否发生这种情况是依赖于实现的。当环境属性从上下文中添加或删除时，验证更改的有效性再次取决于实现。例如，某些属性的验证可能在更改时发生，或在下一个操作在上下文中执行时，或根本不发生。

任何具有对上下文的引用的对象都可以检查该上下文的环境。敏感信息（如明文密码）不应存储在那里，除非已知实现保护它。

资源文件

为了简化设置JNDI应用程序所需环境的任务，应用程序组件和服务提供程序可能与资源文件一起分发。 JNDI资源文件是属性文件格式的文件（请参阅java.util.Properties ），其中包含键/值对列表。关键是属性的名称（例如“java.naming.factory.object”），该值是为该属性定义的格式的字符串。以下是JNDI资源文件的示例：

java.naming.factory.object=com.sun.jndi.ldap.AttrsToCorba:com.wiz.from.Person java.naming.factory.state=com.sun.jndi.ldap.CorbaToAttrs:com.wiz.from.Person java.naming.factory.control=com.sun.jndi.ldap.ResponseControlFactory
JNDI类库读取资源文件，并使属性值免费使用。因此，JNDI资源文件应该被认为是“世界可读”的，敏感信息（如明文密码）不应存储在那里。
有两种JNDI资源文件： 提供者和应用程序。

提供者资源文件
每个服务提供商都有一个可选资源，列出特定于该提供商的属性。该资源的名称是：
[ prefix/] jndiprovider.properties
其中， prefix是提供者的上下文实现的包名，每个句点（“。”）转换为斜杠（“/”）。例如，假设一个服务提供者定义一个类名为com.sun.jndi.ldap.LdapCtx的上下文实现 。此提供程序的提供程序资源名为com/sun/jndi/ldap/jndiprovider.properties 。如果该类不在包中，则该资源的名称仅为jndiprovider.properties 。
JNDI类库中的某些方法使用指定JNDI工厂列表的标准JNDI属性：
- java.naming.factory.object
- java.naming.factory.state
- java.naming.factory.control
- java.naming.factory.url.pkgs
当确定这些属性的值时，JNDI库将查询提供者资源文件。可以由服务提供商自行决定在提供商资源文件中设置这些以外的属性。服务提供者的文件应明确说明允许哪些属性; 该文件中的其他属性将被忽略。
应用资源文件
当部署应用程序时，它的类路径通常会有多个代码库目录和JAR。类似地，当部署小程序时，它将具有一个代码库和存档，指定在哪里找到小程序的类。 JNDI在类路径中定位（使用ClassLoader.getResources() ）名为jndi.properties的所有应用程序资源文件 。此外，如果文件java.home /lib/jndi.properties存在且可读，则JNDI将其视为其他应用程序资源文件。（ java.home表示由java.home系统属性命名的目录 。）这些文件中包含的所有属性都放置在初始上下文的环境中。然后，这种环境由其他上下文继承。
对于在多个应用程序资源文件中找到的每个属性，JNDI使用发现的第一个值，或者在少数情况下，将其连接起来（详细信息如下）。例如，如果在三个jndi.properties资源文件中找到“java.naming.factory.object”属性，则对象工厂列表是来自所有三个文件的属性值的连接。使用此方案，每个可部署组件负责列出其出口的工厂。搜索工厂类时，JNDI会自动收集并使用所有这些导出列表。

搜索算法的属性
当JNDI构建一个初始上下文时，上下文的环境是通过传递给构造函数，系统属性，小程序参数和应用程序资源文件的环境参数中定义的属性进行初始化的。详见InitialContext 。然后，这个初始环境由其他上下文实例继承。
当JNDI类库需要确定一个属性的值时，它按照以下顺序合并来自以下两个来源的值：
1. 上下文的环境正在运行。
2. 为上下文操作的提供者资源文件（ jndiprovider.properties ）。
对于在这两个来源中找到的每个属性，JNDI确定属性的值如下。如果属性是指定JNDI工厂列表的标准JNDI属性之一（列出了above ），则这些值将连接到单个冒号分隔列表中。对于其他属性，仅使用第一个找到的值。
当服务提供商需要确定属性的值时，通常会直接从环境中获取该值。服务提供商可以将供应商特定的属性定义为放置在其自己的提供商资源文件中。在这种情况下，它应该合并上一段所述的值。

以这种方式，每个服务提供商开发人员可以指定要与该服务提供商一起使用的工厂列表。这些可以由应用程序或小应用程序的部署程序指定的应用程序资源修改，而应用程序或小应用程序可以由用户修改。
从以下版本开始：

1.3

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`APPLET` 包含指定用于搜索其他属性时要使用的初始上下文构造函数的小程序的环境属性的常量的常量。
`static String`	`AUTHORITATIVE` 用于指定所请求的服务的权威性的环境属性的名称的常量。
`static String`	`BATCHSIZE` 包含用于指定通过服务协议返回数据时使用的批量大小的环境属性名称的常量。
`static String`	`DNS_URL` 持有用于指定用于JNDI URL上下文的DNS主机和域名的环境属性的名称的常量（例如“dns：//somehost/wiz.com”）。
`static String`	`INITIAL_CONTEXT_FACTORY` 用于指定要使用的初始上下文工厂的环境属性的名称的常量。
`static String`	`LANGUAGE` 包含用于指定与服务一起使用的首选语言的环境属性名称的常量。
`static String`	`OBJECT_FACTORIES` 用于指定要使用的对象工厂列表的环境属性的名称的常量。
`static String`	`PROVIDER_URL` 包含用于指定服务提供商要使用的配置信息的环境属性的名称的常量。
`static String`	`REFERRAL` 持有用于指定如何处理服务提供商遇到的引用的环境属性的名称的常量。
`static String`	`SECURITY_AUTHENTICATION` 持有用于指定要使用的安全级别的环境属性的名称的常量。
`static String`	`SECURITY_CREDENTIALS` 包含用于指定用于验证呼叫者到服务的主体的凭据的环境属性的名称的常量。
`static String`	`SECURITY_PRINCIPAL` 持有用于指定主体的身份的环境属性的常量，用于验证对该服务的呼叫者。
`static String`	`SECURITY_PROTOCOL` 用于指定要使用的安全协议的环境属性的名称的常量。
`static String`	`STATE_FACTORIES` 用于指定要使用的状态工厂列表的环境属性的名称的常量。
`static String`	`URL_PKG_PREFIXES` 持有环境属性名称的常量，用于指定在URL上下文工厂中加载时使用的包前缀列表。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`Object`	`addToEnvironment(String propName, Object propVal)` 在此上下文的环境中添加一个新的环境属性。
`void`	`bind(Name name, Object obj)` 将名称绑定到对象。
`void`	`bind(String name, Object obj)` 将名称绑定到对象。
`void`	`close()` 关闭这个上下文。
`Name`	`composeName(Name name, Name prefix)` 使用相对于该上下文的名称组合此上下文的名称。
`String`	`composeName(String name, String prefix)` 使用相对于该上下文的名称组合此上下文的名称。
`Context`	`createSubcontext(Name name)` 创建并绑定新的上下文。
`Context`	`createSubcontext(String name)` 创建并绑定新的上下文。
`void`	`destroySubcontext(Name name)` 销毁命名上下文并将其从命名空间中删除。
`void`	`destroySubcontext(String name)` 销毁命名上下文并将其从命名空间中删除。
`Hashtable<?,?>`	`getEnvironment()` 检索此环境有效的环境。
`String`	`getNameInNamespace()` 在其自己的命名空间中检索此上下文的全名。
`NameParser`	`getNameParser(Name name)` 检索与命名上下文关联的解析器。
`NameParser`	`getNameParser(String name)` 检索与命名上下文关联的解析器。
`NamingEnumeration<NameClassPair>`	`list(Name name)` 枚举在命名上下文中绑定的名称以及绑定到它们的对象的类名。
`NamingEnumeration<NameClassPair>`	`list(String name)` 枚举在命名上下文中绑定的名称以及绑定到它们的对象的类名。
`NamingEnumeration<Binding>`	`listBindings(Name name)` 枚举在命名上下文中绑定的名称以及绑定到它们的对象。
`NamingEnumeration<Binding>`	`listBindings(String name)` 枚举在命名上下文中绑定的名称以及绑定到它们的对象。
`Object`	`lookup(Name name)` 检索命名对象。
`Object`	`lookup(String name)` 检索命名对象。
`Object`	`lookupLink(Name name)` 检索命名对象，除了名称的终端原子组件以外的链接。
`Object`	`lookupLink(String name)` 检索命名对象，除了名称的终端原子组件以外的链接。
`void`	`rebind(Name name, Object obj)` 将名称绑定到对象，覆盖任何现有绑定。
`void`	`rebind(String name, Object obj)` 将名称绑定到对象，覆盖任何现有绑定。
`Object`	`removeFromEnvironment(String propName)` 从环境环境中删除环境属性。
`void`	`rename(Name oldName, Name newName)` 将绑定到旧名称的对象绑定一个新名称，并取消绑定旧名称。
`void`	`rename(String oldName, String newName)` 将绑定到旧名称的对象绑定一个新名称，并取消绑定旧名称。
`void`	`unbind(Name name)` 取消绑定命名对象。
`void`	`unbind(String name)` 取消绑定命名对象。

- 字段详细信息
  - INITIAL_CONTEXT_FACTORY
```
static final String INITIAL_CONTEXT_FACTORY
```
    用于指定要使用的初始上下文工厂的环境属性的名称的常量。属性的值应该是将创建初始上下文的工厂类的完全限定类名。可以在传递给初始上下文构造函数，applet参数，系统属性或应用程序资源文件的环境参数中指定此属性。如果没有在任何这些源中指定 ，则在需要初始上下文以完成操作时抛出NoInitialContextException。
    该常量的值为“java.naming.factory.initial”。
    
    另请参见：
    
    InitialContext ， InitialDirContext ， NamingManager.getInitialContext(java.util.Hashtable<?, ?>) ， InitialContextFactory ， NoInitialContextException ， addToEnvironment(String, Object) ， removeFromEnvironment(String) ， APPLET ， Constant Field Values
  - OBJECT_FACTORIES
```
static final String OBJECT_FACTORIES
```
    用于指定要使用的对象工厂列表的环境属性的名称的常量。属性的值应该是冒号分隔的工厂类完全限定类名的列表，它将创建一个给定关于该对象的信息的对象。该属性可以在环境，小应用程序参数，系统属性或一个或多个资源文件中指定。
    该常量的值为“java.naming.factory.object”。
    
    另请参见：
    
    NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>) ， ObjectFactory ， addToEnvironment(String, Object) ， removeFromEnvironment(String) ， APPLET ， Constant Field Values
  - STATE_FACTORIES
```
static final String STATE_FACTORIES
```
    用于指定要使用的状态工厂列表的环境属性的名称的常量。属性的值应该是冒号分隔的状态工厂类的完全限定类名的列表，用于在给定对象本身的情况下获取对象的状态。该属性可以在环境，小应用程序参数，系统属性或一个或多个资源文件中指定。
    该常量的值为“java.naming.factory.state”。
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    NamingManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>) ， StateFactory ， addToEnvironment(String, Object) ， removeFromEnvironment(String) ， APPLET ， Constant Field Values
  - URL_PKG_PREFIXES
```
static final String URL_PKG_PREFIXES
```
    持有环境属性名称的常量，用于指定在URL上下文工厂中加载时使用的包前缀列表。该属性的值应该是一个冒号分隔的包前缀列表，用于创建URL上下文工厂的工厂类的类名称。该属性可以在环境，小应用程序参数，系统属性或一个或多个资源文件中指定。前缀com.sun.jndi.url始终附加到可能空的包前缀列表。
    该常量的值为“java.naming.factory.url.pkgs”。
    
    另请参见：
    
    NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>) ， NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>) ， ObjectFactory ， addToEnvironment(String, Object) ， removeFromEnvironment(String) ， APPLET ， Constant Field Values
  - PROVIDER_URL
```
static final String PROVIDER_URL
```
    包含用于指定服务提供商要使用的配置信息的环境属性的名称的常量。该属性的值应该包含一个URL字符串（例如“ldap：// somehost：389”）。该属性可以在环境，小程序参数，系统属性或资源文件中指定。如果没有在任何这些来源中指定，默认配置由服务提供商决定。
    该常量的值为“java.naming.provider.url”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， APPLET ， Constant Field Values
  - DNS_URL
```
static final String DNS_URL
```
    持有用于指定用于JNDI URL上下文的DNS主机和域名的环境属性的名称的常量（例如“dns：//somehost/wiz.com”）。该属性可以在环境，小程序参数，系统属性或资源文件中指定。如果在任何这些源中未指定，并且程序尝试使用包含DNS名称的JNDI URL，则将抛出ConfigurationException 。
    该常量的值为“java.naming.dns.url”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - AUTHORITATIVE
```
static final String AUTHORITATIVE
```
    用于指定所请求的服务的权威性的环境属性的名称的常量。如果属性的值为字符串“true”，则意味着访问权限是最权威的来源（即绕过任何缓存或副本）。如果这个值是其他的，那么源代码不一定是（但可能是）权威的。如果未指定，则该值默认为“false”。
    该常量的值为“java.naming.authoritative”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - BATCHSIZE
```
static final String BATCHSIZE
```
    包含用于指定通过服务协议返回数据时使用的批量大小的环境属性名称的常量。这是提供者以指定大小的批次返回操作结果的提示，因此提供程序可以优化其性能和资源的使用。属性的值是整数的字符串表示形式。如果未指定，则批量大小由服务提供商确定。
    该常量的值为“java.naming.batchsize”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - REFERRAL
```
static final String REFERRAL
```
    持有用于指定如何处理服务提供商遇到的引用的环境属性的名称的常量。该属性的值是以下字符串之一：
    
    “跟随”
    
    自动跟随推荐
    
    “忽视”
    
    忽略引荐
    
    “扔”
    
    抛出ReferralException当遇到引荐时。
    
    如果未指定此属性，则默认值由提供者确定。
    该常量的值为“java.naming.referral”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - SECURITY_PROTOCOL
```
static final String SECURITY_PROTOCOL
```
    用于指定要使用的安全协议的环境属性的名称的常量。它的值是由服务提供商确定的字符串（例如“ssl”）。如果此属性未指定，则行为由服务提供商确定。
    该常量的值为“java.naming.security.protocol”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - SECURITY_AUTHENTICATION
```
static final String SECURITY_AUTHENTICATION
```
    持有用于指定要使用的安全级别的环境属性的名称的常量。它的值是以下字符串之一：“无”，“简单”，“强”。如果此属性未指定，则行为由服务提供商确定。
    该常量的值为“java.naming.security.authentication”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - SECURITY_PRINCIPAL
```
static final String SECURITY_PRINCIPAL
```
    持有用于指定主体的身份的环境属性的常量，用于验证对该服务的呼叫者。主体的格式取决于认证方案。如果此属性未指定，则行为由服务提供商确定。
    该常量的值为“java.naming.security.principal”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - SECURITY_CREDENTIALS
```
static final String SECURITY_CREDENTIALS
```
    包含用于指定用于验证呼叫者到服务的主体的凭据的环境属性的名称的常量。属性的值取决于认证方案。例如，它可以是散列密码，明文密码，密钥，证书等。如果此属性未指定，则行为由服务提供商确定。
    该常量的值为“java.naming.security.credentials”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - LANGUAGE
```
static final String LANGUAGE
```
    包含用于指定与服务一起使用的首选语言的环境属性名称的常量。该属性的值是按照RFC 1766中定义的冒号分隔的语言标签列表。如果此属性未指定，则语言首选项由服务提供者确定。
    该常量的值为“java.naming.language”。
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， Constant Field Values
  - APPLET
```
static final String APPLET
```
    包含指定用于搜索其他属性时要使用的初始上下文构造函数的小程序的环境属性的常量的常量。该属性的值是正在执行的java.applet.Applet实例。可以在传递给初始上下文构造函数的环境参数中指定此属性。设置此属性时，首先在applet的参数列表中查找初始上下文构造函数在系统属性中查找的每个属性。如果此属性未指定，则初始上下文构造函数将仅在传递给它的环境参数，系统属性和应用程序资源文件中搜索属性。
    该常量的值为“java.naming.applet”。
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String) ， InitialContext ， Constant Field Values
- 方法详细信息
  - lookup
```
Object lookup(Name name)
       throws NamingException
```
    检索命名对象。如果name为空，则返回此上下文的新实例（其表示与该上下文相同的命名上下文，但其环境可以独立修改，并且可能被并发访问）。
    
    参数
    
    name - 要查找的对象的名称
    
    结果
    
    对象绑定到 name
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    lookup(String) ， lookupLink(Name)
  - lookup
```
Object lookup(String name)
       throws NamingException
```
    检索命名对象。详见lookup(Name) 。
    
    参数
    
    name - 要查找的对象的名称
    
    结果
    
    对象绑定到 name
    
    异常
    
    NamingException - 如果遇到命名异常
  - bind
```
void bind(Name name,
          Object obj)
   throws NamingException
```
    将名称绑定到对象。所有中间上下文和目标上下文（由名称的所有终端原子组件命名）必须已经存在。
    
    参数
    
    name - 要绑定的名称可能不是空的
    
    obj - 要绑定的对象; 可能为null
    
    异常
    
    NameAlreadyBoundException - 如果名称已经绑定
    
    InvalidAttributesException - 如果对象没有提供所有必需属性
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    bind(String, Object) ， rebind(Name, Object) ， DirContext.bind(Name, Object, javax.naming.directory.Attributes)
  - bind
```
void bind(String name,
          Object obj)
   throws NamingException
```
    将名称绑定到对象。详见bind(Name, Object) 。
    
    参数
    
    name - 要绑定的名称可能不是空的
    
    obj - 要绑定的对象; 可能为null
    
    异常
    
    NameAlreadyBoundException - 如果名称已经绑定
    
    InvalidAttributesException - 如果对象没有提供所有必需属性
    
    NamingException - 如果遇到命名异常
  - rebind
```
void rebind(Name name,
            Object obj)
     throws NamingException
```
    将名称绑定到对象，覆盖任何现有绑定。所有中间上下文和目标上下文（由名称的所有终端原子组件命名）必须已经存在。
    如果对象是DirContext ，与该名称关联的任何现有属性将替换为对象的属性。否则，与名称关联的任何现有属性都保持不变。
    
    参数
    
    name - 要绑定的名称可能不是空的
    
    obj - 要绑定的对象; 可能为null
    
    异常
    
    InvalidAttributesException - 如果对象没有提供所有必需属性
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    rebind(String, Object) ， bind(Name, Object) ， DirContext.rebind(Name, Object, javax.naming.directory.Attributes) ， DirContext
  - rebind
```
void rebind(String name,
            Object obj)
     throws NamingException
```
    将名称绑定到对象，覆盖任何现有绑定。详见rebind(Name, Object) 。
    
    参数
    
    name - 要绑定的名称可能不是空的
    
    obj - 要绑定的对象; 可能为null
    
    异常
    
    InvalidAttributesException - 如果对象没有提供所有必需属性
    
    NamingException - 如果遇到命名异常
  - unbind
```
void unbind(Name name)
     throws NamingException
```
    取消绑定命名对象。从目标上下文中删除name中的终端原子名称 - 由name的末端原子部分name 。
    这种方法是幂等的。即使终端原子名称未绑定在目标上下文中，也可以成功，但如果任何中间上下文不存在，则抛出NameNotFoundException 。
    
    与名称相关联的任何属性都将被删除。中间上下文不变。
    
    参数
    
    name - 取消绑定的名称可能不是空的
    
    异常
    
    NameNotFoundException - 如果中间上下文不存在
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    unbind(String)
  - unbind
```
void unbind(String name)
     throws NamingException
```
    取消绑定命名对象。详见unbind(Name) 。
    
    参数
    
    name - 取消绑定的名称可能不是空的
    
    异常
    
    NameNotFoundException - 如果中间上下文不存在
    
    NamingException - 如果遇到命名异常
  - rename
```
void rename(Name oldName,
            Name newName)
     throws NamingException
```
    将绑定到旧名称的对象绑定一个新名称，并取消绑定旧名称。这两个名称都是相对于这个上下文。与旧名称相关联的任何属性都将与新名称相关联。旧名称的中间上下文不会更改。
    
    参数
    
    oldName - 现有绑定的名称; 可能不是空的
    
    newName - 新绑定的名称; 可能不是空的
    
    异常
    
    NameAlreadyBoundException - 如果 newName已经绑定
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    rename(String, String) ， bind(Name, Object) ， rebind(Name, Object)
  - rename
```
void rename(String oldName,
            String newName)
     throws NamingException
```
    将绑定到旧名称的对象绑定一个新名称，并取消绑定旧名称。详见rename(Name, Name) 。
    
    参数
    
    oldName - 现有绑定的名称; 可能不是空的
    
    newName - 新绑定的名称; 可能不是空的
    
    异常
    
    NameAlreadyBoundException - 如果 newName已经绑定
    
    NamingException - 如果遇到命名异常
  - list
```
NamingEnumeration<NameClassPair> list(Name name)
                               throws NamingException
```
    枚举在命名上下文中绑定的名称以及绑定到它们的对象的类名。不包括任何subcontexts的内容。
    如果将绑定添加到此上下文或从此上下文中删除，则其对先前返回的枚举的影响是未定义的。
    
    参数
    
    name - 要列出的上下文的名称
    
    结果
    
    在此上下文中枚举绑定的名称和类名称。枚举的每个元素都是类型NameClassPair 。
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    list(String) ， listBindings(Name) ， NameClassPair
  - list
```
NamingEnumeration<NameClassPair> list(String name)
                               throws NamingException
```
    枚举在命名上下文中绑定的名称以及绑定到它们的对象的类名。详见list(Name) 。
    
    参数
    
    name - 要列出的上下文的名称
    
    结果
    
    在此上下文中枚举绑定的名称和类名称。枚举的每个元素都是类型NameClassPair 。
    
    异常
    
    NamingException - 如果遇到命名异常
  - listBindings
```
NamingEnumeration<Binding> listBindings(Name name)
                                 throws NamingException
```
    枚举在命名上下文中绑定的名称以及绑定到它们的对象。不包括任何subcontexts的内容。
    如果将绑定添加到此上下文或从此上下文中删除，则其对先前返回的枚举的影响是未定义的。
    
    参数
    
    name - 要列出的上下文的名称
    
    结果
    
    在这个上下文中绑定的枚举。枚举的每个元素都是类型Binding 。
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    listBindings(String) ， list(Name) ， Binding
  - listBindings
```
NamingEnumeration<Binding> listBindings(String name)
                                 throws NamingException
```
    枚举在命名上下文中绑定的名称以及绑定到它们的对象。详见listBindings(Name) 。
    
    参数
    
    name - 要列出的上下文的名称
    
    结果
    
    在这个上下文中绑定的枚举。枚举的每个元素都是类型Binding 。
    
    异常
    
    NamingException - 如果遇到命名异常
  - destroySubcontext
```
void destroySubcontext(Name name)
                throws NamingException
```
    销毁命名上下文并将其从命名空间中删除。与名称相关联的任何属性也将被删除。中间语境不会被破坏。
    这种方法是幂等的。即使终端原子名称未绑定在目标上下文中，也可以成功，但如果任何中间上下文不存在，则抛出NameNotFoundException 。
    
    在联合命名系统中，来自一个命名系统的上下文可能绑定到另一个命名系统中的名称。随后可以使用复合名称查找并执行对外部上下文的操作。然而，企图破坏使用此复合名称将失败，并NotContextException的情况下，因为外部上下文不是在它所在的上下文的“子上下文”。相反，请使用unbind()删除外部上下文的绑定。销毁外部上下文要求destroySubcontext()被从外部上下文的“本机”命名系统的上下文进行。
    
    参数
    
    name - 要销毁的上下文的名称; 可能不是空的
    
    异常
    
    NameNotFoundException - 如果中间上下文不存在
    
    NotContextException - 如果名称是绑定的，但不指定上下文，或者不指定适当类型的上下文
    
    ContextNotEmptyException - 如果命名上下文不为空
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    destroySubcontext(String)
  - destroySubcontext
```
void destroySubcontext(String name)
                throws NamingException
```
    销毁命名上下文并将其从命名空间中删除。详见destroySubcontext(Name) 。
    
    参数
    
    name - 要销毁的上下文的名称; 可能不是空的
    
    异常
    
    NameNotFoundException - 如果中间上下文不存在
    
    NotContextException - 如果名称是绑定的，但没有命名上下文，或者不指定适当类型的上下文
    
    ContextNotEmptyException - 如果命名上下文不为空
    
    NamingException - 如果遇到命名异常
  - createSubcontext
```
Context createSubcontext(Name name)
                  throws NamingException
```
    创建并绑定新的上下文。使用给定的名称创建一个新的上下文，并将其绑定到目标上下文中（由名称的所有端子原子组件命名）。所有中间上下文和目标上下文必须已经存在。
    
    参数
    
    name - 要创建的上下文的名称; 可能不是空的
    
    结果
    
    新创建的上下文
    
    异常
    
    NameAlreadyBoundException - 如果名称已经绑定
    
    InvalidAttributesException - 如果创建子上网需要规定强制属性
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    createSubcontext(String) ， DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)
  - createSubcontext
```
Context createSubcontext(String name)
                  throws NamingException
```
    创建并绑定新的上下文。详见createSubcontext(Name) 。
    
    参数
    
    name - 要创建的上下文的名称; 可能不是空的
    
    结果
    
    新创建的上下文
    
    异常
    
    NameAlreadyBoundException - 如果名称已经绑定
    
    InvalidAttributesException - 如果 InvalidAttributesException创建需要规定强制属性
    
    NamingException - 如果遇到命名异常
  - lookupLink
```
Object lookupLink(Name name)
           throws NamingException
```
    检索命名对象，除了名称的终端原子组件以外的链接。如果绑定到name的对象不是链接，则返回对象本身。
    
    参数
    
    name - 要查找的对象的名称
    
    结果
    
    对象绑定到 name ，不跟随终端链接（如果有的话）。
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    lookupLink(String)
  - lookupLink
```
Object lookupLink(String name)
           throws NamingException
```
    检索命名对象，除了名称的终端原子组件以外的链接。详见lookupLink(Name) 。
    
    参数
    
    name - 要查找的对象的名称
    
    结果
    
    对象绑定到 name ，不跟随终端链接（如果有的话）
    
    异常
    
    NamingException - 如果遇到命名异常
  - getNameParser
```
NameParser getNameParser(Name name)
                  throws NamingException
```
    检索与命名上下文关联的解析器。在命名空间联盟中，不同的命名系统会以不同的方式解析名称。该方法允许应用程序使用特定命名系统的命名约定来获取解析器将其解析为其原子组件的名称。在任何单个命名系统中，此方法返回的NameParser对象必须相等（使用equals()测试）。
    
    参数
    
    name - 从中获取解析器的上下文的名称
    
    结果
    
    一个名称解析器，可以将复合名称解析为其原子组件
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    getNameParser(String) ， CompoundName
  - getNameParser
```
NameParser getNameParser(String name)
                  throws NamingException
```
    检索与命名上下文关联的解析器。详见getNameParser(Name) 。
    
    参数
    
    name - 从中获取解析器的上下文的名称
    
    结果
    
    一个名称解析器，可以将复合名称解析为其原子组件
    
    异常
    
    NamingException - 如果遇到命名异常
  - composeName
```
Name composeName(Name name,
                 Name prefix)
          throws NamingException
```
    使用相对于该上下文的名称组合此上下文的名称。命名（ name ）相对于此上下文，和名称（ prefix这相对于它的一个祖先上下文），则此方法返回使用适合于所涉及的命名系统（S）的语法的两个名字的组成。也就是说，如果name命名相对于该上下文的对象，则结果是相同对象的名称，但相对于祖先上下文。没有一个名字可能为空。
    例如，如果这个上下文相对于初始上下文命名为“wiz.com”，那么
```
  composeName("east", "wiz.com") 
```
    可能会返回"east.wiz.com" 。如果这个上下文被命名为“org / research”，那么
```
  composeName("user/jane", "org/research") 
```
    可能会返回"org/research/user/jane"
```
  composeName("user/jane", "research") 
```
    返回"research/user/jane" 。
    参数
    
    name - 相对于此上下文的名称
    
    prefix - 此上下文相对于其祖先之一的名称
    
    结果
    
    组成 prefix和 name
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    composeName(String, String)
  - composeName
```
String composeName(String name,
                   String prefix)
            throws NamingException
```
    使用相对于该上下文的名称组合此上下文的名称。详见composeName(Name, Name) 。
    
    参数
    
    name - 相对于此上下文的名称
    
    prefix - 此上下文相对于其祖先之一的名称
    
    结果
    
    prefix和 name
    
    异常
    
    NamingException - 如果遇到命名异常
  - addToEnvironment
```
Object addToEnvironment(String propName,
                        Object propVal)
                 throws NamingException
```
    在此上下文的环境中添加一个新的环境属性。如果属性已经存在，其值将被覆盖。有关环境属性的更多详细信息，请参阅类描述。
    
    参数
    
    propName - 要添加的环境属性的名称; 可能不为空
    
    propVal - 要添加的属性的值; 可能不为空
    
    结果
    
    该属性的前一个值，如果该属性不在之前的环境中，则返回null
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    getEnvironment() ， removeFromEnvironment(String)
  - removeFromEnvironment
```
Object removeFromEnvironment(String propName)
                      throws NamingException
```
    从环境环境中删除环境属性。有关环境属性的更多详细信息，请参阅类描述。
    
    参数
    
    propName - 要删除的环境属性的名称; 可能不为空
    
    结果
    
    属性的先前值，如果属性不在环境中，则为null
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    getEnvironment() ， addToEnvironment(String, Object)
  - getEnvironment
```
Hashtable<?,?> getEnvironment()
                       throws NamingException
```
    检索此环境有效的环境。有关环境属性的更多详细信息，请参阅类描述。
    调用者不应该对返回的对象进行任何更改：它们对上下文的影响是未定义的。可以使用addToEnvironment()和removeFromEnvironment()更改此上下文的环境。
    
    结果
    
    这个环境的环境; 从不为空
    
    异常
    
    NamingException - 如果遇到命名异常
    
    另请参见：
    
    addToEnvironment(String, Object) ， removeFromEnvironment(String)
  - close
```
void close()
    throws NamingException
```
    关闭这个上下文。此方法可以立即释放上下文的资源，而不是等待垃圾回收器自动释放该资源。
    该方法是幂等的：在已经关闭的上下文中调用它没有任何效果。不允许在封闭上下文中调用任何其他方法，并导致未定义的行为。
    
    异常
    
    NamingException - 如果遇到命名异常
  - getNameInNamespace
```
String getNameInNamespace()
                   throws NamingException
```
    在其自己的命名空间中检索此上下文的全名。
    许多命名服务对于各自的命名空间中的对象都有一个“全名”概念。例如，LDAP条目具有可分辨名称，DNS记录具有完全限定名称。此方法允许客户端应用程序检索此名称。此方法返回的字符串不是JNDI组合名称，不应直接传递给上下文方法。在命名系统中，全名概念没有意义， OperationNotSupportedException被抛出。
    
    结果
    
    这个上下文的名称在自己的命名空间中; 从不为空
    
    异常
    
    OperationNotSupportedException - 如果命名系统没有全名的概念
    
    NamingException - 如果遇到命名异常
    
    从以下版本开始：
    
    1.3

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface Context

名字

例外

并发访问

参数

环境属性

资源文件

提供者资源文件

应用资源文件

搜索算法的属性

Field Summary

方法摘要

字段详细信息

INITIAL_CONTEXT_FACTORY

OBJECT_FACTORIES

STATE_FACTORIES

URL_PKG_PREFIXES

PROVIDER_URL

DNS_URL

AUTHORITATIVE

BATCHSIZE

REFERRAL

SECURITY_PROTOCOL

SECURITY_AUTHENTICATION

SECURITY_PRINCIPAL

SECURITY_CREDENTIALS

LANGUAGE

APPLET

方法详细信息

lookup

lookup

bind

bind

rebind

rebind

unbind

unbind

rename

rename

list

list

listBindings

listBindings

destroySubcontext

destroySubcontext

createSubcontext

createSubcontext

lookupLink

lookupLink

getNameParser

getNameParser

composeName

composeName

addToEnvironment

removeFromEnvironment

getEnvironment

close

getNameInNamespace