java.lang.Object

javax.naming.InitialContext

javax.naming.directory.InitialDirContext

すべての実装されたインタフェース:: Context, DirContext

直系の既知のサブクラス:: InitialLdapContext

public class InitialDirContext extends InitialContext implements DirContext

このクラスは、ディレクトリ操作を実行するための開始コンテキストです。 InitialContextのクラスについての記述(同期コンテキストを含む)が適用されます。

導入されたバージョン:

1.3

関連項目:

フィールドのサマリー

クラスで宣言されたフィールド InitialContext
defaultInitCtx, gotDefault, myProps

修飾子と型

フィールド

説明

protected Context

defaultInitCtx

NamingManager.getInitialContext()を呼び出した結果を保持するフィールドです。

protected boolean

gotDefault

初期コンテキストがNamingManager.getInitialContext()の呼出しによって取得されたかを示すフィールドです。

protected Hashtable<Object,Object>

myProps

このInitialContextに関連した環境です。

インタフェースContextで宣言されたフィールド
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

修飾子と型

フィールド

説明

static final String

AUTHORITATIVE

要求されたサービスの権限を指定するための、環境プロパティの名前を保持する定数です。

static final String

BATCHSIZE

サービスのプロトコルによってデータを返すときに使用するバッチ・サイズを指定するための、環境プロパティの名前を保持する定数です。

static final String

DNS_URL

JNDI URLコンテキスト(dns://somehost/wiz.comなど)に使用するDNSホスト名およびドメイン名を指定するための、環境プロパティの名前を保持する定数です。

static final String

INITIAL_CONTEXT_FACTORY

使用する初期コンテキスト・ファクトリを指定するための、環境プロパティの名前を保持する定数です。

static final String

LANGUAGE

サービスに使用する優先言語を指定するための、環境プロパティの名前を保持する定数です。

static final String

OBJECT_FACTORIES

使用するオブジェクト・ファクトリのリストを指定するための、環境プロパティの名前を保持する定数です。

static final String

PROVIDER_URL

使用するサービス・プロバイダの構成情報を指定するための、環境プロパティの名前を保持する定数です。

static final String

REFERRAL

サービス・プロバイダによって参照が処理される方法を指定するための、環境プロパティの名前を保持する定数です。

static final String

SECURITY_AUTHENTICATION

使用するセキュリティ・レベルを指定するための、環境プロパティの名前を保持する定数です。

static final String

SECURITY_CREDENTIALS

サービスに対する呼出し側を認証する主体の資格を指定するための、環境プロパティの名前を保持する定数です。

static final String

SECURITY_PRINCIPAL

サービスに対する呼出し側を認証する主体の識別情報を指定するための、環境プロパティの名前を保持する定数です。

static final String

SECURITY_PROTOCOL

使用するセキュリティ・プロトコルを指定するための、環境プロパティの名前を保持する定数です。

static final String

STATE_FACTORIES

使用する状態ファクトリのリストを指定するための、環境プロパティの名前を保持する定数です。

static final String

URL_PKG_PREFIXES

URLコンテキスト・ファクトリをロードするときに使用するパッケージ接頭辞のリストを指定するための、環境プロパティの名前を保持する定数です。

インタフェースで宣言されたフィールド DirContext
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

修飾子と型

フィールド

説明

static final int

ADD_ATTRIBUTE

この定数は、指定された値で属性を追加することを指定します。

static final int

REMOVE_ATTRIBUTE

この定数は、指定された属性値を属性から削除することを指定します。

static final int

REPLACE_ATTRIBUTE

この定数は、指定された値で属性を置換することを指定します。
コンストラクタのサマリー

コンストラクタ

修飾子

コンストラクタ

説明

InitialDirContext()

初期DirContextを構築します。

protected

InitialDirContext(boolean lazy)

初期化しないというオプションを持つ初期DirContextを構築します。

InitialDirContext(Hashtable<?,?> environment)

指定した環境を使用して初期DirContextを構築します。
メソッドのサマリー

修飾子と型

メソッド

説明

void

bind(String name, Object obj, Attributes attrs)

関連付けられている属性とともに、名前をオブジェクトにバインドします。

void

bind(Name name, Object obj, Attributes attrs)

関連付けられている属性とともに、名前をオブジェクトにバインドします。

DirContext

createSubcontext(String name, Attributes attrs)

関連付けられている属性とともに、名前をオブジェクトにバインドします。

DirContext

createSubcontext(Name name, Attributes attrs)

関連付けられている属性とともに、名前をオブジェクトにバインドします。

Attributes

getAttributes(String name)

名前付きオブジェクトに関連付けられている属性をすべて取得します。

Attributes

getAttributes(String name, String[] attrIds)

名前付きオブジェクトに関連付けられている属性で選択されたものを取得します。

Attributes

getAttributes(Name name)

名前付きオブジェクトに関連付けられている属性をすべて取得します。

Attributes

getAttributes(Name name, String[] attrIds)

名前付きオブジェクトに関連付けられている属性で選択されたものを取得します。

DirContext

getSchema(String name)

名前付きオブジェクトに関連したスキーマを取得します。

DirContext

getSchema(Name name)

名前付きオブジェクトに関連したスキーマを取得します。

DirContext

getSchemaClassDefinition(String name)

指定されたオブジェクトのクラス定義のスキーマ・オブジェクトを含むコンテキストを取得します。

DirContext

getSchemaClassDefinition(Name name)

指定されたオブジェクトのクラス定義のスキーマ・オブジェクトを含むコンテキストを取得します。

void

modifyAttributes(String name, int mod_op, Attributes attrs)

名前付きオブジェクトに関連付けられている属性を変更します。

void

modifyAttributes(String name, ModificationItem[] mods)

順序付けされた変更リストを使用して、指定されたオブジェクトに関連付けられている属性を変更します。

void

modifyAttributes(Name name, int mod_op, Attributes attrs)

名前付きオブジェクトに関連付けられている属性を変更します。

void

modifyAttributes(Name name, ModificationItem[] mods)

順序付けされた変更リストを使用して、指定されたオブジェクトに関連付けられている属性を変更します。

void

rebind(String name, Object obj, Attributes attrs)

関連付けられている属性とともに名前をオブジェクトにバインドし、既存のバインディングをオーバーライドします。

void

rebind(Name name, Object obj, Attributes attrs)

関連付けられている属性とともに名前をオブジェクトにバインドし、既存のバインディングをオーバーライドします。

NamingEnumeration<SearchResult>

search(String name, String filterExpr, Object[] filterArgs, SearchControls cons)

名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。

NamingEnumeration<SearchResult>

search(String name, String filter, SearchControls cons)

名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。

NamingEnumeration<SearchResult>

search(String name, Attributes matchingAttributes)

指定された属性のセットを含むオブジェクトを単一コンテキストで検索します。

NamingEnumeration<SearchResult>

search(String name, Attributes matchingAttributes, String[] attributesToReturn)

指定された属性のセットを含むオブジェクトを単一コンテキストで検索し、選択した属性を取得します。

NamingEnumeration<SearchResult>

search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)

