mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-07 01:42:48 +08:00
531 lines
25 KiB
HTML
531 lines
25 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
org.ietf.jgss
|
||
</div>
|
||
<h2 class="title" title="Interface GSSName">Interface GSSName</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">GSSName</span></pre>
|
||
<div class="block">
|
||
<span>该接口封装了单个GSS-API主体实体。</span>
|
||
<span>应用程序通过<a href="../../../org/ietf/jgss/GSSManager.html" title="org.ietf.jgss中的类"><code>GSSManager</code></a>类中存在的<code>createName</code>方法之一获取此接口的实现。</span>
|
||
<span>在概念上，GSSName包含实体或许多原始名称元素的许多表示，每个支持的底层机制一个。</span>
|
||
<span>在GSS术语中，仅包含一个机制的元素的GSSName称为机制名称（MN）</span>
|
||
<p> <span>由于不同的身份验证机制可能会使用不同的命名空间来标识其主体，所以GSS-API的命名支持在多机制环境中（或者甚至在底层机制支持多个命名空间的某些单机制环境中）一定是复杂的。</span> <span>不同的名称格式及其定义标有<a href="../../../org/ietf/jgss/Oid.html" title="org.ietf.jgss中的类"><code>Oid's</code></a>和一些标准的类型在这个接口中定义。</span> <span>名称的格式可以基于其名称类型的唯一<code>Oid</code>派生。</span> </p>
|
||
<p> <span>下面是使用<code>GSSName</code>接口的代码示例。</span> <span>下面的代码创建一个<code>GSSName</code> ，将其转换为MN，执行比较，获取名称的可打印表示，将其导出为字节数组，然后重新导入以获取新的<code>GSSName</code> 。</span> </p>
|
||
<p></p>
|
||
<pre> <span>GSSManager manager = GSSManager.getInstance();
|
||
|
||
// create a host based service name
|
||
GSSName name = manager.createName("service@host",
|
||
GSSName.NT_HOSTBASED_SERVICE);
|
||
|
||
Oid krb5 = new Oid("1.2.840.113554.1.2.2");
|
||
|
||
GSSName mechName = name.canonicalize(krb5);
|
||
|
||
// the above two steps are equivalent to the following
|
||
GSSName mechName = manager.createName("service@host",
|
||
GSSName.NT_HOSTBASED_SERVICE, krb5);
|
||
|
||
// perform name comparison
|
||
if (name.equals(mechName))
|
||
print("Names are equals.");
|
||
|
||
// obtain textual representation of name and its printable
|
||
// name type
|
||
print(mechName.toString() +
|
||
mechName.getStringNameType().toString());
|
||
|
||
// export and re-import the name
|
||
byte [] exportName = mechName.export();
|
||
|
||
// create a new name object from the exported buffer
|
||
GSSName newName = manager.createName(exportName,
|
||
GSSName.NT_EXPORT_NAME);</span> </pre>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.4
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../org/ietf/jgss/GSSName.html#export--"><code>export()</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSName.html#equals-org.ietf.jgss.GSSName-"><code>equals(GSSName)</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSManager.html#createName-java.lang.String-org.ietf.jgss.Oid-"><code>GSSManager.createName(String, Oid)</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSManager.html#createName-java.lang.String-org.ietf.jgss.Oid-org.ietf.jgss.Oid-"><code>GSSManager.createName(String, Oid, Oid)</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSManager.html#createName-byte:A-org.ietf.jgss.Oid-"><code>GSSManager.createName(byte[], Oid)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- =========== FIELD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.summary">
|
||
<!-- --> </a> <h3>Field Summary</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
|
||
<caption>
|
||
<span>Fields</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Field and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>static <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#NT_ANONYMOUS">NT_ANONYMOUS</a></span></code>
|
||
<div class="block">
|
||
用于表示匿名实体的名称类型。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>static <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#NT_EXPORT_NAME">NT_EXPORT_NAME</a></span></code>
|
||
<div class="block">
|
||
用于指示由导出方法生成的导出名称的名称类型。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>static <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#NT_HOSTBASED_SERVICE">NT_HOSTBASED_SERVICE</a></span></code>
|
||
<div class="block">
|
||
Oid表示基于主机的服务名称形式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>static <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#NT_MACHINE_UID_NAME">NT_MACHINE_UID_NAME</a></span></code>
|
||
<div class="block">
|
||
用于指示与本地系统上的用户对应的数字用户标识符的名称类型。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>static <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#NT_STRING_UID_NAME">NT_STRING_UID_NAME</a></span></code>
|
||
<div class="block">
|
||
名称类型，用于指示表示本地系统上用户的数字用户标识符的数字字符串。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>static <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#NT_USER_NAME">NT_USER_NAME</a></span></code>
|
||
<div class="block">
|
||
用于指示本地系统上的命名用户的名称类型。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul>
|
||
<!-- ========== METHOD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.summary">
|
||
<!-- --> </a> <h3>方法摘要</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
|
||
<caption>
|
||
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Method and Description</th>
|
||
</tr>
|
||
<tr class="altColor" id="i0">
|
||
<td class="colFirst"><code><a href="../../../org/ietf/jgss/GSSName.html" title="interface in org.ietf.jgss">GSSName</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#canonicalize-org.ietf.jgss.Oid-">canonicalize</a></span>(<a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> mech)</code>
|
||
<div class="block">
|
||
创建一个为某种机制规范化的名称。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#equals-org.ietf.jgss.GSSName-">equals</a></span>(<a href="../../../org/ietf/jgss/GSSName.html" title="interface in org.ietf.jgss">GSSName</a> another)</code>
|
||
<div class="block">
|
||
比较两个
|
||
<code>GSSName</code>对象，以确定它们是否引用相同的实体。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#equals-java.lang.Object-">equals</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> another)</code>
|
||
<div class="block">
|
||
与此相比
|
||
<code>GSSName</code>对象的另一个对象可能是
|
||
<code>GSSName</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>byte[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#export--">export</a></span>()</code>
|
||
<div class="block">
|
||
返回机制名称（MN）的规范连续字节表示，适用于通过授权功能直接逐字节比较。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code><a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#getStringNameType--">getStringNameType</a></span>()</code>
|
||
<div class="block">
|
||
返回可从
|
||
<code>toString</code>方法获得的该名称的可打印表示的名称类型。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#hashCode--">hashCode</a></span>()</code>
|
||
<div class="block">
|
||
返回此GSSName的哈希码值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#isAnonymous--">isAnonymous</a></span>()</code>
|
||
<div class="block">
|
||
测试此名称对象是否表示匿名实体。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#isMN--">isMN</a></span>()</code>
|
||
<div class="block">
|
||
测试此名称对象是否表示机制名称（MN）。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/ietf/jgss/GSSName.html#toString--">toString</a></span>()</code>
|
||
<div class="block">
|
||
返回
|
||
<code>GSSName</code>对象的文本表示。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="details">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ============ FIELD DETAIL =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.detail">
|
||
<!-- --> </a> <h3>字段详细信息</h3> <a name="NT_HOSTBASED_SERVICE">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>NT_HOSTBASED_SERVICE</h4> <pre>static final <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> NT_HOSTBASED_SERVICE</pre>
|
||
<div class="block">
|
||
<span>Oid表示基于主机的服务名称形式。</span>
|
||
<span>它用于表示与主机相关联的服务。</span>
|
||
<span>此名称表单使用两个元素“service”和“hostname”构建，如下所示：service @ hostname。</span>
|
||
<p> <span>它代表以下Oid值：</span> <br/> <code>{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) service_name(4) }</code> </p>
|
||
</div> </li>
|
||
</ul> <a name="NT_USER_NAME">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>NT_USER_NAME</h4> <pre>static final <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> NT_USER_NAME</pre>
|
||
<div class="block">
|
||
<span>用于指示本地系统上的命名用户的名称类型。</span>
|
||
<p> <span>它代表以下Oid值：</span> <br/> <code>{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) user_name(1) }</code> </p>
|
||
</div> </li>
|
||
</ul> <a name="NT_MACHINE_UID_NAME">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>NT_MACHINE_UID_NAME</h4> <pre>static final <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> NT_MACHINE_UID_NAME</pre>
|
||
<div class="block">
|
||
<span>用于指示与本地系统上的用户对应的数字用户标识符的名称类型。</span>
|
||
<span>（例如Uid）。</span>
|
||
<p> <span>它代表以下Oid值：</span> <br/> <code>{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) machine_uid_name(2) }</code> </p>
|
||
</div> </li>
|
||
</ul> <a name="NT_STRING_UID_NAME">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>NT_STRING_UID_NAME</h4> <pre>static final <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> NT_STRING_UID_NAME</pre>
|
||
<div class="block">
|
||
<span>名称类型，用于指示表示本地系统上用户的数字用户标识符的数字字符串。</span>
|
||
<p> <span>它代表以下Oid值：</span> <br/> <code>{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) string_uid_name(3) }</code> </p>
|
||
</div> </li>
|
||
</ul> <a name="NT_ANONYMOUS">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>NT_ANONYMOUS</h4> <pre>static final <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> NT_ANONYMOUS</pre>
|
||
<div class="block">
|
||
<span>用于表示匿名实体的名称类型。</span>
|
||
<p> <span>它代表以下Oid值：</span> <br/> <code>{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 3(gss-anonymous-name) }</code> </p>
|
||
</div> </li>
|
||
</ul> <a name="NT_EXPORT_NAME">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>NT_EXPORT_NAME</h4> <pre>static final <a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> NT_EXPORT_NAME</pre>
|
||
<div class="block">
|
||
<span>用于指示由导出方法生成的导出名称的名称类型。</span>
|
||
<p> <span>它代表以下Oid值：</span> <br/> <code>{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 4(gss-api-exported-name) }</code> </p>
|
||
</div> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="equals-org.ietf.jgss.GSSName-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>equals</h4> <pre>boolean equals(<a href="../../../org/ietf/jgss/GSSName.html" title="interface in org.ietf.jgss">GSSName</a> another)
|
||
throws <a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></pre>
|
||
<div class="block">
|
||
比较两个
|
||
<code>GSSName</code>对象，以确定它们是否引用同一个实体。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>another</code> -
|
||
<code>GSSName</code>比较这个名字
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果两个名称包含至少一个共同的原始元素，则为true。</span>
|
||
<span>如果任一名称代表匿名实体，则该方法将返回false。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></code> -当名称所不能比拟的，包含以下主要错误代码：
|
||
<a href="../../../org/ietf/jgss/GSSException.html#BAD_NAMETYPE"><code>GSSException.BAD_NAMETYPE</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSException.html#FAILURE"><code>GSSException.FAILURE</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="equals-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>equals</h4> <pre>boolean equals(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> another)</pre>
|
||
<div class="block">
|
||
<span>与此相比<code>GSSName</code>对象的另一个对象可能是<code>GSSName</code> 。</span>
|
||
<span>行为与<a href="../../../org/ietf/jgss/GSSName.html#equals-org.ietf.jgss.GSSName-"><code>equals</code>完全相同，</a>只是不会抛出GSSException;</span>
|
||
<span>相反，在发生错误的情况下将返回false。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a></code>在
|
||
<code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>another</code> - 将该名称与之对比的对象
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果要比较的对象也是一个
|
||
<code>GSSName</code> ，而这两个名字指的是同一个实体。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../org/ietf/jgss/GSSName.html#equals-org.ietf.jgss.GSSName-"><code>equals(GSSName)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="hashCode--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>hashCode</h4> <pre>int hashCode()</pre>
|
||
<div class="block">
|
||
返回此GSSName的哈希码值。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/Object.html#hashCode--">hashCode</a></code>在
|
||
<code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个hashCode值
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(java.lang.Object)</code></a> ，
|
||
<a href="../../../java/lang/System.html#identityHashCode-java.lang.Object-"><code>System.identityHashCode(java.lang.Object)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="canonicalize-org.ietf.jgss.Oid-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>canonicalize</h4> <pre><a href="../../../org/ietf/jgss/GSSName.html" title="interface in org.ietf.jgss">GSSName</a> canonicalize(<a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> mech)
|
||
throws <a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></pre>
|
||
<div class="block">
|
||
创建一个为某种机制规范化的名称。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>mech</code> - 请求该名称的规范形式的机制的oid。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个
|
||
<code>GSSName</code> ，其中只包含一个表示该名称的原始元素，以规范化形式表示所需的机制。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></code> -包含以下主要错误代码：
|
||
<a href="../../../org/ietf/jgss/GSSException.html#BAD_MECH"><code>GSSException.BAD_MECH</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSException.html#BAD_NAMETYPE"><code>GSSException.BAD_NAMETYPE</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSException.html#BAD_NAME"><code>GSSException.BAD_NAME</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSException.html#FAILURE"><code>GSSException.FAILURE</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="export--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>export</h4> <pre>byte[] export()
|
||
throws <a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></pre>
|
||
<div class="block">
|
||
<span>返回机制名称（MN）的规范连续字节表示，适用于通过授权功能直接逐字节比较。</span>
|
||
<span>如果名称不是MN，则实现可能会抛出具有NAME_NOT_MN状态代码的GSSException。</span>
|
||
<span>如果一个实现选择不抛出异常，它应该使用一些系统特定的默认机制来规范名称，然后导出它。</span>
|
||
<span>在结构上，导出的名称对象由包含标识认证名称的机制的OID的标头和包含名称本身的预告片组成，其中拖尾的语法由各个机构规范定义。</span>
|
||
<span>输出缓冲区头的格式在RFC 2743中规定。</span>
|
||
<p> <span>导出的名称在大型访问控制列表中使用时很有用，其中每个名称上创建<code>GSSName</code>对象的开销以及从ACL中的每个名称调用equals方法可能是禁止的。</span> </p>
|
||
<p> <span>可以使用字节数组工厂方法<a href="../../../org/ietf/jgss/GSSManager.html#createName-byte:A-org.ietf.jgss.Oid-"><code>GSSManager.createName</code></a>重新导入导出的名称，并将NT_EXPORT_NAME指定为名称类型对象标识符。</span> <span>得到的<code>GSSName</code>名称也将是MN。</span> </p>
|
||
<p></p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>一个包含导出的名称的字节[]。</span>
|
||
<span>RFC 2743为这些字节定义了“机制独立的导出名称对象格式”。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></code> -包含以下主要错误代码：
|
||
<a href="../../../org/ietf/jgss/GSSException.html#BAD_NAME"><code>GSSException.BAD_NAME</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSException.html#BAD_NAMETYPE"><code>GSSException.BAD_NAMETYPE</code></a> ，
|
||
<a href="../../../org/ietf/jgss/GSSException.html#FAILURE"><code>GSSException.FAILURE</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="toString--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>toString</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
|
||
<div class="block">
|
||
<span>返回<code>GSSName</code>对象的文本表示。</span>
|
||
<span>要检索确定返回字符串语法的打印名称格式，请使用<a href="../../../org/ietf/jgss/GSSName.html#getStringNameType--"><code>getStringNameType</code></a>方法。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/Object.html#toString--">toString</a></code>在
|
||
<code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个以可打印形式表示此名称的字符串。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getStringNameType--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getStringNameType</h4> <pre><a href="../../../org/ietf/jgss/Oid.html" title="class in org.ietf.jgss">Oid</a> getStringNameType()
|
||
throws <a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></pre>
|
||
<div class="block">
|
||
返回可以从
|
||
<code>toString</code>方法获取的该名称的可打印表示的名称类型。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个Oid表示从toString方法返回的名称的名称空间。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../org/ietf/jgss/GSSException.html" title="class in org.ietf.jgss">GSSException</a></code> - 包含以下主要错误代码：
|
||
<a href="../../../org/ietf/jgss/GSSException.html#FAILURE"><code>GSSException.FAILURE</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isAnonymous--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>isAnonymous</h4> <pre>boolean isAnonymous()</pre>
|
||
<div class="block">
|
||
测试此名称对象是否表示匿名实体。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果这是匿名名称，则为true，否则为false。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isMN--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>isMN</h4> <pre>boolean isMN()</pre>
|
||
<div class="block">
|
||
<span>测试此名称对象是否表示机制名称（MN）。</span>
|
||
<span>MN是一个GSSName，它只包含一个机制的原始名称元素。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果这是MN，则为true，否则为false。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |