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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策