org.apache.tools.ant.types
Class Permissions
java.lang.Object
org.apache.tools.ant.types.Permissions
public class Permissions
extends java.lang.Object
This class implements a security manager meant for useage by tasks that run inside the
ant VM. An examples are the Java Task and JUnitTask.
The basic functionality is that nothing (except for a base set of permissions) is allowed, unless
the permission is granted either explicitly or implicitly.
If an permission is granted this can be overruled by explicitly revoking the permission.
It is not permissible to add permissions (either granted or revoked) while the Security Manager
is active (after calling setSecurityManager() but before calling restoreSecurityManager()).
- Ant 1.6
Permissions
public Permissions()
default constructor
Permissions
public Permissions(boolean delegateToOldSM)
create a new set of permissions
delegateToOldSM
- if true
the old security manager
will be used if the permission has not been explicitly granted or revoked
in this instance
if false, it behaves like the default constructor
addConfiguredGrant
public void addConfiguredGrant(Permissions.Permission perm)
Adds a permission to be granted.
perm
- The Permissions.Permission to be granted.
addConfiguredRevoke
public void addConfiguredRevoke(Permissions.Permission perm)
Adds a permission to be revoked.
perm
- The Permissions.Permission to be revoked
restoreSecurityManager
public void restoreSecurityManager()
To be used by tasks that just finished executing the parts subject to these permissions.
setSecurityManager
public void setSecurityManager()
throws BuildException
To be used by tasks wishing to use this security model before executing the part to be
subject to these Permissions. Note that setting the SecurityManager too early may
prevent your part from starting, as for instance changing classloaders may be prohibited.
The classloader for the new situation is supposed to be present.
Copyright B) 2000-2005 Apache Software Foundation. All Rights Reserved.