edu.utexas.cs.bevotest

Class PolicyWrapper

java.lang.Object

java.security.Policy

edu.utexas.cs.bevotest.PolicyWrapper

public class PolicyWrapper
extends java.security.Policy

A security Policy that wraps another policy and adds given Permissions to it. Note that this grants permissions globally, to all classes in this JVM instance. Your security policy may need to be more granular, granting permissions only to certain ProtectionDomains, in which case this class is not the right solution.

Use of this class is equivalent to a security policy configuration file with a default grant entry specifying the given permissions.

Example of use:

 Policy.setPolicy(new PolicyWrapper(Policy.getPolicy(),
     BevoTest.REQUESTED_PERMISSIONS,
     PlaintextTestReporter.REQUESTED_PERMISSIONS,
     new FilePermission("somefile.txt", "read"),
     new FilePermission("anotherfile.txt", "read")
 ));
 System.setSecurityManager(new SecurityManager());
 

Version:

$Id$

Author:

John Thywissen

See Also:

Policy, "Default Policy Implementation and Policy File Syntax"

Nested Class Summary

Nested classes/interfaces inherited from class java.security.Policy

java.security.Policy.Parameters

Field Summary

Fields inherited from class java.security.Policy

UNSUPPORTED_EMPTY_COLLECTION

Constructor Summary

Constructors

Constructor and Description
PolicyWrapper(java.security.Policy wrappedPolicy, java.lang.Object... addPermissionsAndCollections) Constructs a PolicyWrapper for the given Policy, which globally grants the given Permission and PermissionCollections.

Method Summary

Modifier and Type	Method and Description
java.security.Policy.Parameters	getParameters()
java.security.PermissionCollection	getPermissions(java.security.CodeSource codesource)
java.security.PermissionCollection	getPermissions(java.security.ProtectionDomain domain)
java.security.Provider	getProvider()
java.lang.String	getType()
boolean	implies(java.security.ProtectionDomain domain, java.security.Permission permission)
void	refresh()

Methods inherited from class java.security.Policy

getInstance, getInstance, getInstance, getPolicy, setPolicy

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PolicyWrapper

public PolicyWrapper(java.security.Policy wrappedPolicy,
                     java.lang.Object... addPermissionsAndCollections)

Constructs a PolicyWrapper for the given Policy, which globally grants the given Permission and PermissionCollections.

Parameters:

wrappedPolicy - the Policy to be wrapped

addPermissionsAndCollections - varargs or array, each element of which is either a Permission or a PermissionCollection

Throws:

java.lang.IllegalArgumentException - if any element of the argument is not either a Permission or a PermissionCollection

See Also:

Permission, PermissionCollection

Method Detail

getProvider

public java.security.Provider getProvider()

Overrides:

getProvider in class java.security.Policy

getType

public java.lang.String getType()

Overrides:

getType in class java.security.Policy

getParameters

public java.security.Policy.Parameters getParameters()

Overrides:

getParameters in class java.security.Policy

getPermissions

public java.security.PermissionCollection getPermissions(java.security.CodeSource codesource)

Overrides:

getPermissions in class java.security.Policy

getPermissions

public java.security.PermissionCollection getPermissions(java.security.ProtectionDomain domain)

Overrides:

getPermissions in class java.security.Policy

implies

public boolean implies(java.security.ProtectionDomain domain,
                       java.security.Permission permission)

Overrides:

implies in class java.security.Policy

refresh

public void refresh()

Overrides:

refresh in class java.security.Policy