名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。

NamingEnumeration<SearchResult>

search(Name name, String filter, SearchControls cons)

名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。

NamingEnumeration<SearchResult>

search(Name name, Attributes matchingAttributes)

指定された属性のセットを含むオブジェクトを単一コンテキストで検索します。

NamingEnumeration<SearchResult>

search(Name name, Attributes matchingAttributes, String[] attributesToReturn)

指定された属性のセットを含むオブジェクトを単一コンテキストで検索し、選択した属性を取得します。

クラスで宣言されたメソッド InitialContext
addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, doLookup, doLookup, getDefaultInitCtx, getEnvironment, getNameInNamespace, getNameParser, getNameParser, getURLOrDefaultInitCtx, getURLOrDefaultInitCtx, init, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

修飾子と型

メソッド

説明

Object

addToEnvironment(String propName, Object propVal)

このコンテキストの環境に、新しい環境プロパティを追加します。

void

bind(String name, Object obj)

名前をオブジェクトにバインドします。

void

bind(Name name, Object obj)

名前をオブジェクトにバインドします。

void

close()

このコンテキストを閉じます。

String

composeName(String name, String prefix)

このコンテキストを基準にした名前を持つこのコンテキストの名前を変換します。

Name

composeName(Name name, Name prefix)

このコンテキストを基準にした名前を持つこのコンテキストの名前を変換します。

Context

createSubcontext(String name)

新しいコンテキストを作成してバインドします。

Context

createSubcontext(Name name)

新しいコンテキストを作成してバインドします。

void

destroySubcontext(String name)

名前付きコンテキストを破棄し、名前空間から削除します。

void

destroySubcontext(Name name)

名前付きコンテキストを破棄し、名前空間から削除します。

static <T> T

doLookup(String name)

名前付きオブジェクトを取得するstaticメソッドです。

static <T> T

doLookup(Name name)

名前付きオブジェクトを取得するstaticメソッドです。

protected Context

getDefaultInitCtx()

NamingManager.getInitialContext()を呼び出すことによって初期コンテキストを取得し、それをdefaultInitCtx内にキャッシュします。

Hashtable<?,?>

getEnvironment()

このコンテキストで有効な環境を取得します。

String

getNameInNamespace()

独自の名前空間でこのコンテキストの完全な名前を取得します。

NameParser

getNameParser(String name)

名前付きコンテキストに関連したパーサーを取得します。

NameParser

getNameParser(Name name)

名前付きコンテキストに関連したパーサーを取得します。

protected Context

getURLOrDefaultInitCtx(String name)

文字列名nameを解決するためのコンテキストを取得します。

protected Context

getURLOrDefaultInitCtx(Name name)

nameを解決するためのコンテキストを取得します。

protected void

init(Hashtable<?,?> environment)

指定した環境を使用して初期コンテキストを初期化します。

NamingEnumeration<NameClassPair>

list(String name)

バインドされたオブジェクトのクラス名とともに、名前付きコンテキストでバインドされた名前を列挙します。

NamingEnumeration<NameClassPair>

list(Name name)

バインドされたオブジェクトのクラス名とともに、名前付きコンテキストでバインドされた名前を列挙します。

NamingEnumeration<Binding>

listBindings(String name)

バインドされたオブジェクトとともに、名前付きコンテキストでバインドされた名前を列挙します。

NamingEnumeration<Binding>

listBindings(Name name)

バインドされたオブジェクトとともに、名前付きコンテキストでバインドされた名前を列挙します。

Object

lookup(String name)

名前付きオブジェクトを取得します。

Object

lookup(Name name)

名前付きオブジェクトを取得します。

Object

lookupLink(String name)

名前の終端の基本コンポーネントを除くリンクをともなう、名前付きオブジェクトを取得します。

Object

lookupLink(Name name)

名前の終端の基本コンポーネントを除くリンクをともなう、名前付きオブジェクトを取得します。

