uTools-Manuals/docs/java/javax/security/auth/PrivateCredentialPermission.html

426 lines
20 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact1, compact2, compact3
</div>
<div class="subTitle">
javax.security.auth
</div>
<h2 class="title" title="Class PrivateCredentialPermission">Class PrivateCredentialPermission</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/security/Permission.html" title="class in java.security">java.security.Permission</a></li>
<li>
<ul class="inheritance">
<li>javax.security.auth.PrivateCredentialPermission</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a> <a href="../../../java/security/Guard.html" title="java.security中的接口">Guard</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public final class <span class="typeNameLabel">PrivateCredentialPermission</span>
extends <a href="../../../java/security/Permission.html" title="class in java.security">Permission</a></pre>
<div class="block">
<span>此类用于保护对属于特定<code>Subject</code>私有凭据的访问。</span>
<span><code>Subject</code>由一组校长表示。</span>
<p> <span><code>Permission</code>的目标名称指定了凭证类名称和一组主体。</span> <span>此权限操作的唯一有效值是“读取”。</span> <span>目标名称必须遵守以下语法:</span> </p>
<pre> <span>CredentialClass {PrincipalClass "PrincipalName"}*</span> </pre>
<span>例如以下权限授予对主体拥有的com.sun.PrivateCredential的访问权限该对象具有名称为“duke”的com.sun.Principal。</span>
<span>请注意尽管此示例以及以下所有示例在grant语句中不包含CodebaseSignedBy或Principal信息出于简单的原因但实际的策略配置应在适当时指定该信息。</span>
<pre> <span>grant {
permission javax.security.auth.PrivateCredentialPermission
"com.sun.PrivateCredential com.sun.Principal \"duke\"",
"read";
};</span> </pre>
<span>如果CredentialClass为“*”则授予对属于指定的Subject的所有私有凭据的访问<code>Subject</code></span>
<span>如果“PrincipalName”为“*”,那么授权给具有指定的<code>Principal</code> 实际PrincipalName无关紧要的任何<code>Subject</code>所拥有的指定<code>Principal</code>的访问<code>Principal</code></span>
<span>例如以下授权访问由具有abPrincipal的任何<code>Subject</code>拥有的abCredential。</span>
<pre> <span>grant {
permission javax.security.auth.PrivateCredentialPermission
"a.b.Credential a.b.Principal "*"",
"read";
};</span> </pre>
<span>如果PrincipalClass和“PrincipalName”均为“*”,则访问权限将被授予由任何<code>Subject</code>拥有的指定<code>Subject</code></span>
<p> <span>此外可以重复PrincipalClass / PrincipalName配对</span> </p>
<pre> <span>grant {
permission javax.security.auth.PrivateCredentialPermission
"a.b.Credential a.b.Principal "duke" c.d.Principal "dukette"",
"read";
};</span> </pre>
<span>上述授权访问私有证书“abCredential”属于<code>Subject</code>与至少两个相关联的校长“abPrincipal”的名称“公爵”和“cdPrincipal”名称为“dukette”。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../serialized-form.html#javax.security.auth.PrivateCredentialPermission">Serialized Form</a>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/security/auth/PrivateCredentialPermission.html#PrivateCredentialPermission-java.lang.String-java.lang.String-">PrivateCredentialPermission</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> actions)</code>
<div class="block">
创建一个新的
<code>PrivateCredentialPermission</code>与指定的
<code>name</code>
</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="t4"><span><a href="javascript:show(8);">具体的方法</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>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/security/auth/PrivateCredentialPermission.html#equals-java.lang.Object-">equals</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</code>
<div class="block">
检查两个
<code>PrivateCredentialPermission</code>对象的相等性。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<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="../../../javax/security/auth/PrivateCredentialPermission.html#getActions--">getActions</a></span>()</code>
<div class="block">
返回动作的“规范字符串表示”。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<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="../../../javax/security/auth/PrivateCredentialPermission.html#getCredentialClass--">getCredentialClass</a></span>()</code>
<div class="block">
返回与此
<code>PrivateCredentialPermission</code>关联的凭据的类名。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<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="../../../javax/security/auth/PrivateCredentialPermission.html#getPrincipals--">getPrincipals</a></span>()</code>
<div class="block">
返回与此
<code>PrivateCredentialPermission</code>
<code>Principal</code>类和名称。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/security/auth/PrivateCredentialPermission.html#hashCode--">hashCode</a></span>()</code>
<div class="block">
返回此对象的哈希码值。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/security/auth/PrivateCredentialPermission.html#implies-java.security.Permission-">implies</a></span>(<a href="../../../java/security/Permission.html" title="class in java.security">Permission</a> p)</code>
<div class="block">
检查这
<code>PrivateCredentialPermission</code>意味着指定的
<code>Permission</code>
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../java/security/PermissionCollection.html" title="class in java.security">PermissionCollection</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/security/auth/PrivateCredentialPermission.html#newPermissionCollection--">newPermissionCollection</a></span>()</code>
<div class="block">
在PermissionCollection中返回PrivateCredentialPermissions的均匀
<code>PermissionCollection</code>
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.security.Permission">
<!-- --> </a> <h3>Methods inherited from class java.security.<a href="../../../java/security/Permission.html" title="class in java.security">Permission</a></h3> <code><a href="../../../java/security/Permission.html#checkGuard-java.lang.Object-">checkGuard</a>, <a href="../../../java/security/Permission.html#getName--">getName</a>, <a href="../../../java/security/Permission.html#toString--">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="PrivateCredentialPermission-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>PrivateCredentialPermission</h4> <pre>public PrivateCredentialPermission(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> actions)</pre>
<div class="block">
<span>创建一个新的<code>PrivateCredentialPermission</code>与指定的<code>name</code></span>
<span><code>name</code>同时指定凭证类和<code>Principal</code>集。</span>
<p></p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 指定Credential类的名称和
<code>Principal</code> Set。
<p></p>
</dd>
<dd>
<code>actions</code> - 指定可以读取
<code>actions</code>的操作。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>name</code>不符合正确的语法,或
<code>actions</code>不是“读”。
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getCredentialClass--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCredentialClass</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getCredentialClass()</pre>
<div class="block">
返回与此
<code>PrivateCredentialPermission</code>关联的凭据的类名。
<p></p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与该
<code>PrivateCredentialPermission</code>相关联的凭证的类名称。
</dd>
</dl> </li>
</ul> <a name="getPrincipals--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPrincipals</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[][] getPrincipals()</pre>
<div class="block">
<span>返回与此<code>PrivateCredentialPermission</code><code>Principal</code>类和名称。</span>
<span>信息作为二维数组返回array [x] [y])。</span>
<span>'x'值对应于<code>Principal</code>类和名称对的数量。</span>
<span>y == 0它对应于<code>Principal</code>类值而当y == 1它对应于<code>Principal</code>名称值。</span>
<span>例如array [0] [0]对应于数组中第一个<code>Principal</code>的类名。</span>
<span>array [0] [1]对应于数组中第一个<code>Principal</code><code>Principal</code>名称。</span>
<p></p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
这个
<code>Principal</code>类和名字与这个
<code>PrivateCredentialPermission</code>
</dd>
</dl> </li>
</ul> <a name="implies-java.security.Permission-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>implies</h4> <pre>public boolean implies(<a href="../../../java/security/Permission.html" title="class in java.security">Permission</a> p)</pre>
<div class="block">
<span>检查<code>PrivateCredentialPermission</code>是否包含指定的<code>Permission</code></span>
<p> <span>如果这个方法返回true</span> </p>
<ul>
<li> <span><i>p</i>是PrivateCredentialPermission的一个实例</span> </li>
<li> <span>此对象的目标名称暗示<i>p</i>的目标名称。</span> <span>例如:</span> <pre> <span>[* P1 "duke"] implies [a.b.Credential P1 "duke"].
[C1 P1 "duke"] implies [C1 P1 "duke" P2 "dukette"].
[C1 P2 "dukette"] implies [C1 P1 "duke" P2 "dukette"].</span> </pre></li>
</ul>
<p></p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../java/security/Permission.html#implies-java.security.Permission-">implies</a></code>在类别
<code><a href="../../../java/security/Permission.html" title="class in java.security">Permission</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>p</code> - 要检查的
<code>Permission</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果这个
<code>PrivateCredentialPermission</code>意味着指定的
<code>Permission</code> 则为true否则为false。
</dd>
</dl> </li>
</ul> <a name="equals-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>equals</h4> <pre>public boolean equals(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</pre>
<div class="block">
<span>检查两个<code>PrivateCredentialPermission</code>对象的相等性。</span>
<span>检查<i>obj</i>是否为<code>PrivateCredentialPermission</code> ,并且具有与该对象相同的凭据类,以及与该对象相同的主体。</span>
<span>校长在各自的权限目标名称中的顺序是不相关的。</span>
<p></p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../java/security/Permission.html#equals-java.lang.Object-">equals</a></code>在类别
<code><a href="../../../java/security/Permission.html" title="class in java.security">Permission</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>obj</code> - 我们正在测试与此对象相等的对象。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果obj为
<code>PrivateCredentialPermission</code> 则为true与该对象具有相同的凭证类并具有与此对象相同的主体。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../java/lang/Object.html#hashCode--"><code>Object.hashCode()</code></a> <a href="../../../java/util/HashMap.html" title="java.util中的类"><code>HashMap</code></a></span>
</dd>
</dl> </li>
</ul> <a name="hashCode--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hashCode</h4> <pre>public int hashCode()</pre>
<div class="block">
返回此对象的哈希码值。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../java/security/Permission.html#hashCode--">hashCode</a></code>在类别
<code><a href="../../../java/security/Permission.html" title="class in java.security">Permission</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该对象的哈希码值。
</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="getActions--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getActions</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getActions()</pre>
<div class="block">
<span>返回动作的“规范字符串表示”。</span>
<span>这个方法总是返回String“read”。</span>
<p></p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../java/security/Permission.html#getActions--">getActions</a></code>在类
<code><a href="../../../java/security/Permission.html" title="class in java.security">Permission</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
动作总是返回“read”
</dd>
</dl> </li>
</ul> <a name="newPermissionCollection--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>newPermissionCollection</h4> <pre>public <a href="../../../java/security/PermissionCollection.html" title="class in java.security">PermissionCollection</a> newPermissionCollection()</pre>
<div class="block">
<span>在PermissionCollection中返回PrivateCredentialPermissions的均匀<code>PermissionCollection</code></span>
<span>没有这样定义<code>PermissionCollection</code> ,所以这个方法总是返回<code>null</code></span>
<p></p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../java/security/Permission.html#newPermissionCollection--">newPermissionCollection</a></code>在类别
<code><a href="../../../java/security/Permission.html" title="class in java.security">Permission</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
在所有情况下都为null。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>