InitialContext (Java Platform SE 8 )

java.lang.Object
- javax.naming.InitialContext

All Implemented Interfaces:

Context

已知直接子类：

InitialDirContext
```
public class InitialContext
extends Object
implements Context
```
此类是执行命名操作的起始上下文。
所有的命名操作都是相对于上下文的。初始上下文实现了上下文接口，并提供了用于解析名称的起始点。

当初始语境构建，其环境与传递给构造函数的参数初始化环境定义的属性，在任何application resource files。此外，少数标准JNDI属性可以被指定为系统性能或applet参数（通过Context.APPLET使用）。这些特殊的性质，在Context和LdapContext接口文档的字段的详细信息部分中列出。

JNDI将从以下两源值确定每个属性的值为：
1. 从构造函数的环境参数和（适当的属性）的属性的第一个发生的小程序参数和系统属性。
2. 应用程序的资源文件（jndi.properties）。
每个物业发现两种源，或在多个应用程序的资源文件，属性值的确定如下。如果属性是一个标准的JNDI属性指定的JNDI工厂（见 Context），所有的值都连接成一个冒号分隔的列表。对于其他属性，只使用找到的第一个值。
在运行时确定初始上下文实现。默认的政策利用环境产权”java.naming.factory.initial”，其中包含了初始上下文工厂类的名称。此策略的一个异常是在解析字符串时作出的，如下面所述。

当一个URL字符串（一个String的形式scheme_id：rest_of_name）是以任何方法名称，参数传递，用于处理方案地用来解决URL上下文工厂。如果没有这样的工厂被发现，由指定的"java.naming.factory.initial"初始上下文使用。同样，当一个CompositeName对象的第一个组件是一个URL字符串作为名称的任何方法的参数传递，URL上下文工厂坐落，用来解决第一名组成。看到一个描述URL上下文工厂位于NamingManager.getURLContext()。

这种定位的初始上下文和URL上下文工厂默认策略可以通过调用NamingManager.setInitialContextFactoryBuilder()重写。

noinitialcontextexception时引发初始上下文不能实例化。这个例外可以抛出InitialContext任何的互动过程中，不仅构造InitialContext后。例如，该初始上下文的实施可能会检索上下文只有当实际的方法调用它。当确定初始上下文的存在时，应用程序不应该有任何依赖关系。

当环境产权”java。命名。工厂。是非零初始”，InitialContext构造函数将尝试创造规定的初始上下文。在那个时候，如果遇到问题，初始上下文工厂可能会抛出一个异常。然而，它是提供者实现依赖时，它验证和指示用户的初始上下文中的任何环境属性或连接相关的问题。它可以懒洋洋地——延缓直到操作的上下文，执行或急切，在当时的背景下构建。

一个InitialContext实例不同步对多线程并发访问。多个线程中的每个操作不同的InitialContext实例不需要同步。线程需要访问一个InitialContext实例同时应同步自己提供必要的锁。
从以下版本开始：

JNDI 1.1 / java 2平台，标准版，V 1.3

另请参见：

Context， NamingManager.setInitialContextFactoryBuilder

Field Summary

Fields
Modifier and Type	Field and Description
`protected Context`	`defaultInitCtx` 田间持namingmanager getinitialcontext()调用的结果。
`protected boolean`	`gotDefault` 现场指示初始上下文被称getinitialcontext() namingmanager获得。
`protected Hashtable<Object,Object>`	`myProps` 与此相关的环境InitialContext。

Fields inherited from interface javax.naming.Context
APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

构造方法摘要

构造方法
Modifier	Constructor and Description
	`InitialContext()` 构建初始上下文。
`protected`	`InitialContext(boolean lazy)` 构造一个不初始化它的期权初始上下文。
	`InitialContext(Hashtable<?,?> environment)` 使用所提供的环境构造初始上下文。

方法摘要

