javax.security.auth.kerberos
類別 KerberosPrincipal

java.lang.Object
  javax.security.auth.kerberos.KerberosPrincipal

所有已實作的介面：

Serializable, Principal

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 是否相等。
String	getName() 返回的字元串對應於 Kerberos Principal 名稱的 single-string 表示形式，RFC 1964 的 2.1 小節中指定了這種表示形式。
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 Requirements

參數：

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 Requirements 。

參數：

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()

另請參見：

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object other)

比較指定的物件與此 Principal 是否相等。如果給定對象也是一個 KerberosPrincipal 並且兩個 KerberosPrincipal 實例是等效的，則返回 true。更正式地說，如果 getName() 返回的值是相等的並且 getNameType() 返回的值也是相等的，則兩個 KerberosPrincipal 實例是相等的。

指定者：

介面 Principal 中的 equals

覆寫：

類別 Object 中的 equals

參數：

other - 要與之進行比較的 Object

返回：

如果傳入的 Object 和此物件表示相同的主體，則返回 true；否則返回 false。

另請參見：

Object.hashCode(), Hashtable

getName

public String getName()

返回的字元串對應於 Kerberos Principal 名稱的 single-string 表示形式，RFC 1964 的 2.1 小節中指定了這種表示形式。

指定者：

介面 Principal 中的 getName

返回：

主體名稱。

getNameType

public int getNameType()

返回 KerberosPrincipal 的名稱型別。 RFC1510 的 7.2 小節中指定了有效的名稱型別。

返回：

名稱型別。

toString

public String toString()

從類別 Object 複製的描述

返回該物件的字元串表示。通常，toString 方法會返回一個「以文本方式表示」此物件的字元串。結果應是一個簡明但易於讀懂的資訊表達式。建議所有子類別都覆寫此方法。

Object 類別的 toString 方法返回一個字元串，該字元串由類別名（物件是該類別的一個實例）、at 標記符“@”和此物件雜湊碼的無符號十六進製表示組成。換句話說，該方法返回一個字元串，它的值等於：

getClass().getName() + '@' + Integer.toHexString(hashCode())
 

指定者：

介面 Principal 中的 toString

覆寫：

類別 Object 中的 toString

返回：

該物件的字元串表示形式。