コメントの送付先: jndi@java.sun.com
目次
DNS サービスプロバイダによって、JNDI アプリケーションが、インターネットドメインネームシステムに格納された情報にアクセスできるようになります。このプロバイダには、JNDI ディレクトリコンテキストのツリーとしての DNS 名前空間と、JNDI の属性としての DNS リソースレコードが用意されています。
このドキュメントでは、DNS サービスプロバイダの機能と、DNS が JNDI にマッピングされる方法の詳細について説明します。
DNS サービスプロバイダはドメインネームシステムをサポートします。 その規定は、RFC 1034、RFC 1035 およびその更新と明細は RFC 1123、 RFC 2181 に記述されています。現在のところ、次のリソースレコードの型とクラスをサポートしています。
それぞれの検索は、最初に UDP を使用して実行されます。応答が長すぎて、切り捨てないと UDP パケットに返すことができない場合は、TCP を使用して検索が繰り返されます。
型 仕様 A RFC 1035: NS RFC 1035: CNAME RFC 1035: SOA RFC 1035: PTR RFC 1035: MX RFC 1035: TXT RFC 1035: HINFO RFC 1035: AAAA RFC 1886: NAPTR RFC 2915: SRV RFC 2782:
クラス 仕様 IN RFC 1035: HS RFC 1035:
DNS サービスプロバイダでは、次の JNDI 環境プロパティーを使用します。初期コンテキストコンストラクタ、システムプロパティー、アプレットパラメータ、およびリソースファイルを使用してプロパティーを初期化する方法については、「JNDI のドキュメント」を参照してください。
java.naming.authoritative
このプロパティーは、すべての応答が権限をもっている必要があるかどうかを指定するために使用します。この値が true の場合、権限のある応答のみを DNS サーバーから受け入れます。その他の場合は、すべての応答を受け入れます。このプロパティーが設定されない場合は、デフォルト値の false が使用されます。すべての応答が権限をもつ必要があることを指定する場合の例を示します。権限のある応答のみが返されるように要求した場合、一部の情報が利用できなくなる場合があります。これは、DNS プロトコルが権限をもっている情報を要求する方法を提供していないためです。たとえば、DNS サービスプロバイダがクエリの結果として権限のないデータを取得した場合は、権限のあるデータのみを返すため、そのデータを破棄します。env.put(Context.AUTHORITATIVE, "true");
java.naming.factory.initial
DNS サービスプロバイダを選択するときに、初期コンテキストとして使用されます。プロバイダでは使用されません。プロバイダの初期コンテキストファクトリのクラス名を指定し、次の例のように設定できます。env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.dns.DnsContextFactory");
java.naming.factory.object
このプロパティーには、DNS から読み取られたオブジェクトを変換するための、オブジェクトファクトリクラスの完全修飾名のリストが含まれます。各クラス名はコロンで区切ります。この機構を使用して、アプリケーションでより使いやすい形式のオブジェクトに変換されます。詳細については、DirectoryManager.getObjectInstance() を参照してください。
java.naming.provider.url
初期 DNS コンテキストで使用される DNS サーバーのホスト名とポートのほかに、初期コンテキストのドメイン名を指定します。URL 形式の詳細については、下の「DNS の擬似 URL」を参照してください。例を示します。
プロバイダが server1.sun.com にある DNS サーバーを使用するようにして、初期コンテキストのドメイン名を java.sun.com に設定します。このプロパティーが設定されない場合、デフォルト値の「dns:」が使用されます。(使用されるデフォルト値は、「DNS の擬似 URL」セクションに記載されています。)env.put(Context.PROVIDER_URL, "dns://server1.sun.com/java.sun.com");このプロパティーに空白文字で区切った URL のリストを指定して、複数の DNS サーバーを指定できます。サーバーの 1 つが応答するまで、各サーバーに順番に接続します。初期コンテキストには 1 つのドメイン名しか含まれていないため、複数の URL を指定する場合は、それぞれのドメイン部分が同じである必要があります。例を示します。
env.put(Context.PROVIDER_URL, "dns://server1.sun.com/java.sun.com dns://server2.sun.com/java.sun.com");
com.sun.jndi.dns.lookup.attr
デフォルトでは、JNDI が DNS コンテキストでオブジェクトファクトリを呼び出す前に、コンテキストのインターネット TXT 属性を読み取り、ファクトリに渡します。このプロパティーは、設定する場合は、使用する別の属性識別子を指定します。属性識別子の形式については、次の「DNS コンテンツの JNDI へのマッピング」を参照してください。
com.sun.jndi.dns.recursion
このプロパティーは、DNS クエリーで回帰を許可しないことを指定するために使用します。このプロパティーが設定されていない場合や、「true」に設定されている場合、回帰を許可します。その他の場合は、回帰を許可しません。DNS クエリーでの回帰を許可しないことを指定する場合の例を示します。env.put("com.sun.jndi.dns.recursion", "false");
com.sun.jndi.dns.timeout.initial com.sun.jndi.dns.timeout.retries
これらのプロパティーは、DNS プロバイダが UDP クエリーの発行時に使用するタイムアウト関連のデフォルトを変更する場合に使用されます。DNS プロバイダは、次の指数バックオフアルゴリズムを使用して UDP クエリーを発行します。プロバイダは、DNS サーバーにクエリーを発行して、タイムアウト期間内 (デフォルトでは 1 秒) に応答が到着するのを待機します。プロバイダにタイムアウト期間内に応答が到着しなかった場合、プロバイダは次のサーバーにクエリーを発行し、応答を受け取るまで、これを繰り返します。プロバイダがどのサーバーからも応答を受け取らなかった場合、タイムアウト期間を 2 倍にし、リトライの最大回数まで (デフォルトでは 4 回) 各サーバーにクエリーを発行するプロセスを繰り返します。com.sun.jndi.dns.timeout.initial」プロパティーが設定されている場合、初期タイムアウト期間 (すなわち 2 倍にする前の期間) として使用する数値 (ミリ秒) を指定します。このプロパティーが設定されない場合は、デフォルトの初期タイムアウトは 1000 ミリ秒です。
com.sun.jndi.dns.timeout.retries」プロパティーが設定されている場合、上記の指数バックオフアルゴリズムを使用して各サーバーに対してリトライする回数を指定します。このプロパティーが設定されない場合は、デフォルトのリトライ回数は 4 です。
次の例では、タイムアウトの合計の長さをあまり変えずに、初期タイムアウト期間を 2 倍にしています。
env.put("com.sun.jndi.dns.timeout.initial", "2000"); env.put("com.sun.jndi.dns.timeout.retries", "3");注 - Java 2 SDK、v 1.4.1 より前のシステムでは、上記の 2 つのプロパティーは無視され、常にデフォルトが適用されます。
ホスト名はドメイン名のサブセットです。ホスト名のラベルには、US-ASCII 文字、数字、ハイフンのみが使用でき、先頭または末尾にハイフンは使用できません。これらの規則に従っていない名前はドメイン名として有効になる場合もありますが、一部の DNS アプリケーションで使用できないため、ほとんどの場合、このような名前の使用は避けるべきです。
DNS では、US-ASCII 以外の文字に使用するための (UTF-8 などの) エンコーディングを指定していません。その結果、DNS 名の文字がゼロ以外の高位のバイトを使用することはありません。ドメイン名の国際化の作業が終了した時点で、その作業に合わせて DNS サービスプロバイダを更新することができます。
同じ型の複数のレコードは、複数の値がある属性として表現されます。サポートされないレコード型は、数字の識別子およびバイト列の値で表現されます。
DNS リソースレコードのクラス名と型名が、JNDI 属性識別子にマッピングされます。レコードがインターネットクラスの場合、対応する属性 ID はレコードの型名です。サポートされない型の場合は、代わりに整数値が使用されます。レコードがインターネットクラスでない場合は、クラス名 (または整数のクラス値) が、空白文字で区切られて属性 ID に付加されます。たとえば、属性識別子の「AAAA」で IPv6 アドレスレコードが表現され、属性識別子「HS 97」で Hesiod クラスの 97 型のリソースレコードが表現されます。
また、「スーパークラス」属性識別子も定義されます。DirContext.getAttributes() メソッドを使用してレコードを問い合わせる際に、これらの識別子が便利な場合があります。属性名で型名またはクラス名の代わりに「*」がある場合は、任意の型またはクラスのレコードであることを表します。たとえば、属性識別子の「IN *」を getAttributes() メソッドに渡せば、インターネットクラスのすべてのレコードを検出できます。属性識別子「* *」は、任意のクラスまたはタイプを表しています。
属性識別子では、大文字と小文字は区別されません。
dns:[//host[:port]][/domain]「host」および「port」で、使用する DNS サーバーを示します。「host」のみが指定されている場合、ポートにはデフォルトの 53 が使用され、「port」のみが指定されている場合、ホストはデフォルトの「localhost」になります。いずれも指定されない場合、プロバイダは基本プラットフォーム用に構成されたサーバーを判断し、このサーバーの使用を試みます。これに成功した場合、プロバイダは java.naming.provider.url プロパティーを、サーバーで構築されたスペース区切りの URL リストに設定します (たとえば、Solaris または Linux の場合、プロバイダは /etc/resolv.conf ファイルを読み込む)。DNS が基本プラットフォームに設定されていない場合、ホストとポートはデフォルトの「localhost」と 53 になります。
注 - Java 2 SDK、v 1.4.1 より前のシステムでは、プロバイダは基本プラットフォームの DNS 設定の使用を試みません。ホストもポートも指定されていない場合、ホストとポートはデフォルトの「localhost」と 53 になります。
「domain」はコンテキストの DNS ドメイン名であり、必ずしもサーバーのドメインに関連付けられている必要はありません。 デフォルトは「.」です。(ルートドメイン) を使用します。(ルートドメイン) を使用します。
addToEnvironment()
新しいプロパティーを環境に追加するか、既存のプロパティーを変更します。
close()
内部データ構造を解放します。
composeName()
2 つの名前を重ね合わせます。
getAttributes()
DNS リソースレコードを表す属性を返します。
getEnvironment()
このコンテキストに関連する環境プロパティーを返します。
getNameInNamespace()
このノードの完全修飾ドメイン名を返します。
getNameParser()
DNS ドメイン名を解析するために、名前パーサーを返します。
lookup() lookupLink()
指定されたノードを表す DirContext を返します。アプリケーションまたはユーザーがオブジェクトファクトリを供給していた場合は、返される前にオブジェクトで DirectoryManager.getObjectInstance() メソッドが呼び出されます。
list() listBindings()
DNS 名前空間のリストがゾーン転送を使用して実装されているので、これらの操作はコンピュータおよびネットワークに集中し、すべての DNS インストールではサポートされない可能性があります。アプリケーションまたはユーザーがオブジェクトファクトリを供給していた場合は、返される前にオブジェクトで DirectoryManager.getObjectInstance() メソッドが呼び出され、属性は渡されません。
removeFromEnvironment()
環境からプロパティーを削除します。
Hashtable env = new Hashtable();
env.put("java.naming.factory.initial", "com.sun.jndi.dns.DnsContextFactory");
env.put("java.naming.provider.url", "dns://server1.sun.com/sun.com");
DirContext ictx = new InitialDirContext(env);
Attributes attrs1 = ictx.getAttributes("host1", new String[] {"A"});
Attributes attrs2 = ictx.getAttributes("host2", new String[] {"A"});
DirContext ictx = new InitialDirContext();
Attributes attrs3 = ictx.getAttributes("dns://server1.sun.com/host3.sun.com",
new String[] {"MX"});
permission java.net.SocketPermission "host[:port]", "connect,accept";各ホストまたはポートは、java.naming.provider.url プロパティー、コンテキストメソッドに渡された URL 文字列名、およびオブジェクト参照から識別されます。
たとえば、次の例では、次のネームシステムのルートのリストを出力しています。このネームシステムは、DNS コンテキストを超えて連合されています。次に、マルチコンポーネントの複合名を使用して名前が参照されます。
// List the root of the nns.
// Note the use of a trailing slash to indicate traversal into the nns.
NamingEnumeration enum = ctx.list("java.sun.com/");
// A composite name lookup.
Object obj = ctx.lookup("sun.com/some/x/y/z");