所有方法静态方法接口方法具体的方法
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)` 破坏命名的上下文并从命名空间中移除它。
`static <T> T`	`doLookup(Name name)` 检索已命名对象的静态方法。
`static <T> T`	`doLookup(String name)` 检索已命名对象的静态方法。
`protected Context`	`getDefaultInitCtx()` 获取初始上下文的defaultinitctx调用 `NamingManager.getInitialContext()`和缓存。
`Hashtable<?,?>`	`getEnvironment()` 检索此上下文的效果的环境。
`String`	`getNameInNamespace()` 在它自己的命名空间中检索此上下文的完整名称。
`NameParser`	`getNameParser(Name name)` 检索与命名上下文关联的语法分析器。
`NameParser`	`getNameParser(String name)` 检索与命名上下文关联的语法分析器。
`protected Context`	`getURLOrDefaultInitCtx(Name name)` 为解决 `name`上下文检索。
`protected Context`	`getURLOrDefaultInitCtx(String name)` 检索解决字符串名称 `name`上下文。
`protected void`	`init(Hashtable<?,?> environment)` 初始化初始上下文使用提供的环境。
`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)` 其他命名对象。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - myProps
```
protected Hashtable<Object,Object> myProps
```
    与此相关的环境InitialContext。它被初始化为零，受环境的 init()方法或构造函数的更新。
    
    另请参见：
    
    addToEnvironment(java.lang.String, java.lang.Object)， removeFromEnvironment(java.lang.String)， getEnvironment()
  - defaultInitCtx
```
protected Context defaultInitCtx
```
    田间持namingmanager getinitialcontext()调用的结果。它是由getdefaultinitctx()第一时间getdefaultinitctx()叫做。后续调用的返回值getdefaultinitctx() defaultinitctx。
    
    另请参见：
    
    getDefaultInitCtx()
  - gotDefault
```
protected boolean gotDefault
```
    现场指示初始上下文被称getinitialcontext() namingmanager获得。如果是真的，其结果是 defaultInitCtx。
- Constructor Detail
  - InitialContext
```
protected InitialContext(boolean lazy)
                  throws NamingException
```
    构造一个不初始化它的期权初始上下文。这可以通过在子类的构造函数使用时的环境参数的值是没有当时的 InitialContext构造函数被称为。子类的构造函数会调用此构造函数，计算环境的值，然后调用返回之前 init()。
    
    参数
    
    lazy -真的意味着没有初始化初始上下文；假相当于调用 new InitialContext()
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    init(Hashtable)
  - InitialContext
```
public InitialContext()
               throws NamingException
```
    构建初始上下文。没有提供环境属性。相当于 new InitialContext(null)。
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    InitialContext(Hashtable)
  - InitialContext
```
public InitialContext(Hashtable<?,?> environment)
               throws NamingException
```
    使用所提供的环境构造初始上下文。在类描述中讨论环境属性。
    此构造函数将不会修改environment或保存参考，但可以节省一个克隆。人不应该修改的键和值在environment在它被传递给构造函数。
    
    参数
    
    environment环境用于创建初始上下文。空表示一个空的环境。
    
    异常
    
    NamingException -如果遇到一个命名的例外
- 方法详细信息
  - init
```
protected void init(Hashtable<?,?> environment)
             throws NamingException
```
    初始化初始上下文使用提供的环境。在类描述中讨论环境属性。
    该方法将修改environment并保存一个参考吧。调用方可能不再修改它。
    
    参数
    
    environment环境用于创建初始上下文。空表示一个空的环境。
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    InitialContext(boolean)
  - doLookup
```
public static <T> T doLookup(Name name)
                      throws NamingException
```
    检索已命名对象的静态方法。这是一个快捷的方法相当于调用：
    InitialContext ic = new InitialContext(); Object obj = ic.lookup();
    
    如果name为空，返回这方面的一个新实例（代表相同的命名上下文这个语境，但其环境可以独立修改，可以同时访问）。
    
    参数类型
    
    T -返回对象的类型
    
    参数
    
    name -对象的名字查找
    
    结果
    
    对象绑定到 name
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    doLookup(String)， lookup(Name)
  - doLookup
```
public static <T> T doLookup(String name)
                      throws NamingException
```
    检索已命名对象的静态方法。看到 doLookup(Name)详情。
    
    参数类型
    
    T -返回对象的类型
    
    参数
    
    name -对象的名字查找
    
    结果
    
    对象绑定到 name
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    从以下版本开始：
    
    一点六
  - getDefaultInitCtx
```
protected Context getDefaultInitCtx()
                             throws NamingException
