compact3

org.ietf.jgss

Interface GSSName

public interface GSSName

该接口封装单个GSS-API的主体。应用程序通过一个的 createName方法中存在的 GSSManager类获得此接口的实现。在一个gssname包含实体或许多原始名称元素多次交涉，其中一个支持机制。在GSS的术语，一个gssname包含从一个机构的元件称为机构名称（Mn）

由于不同的认证机制，可以采用不同的命名空间来识别他们的校长，支持GSS-API的命名必然是多机制环境复杂（甚至在某些单一的机制环境中的基础机制支持多个命名空间）。不同的名称格式和定义确定Oid's和一些标准类型是该接口定义。该名称的格式可以根据其名称类型独特的Oid衍生。

以下代码示例利用GSSName接口。下面的代码创建一个GSSName，将其转换为一个Mn，进行比较，得出一个可打印的名字表示，出口到一个字节数组，然后再进口来获得一个新的GSSName。

gssmanager经理= gssmanager。getinstance()；创建一个基于主机的服务名称gssname名称=经理。createname（“服务“宿主”，gssname nt_hostbased_service）；OID krb5 =新的OID（“1.2.840.113554.1.2.2”）；gssname mechname =名称规范（krb5）；上述两个步骤相当于以下两个步骤gssname mechname =经理。createname（“服务“宿主”，gssname.nt_hostbased_service krb5）；/执行名称比较如果（名称。等于（mechname））打印（“名称是相等的”）；//获取名称和打印的文本表示/名称类型打印（mechname tostring() +。mechname。getstringnametype() tostring()）；/出口和重新进口的名称字节[] exportname = mechname。export()；从导出的缓冲区创建一个新的名称对象gssname newname =经理。createname（exportname，gssname nt_export_name）；

从以下版本开始：

一点四

另请参见：

export()， equals(GSSName)， GSSManager.createName(String, Oid)， GSSManager.createName(String, Oid, Oid)， GSSManager.createName(byte[], Oid)

Field Summary

Fields

Modifier and Type	Field and Description
static Oid	NT_ANONYMOUS 用于表示一个匿名实体的名称类型。
static Oid	NT_EXPORT_NAME 用于表示导出方法所产生的导出名称的名称类型。
static Oid	NT_HOSTBASED_SERVICE OID表示基于主机的服务名称形式。
static Oid	NT_MACHINE_UID_NAME 表示本地系统上对应于用户的数字用户标识符的名称类型。
static Oid	NT_STRING_UID_NAME 表示表示本地系统上的用户的数字用户标识符的字符串的数字类型。
static Oid	NT_USER_NAME 在本地系统上指示已命名的用户的名称类型。

方法摘要

Modifier and Type	Method and Description
GSSName	canonicalize(Oid mech) 创建一个名为一些机制规范化。
boolean	equals(GSSName another) 比较两 GSSName对象来确定他们是否是指同一个实体。
boolean	equals(Object another) 比较这 GSSName对象到另一个对象，可能是一个 GSSName。
byte[]	export() 返回一个机制名称（锰）的典型连续字节表示，适用于直接，字节按字节的比较，通过授权功能。
Oid	getStringNameType() 返回该名称可以从 toString方法得到的打印表示名称类型。
int	hashCode() 返回此gssname一个hashCode值。
boolean	isAnonymous() 测试这个名称对象是否代表一个匿名实体。
boolean	isMN() 测试这个名称对象是否表示一个机制名称（锰）。
String	toString() 返回的 GSSName对象的文本表示形式。

Field Detail

NT_HOSTBASED_SERVICE

static final Oid NT_HOSTBASED_SERVICE

OID表示基于主机的服务名称形式。它是用来表示与主机计算机相关的服务。这个名字的形式使用两种元素构成的，“服务”和“主机名”，如下：服务@主机名。

它代表以下OID值：
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) service_name(4) }

NT_USER_NAME

static final Oid NT_USER_NAME

在本地系统上指示已命名的用户的名称类型。

它代表以下OID值：
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) user_name(1) }

NT_MACHINE_UID_NAME

static final Oid NT_MACHINE_UID_NAME

表示本地系统上对应于用户的数字用户标识符的名称类型。（例如UID）。

