public final class

PolicySpiFile

extends PolicySpi
java.lang.Object
   ↳ java.security.PolicySpi
     ↳ sun.security.provider.PolicySpiFile

Class Overview

This class wraps the PolicyFile subclass implementation of Policy inside a PolicySpi implementation that is available from the SUN provider via the Policy.getInstance calls.

Summary

Public Constructors
PolicySpiFile(Policy.Parameters params)
Protected Methods
PermissionCollection engineGetPermissions(CodeSource codesource)
Return a PermissionCollection object containing the set of permissions granted to the specified CodeSource.
PermissionCollection engineGetPermissions(ProtectionDomain d)
Return a PermissionCollection object containing the set of permissions granted to the specified ProtectionDomain.
boolean engineImplies(ProtectionDomain d, Permission p)
Check whether the policy has granted a Permission to a ProtectionDomain.
void engineRefresh()
Refreshes/reloads the policy configuration.
[Expand]
Inherited Methods
From class java.security.PolicySpi
From class java.lang.Object

Public Constructors

public PolicySpiFile (Policy.Parameters params)

Protected Methods

protected PermissionCollection engineGetPermissions (CodeSource codesource)

Return a PermissionCollection object containing the set of permissions granted to the specified CodeSource.

The default implementation of this method returns Policy.UNSUPPORTED_EMPTY_COLLECTION object. This method can be overridden if the policy implementation can return a set of permissions granted to a CodeSource.

Parameters
codesource the CodeSource to which the returned PermissionCollection has been granted.
Returns
  • a set of permissions granted to the specified CodeSource. If this operation is supported, the returned set of permissions must be a new mutable instance and it must support heterogeneous Permission types. If this operation is not supported, Policy.UNSUPPORTED_EMPTY_COLLECTION is returned.

protected PermissionCollection engineGetPermissions (ProtectionDomain d)

Return a PermissionCollection object containing the set of permissions granted to the specified ProtectionDomain.

The default implementation of this method returns Policy.UNSUPPORTED_EMPTY_COLLECTION object. This method can be overridden if the policy implementation can return a set of permissions granted to a ProtectionDomain.

Parameters
d the ProtectionDomain to which the returned PermissionCollection has been granted.
Returns
  • a set of permissions granted to the specified ProtectionDomain. If this operation is supported, the returned set of permissions must be a new mutable instance and it must support heterogeneous Permission types. If this operation is not supported, Policy.UNSUPPORTED_EMPTY_COLLECTION is returned.

protected boolean engineImplies (ProtectionDomain d, Permission p)

Check whether the policy has granted a Permission to a ProtectionDomain.

Parameters
d the ProtectionDomain to check.
p check whether this permission is granted to the specified domain.
Returns
  • boolean true if the permission is granted to the domain.

protected void engineRefresh ()

Refreshes/reloads the policy configuration. The behavior of this method depends on the implementation. For example, calling refresh on a file-based policy will cause the file to be re-read.

The default implementation of this method does nothing. This method should be overridden if a refresh operation is supported by the policy implementation.