```
    获取初始上下文的defaultinitctx调用 NamingManager.getInitialContext()和缓存。集 gotDefault使我们知道我们已经尝试过。
    
    结果
    
    非空缓存初始上下文。
    
    异常
    
    如果找不到 NoInitialContextException初始上下文。
    
    NamingException -如果遇到一个命名的例外。
  - getURLOrDefaultInitCtx
```
protected Context getURLOrDefaultInitCtx(String name)
                                  throws NamingException
```
    检索解决字符串名称 name上下文。如果 name叫URL字符串，然后试图找到它的URL上下文。如果没有，或者如果 name不是URL字符串，然后返回 getDefaultInitCtx()。
    看到geturlordefaultinitctx（名称）为描述一个类应该使用这种方法。
    
    参数
    
    name -非空名，获得语境。
    
    结果
    
    一个 name或URL缓存初始上下文语境。结果不能为空。
    
    异常
    
    如果找不到 NoInitialContextException初始上下文。
    
    NamingException -在一个命名的例外是遇到。
    
    另请参见：
    
    NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)
  - getURLOrDefaultInitCtx
```
protected Context getURLOrDefaultInitCtx(Name name)
                                  throws NamingException
```
    为解决 name检索上下文。如果 name名称的第一个组件是一个URL字符串，然后试图找到它的URL上下文。如果没有，或者如果 name第一分量不是URL字符串，然后返回 getDefaultInitCtx()。
    创建InitialContext子类时，使用此方法如下。定义一个新的方法，使用此方法得到所需子类的初始上下文。
    protected XXXContext getURLOrDefaultInitXXXCtx(Name name) throws NamingException { Context answer = getURLOrDefaultInitCtx(name); if (!(answer instanceof XXXContext)) { if (answer == null) { throw new NoInitialContextException(); } else { throw new NotContextException("Not an XXXContext"); } } return (XXXContext)answer; }
    当为子类的新方法的实现，使用这个新定义的方法来获取初始上下文。
    public Object XXXMethod1(Name name, ...) { throws NamingException { return getURLOrDefaultInitXXXCtx(name).XXXMethod1(name, ...); }
    参数
    
    name -非空名，获得语境。
    
    结果
    
    一个 name或URL缓存初始上下文语境。结果不能为空。
    
    异常
    
    如果找不到 NoInitialContextException初始上下文。
    
    NamingException -在一个命名的例外是遇到。
    
    另请参见：
    
    NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)
  - lookup
```
public Object lookup(String name)
              throws NamingException
```
    从接口复制的描述： Context
    
    检索已命名的对象。看到 Context.lookup(Name)详情。
    
    Specified by:
    
    lookup 接口 Context
    
    参数
    
    name -对象的名字查找
    
    结果
    
    对象绑定到 name
    
    异常
    
    NamingException -如果遇到一个命名的例外
  - lookup
```
public Object lookup(Name name)
              throws NamingException
```
    从接口复制的描述： Context
    
    检索已命名的对象。如果 name为空，返回这方面的一个新实例（代表相同的命名上下文这个语境，但其环境可以独立修改，可以同时访问）。
    
    Specified by:
    
    lookup 接口 Context
    
    参数
    
    name -对象的名字查找
    
    结果
    
    对象绑定到 name
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.lookup(String)， Context.lookupLink(Name)
  - bind
```
public void bind(String name,
                 Object obj)
          throws NamingException
```
    从接口复制的描述： Context
    
    将一个名称绑定到一个对象。看到 Context.bind(Name, Object)详情。
    
    Specified by:
    
    bind 接口 Context
    
    参数
    
    name -绑定的名称；不能为空
    
    obj -绑定的对象可能是空的；
    
    异常
    
    NameAlreadyBoundException如果名字已绑定
    
    InvalidAttributesException如果对象没有提供所有必需的属性
    
    NamingException -如果遇到一个命名的例外
  - bind
```
public void bind(Name name,
                 Object obj)
          throws NamingException
