org.apache.jetspeed.security
Class FolderPermission

java.lang.Object
  java.security.Permission
      org.apache.jetspeed.security.PortalResourcePermission
          org.apache.jetspeed.security.FolderPermission

All Implemented Interfaces:

java.io.Serializable, java.security.Guard

public class FolderPermission
extends PortalResourcePermission

Folder permission.

This code was partially inspired from:

• The article : Extend JAAS for class instance-level authorization.
• The FilePermission implementation from the JDK in order to support recursive permissions & wild card

This class represents access to a portal content/folder or document. A FolderPermission consists of a pathname and a set of actions valid for that pathname.

Pathname is the pathname of the folder or document granted the specified actions. A pathname that ends in "/*" (where "/" is the separator character) indicates all the folders and documents contained in that folder. A pathname that ends with "/-" indicates (recursively) all documents and subfolders contained in that directory. A pathname consisting of the special token "<<ALL FILES>>" matches any folder or document.

Version:

$Id: FolderPermission.java 516448 2007-03-09 16:25:47Z ate $

Author:

David Sean Taylor, Christophe Lombart

See Also:

Serialized Form

Field Summary

static char	FOLDER_SEPARATOR
static java.lang.String	FOLDER_SEPARATOR_STR
static char	RECURSIVE_CHAR
static char	WILD_CHAR
static java.lang.String	WILD_CHAR_STR

Fields inherited from class org.apache.jetspeed.security.PortalResourcePermission

mask

Constructor Summary

FolderPermission(java.lang.String name, int mask)
Constructor for FolderPermission.

FolderPermission(java.lang.String name, java.lang.String actions)
Constructor for FolderPermission.

Method Summary

boolean	equals(java.lang.Object obj) Checks two FolderPermission objects for equality.
int	hashCode() Returns the hash code value for this object.
boolean	implies(java.security.Permission p) Checks if this FolderPermission object "implies" the specified permission.

Methods inherited from class org.apache.jetspeed.security.PortalResourcePermission

getActions, newPermissionCollection, parseActions

Methods inherited from class java.security.Permission

checkGuard, getName, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

RECURSIVE_CHAR

public static final char RECURSIVE_CHAR

See Also:

Constant Field Values

WILD_CHAR

public static final char WILD_CHAR

See Also:

Constant Field Values

WILD_CHAR_STR

public static final java.lang.String WILD_CHAR_STR

FOLDER_SEPARATOR

public static final char FOLDER_SEPARATOR

See Also:

Constant Field Values

FOLDER_SEPARATOR_STR

public static final java.lang.String FOLDER_SEPARATOR_STR

Constructor Detail

FolderPermission

public FolderPermission(java.lang.String name,
                        java.lang.String actions)

Constructor for FolderPermission.

Parameters:

name - The portlet name.

actions - The actions on the portlet.

FolderPermission

public FolderPermission(java.lang.String name,
                        int mask)

Constructor for FolderPermission.

Parameters:

name - The portlet name.

mask - The mask of actions on the portlet.

Method Detail

implies

public boolean implies(java.security.Permission p)

Checks if this FolderPermission object "implies" the specified permission.

More specifically, this method returns true if:

• p is an instanceof FolderPermission,

• p's actions are a proper subset of this object's actions, and

• p's pathname is implied by this object's pathname. For example, "/tmp/*" implies "/tmp/foo", since "/tmp/*" encompasses the "/tmp" folder and all subfolders or documents in that directory, including the one named "foo".

Overrides:

implies in class PortalResourcePermission

Parameters:

p - the permission to check against.

Returns:

true if the specified permission is implied by this object, false if not.

equals

public boolean equals(java.lang.Object obj)

Checks two FolderPermission objects for equality. Checks that obj is a FolderPermission, and has the same pathname and actions as this object.

Specified by:

equals in class java.security.Permission

Parameters:

obj - the object we are testing for equality with this object.

Returns:

true if obj is a FolderPermission, and has the same pathname and actions as this FolderPermission object.

hashCode

public int hashCode()

Returns the hash code value for this object.

Overrides:

hashCode in class PortalResourcePermission

Returns:

a hash code value for this object.

See Also:

Permission.hashCode()