字段详细信息

• myProps

  protected Hashtable<Object,​Object> myProps

  与此InitialContext关联的环境。 它初始化为null，并由接受环境的构造函数或init()方法更新。

  另请参见：

  Context.addToEnvironment(java.lang.String, java.lang.Object) ， Context.removeFromEnvironment(java.lang.String) ， Context.getEnvironment()

• defaultInitCtx

  protected Context defaultInitCtx

  字段持有调用NamingManager.getInitialContext（）的结果。 它是在第一次调用getDefaultInitCtx（）时由getDefaultInitCtx（）设置的。 getDefaultInitCtx（）的后续调用返回defaultInitCtx的值。

  另请参见：

  getDefaultInitCtx()

• gotDefault

  protected boolean gotDefault

  指示是否已通过调用NamingManager.getInitialContext（）获取初始上下文的字段。 如果为true，则其结果为defaultInitCtx 。

构造方法详细信息

• InitialContext

  protected InitialContext​(boolean lazy)
                    throws NamingException

  构造一个初始上下文，可以选择不初始化它。 当在调用InitialContext构造函数InitialContext不知道环境参数的值时，子类中的构造函数可以使用它。 子类的构造函数将调用此构造函数，计算环境的值，然后在返回之前调用init() 。

  参数

  lazy - true表示不初始化初始上下文; false相当于调用new InitialContext()

  异常

  NamingException - 如果遇到命名异常

  从以下版本开始：

  1.3

  另请参见：

  init(Hashtable)

• InitialContext

  public InitialContext()
                 throws NamingException

  构造一个初始上下文。 没有提供环境属性。 相当于new InitialContext(null) 。

  异常

  NamingException - 如果遇到命名异常

  另请参见：

  InitialContext(Hashtable)

• InitialContext

  public InitialContext​(Hashtable<?,​?> environment)
                 throws NamingException

  使用提供的环境构造初始上下文。 环境属性在类描述中讨论。

  此构造函数不会修改environment或保存对它的引用，但可以保存克隆。 传递给构造函数后，调用者不应在environment修改可变键和值。

  参数

  environment - 用于创建初始上下文的环境。 Null表示空的环境。

  异常

  NamingException - 如果遇到命名异常

方法详细信息

• init

  protected void init​(Hashtable<?,​?> environment)
               throws NamingException

  使用提供的环境初始化初始上下文。 环境属性在类描述中讨论。

  此方法将修改environment并保存对它的引用。 呼叫者可能不再修改它。

  参数

  environment - 用于创建初始上下文的环境。 Null表示空的环境。

  异常

  NamingException - 如果遇到命名异常

  从以下版本开始：

  1.3

  另请参见：

  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 - 如果遇到命名异常

  从以下版本开始：

  1.6

  另请参见：

  doLookup(String) ， Context.lookup(Name)

• doLookup

  public static <T> T doLookup​(String name)
                        throws NamingException

  一种检索命名对象的静态方法。 有关详细信息，请参见doLookup(Name) 。

  参数类型

  T - 返回对象的类型

  参数

  name - 要查找的对象的名称

  结果

  绑定到 name的对象

  异常

  NamingException - 如果遇到命名异常

  从以下版本开始：

  1.6

• getDefaultInitCtx

  protected Context getDefaultInitCtx()
                               throws NamingException

  通过调用NamingManager.getInitialContext()检索初始上下文并将其缓存在defaultInitCtx中。 设置gotDefault以便我们知道我们之前已经尝试过这个。

  结果

  非null缓存的初始上下文。

  异常

  NoInitialContextException - 如果找不到初始上下文。

  NamingException - 如果遇到命名异常。

• getURLOrDefaultInitCtx

  protected Context getURLOrDefaultInitCtx​(String name)
                                    throws NamingException

  检索用于解析字符串名称name的上下文。 如果name名称是URL字符串，则尝试为其查找URL上下文。 如果未找到，或者如果name不是URL字符串，则返回getDefaultInitCtx() 。

  有关子类应如何使用此方法的说明，请参阅getURLOrDefaultInitCtx（Name）。

  参数

  name - 要获取上下文的非null名称。

  结果

  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 - 要获取上下文的非null名称。

  结果

  name的URL上下文或缓存的初始上下文。 结果不能为空。

  异常

  NoInitialContextException - 如果找不到初始上下文。

  NamingException - 遇到命名异常。

  另请参见：

  NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)

• 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)