Acl

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> java >> security >> [ acl overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

java.security.acl
Interface Acl

All Superinterfaces:: Owner

public interface Acl
extends Owner

A Java access control list (ACL) is a group of individual ACL entries. These entries consist of a Principal and a list of permissions this Principal is either granted or denied. A given Principal can have at most one positive ACL entry (i.e., one that grants permissions) and one negative ACL entry (i.e., one that denies permissions). If a given permission is both granted and denied, the ACL treats it as if it were never granted or denied. If both a Principal and a Group to which the Principal belongs have an ACL entry, the permissions for the individual Principal take precedence over the permissions of the Group if there is a conflict.

Additionally, the ACL interface extends the Owner interface and so an ACL has owners. Actions which modify the ACL are restricted to owners.

Version:: 0.0

Method Summary

boolean addEntry(java.security.Principal caller, AclEntry entry)
          This method adds the specified entry to the ACL

boolean checkPermission(java.security.Principal user, Permission perm)
          This method tests whether or not the specified Principal has the specified Permission

java.util.Enumeration entries()
          This method returns a list of all the entries in the ACL as an Enumeration.

java.lang.String getName()
          This method returns the name of this ACL.

java.util.Enumeration getPermissions(java.security.Principal user)
          This method returns a list of Permission's that are granted to a particular Principal.

boolean removeEntry(java.security.Principal caller, AclEntry entry)
          This method delets the specified entry from the ACL

void setName(java.security.Principal caller, java.lang.String name)
          This method sets the name of the ACL

java.lang.String toString()
          This method returns the ACL as a String

Methods inherited from interface java.security.acl.Owner

addOwner, deleteOwner, isOwner

Method Detail

getName

public java.lang.String getName()

This method returns the name of this ACL.

setName

public void setName(java.security.Principal caller,
                    java.lang.String name)
             throws NotOwnerException

This method sets the name of the ACL

addEntry

public boolean addEntry(java.security.Principal caller,
                        AclEntry entry)
                 throws NotOwnerException

This method adds the specified entry to the ACL

removeEntry

public boolean removeEntry(java.security.Principal caller,
                           AclEntry entry)
                    throws NotOwnerException

This method delets the specified entry from the ACL

entries

public java.util.Enumeration entries()

This method returns a list of all the entries in the ACL as an Enumeration.

checkPermission

public boolean checkPermission(java.security.Principal user,
                               Permission perm)

This method tests whether or not the specified Principal has the specified Permission

getPermissions

public java.util.Enumeration getPermissions(java.security.Principal user)

This method returns a list of Permission's that are granted to a particular Principal. This includes any permissions that are granted to Group's to which the Principal belongs unless they are overridden by a negative ACL. This permission list is returned as an Enumeration.

toString

public java.lang.String toString()

This method returns the ACL as a String