com.goldencode.p2j.concurrent

Class ConcurrentResource

java.lang.Object

com.goldencode.expr.Scope

com.goldencode.p2j.security.AbstractResource

com.goldencode.p2j.security.BitFlagsResource

com.goldencode.p2j.concurrent.ConcurrentResource

All Implemented Interfaces:

BitFlagsConstants, Resource

public class ConcurrentResource
extends BitFlagsResource

Implements the "ConcurrentResource" resource. Access to such resources have rights which can be represented by a small set of flags:

• create - a runtime instance of the resource can be created
• delete - an existing runtime instance can be destroyed
• read - the state or data associated with an existing runtime instance can be accessed
• write - the state or data associated with an existing runtime instance can be modified
• denied - no access is allowed (overrides any other access flags)

Rights objects for this resource are made of one bitfield with 8 bits. The first four bits correspond to the create, delete, read and write respectively. There are 3 reserved bits. The last bit is for explicit denial of access. When printed, they are shown as CDRW...N.

Resource names will be namespaced using the subclass' resource type name. The naming approach is /resource_type_name/instance_name. Each different instance of a particular resource type will share the same type name but must have a unique, non-empty instance name.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.Set<java.lang.String>	names All valid resource names.

Fields inherited from class com.goldencode.p2j.security.AbstractResource

objectPointer, resourceIndex, sm

Fields inherited from interface com.goldencode.p2j.security.BitFlagsConstants

BIT_CREATE_ACCESS, BIT_DELETE_ACCESS, BIT_DENIED_ACCESS, BIT_READ_ACCESS, BIT_WRITE_ACCESS, BITSET_SIZE

Constructor Summary

Constructors

Constructor and Description
ConcurrentResource() Default constructor.

Method Summary

Modifier and Type	Method and Description
Rights	getRightsInstance(java.lang.Object[] rights) Instantiates a plugin's class that implements the Rights interface, using the array of objects representing a set of access rights fields.
java.lang.String	getTypeName() Returns the plugin resource type name as a string.
boolean	isInstanceNameValid(java.lang.String resource) Checks whether a given string is a valid resource name for this resource type.
java.util.Set<java.lang.String>	resourceTypeName() Obtains the set of all possible valid resource type names.

Methods inherited from class com.goldencode.p2j.security.BitFlagsResource

accessWorker, canCreate, canDelete, canRead, canWrite, describeRights, getExtendedBits, isRightsSetValid

Methods inherited from class com.goldencode.p2j.security.AbstractResource

associate, attach, disassociate, getACLMatcher, getEnclosingScope, getLibrary, getLink, getPermissions, init, refresh, registeredAs, toString

Methods inherited from class com.goldencode.expr.Scope

getLibraries, getLibraryClasses, getLibsByClass, getVariableList, getVariables

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

names

private static java.util.Set<java.lang.String> names

All valid resource names.

Constructor Detail

ConcurrentResource

public ConcurrentResource()

Default constructor.

Method Detail

resourceTypeName

public java.util.Set<java.lang.String> resourceTypeName()

Obtains the set of all possible valid resource type names.

Returns:

The set of valid resource type names.

getTypeName

public java.lang.String getTypeName()

Returns the plugin resource type name as a string.

Specified by:

getTypeName in interface Resource

Specified by:

getTypeName in class BitFlagsResource

Returns:

The plugin resource type name.

getRightsInstance

public Rights getRightsInstance(java.lang.Object[] rights)

Instantiates a plugin's class that implements the Rights interface, using the array of objects representing a set of access rights fields.

Specified by:

getRightsInstance in interface Resource

Overrides:

getRightsInstance in class BitFlagsResource

Parameters:

rights - The objects needed to create an access rights instance.

Returns:

The newly created rights instance.

isInstanceNameValid

public boolean isInstanceNameValid(java.lang.String resource)

Checks whether a given string is a valid resource name for this resource type.

Valid names are of the form /resource_type_name/instance_name where instance_name is a non-empty string which has no whitespace and which uniquely identifies a given resource instance and where resource_type_name is shared across all resources of the same type. Resource names are NOT case sensitive.

Parameters:

resource - The possible name to validate.

Returns:

true if the name is syntactically correct