```
    从接口复制的描述： Context
    
    将一个名称绑定到一个对象。所有的中间上下文和目标上下文（被命名的所有，但终端原子组件的名称）必须已经存在。
    
    Specified by:
    
    bind 接口 Context
    
    参数
    
    name -绑定的名称；不能为空
    
    obj -绑定的对象可能是空的；
    
    异常
    
    NameAlreadyBoundException如果名字已绑定
    
    InvalidAttributesException如果对象没有提供所有必需的属性
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.bind(String, Object)， Context.rebind(Name, Object)， DirContext.bind(Name, Object, javax.naming.directory.Attributes)
  - rebind
```
public void rebind(String name,
                   Object obj)
            throws NamingException
```
    从接口复制的描述： Context
    
    绑定一个名字对象，覆盖任何现有的结合。看到 Context.rebind(Name, Object)详情。
    
    Specified by:
    
    rebind 接口 Context
    
    参数
    
    name -绑定的名称；不能为空
    
    obj -绑定的对象可能是空的；
    
    异常
    
    InvalidAttributesException如果对象没有提供所有必需的属性
    
    NamingException -如果遇到一个命名的例外
  - rebind
```
public void rebind(Name name,
                   Object obj)
            throws NamingException
```
    从接口复制的描述： Context
    
    绑定一个名字对象，覆盖任何现有的结合。所有的中间上下文和目标上下文（被命名的所有，但终端原子组件的名称）必须已经存在。
    如果对象是一个DirContext，任何现有的属性相关的名称与对象替换。否则，任何与名称相关联的现有属性保持不变。
    
    Specified by:
    
    rebind 接口 Context
    
    参数
    
    name -绑定的名称；不能为空
    
    obj -绑定的对象可能是空的；
    
    异常
    
    InvalidAttributesException如果对象没有提供所有必需的属性
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.rebind(String, Object)， Context.bind(Name, Object)， DirContext.rebind(Name, Object, javax.naming.directory.Attributes)， DirContext
  - unbind
```
public void unbind(String name)
            throws NamingException
```
    从接口复制的描述： Context
    
    其他命名对象。看到 Context.unbind(Name)详情。
    
    Specified by:
    
    unbind 接口 Context
    
    参数
    
    name -绑定的名字；不能为空
    
    异常
    
    NameNotFoundException如果中间语境不存在
    
    NamingException -如果遇到一个命名的例外
  - unbind
```
public void unbind(Name name)
            throws NamingException
```
    从接口复制的描述： Context
    
    其他命名对象。删除终端原子的名字从目标上下文 name --所有但 name终端原子部分命名。
    这种方法是幂等。它的成功即使终端原子的名字是不受约束的在目标范围内，但如果把NameNotFoundException任何中间情况不存在。
    
    与名称相关联的任何属性都被删除。中间上下文没有改变。
    
    Specified by:
    
    unbind 接口 Context
    
    参数
    
    name -绑定的名字；不能为空
    
    异常
    
    NameNotFoundException如果中间语境不存在
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.unbind(String)
  - rename
```
public void rename(String oldName,
                   String newName)
            throws NamingException
```
    从接口复制的描述： Context
    
    绑定了一个新的名字对象绑定到一个古老的名字，和其他老字号。看到 Context.rename(Name, Name)详情。
    
    Specified by:
    
    rename 接口 Context
    
    参数
    
    oldName -现有绑定的名称不能为空；
    
    newName -新的绑定名称不能为空；
    
    异常
    
    如果 newName NameAlreadyBoundException已绑定
    
    NamingException -如果遇到一个命名的例外
  - rename
```
public void rename(Name oldName,
                   Name newName)
            throws NamingException
```
    从接口复制的描述： Context
    
    绑定了一个新的名字对象绑定到一个古老的名字，和其他老字号。两个名称都是相对于这个上下文。与旧名称相关联的任何属性都与新名称关联。旧名称的中间上下文没有更改。
    
    Specified by:
    
    rename 接口 Context
    
    参数
    
    oldName -现有绑定的名称不能为空；
    
    newName -新的绑定名称不能为空；
    
    异常
    
    如果 newName NameAlreadyBoundException已绑定
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.rename(String, String)， Context.bind(Name, Object)， Context.rebind(Name, Object)
  - list
```
public NamingEnumeration<NameClassPair> list(String name)
                                      throws NamingException