void

rebind(String name, Object obj)

名前をオブジェクトにバインドし、既存のバインディングを上書きします。

void

rebind(Name name, Object obj)

名前をオブジェクトにバインドし、既存のバインディングを上書きします。

Object

removeFromEnvironment(String propName)

このコンテキストの環境から環境プロパティを削除します。

void

rename(String oldName, String newName)

新しい名前を、以前の名前にバインドされたオブジェクトにバインドし、以前の名前をアンバインドします。

void

rename(Name oldName, Name newName)

新しい名前を、以前の名前にバインドされたオブジェクトにバインドし、以前の名前をアンバインドします。

void

unbind(String name)

名前付きオブジェクトをアンバインドします。

void

unbind(Name name)

名前付きオブジェクトをアンバインドします。

クラスオブジェクトで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

修飾子と型

メソッド

説明

protected Object

clone()

このオブジェクトのコピーを作成して、返します。

boolean

equals(Object obj)

このオブジェクトと他のオブジェクトが等しいかどうかを示します。

protected void

finalize()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
最終決定は非推奨であり、将来のリリースで削除される可能性があります。

final Class<?>

getClass()

このObjectの実行時クラスを返します。

int

hashCode()

このオブジェクトに対するハッシュ・コード値を返します。

final void

notify()

このオブジェクトのモニターで待機中のスレッドを1つ再開します。

final void

notifyAll()

このオブジェクトのモニターで待機中のすべてのスレッドを再開します。

String

toString()

オブジェクトの文字列表現を返します。

final void

wait()

現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。

final void

wait(long timeoutMillis)

現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

final void

wait(long timeoutMillis, int nanos)

現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細
- InitialDirContext
  protected InitialDirContext(boolean lazy) throws NamingException
  
  初期化しないというオプションを持つ初期DirContextを構築します。これは、InitialDirContextコンストラクタの呼出し時に環境パラメータの値がまだわからない場合に、サブクラスのコンストラクタによって使用される場合があります。サブクラスのコンストラクタは、このコンストラクタをコールし、環境の値をコンピュートし、init()をコールしてから戻ります。
  
  パラメータ:
  
  lazy - trueは、初期DirContextを初期化しないことを意味します。falseは、new InitialDirContext()をコールすることと同じです
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
  
  導入されたバージョン:
  
  1.3
  
  関連項目:
  
  InitialContext.init(Hashtable)
- InitialDirContext
  public InitialDirContext() throws NamingException
  
  初期DirContextを構築します。環境プロパティは指定されません。 new InitialDirContext(null)と等価です。
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  InitialDirContext(Hashtable)
- InitialDirContext
  public InitialDirContext(Hashtable<?,?> environment) throws NamingException
  
  指定した環境を使用して初期DirContextを構築します。環境プロパティについては、javax.naming.InitialContextクラスの説明を参照してください。
  指定された環境のjava.naming.provider.urlプロパティがLDAPプロトコルを使用してURL (またはUrlのリスト)で構成されている場合、結果のLdapContextは構成されたLdapDnsProvidersによって解決されたLDAPサーバーを使用します:
  
  Ldapプロトコルを使用してjava.naming.provider.urlで作成された最初のInitialDirContextである場合、ServiceLoaderメカニズムを使用して、システム・クラス・ローダーを使用してLdapDnsProvider実装を検索します。プロバイダが配置される順序は実装に固有で、実装は位置しているプロバイダを自由にキャッシュできます。
  各プロバイダのlookupEndpointsメソッドは、インスタンス化されると、プロバイダが空でないかすべてのプロバイダが使い果たされるまで、java.naming.provider.urlプロパティの各URLと環境を組み合せて1回起動されます。 LdapDnsProvidersのいずれにも空でないresultが戻されない場合は、エンドポイントの判別がベスト・エフォートに試みられます。 LdapDnsProviderのロード時または呼出し時にServiceConfigurationError、ErrorまたはRuntimeExceptionがスローされた場合、呼出し側のスレッドに伝播されます。
  
  このコンストラクタは、environmentの変更や参照の保存は行いませんが、クローンの保存は可能です。呼出し元は、environmentがコンストラクタに渡された後、変更可能なキーおよび値を変更しないでください。
  
  パラメータ:
  
  environment - 初期のDirContextを作成するために使用される環境。 nullは空の環境を示す。
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
メソッドの詳細
- getAttributes
  
  public Attributes getAttributes(String name) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連付けられている属性をすべて取得します。詳細は、DirContext.getAttributes(Name)を参照してください。
  
  定義:
  
  getAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性の取得元のオブジェクトの名前
  
  戻り値:
  
  nameに関連付けられている属性のセット
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
- getAttributes
  
  public Attributes getAttributes(String name, String[] attrIds) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連付けられている属性で選択されたものを取得します。詳細は、DirContext.getAttributes(Name, String[])を参照してください。
  
  定義:
  
  getAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性の取得元のオブジェクトの名前
  
  attrIds - 取得する属性の識別子。nullはすべての属性が取得されることを示す。空の配列は何も取得されないことを示す。
  
  戻り値:
  
  要求された属性。nullは不可
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
- getAttributes
  public Attributes getAttributes(Name name) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連付けられている属性をすべて取得します。属性モデル、属性型名、および操作属性については、クラスの説明を参照してください。
  
  定義:
  
  getAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性の取得元のオブジェクトの名前
  
  戻り値:
  
  nameに関連付けられている属性のセット。名前に属性がない場合、空の属性セットを返し、nullになることはない。
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  DirContext.getAttributes(String)
  
  DirContext.getAttributes(Name, String[])
