java.security.acl.AclEntry翻译

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<HTML>

<HEAD>

<TITLE>

AclEntry (Java 2 Platform SE v1.4.2)

</TITLE>

function windowTitle()

{

parent.document.title="AclEntry (Java 2 Platform SE v1.4.2)";

}

</SCRIPT>

</HEAD>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../../java/security/acl/Acl.html" title="interface in java.security.acl">PREV CLASS</A>

<A HREF="../../../java/security/acl/Group.html" title="interface in java.security.acl">NEXT CLASS</A></TD>

<A HREF="../../../index.html" target="_top">FRAMES</A>

<A HREF="AclEntry.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<H2>

java.security.acl

Interface AclEntry</H2>

<DL>

<DT>All Superinterfaces: <DD><A HREF="../../../java/lang/Cloneable.html" title="interface in java.lang">Cloneable</A></DD>

</DL>

<HR>

<DL>

<DT>public interface AclEntry<DT>extends <A HREF="../../../java/lang/Cloneable.html" title="interface in java.lang">Cloneable</A></DL>

This is the interface used for representing one entry in an Access

Control List (ACL).

该接口用来表示访问控制列表中（ACL）的一个入口。

An ACL can be thought of as a data structure with multiple ACL entry

objects. Each ACL entry object contains a set of permissions associated

with a particular principal. (A principal represents an entity such as

an individual user or a group). Additionally, each ACL entry is specified

as being either positive or negative. If positive, the permissions are

to be granted to the associated principal. If negative, the permissions

are to be denied. Each principal can have at most one positive ACL entry

and one negative entry; that is, multiple positive or negative ACL

entries are not allowed for any principal.

Note: ACL entries are by default positive. An entry becomes a

negative entry only if the

<A HREF="../../../java/security/acl/AclEntry.html#setNegativePermissions()"><CODE>setNegativePermissions</CODE></A>

method is called on it.

ACL可以认为是包含多个ACL入口对象的数据结构，每个ACL入口包含特定主体相关的一组许可

（主体表示一个实体，比如个体或组）。另为，每个ACL入口都可以用肯定或否定描述：肯定表示许可被授予相关联的主体，否定

表示拒绝的许可。每个主体最多有一个肯定ACL入口和一个否定入口，也就是说，任何主体都不允许有多个肯定或否定ACL入口。

注：ACL入口默认为肯定，只有调用setNegativePermissions方法入口才会成为否定入口。

<DL>

<HR>

Method Summary</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#addPermission(java.security.acl.Permission)">addPermission</A>(<A HREF="../../../java/security/acl/Permission.html" title="interface in java.security.acl">Permission</A> permission)</CODE>

          Adds the specified permission to this ACL entry.

给该ACL入口添加指定许可。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#checkPermission(java.security.acl.Permission)">checkPermission</A>(<A HREF="../../../java/security/acl/Permission.html" title="interface in java.security.acl">Permission</A> permission)</CODE>

          Checks if the specified permission is part of the

permission set in this entry.

检查该指定许可是否是该入口的一部分。</TD>

</TR>

<CODE> <A HREF="../../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#clone()">clone</A>()</CODE>

          Clones this ACL entry.

克隆该ACL入口。</TD>

</TR>

<CODE> <A HREF="../../../java/security/Principal.html" title="interface in java.security">Principal</A></CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#getPrincipal()">getPrincipal</A>()</CODE>

          Returns the principal for which permissions are granted or denied by

this ACL entry.

返回该ACL入口中许可授予或拒绝的主体。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#isNegative()">isNegative</A>()</CODE>

          Returns true if this is a negative ACL entry (one denying the

associated principal the set of permissions in the entry), false

otherwise.如果这是一个否定ACL入口（入口中拒绝相关主体以许可集合），返回true，否则为false。</TD>

</TR>

<CODE> <A HREF="../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</A></CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#permissions()">permissions</A>()</CODE>

          Returns an enumeration of the permissions in this ACL entry.

