The DeploymentCustomizerPermission permission gives the right to
Resource Processors to access a bundle's (residing in a Deployment Package)
private area. The bundle and the Resource Processor (customizer) have to be
in the same Deployment Package.

The Resource Processor that has this permission is allowed to access the
bundle's private area by calling the
DeploymentSession.getDataFile(Bundle) method during the session (see
DeploymentSession). After the session ends the FilePermissions are
withdrawn. The Resource Processor will have FilePermission with
"read", "write" and "delete" actions for the returned File
that represents the the base directory of the persistent storage area and for
its subdirectories.

DeploymentCustomizerPermission

Creates a new DeploymentCustomizerPermission object for the given
name and action.

The name parameter is a filter string. This filter has the same syntax as
an OSGi filter but only the "name" attribute is allowed. The value of the
attribute is a Bundle Symbolic Name that represents a bundle. The only
allowed action is the "privatearea" action. E.g.

The Resource Processor that has this permission is allowed to access the
bundle's private area by calling the
DeploymentSession.getDataFile(Bundle) method. The Resource
Processor will have FilePermission with "read", "write" and
"delete" actions for the returned File and its
subdirectories during the deployment session.

Parameters:

name - Bundle Symbolic Name of the target bundle, must not be
null.

actions - action string (only the "privatearea" or "*" action is
valid; "*" means all the possible actions), must not be
null.

Throws:

java.lang.IllegalArgumentException - if the filter is invalid, the list of
actions contains unknown operations or one of the parameters is
null

Method Detail

equals

public boolean equals(java.lang.Object obj)

Checks two DeploymentCustomizerPermission objects for equality.
Two permission objects are equal if:

their target filters are equal (semantically and not character by
character) and

their actions are the same

Specified by:

equals in class java.security.Permission

Parameters:

obj - the reference object with which to compare.

Returns:

true if the two objects are equal.

See Also:

Object.equals(java.lang.Object)

hashCode

public int hashCode()

Returns hash code for this permission object.

Specified by:

hashCode in class java.security.Permission

Returns:

Hash code for this permission object.

See Also:

Object.hashCode()

getActions

public java.lang.String getActions()

Returns the String representation of the action list.

Specified by:

getActions in class java.security.Permission

Returns:

Action list of this permission instance. It is always "privatearea".

See Also:

Permission.getActions()

implies

public boolean implies(java.security.Permission permission)

Checks if this DeploymentCustomizerPermission would imply the parameter permission.
This permission implies another DeploymentCustomizerPermission permission if:

both of them has the "privatearea" action (other actions are not allowed) and