当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

KerberosPrincipal (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

返回：

该对象的字符串表示形式。

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。