返回该ACL入口中的许可枚举。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#removePermission(java.security.acl.Permission)">removePermission</A>(<A HREF="../../../java/security/acl/Permission.html" title="interface in java.security.acl">Permission</A> permission)</CODE>

          Removes the specified permission from this ACL entry.

从该ACL入口中删除指定的许可。</TD>

</TR>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#setNegativePermissions()">setNegativePermissions</A>()</CODE>

          Sets this ACL entry to be a negative one.

将该ACL入口设置为否定。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#setPrincipal(java.security.Principal)">setPrincipal</A>(<A HREF="../../../java/security/Principal.html" title="interface in java.security">Principal</A> user)</CODE>

          Specifies the principal for which permissions are granted or denied

by this ACL entry. 指定该ACL入口授予或拒绝许可的主体。</TD>

</TR>

<CODE> <A HREF="../../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../../java/security/acl/AclEntry.html#toString()">toString</A>()</CODE>

          Returns a string representation of the contents of this ACL entry.

返回该ACL入口内容的字符串形式。</TD>

</TR>

</TABLE>

Method Detail</TD>

</TR>

</TABLE>

setPrincipal</H3>

<PRE>

public boolean setPrincipal(<A HREF="../../../java/security/Principal.html" title="interface in java.security">Principal</A> user)</PRE>

<DL>

<DD>Specifies the principal for which permissions are granted or denied

by this ACL entry. If a principal was already set for this ACL entry,

false is returned, otherwise true is returned.

指定该ACL入口授予或拒绝许可的主体。如果该主体已被设置给该ACL入口，返回false，否则返回true。

</DL>

</DD>

<DT>Parameters:<DD><CODE>user</CODE> - the principal to be set for this entry. 被设置给该入口的主体。

<DT>Returns:<DD>true if the principal is set, false if there was

already a principal set for this entry.

如果该主体被设置，返回true，如果入口中已有该主体返回false。<DT>See Also:<DD><A HREF="../../../java/security/acl/AclEntry.html#getPrincipal()"><CODE>getPrincipal()</CODE></A></DL>

</DD>

</DL>

<HR>

getPrincipal</H3>

<PRE>

public <A HREF="../../../java/security/Principal.html" title="interface in java.security">Principal</A> getPrincipal()</PRE>

<DL>

<DD>Returns the principal for which permissions are granted or denied by

this ACL entry. Returns null if there is no principal set for this

entry yet. 返回该ACL入口中许可授予或拒绝的主体。如果该ACL入口中还没有主体设置给该入口返回null。

</DL>

</DD>

<DT>Returns:<DD>the principal associated with this entry. 与该入口相关的主体。<DT>See Also:<DD><A HREF="../../../java/security/acl/AclEntry.html#setPrincipal(java.security.Principal)"><CODE>setPrincipal(java.security.Principal)</CODE></A></DL>

</DD>

</DL>

<HR>

setNegativePermissions</H3>

<PRE>

public void setNegativePermissions()</PRE>

<DL>

<DD>Sets this ACL entry to be a negative one. That is, the associated

principal (e.g., a user or a group) will be denied the permission set

specified in the entry.

Note: ACL entries are by default positive. An entry becomes a

negative entry only if this <code>setNegativePermissions</code>

method is called on it.

将该ACL入口设置为否定。也就是说，入口将指定关联主体（用户或组）拒绝该许可集合。

注：ACL入口默认为肯定。只有调用setNegativePermissions方法入口才会成为否定入口。

</DL>

</DD>

</DL>

</DD>

</DL>

<HR>

isNegative</H3>

<PRE>

public boolean isNegative()</PRE>

<DL>

<DD>Returns true if this is a negative ACL entry (one denying the

associated principal the set of permissions in the entry), false

otherwise.

如果这是一个否定ACL入口（入口中拒绝相关主体以许可集合），返回true，否则为false。

</DL>

</DD>

<DT>Returns:<DD>true if this is a negative ACL entry, false if it's not. 如果这是一个否定ACL入口，返回true，否则为false。</DL>

</DD>

</DL>

