JavaTM 2 Platform
Standard Ed. 5.0

javax.naming.spi
クラス DirectoryManager

java.lang.Object
  上位を拡張 javax.naming.spi.NamingManager
      上位を拡張 javax.naming.spi.DirectoryManager

public class DirectoryManager
extends NamingManager

このクラスには、DirContext 実装をサポートするメソッドが含まれます。

このクラスは NamingManager を拡張したものです。サービスプロバイダがオブジェクトファクトリおよび状態ファクトリにアクセスするとき、および連合をサポートする継続コンテキストを取得するときに使用するメソッドを格納します。

DirectoryManager は、複数のスレッドによる並行アクセスでもセキュリティ上安全です。

別途注釈のある場合を除いて、NameAttributes、またはメソッドに渡される環境パラメータは、呼び出し側が所有します。実装ではオブジェクトを変更せず、そのオブジェクトに対する参照も保持しませんが、複製またはコピーに対する参照を保持することがあります。

導入されたバージョン:
1.3
関連項目:
DirObjectFactory, DirStateFactory

フィールドの概要
 
クラス javax.naming.spi.NamingManager から継承されたフィールド
CPE
 
メソッドの概要
static DirContext getContinuationDirContext(CannotProceedException cpe)
          DirContext 操作を継続するコンテキストを生成します。
static Object getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs)
          指定されたオブジェクト、属性、および環境にオブジェクトのインスタンスを生成します。
static DirStateFactory.Result getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs)
          元のオブジェクトおよびその属性が指定されたときに、オブジェクトのバインディングの状態を取得します。
 
クラス javax.naming.spi.NamingManager から継承されたメソッド
getContinuationContext, getInitialContext, getObjectInstance, getStateToBind, getURLContext, hasInitialContextFactoryBuilder, setInitialContextFactoryBuilder, setObjectFactoryBuilder
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

getContinuationDirContext

public static DirContext getContinuationDirContext(CannotProceedException cpe)
                                            throws NamingException
DirContext 操作を継続するコンテキストを生成します。NamingManager.getContinuationContext() と同じように動作します。返される継続コンテキストは DirContext だけです。

パラメータ:
cpe - この継続をトリガした null 以外の例外
戻り値:
操作を継続する null 以外の DirContext オブジェクト
例外:
NamingException - ネーミング例外が発生した場合
関連項目:
NamingManager.getContinuationContext(CannotProceedException)

getObjectInstance

public static Object getObjectInstance(Object refInfo,
                                       Name name,
                                       Context nameCtx,
                                       Hashtable<?,?> environment,
                                       Attributes attrs)
                                throws Exception
指定されたオブジェクト、属性、および環境にオブジェクトのインスタンスを生成します。

このメソッドは NamingManager.getObjectInstance とほぼ同じですが、以下の点が違います。

NamingManager.getObjectInstance() インタフェースではなく DirContext インタフェースを実装しているサービスプロバイダがこのメソッドを使います。

パラメータ:
refInfo - オブジェクト生成対象の、null の可能性があるオブジェクト
name - nameCtx に関連するこのオブジェクトの名前。名前の指定は任意。省略する場合、name は null
nameCtx - name パラメータの指定に関連するコンテキスト。null の場合、name はデフォルトの初期コンテキストに関連する
environment - オブジェクトファクトリおよびオブジェクトの生成に使用される、null の可能性がある環境
attrs - null の可能性がある、refInfo に関連した属性。これは refInfo の完全属性セットではない場合がある。ディレクトリからさらに属性を読み込めることがある
戻り値:
refInfo および attrs を使って生成された属性、またはファクトリがオブジェクトを生成できない場合は refInfo
例外:
NamingException - URL コンテキストを取得するときにネーミング例外が見つかった場合、またはアクセスしたファクトリの 1 つが NamingException をスローした場合
Exception - アクセスしたファクトリの 1 つが例外をスローした場合、またはファクトリおよびオブジェクトクラスのロードおよびインスタンス化中にエラーが見つかった場合。ファクトリは、オブジェクト生成にほかのファクトリを使用したくない場合に限り例外をスローするようにする。DirObjectFactory.getObjectInstance() を参照
導入されたバージョン:
1.3
関連項目:
NamingManager.getURLContext(java.lang.String, java.util.Hashtable), DirObjectFactory, DirObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)

getStateToBind

public static DirStateFactory.Result getStateToBind(Object obj,
                                                    Name name,
                                                    Context nameCtx,
                                                    Hashtable<?,?> environment,
                                                    Attributes attrs)
                                             throws NamingException
元のオブジェクトおよびその属性が指定されたときに、オブジェクトのバインディングの状態を取得します。

このメソッドは NamingManager.getStateToBind に似ていますが、以下の点が違います。

NamingManager.getStateToBind() インタフェースではなく DirContext インタフェースを実装しているサービスプロバイダをこのメソッドに使います。

試行する状態ファクトリのリストを決定する方法の説明については、NamingManager.getStateToBind() を参照してください。

このメソッドによって返されるオブジェクトは呼び出し側が所有します。実装はその後このオブジェクトを変更しません。実装は、呼び出し側が所有するのと同じ新しい Attributes オブジェクトか、元の attrs パラメータへの参照のどちらかを含みます。

パラメータ:
obj - バインドする状態の取得対象となる null 以外のオブジェクト
name - nameCtx に関連するこのオブジェクトの名前、または名前が指定されない場合は null
nameCtx - name パラメータの指定に関連するコンテキスト、または name がデフォルトの初期コンテキストに関連する場合は null
environment - 状態ファクトリおよびオブジェクトの状態の生成に使用される、null の可能性がある環境
attrs - null の可能性がある、オブジェクトにバインドされる Attribute
戻り値:
null 以外の DirStateFactory。結果にはバインドされるオブジェクトおよび属性を含む。null 以外の答えを返す状態ファクトリがない場合、結果はオブジェクト (obj) 自体を元の属性とともに含む
例外:
NamingException - ファクトリを使用中にネーミング例外が見つかった場合。ファクトリは、オブジェクト生成にほかのファクトリを使用したくない場合に限り例外をスローするようにする。DirStateFactory.getStateToBind() を参照
導入されたバージョン:
1.3
関連項目:
DirStateFactory, DirStateFactory.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes), NamingManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。