```
    从接口复制的描述： Context
    
    枚举名称绑定在指定的背景下，随着束缚他们的对象的类的名称。看到 Context.list(Name)详情。
    
    Specified by:
    
    list 接口 Context
    
    参数
    
    name -上下文的名称列表
    
    结果
    
    在此上下文中绑定的名称和类名称的枚举。每个元素的枚举类型是 NameClassPair。
    
    异常
    
    NamingException -如果遇到一个命名的例外
  - list
```
public NamingEnumeration<NameClassPair> list(Name name)
                                      throws NamingException
```
    从接口复制的描述： Context
    
    枚举名称绑定在指定的背景下，随着束缚他们的对象的类的名称。任何子上下文的内容不包括。
    如果一个绑定被添加到或从这个上下文中删除，它对以前返回的枚举的效果是不确定的。
    
    Specified by:
    
    list 接口 Context
    
    参数
    
    name -上下文的名称列表
    
    结果
    
    在此上下文中绑定的名称和类名称的枚举。每个元素的枚举类型是 NameClassPair。
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.list(String)， Context.listBindings(Name)， NameClassPair
  - listBindings
```
public NamingEnumeration<Binding> listBindings(String name)
                                        throws NamingException
```
    从接口复制的描述： Context
    
    枚举名称绑定在指定的背景下，随着对象绑定到他们。看到 Context.listBindings(Name)详情。
    
    Specified by:
    
    listBindings 接口 Context
    
    参数
    
    name -上下文的名称列表
    
    结果
    
    在此上下文中的绑定的枚举。每个元素的枚举类型是 Binding。
    
    异常
    
    NamingException -如果遇到一个命名的例外
  - listBindings
```
public NamingEnumeration<Binding> listBindings(Name name)
                                        throws NamingException
```
    从接口复制的描述： Context
    
    枚举名称绑定在指定的背景下，随着对象绑定到他们。任何子上下文的内容不包括。
    如果一个绑定被添加到或从这个上下文中删除，它对以前返回的枚举的效果是不确定的。
    
    Specified by:
    
    listBindings 接口 Context
    
    参数
    
    name -上下文的名称列表
    
    结果
    
    在此上下文中的绑定的枚举。每个元素的枚举类型是 Binding。
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.listBindings(String)， Context.list(Name)， Binding
  - destroySubcontext
```
public void destroySubcontext(String name)
                       throws NamingException
```
    从接口复制的描述： Context
    
    破坏命名的上下文并从命名空间中移除它。看到 Context.destroySubcontext(Name)详情。
    
    Specified by:
    
    destroySubcontext 接口 Context
    
    参数
    
    name -上下文名称被破坏；不能为空
    
    异常
    
    NameNotFoundException如果中间语境不存在
    
    NotContextException如果名字约束但没有命名上下文，或不适当类型的上下文名称
    
    ContextNotEmptyException如果命名上下文不空
    
    NamingException -如果遇到一个命名的例外
  - destroySubcontext
```
public void destroySubcontext(Name name)
                       throws NamingException
```
    从接口复制的描述： Context
    
    破坏命名的上下文并从命名空间中移除它。与名称相关联的任何属性也被删除。中间上下文不被破坏。
    这种方法是幂等。它的成功即使终端原子的名字是不受约束的在目标范围内，但如果把NameNotFoundException任何中间情况不存在。
    
    在联合命名系统中，从一个命名系统的上下文可以绑定到另一个命名系统的名称。一个可以随后查找并使用复合名称在外国上下文中执行操作。然而，企图破坏的背景下使用该复合名字会失败的NotContextException，因为国外语境不是“形式”的上下文中，它必然。相反，使用unbind()消除外国背景的结合。破坏外，destroySubcontext()上下文进行上下文从外国背景的“本土”的命名系统。
    
    Specified by:
    
    destroySubcontext 接口 Context
    
    参数
    
    name -上下文名称被破坏；不能为空
    
    异常
    
    NameNotFoundException如果中间语境不存在
    
    NotContextException如果名字约束但没有命名上下文，或不适当类型的上下文名称
    
    ContextNotEmptyException如果命名上下文不空
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.destroySubcontext(String)
  - createSubcontext
```
public Context createSubcontext(String name)
                         throws NamingException
