public class JndiTemplate extends ObjectSE
JndiCallback
インターフェースの実装が、提供された JNDI ネーミングコンテキストで任意の操作を実行できるようにします。JndiCallback
, execute(org.springframework.jndi.JndiCallback<T>)
コンストラクターと説明 |
---|
JndiTemplate() 新しい JndiTemplate インスタンスを作成します。 |
JndiTemplate(PropertiesSE environment) 指定された環境を使用して、新しい JndiTemplate インスタンスを作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
void | bind(StringSE name, ObjectSE object) 指定された名前を使用して、指定されたオブジェクトを現在の JNDI コンテキストにバインドします。 |
protected ContextSE | createInitialContext() 新しい JNDI 初期コンテキストを作成します。 |
<T> T | execute(JndiCallback<T> contextCallback) 指定された JNDI コンテキストコールバック実装を実行します。 |
ContextSE | getContext() このテンプレートの構成に対応する JNDI コンテキストを取得します。 |
PropertiesSE | getEnvironment() JNDI InitialContext の環境があれば、それを返します。 |
ObjectSE | lookup(StringSE name) 現在の JNDI コンテキストで指定された名前のオブジェクトを検索します。 |
<T> T | lookup(StringSE name, ClassSE<T> requiredType) 現在の JNDI コンテキストで指定された名前のオブジェクトを検索します。 |
void | rebind(StringSE name, ObjectSE object) 指定された名前を使用して、指定されたオブジェクトを現在の JNDI コンテキストに再バインドします。 |
void | releaseContext(ContextSE ctx) getContext() から取得した JNDI コンテキストを解放します。 |
void | setEnvironment(PropertiesSE environment) JNDI InitialContext の環境を設定します。 |
void | unbind(StringSE name) 現在の JNDI コンテキストから指定された名前のバインディングを削除します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
protected final Log logger
public JndiTemplate()
public JndiTemplate(@Nullable PropertiesSE environment)
public void setEnvironment(@Nullable PropertiesSE environment)
@Nullable public PropertiesSE getEnvironment()
@Nullable public <T> T execute(JndiCallback<T> contextCallback) throws NamingExceptionSE
contextCallback
- 使用する JndiCallback 実装 null
NamingExceptionSE
- コールバック実装によってスローされます createInitialContext()
public ContextSE getContext() throws NamingExceptionSE
execute(org.springframework.jndi.JndiCallback<T>)
によって呼び出されます。直接呼び出すこともできます。 デフォルトの実装は createInitialContext()
に委譲します。
null
)NamingExceptionSE
- コンテキストの取得に失敗した場合 releaseContext(javax.naming.Context)
public void releaseContext(@Nullable ContextSE ctx)
getContext()
から取得した JNDI コンテキストを解放します。ctx
- リリースする JNDI コンテキスト (null
の場合があります)getContext()
protected ContextSE createInitialContext() throws NamingExceptionSE
getContext()
によって呼び出されます。デフォルトの実装では、このテンプレートの環境設定を使用します。カスタムコンテキスト用にサブクラス化できます。テスト用。
NamingExceptionSE
- 初期化エラーの場合 public ObjectSE lookup(StringSE name) throws NamingExceptionSE
name
- オブジェクトの JNDI 名 null
にすることはできません。正常に動作しない JNDI 実装が null を返す場合、NamingException がスローされます)NamingExceptionSE
- JNDI にバインドされた特定の名前のオブジェクトがない場合 public <T> T lookup(StringSE name, @Nullable ClassSE<T> requiredType) throws NamingExceptionSE
name
- オブジェクトの JNDI 名 requiredType
- JNDI オブジェクトが一致する必要がある型。実際のクラスのインターフェースまたはスーパークラス、または一致する場合は null
を指定できます。例: 値が Object.class
の場合、このメソッドは返されたインスタンスのクラスが何であっても成功します。null
にすることはできません。正常に動作しない JNDI 実装が null を返す場合、NamingException がスローされます)NamingExceptionSE
- JNDI にバインドされた特定の名前のオブジェクトがない場合 public void bind(StringSE name, ObjectSE object) throws NamingExceptionSE
name
- オブジェクトの JNDI 名 object
- バインドするオブジェクト NamingExceptionSE
- JNDI によってスローされ、ほとんどの名前はすでにバインドされています public void rebind(StringSE name, ObjectSE object) throws NamingExceptionSE
name
- オブジェクトの JNDI 名 object
- 再バインドするオブジェクト NamingExceptionSE
- JNDI によってスローされます public void unbind(StringSE name) throws NamingExceptionSE
name
- オブジェクトの JNDI 名 NamingExceptionSE
- JNDI によってスローされ、ほとんどの場合、名前が見つかりません