SimpleNamingContextBuilder (Spring Framework API)

java.lang.ObjectSE
- org.springframework.mock.jndi.SimpleNamingContextBuilder

実装されたすべてのインターフェース:
InitialContextFactoryBuilderSE
使用すべきではありません。
Spring Framework 5.2 の時点で非推奨、Simple-JNDI などのサードパーティからの完全なソリューションを推奨
```
@DeprecatedSE
public class SimpleNamingContextBuilder
extends ObjectSE
implements InitialContextFactoryBuilderSE
```
JNDI ネーミングコンテキストビルダーのシンプルな実装。
new InitialContext() が必要なオブジェクトを公開するように、各テストケースが JNDI を適切に構成できるテスト環境を主に対象としています。スタンドアロンアプリケーションにも使用できます。JDBC DataSource を既知の JNDI ロケーションにバインドして、Java EE コンテナーの外部で従来の Java EE データアクセスコードを使用できるようにします。
DataSource 実装にはさまざまな選択肢があります。
- SingleConnectionDataSource (すべての getConnection 呼び出しに同じ接続を使用する)
- DriverManagerDataSource (各 getConnection 呼び出しで新しい接続を作成する)
- Apache のコモンズ DBCP は org.apache.commons.dbcp.BasicDataSource を提供します (実際のプール)
ブートストラップコードの典型的な使用箇所:
```
 SimpleNamingContextBuilder builder = new SimpleNamingContextBuilder();
 DataSource ds = new DriverManagerDataSource(...);
 builder.bind("java:comp/env/jdbc/myds", ds);
 builder.activate();
```
JNDI の制限により、同じ JVM 内で複数の Builder をアクティブにすることはできないことに注意してください。新しいビルダーを繰り返し構成するには、次のコードを使用して、すでにアクティブ化されているビルダーまたは新しくアクティブ化されたビルダーへの参照を取得します。
```
 SimpleNamingContextBuilder builder = SimpleNamingContextBuilder.emptyActivatedContextBuilder();
 DataSource ds = new DriverManagerDataSource(...);
 builder.bind("java:comp/env/jdbc/myds", ds);
```
このファクトリメソッドからビルダーで activate() を呼び出すべきではないことに注意してください。いずれにしても、すでにアクティブ化されているものがあるからです。
このクラスのインスタンスは、セットアップ時にのみ必要です。アプリケーションは、アクティベーション後に参照を保持する必要はありません。
作成者:
Juergen Hoeller, Rod Johnson
関連事項:
emptyActivatedContextBuilder(), bind(String, Object), activate(), SimpleNamingContext, SingleConnectionDataSource, DriverManagerDataSource

コンストラクターのサマリー
コンストラクター
コンストラクターと説明
SimpleNamingContextBuilder()
使用すべきではありません。

コンストラクター
コンストラクターと説明
`SimpleNamingContextBuilder()` 使用すべきではありません。

メソッドのサマリー

すべてのメソッド静的メソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`void`	`activate()` 使用すべきではありません。 JNDI NamingManager に登録して、コンテキストビルダーを登録します。
`void`	`bind(StringSE name, ObjectSE obj)` 使用すべきではありません。このコンテキストビルダーが生成するすべてのネーミングコンテキストについて、指定されたオブジェクトを指定された名前でバインドします。
`void`	`clear()` 使用すべきではありません。アクティブにしたまま、このコンテキストビルダーのすべてのバインディングをクリアします。
`InitialContextFactorySE`	`createInitialContextFactory(HashtableSE<?,?> environment)` 使用すべきではありません。新しい SimpleNamingContext インスタンスを作成する、シンプルな InitialContextFactoryBuilder 実装。
`void`	`deactivate()` 使用すべきではありません。このコンテキストビルダーを一時的に無効にします。
`static SimpleNamingContextBuilder`	`emptyActivatedContextBuilder()` 使用すべきではありません。すでに SimpleNamingContextBuilder が JNDI を構成していない場合は、作成してアクティブ化します。
`static SimpleNamingContextBuilder`	`getCurrentContextBuilder()` 使用すべきではありません。 SimpleNamingContextBuilder がアクティブかどうかを確認します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - SimpleNamingContextBuilder
```
public SimpleNamingContextBuilder()
```
    使用すべきではありません。