```
    从接口复制的描述： Context
    
    创建和绑定一个新的上下文。看到 Context.createSubcontext(Name)详情。
    
    Specified by:
    
    createSubcontext 接口 Context
    
    参数
    
    name -创建上下文的名称不能为空；
    
    结果
    
    新创建的语境
    
    异常
    
    NameAlreadyBoundException如果名字已绑定
    
    InvalidAttributesException如果的形式创作需要强制属性规范
    
    NamingException -如果遇到一个命名的例外
  - createSubcontext
```
public Context createSubcontext(Name name)
                         throws NamingException
```
    从接口复制的描述： Context
    
    创建和绑定一个新的上下文。用给定的名称创建一个新的上下文，并将其绑定在目标上下文中（这是由名称的所有终端原子组件命名的）。所有的中间上下文和目标上下文必须已经存在。
    
    Specified by:
    
    createSubcontext 接口 Context
    
    参数
    
    name -创建上下文的名称不能为空；
    
    结果
    
    新创建的语境
    
    异常
    
    NameAlreadyBoundException如果名字已绑定
    
    InvalidAttributesException如果的形式创作需要强制属性规范
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.createSubcontext(String)， DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)
  - lookupLink
```
public Object lookupLink(String name)
                  throws NamingException
```
    从接口复制的描述： Context
    
    检索已命名的对象，除了名称的终端原子组件以外的下列链接。看到 Context.lookupLink(Name)详情。
    
    Specified by:
    
    lookupLink 接口 Context
    
    参数
    
    name -对象的名字查找
    
    结果
    
    对象绑定到 name，不遵循终端链接（如果有）
    
    异常
    
    NamingException -如果遇到一个命名的例外
  - lookupLink
```
public Object lookupLink(Name name)
                  throws NamingException
```
    从接口复制的描述： Context
    
    检索已命名的对象，除了名称的终端原子组件以外的下列链接。如果对象绑定到 name不是链接，返回对象本身。
    
    Specified by:
    
    lookupLink 接口 Context
    
    参数
    
    name -对象的名字查找
    
    结果
    
    对象绑定到 name，不遵循终端链接（如果有）。
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.lookupLink(String)
  - getNameParser
```
public NameParser getNameParser(String name)
                         throws NamingException
```
    从接口复制的描述： Context
    
    检索与命名上下文关联的语法分析器。看到 Context.getNameParser(Name)详情。
    
    Specified by:
    
    getNameParser 接口 Context
    
    参数
    
    name -从它的上下文的名称让解析器
    
    结果
    
    可以解析复合名到它们的原子部件的名称解析器
    
    异常
    
    NamingException -如果遇到一个命名的例外
  - getNameParser
```
public NameParser getNameParser(Name name)
                         throws NamingException
```
    从接口复制的描述： Context
    
    检索与命名上下文关联的语法分析器。在一个命名空间，不同的命名系统将解析名称不同。该方法允许应用程序使用一个特定命名系统的命名约定来获取解析名为它们的原子部件的解析器。任何单一的命名系统中， NameParser此方法返回的对象必须是相等的（使用 equals()试验）。
    
    Specified by:
    
    getNameParser 接口 Context
    
    参数
    
    name -从它的上下文的名称让解析器
    
    结果
    
    可以解析复合名到它们的原子部件的名称解析器
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.getNameParser(String)， CompoundName
  - composeName
```
public String composeName(String name,
                          String prefix)
                   throws NamingException
```
    在此上下文中与此上下文相关的名称组成此上下文的名称。由于初始上下文可能永远不会被命名为相对于自身以外的任何情况下，该 prefix参数的值必须是一个空名（ ""）。
    
    Specified by:
    
    composeName 接口 Context
    
    参数
    
    相对 name -名字这个语境
    
    prefix -这方面相对于它的一个祖先的名字
    
    结果
    
    对 prefix和 name组成
    
    异常
    
    NamingException -如果遇到一个命名的例外
  - composeName
```
public Name composeName(Name name,
                        Name prefix)
                 throws NamingException
