JavaTM 2
Platform
Std. Ed. v1.4.0

javax.security.auth.kerberos
クラス KerberosPrincipal

java.lang.Object
  |
  +--javax.security.auth.kerberos.KerberosPrincipal
すべての実装インタフェース:
Principal, Serializable

public final class KerberosPrincipal
extends Object
implements Principal, Serializable

このクラスは Kerberos 主体をカプセル化します。

導入されたバージョン:
1.4
関連項目:
直列化された形式

フィールドの概要
static int KRB_NT_PRINCIPAL
          ユーザ主体の名前タイプです。
static int KRB_NT_SRV_HST
          インスタンス (telnet、rcommands) の名前タイプとしてホスト名を保持するサービスです。
static int KRB_NT_SRV_INST
          サービスやそのほかの固有インスタンス (krbtgt) の名前タイプです。
static int KRB_NT_SRV_XHST
          残りのコンポーネント名前タイプのホストを保持するサービスです。
static int KRB_NT_UID
          一意の ID 名前タイプです。
static int KRB_NT_UNKNOWN
          不明な名前タイプです。
 
コンストラクタの概要
KerberosPrincipal(String name)
          指定した文字列入力で KerberosPrincipal を構築します。
KerberosPrincipal(String name, int nameType)
          指定した文字列と名前タイプの入力で KerberosPrincipal を構築します。
 
メソッドの概要
 boolean equals(Object other)
          この Principal と指定した Object が等しいかどうかを比較します。
 String getName()
          返される文字列は、RFC 1964 のセクション 2.1 で指定されている Kerberos Principal 名の単一文字列表現に対応します。
 int getNameType()
          KerberosPrincipal の名前タイプを返します。
 String getRealm()
          この Kerberos 主体の領域コンポーネントを返します。
 int hashCode()
          この主体のハッシュコードを返します。
 String toString()
          主体の文字列表現を返します。
 
クラス java.lang.Object から継承したメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

KRB_NT_UNKNOWN

public static final int KRB_NT_UNKNOWN
不明な名前タイプです。

関連項目:
定数フィールド値

KRB_NT_PRINCIPAL

public static final int KRB_NT_PRINCIPAL
ユーザ主体の名前タイプです。

関連項目:
定数フィールド値

KRB_NT_SRV_INST

public static final int KRB_NT_SRV_INST
サービスやそのほかの固有インスタンス (krbtgt) の名前タイプです。

関連項目:
定数フィールド値

KRB_NT_SRV_HST

public static final int KRB_NT_SRV_HST
インスタンス (telnet、rcommands) の名前タイプとしてホスト名を保持するサービスです。

関連項目:
定数フィールド値

KRB_NT_SRV_XHST

public static final int KRB_NT_SRV_XHST
残りのコンポーネント名前タイプのホストを保持するサービスです。

関連項目:
定数フィールド値

KRB_NT_UID

public static final int KRB_NT_UID
一意の ID 名前タイプです。

関連項目:
定数フィールド値
コンストラクタの詳細

KerberosPrincipal

public KerberosPrincipal(String name)
指定した文字列入力で KerberosPrincipal を構築します。この主体の名前タイプは、デフォルトで KRB_NT_PRINCIPAL です。この文字列は RFC 1964 のセクション 2.1.1 (Kerberos Principal Name Form) で指定された形式の名前を含む必要があります (たとえば duke@FOO.COM。ここで duke は主体、FOO.COM は領域を表す)。

入力した名前に領域が含まれない場合は、デフォルトの領域が使用されます。デフォルトの領域は Kerberos 構成ファイルか、java.security.krb5.realm システムプロパティで指定されます。詳細は、「Kerberos 要件」 を参照してください。

パラメータ:
name - 主体名
例外:
IllegalArgumentException - 名前の形式が正しくない場合、名前が null の場合、あるいは、名前に使用できる領域が含まれず、かつデフォルトの領域が Kerberos 構成ファイルでも java.security.krb5.realm でも指定されていない場合

KerberosPrincipal

public KerberosPrincipal(String name,
                         int nameType)
指定した文字列と名前タイプの入力で KerberosPrincipal を構築します。この文字列は RFC 1964 のセクション 2.1 (Mandatory Name Forms) で指定された形式の名前を含む必要があります。有効な名前タイプは、RFC 1510 のセクション 7.2 (Principal Names) で定義されています。入力名は、指定した名前タイプと矛盾しないようにしなければなりません (たとえば duke@FOO.COM は名前タイプ KRB_NT_PRINCIPAL に対して有効な入力文字列。ここで duke は主体、FOO.COM は領域を表す)。

入力した名前に領域が含まれない場合は、デフォルトの領域が使用されます。デフォルトの領域は Kerberos 構成ファイルか、java.security.krb5.realm システムプロパティで指定されます。詳細は、「Kerberos 要件」 を参照してください。

パラメータ:
name - 主体名
nameType - 主体の名前タイプ
例外:
IllegalArgumentException - 名前の形式が正しくない場合、名前が null の場合、nameType がサポートされていない場合、あるいは、名前に使用できる領域が含まれず、かつデフォルトの領域が Kerberos 構成ファイルでも java.security.krb5.realm でも指定されていない場合
メソッドの詳細

getRealm

public String getRealm()
この Kerberos 主体の領域コンポーネントを返します。

戻り値:
この Kerberos 主体の領域コンポーネント

hashCode

public int hashCode()
この主体のハッシュコードを返します。ハッシュコードは、次の計算の結果として定義されます。

  hashCode = getName().hashCode();
 

定義:
インタフェース Principal 内の hashCode
オーバーライド:
クラス Object 内の hashCode
戻り値:
この KerberosPrincipal の hashCode()

equals

public boolean equals(Object other)
この Principal と指定した Object が等しいかどうかを比較します。指定したオブジェクトが KerberosPrincipal であり、2 つの KerberosPrincipal インスタンスが等価である場合に true を返します。より正確には、getName() で返される値が等しく、getNameType() で返される値が等しい場合、2 つの KerberosPrincipal インスタンスは等しいと言えます。

定義:
インタフェース Principal 内の equals
オーバーライド:
クラス Object 内の equals
パラメータ:
other - 比較対象の Object
戻り値:
渡された Object がこの主体と同じ主体を表す場合は true、そうでない場合は false

getName

public String getName()
返される文字列は、RFC 1964 のセクション 2.1 で指定されている Kerberos Principal 名の単一文字列表現に対応します。

定義:
インタフェース Principal 内の getName
戻り値:
主体名

getNameType

public int getNameType()
KerberosPrincipal の名前タイプを返します。有効な名前タイプは、 RFC1510 のセクション 7.2 で指定されています。

戻り値:
名前タイプ

toString

public String toString()
インタフェース Principal の記述:
主体の文字列表現を返します。

定義:
インタフェース Principal 内の toString
オーバーライド:
クラス Object 内の toString
戻り値:
主体の文字列表現

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.