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之前，所有的参数被视为复合名字的名字。

此外，系统支持联邦，所有名字返回从list()和listBindings()一NamingEnumeration复合名称表示为字符串。看名字的字符串的语法CompositeName。

对于那些不支持联邦系统，命名参数（无论Name或String形式）和名在NamingEnumeration可能在自己的命名空间名称，而不是在一个复合的命名空间名称，服务提供者的自由裁量权。

例外
所有的方法在这个界面可以把 NamingException或其任何子类。看到 NamingException及其各子类异常的细节。
并发访问
上下文实例不能保证同步对多线程并发访问。需要访问一个单独的上下文实例的线程应该同步，并提供必要的锁。每个操作一个不同的上下文实例的多个线程不需要同步。请注意， lookup方法，当通过一个空名，将返回一个新的上下文实例表示相同的命名上下文。
对并发控制的目的，一方面操作，返回一个NamingEnumeration不认为已经完成，枚举是仍在使用，或在任何的操作仍然是产生转介。

参数
一 Name参数传递到任何方法的 Context接口或它的一个子不会由服务提供者修改。服务提供程序可以为操作的持续时间保留一个引用，包括对方法的结果的任何枚举和任何生成的转介的处理。调用方不应在此期间修改对象。一个 Name返回任何这样的方法是由调用方拥有。调用方随后可能修改它；服务提供程序可能不修改它。
环境性能

JNDI的应用需要的沟通方式不同的偏好和属性定义的环境中，命名和目录服务的访问。例如，一个上下文可能需要安全凭据的规范，以访问服务。另一个上下文可能需要提供服务器配置信息。这些被称为一个上下文的环境。的Context接口提供检索和更新这个环境的方法。

环境是从父上下文继承的，因为上下文方法从一个上下文到下一个。一个上下文的环境的变化不直接影响到其他上下文。

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

任何上下文的引用的任何对象都可以检查上下文的环境。敏感信息，如明文密码不应被存储在那里，除非执行是已知的，以保护它。

资源文件

为了简化设置通过JNDI的应用所需的环境的任务，应用程序组件和服务提供商可能会随着资源文件的分布。JNDI资源文件的属性文件格式的文件（见java.util.Properties），包含一个键/值对列表。关键是属性的名称（如“java。命名。工厂对象”）和价值是在属性定义的格式字符串。这里是一个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
，前缀是供应商的背景下实施的包的名称（S），每一期（“。”）转换为一个斜杠（“/”）。例如，假设一个服务提供者定义上下文实现的类的名称 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的图书馆咨询供应商资源文件确定这些属性的值时。除了这些属性以外的属性可以在服务提供商的自由裁量权中设置提供程序资源文件中的属性。服务提供商的文档应该清楚地说明哪些属性是被允许的；文件中的其他属性将被忽略。
应用资源文件
部署应用程序时，它通常会在类路径中有几个代码目录和罐。同样，当一个程序被部署，它会有一个代码库和档案指定在哪里可以找到应用程序的类。JNDI定位（使用 ClassLoader.getResources()）所有应用程序资源文件命名 jndi.properties在类路径。此外，如果文件java.home /lib/jndi.properties存在并且是可读的，是把它作为一个额外的应用程序的资源文件。（java.home表示目录的 java.home系统性能。命名）所有属性包含在这些文件放置到初始上下文环境。这种环境是继承的其他情况下。当
对于每个属性出现在多个应用程序的资源文件，JNDI使用第一价值发现，在少数情况下，这样做是有意义的，它将所有的值（详见下文）。例如，如果“java。命名。工厂对象”的财产在三jndi.properties资源文件发现，对象工厂名单是从所有三个文件的连接属性值。使用这个方案，每个部署组件是负责列出它的出口的工厂。JNDI的自动收集和使用这些出口商品目录搜索时，工厂类。

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

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