- メソッドの詳細
  - getCurrentContextBuilder
```
@Nullable
public static SimpleNamingContextBuilder getCurrentContextBuilder()
```
    使用すべきではありません。
    SimpleNamingContextBuilder がアクティブかどうかを確認します。
    戻り値:
    現在の SimpleNamingContextBuilder インスタンス、または存在しない場合は null
  - emptyActivatedContextBuilder
```
public static SimpleNamingContextBuilder emptyActivatedContextBuilder()
                                                               throws NamingExceptionSE
```
    使用すべきではありません。
    すでに SimpleNamingContextBuilder が JNDI を構成していない場合は、作成してアクティブ化します。そうでない場合は、既存のアクティブ化された SimpleNamingContextBuilder を取り出し、クリアしてから返します。
    これは主に、JNDI バインディングをゼロから繰り返し再初期化するテストスイートを対象としています。
    戻り値:
    JNDI バインディングの制御に使用できる空の SimpleNamingContextBuilder
    例外:
    NamingExceptionSE
  - activate
```
public void activate()
              throws IllegalStateExceptionSE,
                     NamingExceptionSE
```
    使用すべきではありません。
    JNDI NamingManager に登録して、コンテキストビルダーを登録します。これが完了すると、new InitialContext() は常にこのファクトリからコンテキストを返すことに注意してください。emptyActivatedContextBuilder() 静的メソッドを使用して、空のコンテキストを取得します（たとえば、テストメソッドで）。
    例外:
    IllegalStateExceptionSE - JNDI NamingManager に登録されているネーミングコンテキストビルダーがすでにある場合
    NamingExceptionSE
  - deactivate
```
public void deactivate()
```
    使用すべきではありません。
    このコンテキストビルダーを一時的に無効にします。JNDI NamingManager に登録されたままですが、バインドされたオブジェクトを公開する代わりに、標準の JNDI InitialContextFactory（設定されている場合）に委譲します。
    このコンテキストビルダーのバインドされたオブジェクトを再度公開するには、activate() を再度呼び出します。このようなアクティブ化 / 非アクティブ化シーケンスは、何度でも適用できます（たとえば、同じ VM で実行されるより大きな統合テストスイート内）。
    関連事項:
    activate()
  - clear
```
public void clear()
```
    使用すべきではありません。
    アクティブにしたまま、このコンテキストビルダーのすべてのバインディングをクリアします。
  - bind
```
public void bind(StringSE name,
                 ObjectSE obj)
```
    使用すべきではありません。
    このコンテキストビルダーが生成するすべてのネーミングコンテキストについて、指定されたオブジェクトを指定された名前でバインドします。
    パラメーター:
    name - オブジェクトの JNDI 名 (たとえば "java:comp/env/jdbc/myds" )
    obj - バインドするオブジェクト (たとえば DataSource 実装)
  - createInitialContextFactory
```
public InitialContextFactorySE createInitialContextFactory(@Nullable
                                                         HashtableSE<?,?> environment)
```
    使用すべきではありません。
    新しい SimpleNamingContext インスタンスを作成する、シンプルな InitialContextFactoryBuilder 実装。
    次で指定:
    インターフェース InitialContextFactoryBuilderSE の createInitialContextFactorySE
    関連事項:
    SimpleNamingContext

クラス SimpleNamingContextBuilder

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

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

SimpleNamingContextBuilder

メソッドの詳細

getCurrentContextBuilder

emptyActivatedContextBuilder

activate

deactivate

clear

bind

createInitialContextFactory