它代表以下OID值：
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) machine_uid_name(2) }

NT_STRING_UID_NAME

static final Oid NT_STRING_UID_NAME

表示表示本地系统上的用户的数字用户标识符的字符串的数字类型。

它代表以下OID值：
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) string_uid_name(3) }

NT_ANONYMOUS

static final Oid NT_ANONYMOUS

用于表示一个匿名实体的名称类型。

它代表以下OID值：
{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 3(gss-anonymous-name) }

NT_EXPORT_NAME

static final Oid NT_EXPORT_NAME

用于表示导出方法所产生的导出名称的名称类型。

它代表以下OID值：
{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 4(gss-api-exported-name) }

方法详细信息

equals

boolean equals(GSSName another)
        throws GSSException

比较两 GSSName对象来确定他们是否是指同一个实体。

参数

another - GSSName与这个名字比较

结果

如果两个名称中至少包含一个共同的元素。如果两个名称中的任何一个都表示一个匿名实体，则该方法将返回错误。

异常

GSSException当名称不能相比，包含以下主要错误代码： GSSException.BAD_NAMETYPE， GSSException.FAILURE

equals

boolean equals(Object another)

比较这 GSSName对象到另一个对象，可能是一个 GSSName。的行为是完全一样 equals除了没有gssexception抛出；相反，错误会在哪里出现错误情况返回。

重写：

equals 方法重写，继承类 Object

参数

another -对象比较这个名字

结果

如果对象比较也是一 GSSName和两个名字指的是同一个实体。

另请参见：

equals(GSSName)

hashCode

int hashCode()

返回此gssname一个hashCode值。

重写：

hashCode 方法重写，继承类 Object

结果

一个hashCode值

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

canonicalize

GSSName canonicalize(Oid mech)
              throws GSSException

创建一个名为一些机制规范化。

参数

mech为机构名称的规范形式，要求老。

结果

一个 GSSName，只包含一个基元表示此名称的规范化形式所需的机制。

异常

GSSException含有以下主要错误代码： GSSException.BAD_MECH， GSSException.BAD_NAMETYPE， GSSException.BAD_NAME， GSSException.FAILURE

export

byte[] export()
       throws GSSException

返回一个机制名称（锰）的典型连续字节表示，适用于直接，字节按字节的比较，通过授权功能。如果名字不是一个Mn，实现可能抛出一个gssexception与name_not_mn状态代码。如果一个执行选择不抛出异常，它应该使用一些系统特定的默认机制规范名称然后再出口。在结构上，出口对象名称包含头包含一个OID识别机制，认证的名称，和一个拖车包含名称本身，在拖车的语法是由个别机构规范定义。对输出缓冲区头的格式在RFC 2743中指定的。

出口的名字是有用的，用于大型访问控制列表，创建每个名字GSSName对象和调用equals方法在每个名字从ACL的开销可能会非常高。

出口名称可以使用工厂方法GSSManager.createName字节数组并指定nt_export_name作为名称类型对象标识符重新进口的。由此产生的GSSName名称也将锰。

结果

包含导出名称的字节[ ]。RFC 2743定义了这些字节“机制独立出口的名字对象格式”。

异常

GSSException含有以下主要错误代码： GSSException.BAD_NAME， GSSException.BAD_NAMETYPE， GSSException.FAILURE

toString

String toString()

返回的 GSSName对象的文本表示形式。检索姓名格式，确定返回的字符串的语法，使用 getStringNameType方法。

重写：

toString 方法重写，继承类 Object

结果

一个字符串，打印形式这个名字。

getStringNameType

Oid getStringNameType()
               throws GSSException

返回该名称可以从 toString方法得到的打印表示名称类型。

结果

一个OID表示该名称的命名空间返回toString方法。

异常

GSSException含有以下主要错误代码： GSSException.FAILURE

isAnonymous

boolean isAnonymous()

测试这个名称对象是否代表一个匿名实体。

结果

如果这是一个匿名的名称，则为假。

isMN

boolean isMN()

测试这个名称对象是否表示一个机制名称（锰）。锰是一种gssname的包含一个机制的原始名称元素。

结果

如果这是一个锰，假否则。