一点三

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 /奇才。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)` 其他命名对象。

- Field Detail
  - INITIAL_CONTEXT_FACTORY
```
static final String INITIAL_CONTEXT_FACTORY
```
    保持指定初始上下文工厂使用的环境属性的名称的常量。属性的值应该是将创建一个初始上下文的工厂类的完全限定的类名称。此属性可以在传递给初始上下文构造函数的环境参数中指定，一个小程序参数，一个系统属性或一个应用程序资源文件。如果它不在任何这些来源的规定， NoInitialContextException时引发初始上下文要求完成操作。
    该常数的值是“java。命名。工厂。最初的“。
    
    另请参见：
    
    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。命名。工厂的对象。”。
    
    另请参见：
    
    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。命名。工厂。”。
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    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。命名。工厂。URL。中心”。
    
    另请参见：
    
    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。命名。供应商。网址”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， APPLET， Constant Field Values
  - DNS_URL
```
static final String DNS_URL
```
    常数，用于指定要使用的JNDI URL中的DNS主机和域名持有环境属性的名称（例如，“DNS：/ / somehost /奇才。com”）。此属性可以在环境中指定，一个小程序参数，一个系统属性，或一个资源文件。如果它不在任何这些来源和程序试图使用一个包含DNS名称JNDI指定URL，一个 ConfigurationException将抛出。
    该常数的值是“java。命名。DNS。网址”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - AUTHORITATIVE
```
static final String AUTHORITATIVE
```
    常数，用于指定服务的权威性是环境属性的名称要求。如果属性的值是字符串“真”，则意味着访问是最权威的源代码（即绕过任何缓存或副本）。如果这个值是别的东西，源不必是（但可能是）权威。如果未指定，默认值为“假”。
    该常数的值是“java。命名。权威”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - BATCHSIZE
```
static final String BATCHSIZE
```
    保持属性的名称，用于指定通过服务协议返回数据时使用的批处理大小的名称。这是一个提示，以返回指定大小的批处理的操作结果，因此提供程序可以优化其性能和资源使用情况。属性的值是整数的字符串表示形式。如果未指定，则由服务提供程序确定批处理大小。
    该常数的值是“java BATCHSIZE。命名。”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - REFERRAL
```
static final String REFERRAL
```
    保持指定服务提供程序如何处理的环境属性的名称的常量。该属性的值是一个字符串
    
    “跟随”
    
    按照推荐的自动
    
    “忽略”
    
    不推荐
    
    “扔”
    
    把 ReferralException当转诊时。
    
    如下：如果不指定此属性，默认值是由供应商来确定。
    该常数的值是“java。命名。推荐”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - SECURITY_PROTOCOL
```
static final String SECURITY_PROTOCOL
```
    保持用于指定要使用的安全协议的环境属性的名称的常数。它的价值是由服务提供商一个字符串（例如“SSL”）。如果此属性是未指定的，则该行为由服务提供程序确定。
    该常数的值是“java。命名。安全。协议”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - SECURITY_AUTHENTICATION
```
static final String SECURITY_AUTHENTICATION
```
    保持用于指定要使用的安全级别的环境属性的名称的常量。它的值是下列字符串之一：“没有”，“简单”，“强”。如果此属性是未指定的，则该行为由服务提供程序确定。
    该常数的值是“java。命名。安全认证”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - SECURITY_PRINCIPAL
```
static final String SECURITY_PRINCIPAL
```
    常数，为服务验证调用者指定委托人的身份持有的环境属性的名称。委托人的格式取决于认证方案。如果此属性是未指定的，则该行为由服务提供程序确定。
    该常数的值是“java。命名。安全。主”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - SECURITY_CREDENTIALS
```
static final String SECURITY_CREDENTIALS
```
    常数，用于向服务验证对方的主要凭据保存环境属性的名称。属性的值取决于身份验证方案。例如，它可能是一个密码，密码的明文，密钥，证书，等等。如果此属性是未指定的，则该行为由服务提供程序确定。
    该常数的值是“java。命名。安全。凭据”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - LANGUAGE
```
static final String LANGUAGE
```
    保持环境属性的名称的常量，用于指定服务使用的首选语言。该属性的值是一个冒号分隔的语言标签RFC 1766中定义的列表。如果这个属性是未指定的，语言偏好由服务提供商确定。
    该常数的值是“java语言。命名。”。
    
    另请参见：
    
    addToEnvironment(String, Object)， removeFromEnvironment(String)， Constant Field Values
  - APPLET
```
static final String APPLET
```
    保持用于指定初始上下文构造函数的名称的环境属性的名称，用于在搜索其他属性时使用的程序属性。此属性的值是 java.applet.Applet实例被执行。此属性可以在传递给初始上下文构造函数的环境参数中指定。当这个属性被设置时，初始上下文构造函数在系统属性中查找的每个属性首先在小程序的参数列表中查找。如果这个属性是未指定的，初始上下文构造函数将只在传递给它的环境参数中搜索属性，系统属性和应用程序资源文件。
    该常数的值是“java applet。命名。”。
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    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 -绑定的对象可能是空的；
    
    异常
    
    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 -绑定的对象可能是空的；
    
    异常
    
    NameAlreadyBoundException如果名字已绑定
    
    InvalidAttributesException如果对象没有提供所有必需的属性
    
    NamingException -如果遇到一个命名的例外
  - rebind
```
void rebind(Name name,
            Object obj)
     throws NamingException