<HR>

addPermission</H3>

<PRE>

public boolean addPermission(<A HREF="../../../java/security/acl/Permission.html" title="interface in java.security.acl">Permission</A> permission)</PRE>

<DL>

<DD>Adds the specified permission to this ACL entry. Note: An entry can

have multiple permissions.

给该ACL入口添加指定许可。注：一个入口可以有多个许可。

</DL>

</DD>

<DT>Parameters:<DD><CODE>permission</CODE> - the permission to be associated with

the principal in this entry. 入口中关联给该主体的许可。

<DT>Returns:<DD>true if the permission was added, false if the

permission was already part of this entry's permission set.

如果许可被添加，返回true，如果许可已经是该入口许可集合的一部分，返回false。</DL>

</DD>

</DL>

<HR>

removePermission</H3>

<PRE>

public boolean removePermission(<A HREF="../../../java/security/acl/Permission.html" title="interface in java.security.acl">Permission</A> permission)</PRE>

<DL>

<DD>Removes the specified permission from this ACL entry.

从该ACL入口中删除指定的许可。

</DL>

</DD>

<DT>Parameters:<DD><CODE>permission</CODE> - the permission to be removed from this entry. 从该入口中被删除的许可。

<DT>Returns:<DD>true if the permission is removed, false if the

permission was not part of this entry's permission set.

如果该许可被删除，返回true，如果该许可不是该入口许可集合的一部分，返回false。</DL>

</DD>

</DL>

<HR>

checkPermission</H3>

<PRE>

public boolean checkPermission(<A HREF="../../../java/security/acl/Permission.html" title="interface in java.security.acl">Permission</A> permission)</PRE>

<DL>

<DD>Checks if the specified permission is part of the

permission set in this entry.

检查该指定许可是否是该入口的一部分。

</DL>

</DD>

<DT>Parameters:<DD><CODE>permission</CODE> - the permission to be checked for. 被检查的许可。

<DT>Returns:<DD>true if the permission is part of the

permission set in this entry, false otherwise. 如果该许可是该入口许可集合的一部分，返回true，否则为false。</DL>

</DD>

</DL>

<HR>

permissions</H3>

<PRE>

public <A HREF="../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</A> permissions()</PRE>

<DL>

<DD>Returns an enumeration of the permissions in this ACL entry.

返回该ACL入口中的许可枚举。

</DL>

</DD>

<DT>Returns:<DD>an enumeration of the permissions in this ACL entry. 该ACL入口中的许可枚举。</DL>

</DD>

</DL>

<HR>

toString</H3>

<PRE>

public <A HREF="../../../java/lang/String.html" title="class in java.lang">String</A> toString()</PRE>

<DL>

<DD>Returns a string representation of the contents of this ACL entry.

返回该ACL入口内容的字符串形式。

<DT>Overrides:<DD><CODE><A HREF="../../../java/lang/Object.html#toString()">toString</A></CODE> in class <CODE><A HREF="../../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Returns:<DD>a string representation of the contents.

内容的字符串形式。</DL>

</DD>

</DL>

<HR>

clone</H3>

<PRE>

public <A HREF="../../../java/lang/Object.html" title="class in java.lang">Object</A> clone()</PRE>

<DL>

<DD>Clones this ACL entry. 克隆该ACL入口。

</DL>

</DD>

<DT>Returns:<DD>a clone of this ACL entry. 该ACL入口的克隆。</DL>

</DD>

</DL>

<HR>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../../java/security/acl/Acl.html" title="interface in java.security.acl">PREV CLASS</A>

<A HREF="../../../java/security/acl/Group.html" title="interface in java.security.acl">NEXT CLASS</A></TD>

<A HREF="../../../index.html" target="_top">FRAMES</A>

<A HREF="AclEntry.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a> For further API reference and developer documentation, see <a href="../../../../relnotes/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../../relnotes/license.html">license terms</a>. Also see the <a href="http://java.sun.com/docs/redist.html">documentation redistribution policy</a>.

</BODY>

</HTML>