モジュールjava.naming


モジュールjava.naming
Java Naming and Directory Interface (JNDI) APIを定義します。

JNDIプロバイダでサポートされる可能性のある共通の標準JNDI環境プロパティは、Contextで定義およびドキュメント化されています。 特定のJNDIプロバイダの実装は、実装に固有の他の環境またはシステム・プロパティもサポートする場合があります。

実装上のノート:
JDKのデフォルトのLDAPネーミング・サービス・プロバイダ実装では、次の実装固有の環境プロパティがサポートされています:
  • com.sun.jndi.ldap.connect.timeout:
    このプロパティの値は、接続タイムアウト(ミリ秒)を表す整数の文字列表現です。
    LDAPプロバイダがこの値の期間中に接続を確立できないと、接続の試行は中止されます。 整数は0より大きい必要があります。 0以下の整数を指定した場合は、TCPなどのネットワーク・プロトコルのタイム・アウト値が使用されます。
    このプロパティが指定されない場合は、接続が確立されるのを待機するか、またはベースとなるネットワークのタイム・アウトまで待機します。
  • com.sun.jndi.ldap.read.timeout:
    このプロパティの値は、LDAP演算の読取りタイムアウト(ミリ秒)を表す整数の文字列表現です。
    LDAPプロバイダがこの値の期間中にLDAP応答を取得できないと、読取りの試行は中止されます。 整数は0より大きい必要があります。 0以下の整数は、読取りタイム・アウトが指定されていないことを表し、応答があるまで無限に待機するということです。
    このプロパティを指定しないと、デフォルトは応答があるまで待つという設定になります。
  • com.sun.jndi.ldap.tls.cbtype:
    このプロパティの値は、SSL/TLS経由のLDAP接続に必要なTLSチャネル・バインディング・タイプを表す文字列です。
    可能な値は次のとおりです :
    • "tls-server-end-point" - チャネル・バインディング・データはTLSサーバー証明書に基づいて作成されます。

    "tls-unique" TLSチャネル・バインド・タイプがRFC-5929で指定されていますが、サポートされていません。

    このプロパティを指定しない場合、クライアントはチャネル・バインディング情報をサーバーに送信しません。

JDKのデフォルトのLDAPネーミング・サービス・プロバイダ実装では、次の実装固有のシステム・プロパティがサポートされています:

  • com.sun.jndi.ldap.object.trustSerialData:
    このシステム・プロパティの値は、'javaSerializedData' LDAP属性からのjavaオブジェクトの直列化復元を制御できるブール値の文字列表現です。
    'javaSerializedData'属性からのjavaオブジェクトの直列化復元を防ぐために、システム・プロパティ値を'false'に設定できます。
    プロパティが指定されていない場合、'javaSerializedData'属性からのjavaオブジェクトの直列化復元が許可されます。
  • jdk.jndi.object.factoriesFilter:
    このシステム・プロパティの値は、JNDIランタイム実装によって使用されるフィルタを定義して、ネーミング/ディレクトリ・システムによって返されるオブジェクト参照からオブジェクトをインスタンス化できる一連のオブジェクト・ファクトリ・クラスを制御します。
    参照インスタンスで指定されたファクトリ・クラスがこのフィルタと照合されます。 フィルタ・プロパティは、jdk.serialFilterと同じ形式でパターン・ベースのフィルタ構文をサポートします。 このプロパティは、「セキュリティ・プロパティ」と指定することもできます。 このプロパティは、「デフォルトのJNDI RMIプロバイダ」でもサポートされています。
    デフォルト値では、参照インスタンスで指定されたオブジェクト・ファクトリ・クラスによって、参照オブジェクトを再作成できます。

他のプロバイダは、モジュールの説明に追加のプロパティを定義できます:

モジュール・グラフ:
java.namingのモジュール・グラフjava.namingのモジュール・グラフ
導入されたバージョン:
9
  • パッケージ

    エクスポート
    パッケージ
    説明
    ネーム・サービスにアクセスするためのクラスおよびインタフェースを提供します。
    javax.namingパッケージを拡張して、ディレクトリ・サービスにアクセスする機能を提供します。
    ネーミングおよびディレクトリ・サービスにアクセスする場合、イベント通知のサポートを提供します。
    LDAPv3の拡張操作とコントロールのサポートを提供します。
     
    javax.namingおよび関連パッケージを使用して、ネーミングおよびディレクトリ・サービスにアクセスするためのサポートを動的にプラグインする手段を提供します。
  • サービス

    使用
    説明
    LDAP操作を実行するときのDNSルックアップのサービス提供クラス。