```
    绑定一个名字对象，覆盖任何现有的结合。所有的中间上下文和目标上下文（被命名的所有，但终端原子组件的名称）必须已经存在。
    如果对象是一个DirContext，任何现有的属性相关的名称与对象替换。否则，任何与名称相关联的现有属性保持不变。
    
    参数
    
    name -绑定的名称；不能为空
    
    obj -绑定的对象可能是空的；
    
    异常
    
    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 -绑定的对象可能是空的；
    
    异常
    
    InvalidAttributesException如果对象没有提供所有必需的属性
    
    NamingException -如果遇到一个命名的例外
  - unbind
```
void unbind(Name name)
     throws NamingException
```
    其他命名对象。删除终端原子的名字从目标上下文 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 -新的绑定名称不能为空；
    
    异常
    
    如果 newName NameAlreadyBoundException已绑定
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    rename(String, String)， bind(Name, Object)， rebind(Name, Object)
  - rename
```
void rename(String oldName,
            String newName)
     throws NamingException
```
    绑定了一个新的名字对象绑定到一个古老的名字，和其他老字号。看到 rename(Name, Name)详情。
    
    参数
    
    oldName -现有绑定的名称不能为空；
    
    newName -新的绑定名称不能为空；
    
    异常
    
    如果 newName NameAlreadyBoundException已绑定
    
    NamingException -如果遇到一个命名的例外
  - list
```
NamingEnumeration<NameClassPair> list(Name name)
                               throws NamingException
```
    枚举名称绑定在指定的背景下，随着束缚他们的对象的类的名称。任何子上下文的内容不包括。
    如果一个绑定被添加到或从这个上下文中删除，它对以前返回的枚举的效果是不确定的。
    
    参数
    
    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
```
    枚举名称绑定在指定的背景下，随着对象绑定到他们。任何子上下文的内容不包括。
    如果一个绑定被添加到或从这个上下文中删除，它对以前返回的枚举的效果是不确定的。
    
    参数
    
    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如果的形式创作需要强制属性规范
    
    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名字对象相对于这样的背景下，其结果是对同一对象的名称，但相对于祖先背景。没有名字可能是空的。
    例如，如果这种情况下被称为“天才。com”相对于初始上下文，然后
```
composename（“东”、“天才。com”）
```
    可能返回 "east.wiz.com"。如果不是这方面的“组织研究”，然后
```
composename（“用户/简”、“组织/研究”）
```
    可能返回 "org/research/user/jane"而
```
composename（“用户/简”，“研究”）
```
    返回 "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 -属性加值；不得空
    
    结果
    
    属性的前值，或无效，如果属性不在环境中之前
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    getEnvironment()， removeFromEnvironment(String)
  - removeFromEnvironment
```
Object removeFromEnvironment(String propName)
                      throws NamingException
```
    从这个上下文的环境中移除环境属性。有关环境属性的详细信息，请参见类描述。
    
    参数
    
    propName -去除环境属性的名称；不得空
    
    结果
    
    属性的前一个值，或无效，如果属性不在环境中
    
    异常
    
    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 -如果遇到一个命名的例外
    
    从以下版本开始：
    
    一点三

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

方法摘要

Field Detail

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