org.apache.river.phoenix

Class ExecOptionPermission

java.lang.Object

java.security.Permission

org.apache.river.phoenix.ExecOptionPermission

All Implemented Interfaces:

Serializable, Guard

public final class ExecOptionPermission
extends Permission

Represents permission to use a specific option or options in the command for creating an activation group. An instance of this class contains a name (also referred to as a "target name") but no actions list; you either have the named permission or you don't. The target name can be any of the following forms:

 "literal"
 literal*
 literal{fpname}
 string
 

A target name is parsed according to the first form (in the order given above) that it matches. A literal is zero or more arbitrary characters. An fpname is zero or more characters, none of which are '{'. A string is zero or more arbitrary characters that do not match any of the previous forms.

An option option matches a target name of the form "literal" if option is equal to literal.

An option option matches a target name of the form literal* if option starts with literal.

An option option matches a target name of the form literal{fpname} if option starts with literal and the remainder of option matches fpname according to the matching semantics defined by FilePermission; that is, if a FilePermission created with target name fpname (and some actions) implies a FilePermission created with the remainder of option (and the same actions).

An option option matches a target name of the form string if option is equal to string.

Since:

2.0

Author:

Sun Microsystems, Inc.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private Permission	fp
private boolean	plain true if the name ended with a wildcard or fpname, false otherwise
private String	prefix the name without any wildcard or fpname on the end
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
ExecOptionPermission(String name) Constructs an instance with the specified name.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj) Two instances of this class are equal if each implies the other; that is, every option that matches the name of one instance matches the name of the other instance.
String	getActions() Returns the empty string.
int	hashCode() Returns a hash code value for this object.
boolean	implies(Permission p) Returns true if the specified permission is an instance of ExecOptionPermission and every option that matches the name of specified permission also matches the name of this permission; returns false otherwise.
private void	init(String name) Parses the target name and initializes the transient fields.
private void	readObject(ObjectInputStream s) Recreates any transient state.

Methods inherited from class java.security.Permission

checkGuard, getName, newPermissionCollection, toString

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

prefix

private transient String prefix

the name without any wildcard or fpname on the end

plain

private transient boolean plain

true if the name ended with a wildcard or fpname, false otherwise

fp

private transient Permission fp

Constructor Detail

ExecOptionPermission

public ExecOptionPermission(String name)

Constructs an instance with the specified name.

Parameters:

name - the target name

Throws:

NullPointerException - if the name is null

Method Detail

init

private void init(String name)

Parses the target name and initializes the transient fields.

implies

public boolean implies(Permission p)

Returns true if the specified permission is an instance of ExecOptionPermission and every option that matches the name of specified permission also matches the name of this permission; returns false otherwise.

Specified by:

implies in class Permission

Parameters:

p - the permission to check

Returns:

true if the specified permission is an instance of ExecOptionPermission and every option that matches the name of specified permission also matches the name of this permission; false otherwise

equals

public boolean equals(Object obj)

Two instances of this class are equal if each implies the other; that is, every option that matches the name of one instance matches the name of the other instance.

Specified by:

equals in class Permission

hashCode

public int hashCode()

Returns a hash code value for this object.

Specified by:

hashCode in class Permission

getActions

public String getActions()

Returns the empty string.

Specified by:

getActions in class Permission

readObject

private void readObject(ObjectInputStream s)
                 throws IOException,
                        ClassNotFoundException

Recreates any transient state.

Throws:

InvalidObjectException - if the target name is null

IOException

ClassNotFoundException