```
    在此上下文中与此上下文相关的名称组成此上下文的名称。由于初始上下文可能永远不会被命名为相对于自身以外的任何情况下，该 prefix参数的值必须是一个空名。
    
    Specified by:
    
    composeName 接口 Context
    
    参数
    
    name -名字相对这个语境
    
    prefix -这方面相对于它的一个祖先的名字
    
    结果
    
    对 prefix和 name组成
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.composeName(String, String)
  - addToEnvironment
```
public Object addToEnvironment(String propName,
                               Object propVal)
                        throws NamingException
```
    从接口复制的描述： Context
    
    在这种情况下添加一个新的环境属性。如果属性已经存在，它的值被覆盖。有关环境属性的详细信息，请参见类描述。
    
    Specified by:
    
    addToEnvironment 接口 Context
    
    参数
    
    propName -要添加的环境属性的名称；不得空
    
    propVal -属性加值；不得空
    
    结果
    
    属性的前值，或无效，如果属性不在环境中之前
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.getEnvironment()， Context.removeFromEnvironment(String)
  - removeFromEnvironment
```
public Object removeFromEnvironment(String propName)
                             throws NamingException
```
    从接口复制的描述： Context
    
    从这个上下文的环境中移除环境属性。有关环境属性的详细信息，请参见类描述。
    
    Specified by:
    
    removeFromEnvironment 接口 Context
    
    参数
    
    propName -去除环境属性的名称；不得空
    
    结果
    
    属性的前一个值，或无效，如果属性不在环境中
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.getEnvironment()， Context.addToEnvironment(String, Object)
  - getEnvironment
```
public Hashtable<?,?> getEnvironment()
                              throws NamingException
```
    从接口复制的描述： Context
    
    检索此上下文的效果的环境。有关环境属性的详细信息，请参见类描述。
    调用方不应该对返回的对象进行任何更改：它们对上下文的影响是不确定的。这个上下文环境可以使用addToEnvironment()和removeFromEnvironment()改变。
    
    Specified by:
    
    getEnvironment 接口 Context
    
    结果
    
    这种语境的环境；永不
    
    异常
    
    NamingException -如果遇到一个命名的例外
    
    另请参见：
    
    Context.addToEnvironment(String, Object)， Context.removeFromEnvironment(String)
  - close
```
public void close()
           throws NamingException
```
    从接口复制的描述： Context
    
    关闭此上下文。此方法立即释放此上下文的资源，而不是等待它们由垃圾收集器自动释放。
    这种方法是幂等：调用上下文上已经关闭没有影响。在不允许在封闭的上下文中调用任何其他方法，并导致未定义的行为。
    
    Specified by:
    
    close 接口 Context
    
    异常
    
    NamingException -如果遇到一个命名的例外
  - getNameInNamespace
```
public String getNameInNamespace()
                          throws NamingException
```
    从接口复制的描述： Context
    
    在它自己的命名空间中检索此上下文的完整名称。
    许多命名服务有一个“在各自的命名空间对象姓名”的概念。例如，一个LDAP条目有一个著名的名字，和DNS记录有一个完全合格的名称。此方法允许客户端应用程序检索此名称。此方法返回的字符串不是一个JNDI复合名称和不应直接传递到上下文的方法。在命名系统，姓名的概念没有意义，OperationNotSupportedException抛出。
    
    Specified by:
    
    getNameInNamespace 接口 Context
    
    结果
    
    这个上下文的名称在它自己的命名空间中；从不空
    
    异常
    
    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.

Class InitialContext

Field Summary

Fields inherited from interface javax.naming.Context

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

myProps

defaultInitCtx

gotDefault

Constructor Detail

InitialContext

InitialContext

InitialContext

方法详细信息

init

doLookup

doLookup

getDefaultInitCtx

getURLOrDefaultInitCtx

getURLOrDefaultInitCtx

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