- getAttributes
  
  public Attributes getAttributes(Name name, String[] attrIds) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連付けられている属性で選択されたものを取得します。属性モデル、属性型名、および操作属性については、クラスの説明を参照してください。
  指定された属性をオブジェクトが持っていない場合、ディレクトリは存在しない属性を無視し、オブジェクトが持っている要求された属性を返します。
  ディレクトリは要求された数より多い属性を返すことがあります(クラスの説明にあるAttribute Type Namesを参照)が、任意の無関連な属性を返すことは許可されていません。
  クラスの説明にあるOperational Attributesも参照してください。
  
  定義:
  
  getAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性の取得元のオブジェクトの名前
  
  attrIds - 取得する属性の識別子。nullはすべての属性が取得されることを示す。空の配列は何も取得されないことを示す。
  
  戻り値:
  
  要求された属性。nullは不可
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
- modifyAttributes
  
  public void modifyAttributes(String name, int mod_op, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連付けられている属性を変更します。詳細は、DirContext.modifyAttributes(Name, int, Attributes)を参照してください。
  
  定義:
  
  modifyAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性が更新されるオブジェクトの名前
  
  mod_op - 変更操作。ADD_ATTRIBUTE、REPLACE_ATTRIBUTE、REMOVE_ATTRIBUTEのうちのいずれか。
  
  attrs - 変更に使用される属性。nullは不可
  
  スロー:
  
  AttributeModificationException - 変更を正常に完了できない場合
  
  NamingException - ネーミング例外が発生した場合
- modifyAttributes
  public void modifyAttributes(Name name, int mod_op, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連付けられている属性を変更します。変更の順序は指定されません。可能な場合、変更は基本的に行われます。
  
  定義:
  
  modifyAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性が更新されるオブジェクトの名前
  
  mod_op - 変更操作。ADD_ATTRIBUTE、REPLACE_ATTRIBUTE、REMOVE_ATTRIBUTEのうちのいずれか。
  
  attrs - 変更に使用される属性。nullは不可
  
  スロー:
  
  AttributeModificationException - 変更を正常に完了できない場合
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  DirContext.modifyAttributes(Name, ModificationItem[])
- modifyAttributes
  
  public void modifyAttributes(String name, ModificationItem[] mods) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  順序付けされた変更リストを使用して、指定されたオブジェクトに関連付けられている属性を変更します。詳細は、DirContext.modifyAttributes(Name, ModificationItem[])を参照してください。
  
  定義:
  
  modifyAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性が更新されるオブジェクトの名前
  
  mods - 実行される変更の順序。nullは不可
  
  スロー:
  
  AttributeModificationException - 変更を正常に完了できない場合
  
  NamingException - ネーミング例外が発生した場合
- modifyAttributes
  public void modifyAttributes(Name name, ModificationItem[] mods) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  順序付けされた変更リストを使用して、指定されたオブジェクトに関連付けられている属性を変更します。変更は指定された順序で行われます。各変更は変更操作コードおよび操作する属性を指定します。可能な場合、変更は基本的に行われます。
  
  定義:
  
  modifyAttributes、インタフェースDirContext
  
  パラメータ:
  
  name - 属性が更新されるオブジェクトの名前
  
  mods - 実行される変更の順序。nullは不可
  
  スロー:
  
  AttributeModificationException - 変更を正常に完了できない場合
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  DirContext.modifyAttributes(Name, int, Attributes)
  
  ModificationItem
- bind
  
  public void bind(String name, Object obj, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  関連付けられている属性とともに、名前をオブジェクトにバインドします。詳細は、DirContext.bind(Name, Object, Attributes)を参照してください。
  
  定義:
  
  bind、インタフェースDirContext
  
  パラメータ:
  
  name - バインドする名前。空は不可
  
  obj - バインドするオブジェクト。nullの可能性がある
  
  attrs - バインディングに関連付ける属性
  
  スロー:
  
  NameAlreadyBoundException - 名前がすでにバインドされている場合
  
  InvalidAttributesException - バインディングの一部の「必須」属性が提供されていない場合
  
  NamingException - ネーミング例外が発生した場合
- bind
  public void bind(Name name, Object obj, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  関連付けられている属性とともに、名前をオブジェクトにバインドします。 attrsがnullの場合、結果のバインディングでは、objがDirContextの場合はobjに関連付けられた属性が設定され、それ以外の場合は属性は関連付けられません。 attrsがnull以外の場合、結果のバインディングの属性としてattrsが設定されます。objに関連付けられた属性は無視されます。
  
  定義:
  
  bind、インタフェースDirContext
  
  パラメータ:
  
  name - バインドする名前。空は不可
  
  obj - バインドするオブジェクト。nullの可能性がある
  
  attrs - バインディングに関連付ける属性
  
  スロー:
  
  NameAlreadyBoundException - 名前がすでにバインドされている場合
  
  InvalidAttributesException - バインディングの一部の「必須」属性が提供されていない場合
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  Context.bind(Name, Object)
  
  DirContext.rebind(Name, Object, Attributes)
- rebind
  
  public void rebind(String name, Object obj, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  関連付けられている属性とともに名前をオブジェクトにバインドし、既存のバインディングをオーバーライドします。詳細は、DirContext.rebind(Name, Object, Attributes)を参照してください。
  
  定義:
  
  rebind、インタフェースDirContext
  
  パラメータ:
  
  name - バインドする名前。空は不可
  
  obj - バインドするオブジェクト。nullの可能性がある
  
  attrs - バインディングに関連付ける属性
  
  スロー:
  
  InvalidAttributesException - バインディングの一部の「必須」属性が提供されていない場合
  
  NamingException - ネーミング例外が発生した場合
- rebind
  public void rebind(Name name, Object obj, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  関連付けられている属性とともに名前をオブジェクトにバインドし、既存のバインディングをオーバーライドします。 attrsがnullで、objがDirContextの場合、objの属性が使用されます。 attrsがnullで、objがDirContextでない場合、ディレクトリにすでにバインドされているオブジェクトに関連付けられた既存の属性は変更されません。 attrsがnullでない場合、ディレクトリにすでにバインドされているオブジェクトに関連付けられた既存の属性が削除され、attrsが名前付きオブジェクトに関連付けられます。 objがDirContextで、attrsがnull以外の場合、objの属性は無視されます。
  
  定義:
  
  rebind、インタフェースDirContext
  
  パラメータ:
  
  name - バインドする名前。空は不可
  
  obj - バインドするオブジェクト。nullの可能性がある
  
  attrs - バインディングに関連付ける属性
  
  スロー:
  
  InvalidAttributesException - バインディングの一部の「必須」属性が提供されていない場合
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  Context.bind(Name, Object)
  
  DirContext.bind(Name, Object, Attributes)
- createSubcontext
  
  public DirContext createSubcontext(String name, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  関連付けられている属性とともに、名前をオブジェクトにバインドします。詳細は、DirContext.createSubcontext(Name, Attributes)を参照してください。
  
  定義:
  
  createSubcontext、インタフェースDirContext
  
  パラメータ:
  
  name - 作成するコンテキストの名前。空は不可
  
  attrs - 新しく作成されたコンテキストに関連付ける属性
  
  戻り値:
  
  新しく作成されたコンテキスト
  
  スロー:
  
  NameAlreadyBoundException - 名前がすでにバインドされている場合
  
  InvalidAttributesException - attrsに、作成に必要な必須属性の一部が含まれていない場合
  
  NamingException - ネーミング例外が発生した場合
- createSubcontext
  public DirContext createSubcontext(Name name, Attributes attrs) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  関連付けられている属性とともに、名前をオブジェクトにバインドします。このメソッドは指定した名前で新しいサブコンテキストを作成し、そのサブコンテキストを(名前の末端にあるものを除くすべての不可分の成分)ターゲット・コンテキストでバインドし、提供された属性を新しく作成されたオブジェクトに関連付けます。すべての中間コンテキストおよびターゲット・コンテキストがすでに存在している必要があります。 attrsがnullの場合、このメソッドはContext.createSubcontext()と同等です。
  
  定義:
  
  createSubcontext、インタフェースDirContext
  
  パラメータ:
  
  name - 作成するコンテキストの名前。空は不可
  
  attrs - 新しく作成されたコンテキストに関連付ける属性
  
  戻り値:
  
  新しく作成されたコンテキスト
  
  スロー:
  
  NameAlreadyBoundException - 名前がすでにバインドされている場合
  
  InvalidAttributesException - attrsに、作成に必要な必須属性の一部が含まれていない場合
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  Context.createSubcontext(Name)
- getSchema
  
  public DirContext getSchema(String name) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連したスキーマを取得します。詳細は、DirContext.getSchema(Name)を参照してください。
  
  定義:
  
  getSchema、インタフェースDirContext
  
  パラメータ:
  
  name - スキーマが取得されるオブジェクトの名前
  
  戻り値:
  
  コンテキストに関連付けられるスキーマ。nullは不可
  
  スロー:
  
  OperationNotSupportedException - スキーマがサポートされていない場合
  
  NamingException - ネーミング例外が発生した場合
- getSchema
  
  public DirContext getSchema(Name name) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きオブジェクトに関連したスキーマを取得します。スキーマは、名前空間の構造と、その中に保存された属性に関する規則を説明します。スキーマは、ディレクトリに追加できるオブジェクトの型とそのオブジェクトを追加する場所、オブジェクトが持てる必須属性と任意の属性を指定します。スキーマのサポート範囲はディレクトリに固有です。
  このメソッドは、指定されたオブジェクトに適用できるスキーマ情報ツリーのルートを返します。指定されたオブジェクト(またはディレクトリ全体)のいくつかが、同じスキーマを共有する場合があります。
  スキーマ・ツリーの構造と内容、スキーマ・ツリーの内容の変更許可、こうした変更のディレクトリへの影響などの問題は、ベースとなるディレクトリによって異なります。
  
  定義:
  
  getSchema、インタフェースDirContext
  
  パラメータ:
  
  name - スキーマが取得されるオブジェクトの名前
  
  戻り値:
  
  コンテキストに関連付けられるスキーマ。nullは不可
  
  スロー:
  
  OperationNotSupportedException - スキーマがサポートされていない場合
  
  NamingException - ネーミング例外が発生した場合
- getSchemaClassDefinition
  
  public DirContext getSchemaClassDefinition(String name) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  指定されたオブジェクトのクラス定義のスキーマ・オブジェクトを含むコンテキストを取得します。詳細は、DirContext.getSchemaClassDefinition(Name)を参照してください。
  
  定義:
  
  getSchemaClassDefinition、インタフェースDirContext
  
  パラメータ:
  
  name - オブジェクト・クラス定義が取得されるオブジェクトの名前
  
  戻り値:
  
  指定されたオブジェクトのクラス定義を含むDirContext。null以外
  
  スロー:
  
  OperationNotSupportedException - スキーマがサポートされていない場合
  
  NamingException - ネーミング例外が発生した場合
- getSchemaClassDefinition
  
  public DirContext getSchemaClassDefinition(Name name) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  指定されたオブジェクトのクラス定義のスキーマ・オブジェクトを含むコンテキストを取得します。
  ディレクトリ・スキーマ内にある情報のカテゴリの1つにクラス定義があります。「オブジェクト・クラス」の定義は、オブジェクトの型と、そのオブジェクトが備える必要のある、または備えることのできる(必須およびオプションの)属性を指定します。ここで言う「オブジェクト・クラス」は、Java的な意味ではなく、ディレクトリ的な意味で使われています。たとえば、指定されたオブジェクトが"個人"クラスのディレクトリ・オブジェクトである場合、getSchemaClassDefinition()は、"個人"の(directory's)オブジェクト・クラス定義を表すDirContextを返します。
  オブジェクト・クラス定義から取得できる情報は、ディレクトリ依存です。
  JNDI 1.2より前は、このメソッドは指定されたオブジェクトのクラス定義を表す単一のスキーマ・オブジェクトを返していました。 JNDI 1.2以降、このメソッドは、指定されたオブジェクトのクラス定義をすべて含むDirContextを返します。
  
  定義:
  
  getSchemaClassDefinition、インタフェースDirContext
  
  パラメータ:
  
  name - オブジェクト・クラス定義が取得されるオブジェクトの名前
  
  戻り値:
  
  指定されたオブジェクトのクラス定義を含むDirContext。null以外
  
  スロー:
  
  OperationNotSupportedException - スキーマがサポートされていない場合
  
  NamingException - ネーミング例外が発生した場合
- search
  
  public NamingEnumeration<SearchResult> search(String name, Attributes matchingAttributes) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  指定された属性のセットを含むオブジェクトを単一コンテキストで検索します。詳細は、DirContext.search(Name, Attributes)を参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストの名前
  
  matchingAttributes - 検索する属性
  
  戻り値:
  
  SearchResultオブジェクトの列挙
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
- search
  public NamingEnumeration<SearchResult> search(Name name, Attributes matchingAttributes) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  指定された属性のセットを含むオブジェクトを単一コンテキストで検索します。このメソッドはそのオブジェクトのすべての属性を返します。これは、attributesToReturnパラメータとしてnullをsearch(Name, Attributes, String[])メソッドに渡すのと同じです。
  詳細は、DirContext.search(Name, Attributes, String[])を参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストの名前
  
  matchingAttributes - 検索する属性
  
  戻り値:
  
  SearchResultオブジェクトの列挙
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  DirContext.search(Name, Attributes, String[])
- search
  
  public NamingEnumeration<SearchResult> search(String name, Attributes matchingAttributes, String[] attributesToReturn) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  指定された属性のセットを含むオブジェクトを単一コンテキストで検索し、選択した属性を取得します。詳細は、DirContext.search(Name, Attributes, String[])を参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストの名前
  
  matchingAttributes - 検索する属性
  
  attributesToReturn - 返す属性
  
  戻り値:
  
  SearchResultオブジェクトのnull以外の列挙
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
- search
  public NamingEnumeration<SearchResult> search(Name name, Attributes matchingAttributes, String[] attributesToReturn) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  指定された属性のセットを含むオブジェクトを単一コンテキストで検索し、選択した属性を取得します。検索は、デフォルトのSearchControls設定を使用して実行されます。
  オブジェクトが選択されるには、matchingAttributes内の各属性がそのオブジェクトのいずれかの属性に一致している必要があります。 matchingAttributesが空またはnullの場合は、ターゲット・コンテキスト内のすべてのオブジェクトが返されます。
  matchingAttributes内の属性A₁とオブジェクトの属性A₂が同じ識別子を持っており、A₁の各値がA₂のいずれかの値に等しい場合、A₁はA₂に一致すると見なされます。これは、値の順序は重要でなく、A₁にはない「余分な」値が比較に影響を与えることなくA₂に含まれている可能性があることを示しています。また、A₁に値が含まれていない場合は、一致しているかどうかをテストすることが、同じ識別子を持つ属性A₂が存在するかどうかをテストすることと同等であることも示しています。
  属性値を比較するのに使用される「同等」の詳細な定義は、ベースとなるディレクトリ・サービスによって定義されます。これは、たとえばObject.equalsメソッドを使用することも、スキーマを使用して別の同等操作を指定することもあります。同等以外の操作に基づくマッチング(部分文字列の比較など)には、searchメソッドのフィルタ引数を取るバージョンを使用します。
  このDirContextに変更が加えられると、このメソッドへの以前のコールによって返される列挙への影響は未定義です。
  指定された属性をオブジェクトが持っていない場合、ディレクトリは存在しない属性を無視し、オブジェクトが持っている要求された属性を返します。
  ディレクトリは要求された数より多い属性を返すことがあります(クラスの説明にあるAttribute Type Namesを参照)が、任意の無関連な属性を返すことは許可されていません。
  クラスの説明にあるOperational Attributesも参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストの名前
  
  matchingAttributes - 検索する属性。空またはnullの場合、ターゲット・コンテキストのすべてのオブジェクトが返される。
  
  attributesToReturn - 返す属性。nullはすべての属性が返されることを示す。空の配列は何も返されないことを示す。
  
  戻り値:
  
  SearchResultオブジェクトのnull以外の列挙。各SearchResultには、attributesToReturnで識別される属性と、nameで指定されたコンテキストに対して相対的に指定された対応するオブジェクトの名前が含まれます。
  
  スロー:
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  SearchControls
  
  SearchResult
  
  DirContext.search(Name, String, Object[], SearchControls)
- search
  
  public NamingEnumeration<SearchResult> search(String name, String filter, SearchControls cons) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。検索制御によって指定されたように検索を行います。詳細は、DirContext.search(Name, String, SearchControls)を参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストまたはオブジェクトの名前
  
  filter - 検索に使用するフィルタ式。nullは不可
  
  cons - 検索を制御する検索コントロール。 nullの場合、デフォルトの検索コントロールは((new SearchControls())と同等)が使用されます。
  
  戻り値:
  
  フィルタを満たすオブジェクトのSearchResultの列挙。
  
  スロー:
  
  InvalidSearchFilterException - 指定された検索フィルタが、ベースとなるディレクトリによってサポートまたは認識されていない場合
  
  InvalidSearchControlsException - 検索コントロールに無効な設定が含まれている場合
  
  NamingException - ネーミング例外が発生した場合
- search
  public NamingEnumeration<SearchResult> search(Name name, String filter, SearchControls cons) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。検索制御によって指定されたように検索を行います。
  filterの形式と解釈は、RFC 2254に従います。このRFCでは、attrとvalueに対して次の解釈が示されています。
  attrは属性の識別子です。
  valueは属性の値文字列表現です。属性値へのこの文字列表現の平行移動は、ディレクトリに固有です。
  たとえば、「someCount=127」というアサーションでは、attrが「someCount」であり、valueが「127」です。属性ID (「someCount」)、および場合によってはそのスキーマに基づいて、プロバイダは属性の値が整数型であることを判別します。プロバイダは続いて文字列「127」を適切に構文解析します。
  フィルタ文字列のASCII以外の文字は、該当するJava (Unicode)文字で表し、UTF-8オクテットへのエンコードはしません。あるいは、RFC 2254で述べられている「バックスラッシュ - 16進数字」表記法も使用できます。
  ディレクトリがその属性の一部またはすべての文字列表現をサポートしていない場合は、代わりに、Objectsの形式のフィルタ引数を受け入れるsearchの形式を使用できます。このようなディレクトリのサービス・プロバイダは、フィルタ引数をフィルタ評価のそのサービス特定の表現に平行移動します。 search(Name, String, Object[], SearchControls)を参照してください。
  RFC 2254は、部分文字列一致、等価、近似一致、より大、より小を含む所定の演算子を定義します。これらの演算子は、対応するセマンティックスとともにベースとなるディレクトリにある演算子にマップされます。たとえば、同等演算子の場合、ディレクトリはフィルタの属性の「同等」を定義する一致規則を持っているとします。この規則を使用して、フィルタで指定された属性と、ディレクトリのオブジェクトの属性とが同等かどうかを調べます。同様に、ディレクトリが順序付けの規則を持っていれば、この規則を使用して「より大」および「より小」の比較をします。
  RFC 2254で定義されている演算子のすべてをすべての属性に適用できるわけではありません。演算子を適用できない場合は、例外InvalidSearchFilterExceptionがスローされます。
  結果は、SearchResultsの列挙で返されます。各SearchResultには、オブジェクトの名前と、オブジェクト(SearchResultを参照してください)に関するその他の情報が含まれます。この名前は、(nameパラメータで指定された)検索のターゲット・コンテキストに関連しているか、またはURL文字列であるかのどちらかです。ターゲット・コンテキストが列挙に含まれている場合(consによってSearchControls.OBJECT_SCOPEまたはSearchControls.SUBSTREE_SCOPEの検索範囲が指定されているときは可能性がある)、その名前は空の文字列です。 cons引数で属性が返されることが指定されている場合、SearchResultには、一致するオブジェクトの属性を含めることもできます。
  要求された属性をオブジェクトが持っていない場合、その存在しない属性は無視されます。オブジェクトが持っている要求された属性が返されます。
  ディレクトリは要求された数より多い属性を返すことがあります(クラスの説明にあるAttribute Type Namesを参照)が、任意の無関連な属性を返すことは許可されていません。
  クラスの説明にあるOperational Attributesも参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストまたはオブジェクトの名前
  
  filter - 検索に使用するフィルタ式。nullは不可
  
  cons - 検索を制御する検索コントロール。 nullの場合、デフォルトの検索コントロールは((new SearchControls())と同等)が使用されます。
  
  戻り値:
  
  フィルタを満たすオブジェクトのSearchResultの列挙。NULL以外
  
  スロー:
  
  InvalidSearchFilterException - 指定された検索フィルタが、ベースとなるディレクトリによってサポートまたは認識されていない場合
  
  InvalidSearchControlsException - 検索コントロールに無効な設定が含まれている場合
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  DirContext.search(Name, String, Object[], SearchControls)
  
  SearchControls
  
  SearchResult
- search
  
  public NamingEnumeration<SearchResult> search(String name, String filterExpr, Object[] filterArgs, SearchControls cons) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。検索制御によって指定されたように検索を行います。詳細は、DirContext.search(Name, String, Object[], SearchControls)を参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストまたはオブジェクトの名前
  
  filterExpr - 検索に使用するフィルタ式。この式には、形式「{i}」の変数(iは負にならない整数)が含まれる可能性がある。 nullは不可。
  
  filterArgs - filterExpr内の変数を置換する引数の配列。 filterArgs[i]の値が各「{i}」を置換する。 nullの場合、空の配列と同等。
  
  cons - 検索を制御する検索コントロール。 nullの場合、デフォルトの検索コントロールは((new SearchControls())と同等)が使用されます。
  
  戻り値:
  
  フィルタを満たすオブジェクトのSearchResultの列挙。NULL以外
  
  スロー:
  
  InvalidSearchControlsException - consに無効な設定が含まれている場合
  
  InvalidSearchFilterException - filterArgsを指定したfilterExprが無効な検索フィルタを表す場合
  
  NamingException - ネーミング例外が発生した場合
- search
  public NamingEnumeration<SearchResult> search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons) throws NamingException
  
  インタフェースからコピーされた説明: DirContext
  
  名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。検索制御によって指定されたように検索を行います。
  filterExprの解釈は、RFC 2254に基づいています。これにはさらに、filterArgs配列内のオブジェクトを参照する形式{i}の変数(iは整数)が含まれる可能性があります。 filterExprの解釈は、それ以外の点では、メソッドsearch(Name, String, SearchControls)のfilterパラメータの解釈と同じです。
  変数{i}は、検索フィルタ内にある場合、フィルタ引数filterArgs[i]がその場所で使用されることを示します。このような変数は、attr、value、またはmatchingrule生成がRFC 2254、セクション4のフィルタ文法内で現れる場所ならどこでも使用できます。文字列値のフィルタ引数で変数を置換する場合、フィルタは変数の代わりに文字列が指定されたかのように解釈され、フィルタ内で特殊な意味を持つ文字('*'など)はすべてRFC 2254の規則に従ってエスケープされています。
  属性の一部または全部に文字列表現を使用しないディレクトリの場合、属性値に対応するフィルタ引数はString以外の型の可能性があります。たとえば、構造化されていない2進値の属性をサポートするディレクトリは、バイト配列をフィルタ引数として受け入れます。ほかの型のフィルタ引数の解釈がある場合、解釈はそのディレクトリのサービス・プロバイダによって判別され、サービス・プロバイダはフィルタ操作を、該当するセマンティックスとともにベースとなるディレクトリの操作にマップします。
  このメソッドは結果の列挙を返します。列挙内の各要素には、オブジェクトの名前と、オブジェクトに関するその他の情報が含まれています(SearchResultを参照)。この名前は、(nameパラメータで指定された)検索のターゲット・コンテキストに関連しているか、またはURL文字列であるかのどちらかです。ターゲット・コンテキストが列挙に含まれている場合(consによってSearchControls.OBJECT_SCOPEまたはSearchControls.SUBSTREE_SCOPEの検索範囲が指定されているときは可能性がある)、その名前は空の文字列です。
  cons引数で属性が返されるように指定されている場合、SearchResultには一致するオブジェクトの属性も含まれる場合があります。
  要求された属性をオブジェクトが持っていない場合、その存在しない属性は無視されます。オブジェクトが持っている要求された属性が返されます。
  ディレクトリは要求された数より多い属性を返すことがあります(クラスの説明にあるAttribute Type Namesを参照)が、任意の無関連な属性を返すことは許可されていません。
  無効な変数の置換を行う検索フィルタがこのメソッドに提供された場合、結果は定義されていません。このDirContextに変更が行われた場合、変更前のこのメソッドに対する呼出しによって返された列挙の結果は、定義されていません。
  クラスの説明にあるOperational Attributesも参照してください。
  
  定義:
  
  search、インタフェースDirContext
  
  パラメータ:
  
  name - 検索するコンテキストまたはオブジェクトの名前
  
  filterExpr - 検索に使用するフィルタ式。この式には、形式「{i}」の変数(iは負にならない整数)が含まれる可能性がある。 nullは不可。
  
  filterArgs - filterExpr内の変数を置換する引数の配列。 filterArgs[i]の値が各「{i}」を置換する。 nullの場合、空の配列と同等。
  
  cons - 検索を制御する検索コントロール。 nullの場合、デフォルトの検索コントロールは((new SearchControls())と同等)が使用されます。
  
  戻り値:
  
  フィルタを満たすオブジェクトのSearchResultの列挙。NULL以外
  
  スロー:
  
  InvalidSearchControlsException - consに無効な設定が含まれている場合
  
  InvalidSearchFilterException - filterArgsを指定したfilterExprが無効な検索フィルタを表す場合
  
  NamingException - ネーミング例外が発生した場合
  
  関連項目:
  
  DirContext.search(Name, Attributes, String[])
  
  MessageFormat

クラスInitialDirContext

フィールドのサマリー

クラスで宣言されたフィールド InitialContext

インタフェースContextで宣言されたフィールド

インタフェースで宣言されたフィールド DirContext

コンストラクタのサマリー

メソッドのサマリー

クラスで宣言されたメソッド InitialContext

クラスオブジェクトで宣言されたメソッド

コンストラクタの詳細

InitialDirContext

InitialDirContext

InitialDirContext

メソッドの詳細

getAttributes

getAttributes

getAttributes

getAttributes

modifyAttributes

modifyAttributes

modifyAttributes

modifyAttributes

bind

bind

rebind

rebind

createSubcontext

createSubcontext

getSchema

getSchema

getSchemaClassDefinition

getSchemaClassDefinition

search

search

search

search

search

search

search

search