Modifier and Type	Class and Description
public static interface	Policy.Parameters Deprecated for removal since 17. This class is only useful in conjunction with the Security Manager, which is deprecated and subject to removal in a future release. This represents a marker interface for Policy parameters.
private static class	Policy.PolicyDelegate References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. This subclass is returned by the getInstance calls.
private static class	Policy.PolicyInfo
private static class	Policy.UnsupportedEmptyCollection This class represents a read-only empty PermissionCollection object that is returned from the `getPermissions(CodeSource)` and `getPermissions(ProtectionDomain)` methods in the `Policy` class when those operations are not supported by the Policy implementation.

Modifier and Type	Field and Description
private static final Debug	debug
private static final String	DEFAULT_POLICY
private WeakHashMap<ProtectionDomain.Key, PermissionCollection>	pdMapping
private static volatile Policy.PolicyInfo	policyInfo
public static final PermissionCollection	UNSUPPORTED_EMPTY_COLLECTION A read-only empty PermissionCollection instance.

Access	Constructor and Description
public	Policy() Constructor for subclasses to call.

Method Summary

Modifier and Type	Method and Description
private void	addStaticPerms(PermissionCollection perms, PermissionCollection statics) add static permissions to provided permission collection
private static void	checkPermission(String type)
public static Policy	Returns: the new `Policy` object getInstance(String the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types. type, Policy.Parameters parameters for the `Policy`, which may be `null`. params) References Deprecated `Policy.Parameters` and `Policy` are deprecated or reference (maybe indirectly) at least one deprecated element. Returns a Policy object of the specified type.
public static Policy	Returns: the new `Policy` object getInstance(String the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types. type, Policy.Parameters parameters for the `Policy`, which may be `null`. params, String the provider. provider) References Deprecated `Policy.Parameters` and `Policy` are deprecated or reference (maybe indirectly) at least one deprecated element. Returns a `Policy` object of the specified type.
public static Policy	Returns: the new `Policy` object getInstance(String the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types. type, Policy.Parameters parameters for the `Policy`, which may be `null`. params, Provider the `Provider`. provider) References Deprecated `Policy.Parameters` and `Policy` are deprecated or reference (maybe indirectly) at least one deprecated element. Returns a `Policy` object of the specified type.
public Policy.Parameters	Returns: `Policy` parameters, or `null`. getParameters() References Deprecated `Policy.Parameters` is deprecated or references (maybe indirectly) at least one deprecated element. Return `Policy` parameters.
public PermissionCollection	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. getPermissions(CodeSource the CodeSource to which the returned PermissionCollection has been granted. codesource) Return a PermissionCollection object containing the set of permissions granted to the specified CodeSource.
public PermissionCollection	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. getPermissions(ProtectionDomain the ProtectionDomain to which the returned PermissionCollection has been granted. domain) Return a PermissionCollection object containing the set of permissions granted to the specified ProtectionDomain.
public static Policy	Returns: the installed Policy. getPolicy() References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. Returns the installed `Policy` object.
pack-priv static Policy	Returns: the installed `Policy`. getPolicyNoCheck() References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. Returns the installed `Policy` object, skipping the security check.
public Provider	Returns: the `Provider` of this policy, or `null`. getProvider() Return the `Provider` of this policy.
public String	Returns: the type of this `Policy`, or `null`. getType() Return the type of this `Policy`.
private static Policy	handleException(NoSuchAlgorithmException nsae) References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element.
public boolean	Returns: `true` if "permission" is a proper subset of a permission granted to this ProtectionDomain. implies(ProtectionDomain the ProtectionDomain to test domain, Permission the Permission object to be tested for implication. permission) Evaluates the global policy for the permissions granted to the ProtectionDomain and tests whether the permission is granted.
private static void	initPolicy(final Policy p) References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. Initialize superclass state such that a legacy provider can handle queries for itself.
pack-priv static boolean	isSet() package private for AccessControlContext and ProtectionDomain
private static Policy	loadPolicyProvider() References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. Loads and instantiates a Policy implementation specified by the policy.provider security property.
public void	refresh() Refreshes/reloads the policy configuration.
public static void	setPolicy(Policy the new system `Policy` object. p) References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. Sets the system-wide `Policy` object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

debug	back to summary
private static final Debug debug

DEFAULT_POLICY	back to summary
private static final String DEFAULT_POLICY

pdMapping	back to summary
private WeakHashMap<ProtectionDomain.Key, PermissionCollection> pdMapping

policyInfo	back to summary
private static volatile Policy.PolicyInfo policyInfo

UNSUPPORTED_EMPTY_COLLECTION	back to summary
public static final PermissionCollection UNSUPPORTED_EMPTY_COLLECTION A read-only empty PermissionCollection instance. Since 1.6

UNSUPPORTED_EMPTY_COLLECTION

back to summary

public static final PermissionCollection UNSUPPORTED_EMPTY_COLLECTION

A read-only empty PermissionCollection instance.

Since: 1.6

Constructor Detail

Policy	back to summary
public Policy() Constructor for subclasses to call.

Method Detail

addStaticPerms	back to summary
private void addStaticPerms(PermissionCollection perms, PermissionCollection statics) add static permissions to provided permission collection

checkPermission	back to summary
private static void checkPermission(String type)

getInstance back to summary

getInstance	back to summary
public static Policy getInstance(String type, Policy.Parameters params) throws NoSuchAlgorithmException References Deprecated `Policy.Parameters` and `Policy` are deprecated or reference (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Returns a Policy object of the specified type. This method traverses the list of registered security providers, starting with the most preferred provider. A new `Policy` object encapsulating the `PolicySpi` implementation from the first provider that supports the specified type is returned. Note that the list of registered providers may be retrieved via the `Security.getProviders()` method. Implementation Note The JDK Reference Implementation additionally uses the `jdk.security.provider.preferred` `Security` property to determine the preferred provider order for the specified algorithm. This may be different than the order of providers returned by `Security.getProviders()`. Parameters type:String the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types. params:Policy.Parameters parameters for the `Policy`, which may be `null`. Returns:Policy the new `Policy` object Annotations @SuppressWarnings:removal Exceptions NoSuchAlgorithmException: if no `Provider` supports a `PolicySpi` implementation for the specified type IllegalArgumentException: if the specified parameters are not understood by the `PolicySpi` implementation from the selected `Provider` NullPointerException: if `type` is `null` SecurityException: if the caller does not have permission to get a `Policy` instance for the specified type. Since 1.6 See Also `Provider`

public static Policy getInstance(String type, Policy.Parameters params) throws NoSuchAlgorithmException

References Deprecated

Policy.Parameters and Policy are deprecated or reference (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Returns a Policy object of the specified type.

This method traverses the list of registered security providers, starting with the most preferred provider. A new Policy object encapsulating the PolicySpi implementation from the first provider that supports the specified type is returned.

Note that the list of registered providers may be retrieved via the Security.getProviders() method.

Implementation Note

The JDK Reference Implementation additionally uses the jdk.security.provider.preferred Security property to determine the preferred provider order for the specified algorithm. This may be different than the order of providers returned by Security.getProviders().

Parameters

type:String: the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types.
params:Policy.Parameters: parameters for the Policy, which may be null.

Returns:Policy

the new Policy object

Annotations

@SuppressWarnings:removal

Exceptions

NoSuchAlgorithmException:: if no Provider supports a PolicySpi implementation for the specified type
IllegalArgumentException:: if the specified parameters are not understood by the PolicySpi implementation from the selected Provider
NullPointerException:: if type is null
SecurityException:: if the caller does not have permission to get a Policy instance for the specified type.

Since

1.6

See Also

Provider

getInstance back to summary

getInstance	back to summary
public static Policy getInstance(String type, Policy.Parameters params, String provider) throws NoSuchProviderException, NoSuchAlgorithmException References Deprecated `Policy.Parameters` and `Policy` are deprecated or reference (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Returns a `Policy` object of the specified type. A new `Policy` object encapsulating the `PolicySpi` implementation from the specified provider is returned. The specified provider must be registered in the provider list. Note that the list of registered providers may be retrieved via the `Security.getProviders()` method. Parameters type:String the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types. params:Policy.Parameters parameters for the `Policy`, which may be `null`. provider:String the provider. Returns:Policy the new `Policy` object Annotations @SuppressWarnings:removal Exceptions NoSuchProviderException: if the specified provider is not registered in the security provider list NoSuchAlgorithmException: if the specified provider does not support a `PolicySpi` implementation for the specified type IllegalArgumentException: if the specified provider is `null` or empty, or if the specified parameters are not understood by the `PolicySpi` implementation from the specified provider NullPointerException: if `type` is `null` SecurityException: if the caller does not have permission to get a `Policy` instance for the specified type Since 1.6 See Also `Provider`

public static Policy getInstance(String type, Policy.Parameters params, String provider) throws NoSuchProviderException, NoSuchAlgorithmException

References Deprecated

Policy.Parameters and Policy are deprecated or reference (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Returns a Policy object of the specified type.

A new Policy object encapsulating the PolicySpi implementation from the specified provider is returned. The specified provider must be registered in the provider list.

Note that the list of registered providers may be retrieved via the Security.getProviders() method.

Parameters

type:String: the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types.
params:Policy.Parameters: parameters for the Policy, which may be null.
provider:String: the provider.

Returns:Policy

the new Policy object

Annotations

@SuppressWarnings:removal

Exceptions

NoSuchProviderException:: if the specified provider is not registered in the security provider list
NoSuchAlgorithmException:: if the specified provider does not support a PolicySpi implementation for the specified type
IllegalArgumentException:: if the specified provider is null or empty, or if the specified parameters are not understood by the PolicySpi implementation from the specified provider
NullPointerException:: if type is null
SecurityException:: if the caller does not have permission to get a Policy instance for the specified type

Since

1.6

See Also

Provider

getInstance back to summary

getInstance	back to summary
public static Policy getInstance(String type, Policy.Parameters params, Provider provider) throws NoSuchAlgorithmException References Deprecated `Policy.Parameters` and `Policy` are deprecated or reference (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Returns a `Policy` object of the specified type. A new `Policy` object encapsulating the `PolicySpi` implementation from the specified provider is returned. Note that the specified provider does not have to be registered in the provider list. Parameters type:String the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types. params:Policy.Parameters parameters for the `Policy`, which may be `null`. provider:Provider the `Provider`. Returns:Policy the new `Policy` object Annotations @SuppressWarnings:removal Exceptions NoSuchAlgorithmException: if the specified `Provider` does not support a `PolicySpi` implementation for the specified type IllegalArgumentException: if the specified `Provider` is `null`, or if the specified parameters are not understood by the `PolicySpi` implementation from the specified `Provider` NullPointerException: if `type` is `null` SecurityException: if the caller does not have permission to get a `Policy` instance for the specified type Since 1.6 See Also `Provider`

public static Policy getInstance(String type, Policy.Parameters params, Provider provider) throws NoSuchAlgorithmException

References Deprecated

Policy.Parameters and Policy are deprecated or reference (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Returns a Policy object of the specified type.

A new Policy object encapsulating the PolicySpi implementation from the specified provider is returned. Note that the specified provider does not have to be registered in the provider list.

Parameters

type:String: the specified Policy type. See the Policy section in the Java Security Standard Algorithm Names Specification for a list of standard Policy types.
params:Policy.Parameters: parameters for the Policy, which may be null.
provider:Provider: the Provider.

Returns:Policy

the new Policy object

Annotations

@SuppressWarnings:removal

Exceptions

NoSuchAlgorithmException:: if the specified Provider does not support a PolicySpi implementation for the specified type
IllegalArgumentException:: if the specified Provider is null, or if the specified parameters are not understood by the PolicySpi implementation from the specified Provider
NullPointerException:: if type is null
SecurityException:: if the caller does not have permission to get a Policy instance for the specified type

Since

1.6

See Also

Provider

getParameters back to summary

getParameters	back to summary
public Policy.Parameters getParameters() References Deprecated `Policy.Parameters` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Return `Policy` parameters. This `Policy` instance will only have parameters if it was obtained via a call to `Policy.getInstance`. Otherwise this method returns `null`. Returns:Policy.Parameters `Policy` parameters, or `null`. Since 1.6

public Policy.Parameters getParameters()

References Deprecated

Policy.Parameters is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Return Policy parameters.

This Policy instance will only have parameters if it was obtained via a call to Policy.getInstance. Otherwise this method returns null.

Returns:Policy.Parameters: Policy parameters, or null.
Since: 1.6

getPermissions back to summary

getPermissions	back to summary
public PermissionCollection getPermissions(CodeSource codesource) Return a PermissionCollection object containing the set of permissions granted to the specified CodeSource. Applications are discouraged from calling this method since this operation may not be supported by all policy implementations. Applications should solely rely on the `implies` method to perform policy checks. If an application absolutely must call a getPermissions method, it should call `getPermissions(ProtectionDomain)`. The default implementation of this method returns Policy.UNSUPPORTED_EMPTY_COLLECTION. This method can be overridden if the policy implementation can return a set of permissions granted to a CodeSource. Parameters codesource:CodeSource the CodeSource to which the returned PermissionCollection has been granted. Returns:PermissionCollection 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.

public PermissionCollection getPermissions(CodeSource codesource)

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

Applications are discouraged from calling this method since this operation may not be supported by all policy implementations. Applications should solely rely on the implies method to perform policy checks. If an application absolutely must call a getPermissions method, it should call getPermissions(ProtectionDomain).

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

Parameters

codesource:CodeSource: the CodeSource to which the returned PermissionCollection has been granted.

Returns:PermissionCollection

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.

getPermissions back to summary

getPermissions	back to summary
public PermissionCollection getPermissions(ProtectionDomain domain) Return a PermissionCollection object containing the set of permissions granted to the specified ProtectionDomain. Applications are discouraged from calling this method since this operation may not be supported by all policy implementations. Applications should rely on the `implies` method to perform policy checks. The default implementation of this method first retrieves the permissions returned via `getPermissions(CodeSource)` (the CodeSource is taken from the specified ProtectionDomain), as well as the permissions located inside the specified ProtectionDomain. All of these permissions are then combined and returned in a new PermissionCollection object. If `getPermissions(CodeSource)` returns Policy.UNSUPPORTED_EMPTY_COLLECTION, then this method returns the permissions contained inside the specified ProtectionDomain in a new PermissionCollection object. This method can be overridden if the policy implementation supports returning a set of permissions granted to a ProtectionDomain. Parameters domain:ProtectionDomain the ProtectionDomain to which the returned PermissionCollection has been granted. Returns:PermissionCollection 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. Since 1.4

public PermissionCollection getPermissions(ProtectionDomain domain)

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

Applications are discouraged from calling this method since this operation may not be supported by all policy implementations. Applications should rely on the implies method to perform policy checks.

The default implementation of this method first retrieves the permissions returned via getPermissions(CodeSource) (the CodeSource is taken from the specified ProtectionDomain), as well as the permissions located inside the specified ProtectionDomain. All of these permissions are then combined and returned in a new PermissionCollection object. If getPermissions(CodeSource) returns Policy.UNSUPPORTED_EMPTY_COLLECTION, then this method returns the permissions contained inside the specified ProtectionDomain in a new PermissionCollection object.

This method can be overridden if the policy implementation supports returning a set of permissions granted to a ProtectionDomain.

Parameters

domain:ProtectionDomain: the ProtectionDomain to which the returned PermissionCollection has been granted.

Returns:PermissionCollection

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.

Since

1.4

getPolicy back to summary

getPolicy	back to summary
public static Policy getPolicy() References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Returns the installed `Policy` object. This value should not be cached, as it may be changed by a call to `setPolicy`. This method first calls `SecurityManager.checkPermission` with a `SecurityPermission("getPolicy")` permission to ensure it's ok to get the `Policy` object. Returns:Policy the installed Policy. Exceptions SecurityException: if a security manager exists and its `checkPermission` method doesn't allow getting the `Policy` object. See Also `SecurityManager#checkPermission(Permission)`, `setPolicy(java.security.Policy)`

public static Policy getPolicy()

References Deprecated

Policy is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Returns the installed Policy object. This value should not be cached, as it may be changed by a call to setPolicy. This method first calls SecurityManager.checkPermission with a SecurityPermission("getPolicy") permission to ensure it's ok to get the Policy object.

Returns:Policy

the installed Policy.

Exceptions

SecurityException:: if a security manager exists and its checkPermission method doesn't allow getting the Policy object.

getPolicyNoCheck back to summary

getPolicyNoCheck	back to summary
pack-priv static Policy getPolicyNoCheck() References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Returns the installed `Policy` object, skipping the security check. Used by ProtectionDomain and getPolicy. Returns:Policy the installed `Policy`.

pack-priv static Policy getPolicyNoCheck()

References Deprecated

Policy is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Returns the installed Policy object, skipping the security check. Used by ProtectionDomain and getPolicy.

Returns:Policy: the installed Policy.

getProvider back to summary

getProvider	back to summary
public Provider getProvider() Return the `Provider` of this policy. This `Policy` instance will only have a provider if it was obtained via a call to `Policy.getInstance`. Otherwise this method returns `null`. Returns:Provider the `Provider` of this policy, or `null`. Since 1.6

public Provider getProvider()

Return the Provider of this policy.

This Policy instance will only have a provider if it was obtained via a call to Policy.getInstance. Otherwise this method returns null.

Returns:Provider: the Provider of this policy, or null.
Since: 1.6

getType back to summary

getType	back to summary
public String getType() Return the type of this `Policy`. This `Policy` instance will only have a type if it was obtained via a call to `Policy.getInstance`. Otherwise this method returns `null`. Returns:String the type of this `Policy`, or `null`. Since 1.6

public String getType()

Return the type of this Policy.

This Policy instance will only have a type if it was obtained via a call to Policy.getInstance. Otherwise this method returns null.

Returns:String: the type of this Policy, or null.
Since: 1.6

handleException	back to summary
private static Policy handleException(NoSuchAlgorithmException nsae) throws NoSuchAlgorithmException References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information.

implies back to summary

implies	back to summary
public boolean implies(ProtectionDomain domain, Permission permission) Evaluates the global policy for the permissions granted to the ProtectionDomain and tests whether the permission is granted. Parameters domain:ProtectionDomain the ProtectionDomain to test permission:Permission the Permission object to be tested for implication. Returns:boolean `true` if "permission" is a proper subset of a permission granted to this ProtectionDomain. Since 1.4 See Also `java.security.ProtectionDomain`

public boolean implies(ProtectionDomain domain, Permission permission)

Evaluates the global policy for the permissions granted to the ProtectionDomain and tests whether the permission is granted.

Parameters

domain:ProtectionDomain: the ProtectionDomain to test
permission:Permission: the Permission object to be tested for implication.

Returns:boolean

true if "permission" is a proper subset of a permission granted to this ProtectionDomain.

Since

1.4

See Also

java.security.ProtectionDomain

initPolicy back to summary

initPolicy	back to summary
private static void initPolicy(final Policy p) References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Initialize superclass state such that a legacy provider can handle queries for itself. Since 1.4

private static void initPolicy(final Policy p)

References Deprecated

Policy is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Initialize superclass state such that a legacy provider can handle queries for itself.

Since: 1.4

isSet	back to summary
pack-priv static boolean isSet() package private for AccessControlContext and ProtectionDomain

loadPolicyProvider back to summary

loadPolicyProvider	back to summary
private static Policy loadPolicyProvider() References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Loads and instantiates a Policy implementation specified by the policy.provider security property. Note that this method should only be called by getPolicyNoCheck and from within a synchronized block with an intrinsic lock on the Policy.class.

private static Policy loadPolicyProvider()

References Deprecated

Policy is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Loads and instantiates a Policy implementation specified by the policy.provider security property. Note that this method should only be called by getPolicyNoCheck and from within a synchronized block with an intrinsic lock on the Policy.class.

refresh back to summary

refresh	back to summary
public void refresh() 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.

public void refresh()

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.

setPolicy back to summary

setPolicy	back to summary
public static void setPolicy(Policy p) References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Sets the system-wide `Policy` object. This method first calls `SecurityManager.checkPermission` with a `SecurityPermission("setPolicy")` permission to ensure it's ok to set the Policy. Parameters p:Policy the new system `Policy` object. Exceptions SecurityException: if a security manager exists and its `checkPermission` method doesn't allow setting the Policy. See Also `SecurityManager#checkPermission(Permission)`, `getPolicy()`

public static void setPolicy(Policy p)

References Deprecated

Policy is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Sets the system-wide Policy object. This method first calls SecurityManager.checkPermission with a SecurityPermission("setPolicy") permission to ensure it's ok to set the Policy.

Parameters

p:Policy: the new system Policy object.

Exceptions

SecurityException:: if a security manager exists and its checkPermission method doesn't allow setting the Policy.

java.security back to summary

public Interface Policy.Parameters

Known Direct Implementers

java.security.URIParameter

Annotations

@Deprecated
since:17
forRemoval:true

Deprecated

for removal since 17.

This class is only useful in conjunction with the Security Manager, which is deprecated and subject to removal in a future release. Consequently, this class is also deprecated and subject to removal. There is no replacement for the Security Manager or this class.

This represents a marker interface for Policy parameters.

Since: 1.6

java.security back to summary

private Class Policy.PolicyDelegate

Class Inheritance

extends Policy

java.lang.Object
java.security.Policy
java.security.Policy.PolicyDelegate

References Deprecated

Policy is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

This subclass is returned by the getInstance calls. All Policy calls are delegated to the underlying PolicySpi.

Field Summary

Modifier and Type	Field and Description
private Provider	p
private Policy.Parameters	params References Deprecated `Policy.Parameters` is deprecated or references (maybe indirectly) at least one deprecated element.
private PolicySpi	spi References Deprecated `PolicySpi` is deprecated or references (maybe indirectly) at least one deprecated element.
private String	type

Inherited from java.security.Policy:: UNSUPPORTED_EMPTY_COLLECTION

Constructor Summary

Access	Constructor and Description
private	PolicyDelegate(PolicySpi spi, Provider p, String type, Policy.Parameters params) References Deprecated `PolicySpi` and `Policy.Parameters` are deprecated or reference (maybe indirectly) at least one deprecated element.

Method Summary

Modifier and Type	Method and Description
public Policy.Parameters	getParameters() Overrides java.security.Policy.getParameters. References Deprecated `Policy.Parameters` is deprecated or references (maybe indirectly) at least one deprecated element. Return `Policy` parameters.
public PermissionCollection	getPermissions(CodeSource the CodeSource to which the returned PermissionCollection has been granted. codesource) Overrides java.security.Policy.getPermissions. Return a PermissionCollection object containing the set of permissions granted to the specified CodeSource.
public PermissionCollection	getPermissions(ProtectionDomain the ProtectionDomain to which the returned PermissionCollection has been granted. domain) Overrides java.security.Policy.getPermissions. Return a PermissionCollection object containing the set of permissions granted to the specified ProtectionDomain.
public Provider	getProvider() Overrides java.security.Policy.getProvider. Return the `Provider` of this policy.
public String	getType() Overrides java.security.Policy.getType. Return the type of this `Policy`.
public boolean	implies(ProtectionDomain the ProtectionDomain to test domain, Permission the Permission object to be tested for implication. perm) Overrides java.security.Policy.implies. Evaluates the global policy for the permissions granted to the ProtectionDomain and tests whether the permission is granted.
public void	refresh() Overrides java.security.Policy.refresh. Refreshes/reloads the policy configuration.

Inherited from java.security.Policy:: getInstance getInstance getInstance getPolicy getPolicyNoCheck isSet setPolicy

Field Detail

p	back to summary
private Provider p

params	back to summary
private Policy.Parameters params References Deprecated `Policy.Parameters` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information.

spi	back to summary
private PolicySpi spi References Deprecated `PolicySpi` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Annotations @SuppressWarnings:removal

type	back to summary
private String type

Constructor Detail

PolicyDelegate	back to summary
private PolicyDelegate(PolicySpi spi, Provider p, String type, Policy.Parameters params) References Deprecated `PolicySpi` and `Policy.Parameters` are deprecated or reference (maybe indirectly) at least one deprecated element. See corresponding docs for further information.

Method Detail

getParameters back to summary

getParameters	back to summary
public Policy.Parameters getParameters() Overrides java.security.Policy.getParameters. Doc from java.security.Policy.getParameters. References Deprecated `Policy.Parameters` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Return `Policy` parameters. This `Policy` instance will only have parameters if it was obtained via a call to `Policy.getInstance`. Otherwise this method returns `null`. Returns:Policy.Parameters `Policy` parameters, or `null`. Annotations @Override

public Policy.Parameters getParameters()

Overrides java.security.Policy.getParameters.

Doc from java.security.Policy.getParameters.

References Deprecated

Policy.Parameters is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Return Policy parameters.

This Policy instance will only have parameters if it was obtained via a call to Policy.getInstance. Otherwise this method returns null.

Returns:Policy.Parameters

Policy parameters, or null.

Annotations

@Override

getPermissions back to summary

getPermissions	back to summary
public PermissionCollection getPermissions(CodeSource codesource) Overrides java.security.Policy.getPermissions. Doc from java.security.Policy.getPermissions. Return a PermissionCollection object containing the set of permissions granted to the specified CodeSource. Applications are discouraged from calling this method since this operation may not be supported by all policy implementations. Applications should solely rely on the `implies` method to perform policy checks. If an application absolutely must call a getPermissions method, it should call `getPermissions(ProtectionDomain)`. The default implementation of this method returns Policy.UNSUPPORTED_EMPTY_COLLECTION. This method can be overridden if the policy implementation can return a set of permissions granted to a CodeSource. Parameters codesource:CodeSource the CodeSource to which the returned PermissionCollection has been granted. Returns:PermissionCollection 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. Annotations @Override

public PermissionCollection getPermissions(CodeSource codesource)

Overrides java.security.Policy.getPermissions.

Doc from java.security.Policy.getPermissions.

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

Parameters

codesource:CodeSource: the CodeSource to which the returned PermissionCollection has been granted.

Returns:PermissionCollection

Annotations

@Override

getPermissions back to summary

getPermissions	back to summary
public PermissionCollection getPermissions(ProtectionDomain domain) Overrides java.security.Policy.getPermissions. Doc from java.security.Policy.getPermissions. Return a PermissionCollection object containing the set of permissions granted to the specified ProtectionDomain. Applications are discouraged from calling this method since this operation may not be supported by all policy implementations. Applications should rely on the `implies` method to perform policy checks. The default implementation of this method first retrieves the permissions returned via `getPermissions(CodeSource)` (the CodeSource is taken from the specified ProtectionDomain), as well as the permissions located inside the specified ProtectionDomain. All of these permissions are then combined and returned in a new PermissionCollection object. If `getPermissions(CodeSource)` returns Policy.UNSUPPORTED_EMPTY_COLLECTION, then this method returns the permissions contained inside the specified ProtectionDomain in a new PermissionCollection object. This method can be overridden if the policy implementation supports returning a set of permissions granted to a ProtectionDomain. Parameters domain:ProtectionDomain the ProtectionDomain to which the returned PermissionCollection has been granted. Returns:PermissionCollection 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. Annotations @Override

public PermissionCollection getPermissions(ProtectionDomain domain)

Overrides java.security.Policy.getPermissions.

Doc from java.security.Policy.getPermissions.

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

This method can be overridden if the policy implementation supports returning a set of permissions granted to a ProtectionDomain.

Parameters

domain:ProtectionDomain: the ProtectionDomain to which the returned PermissionCollection has been granted.

Returns:PermissionCollection

Annotations

@Override

getProvider back to summary

getProvider	back to summary
public Provider getProvider() Overrides java.security.Policy.getProvider. Doc from java.security.Policy.getProvider. Return the `Provider` of this policy. This `Policy` instance will only have a provider if it was obtained via a call to `Policy.getInstance`. Otherwise this method returns `null`. Returns:Provider the `Provider` of this policy, or `null`. Annotations @Override

public Provider getProvider()

Overrides java.security.Policy.getProvider.

Doc from java.security.Policy.getProvider.

Return the Provider of this policy.

This Policy instance will only have a provider if it was obtained via a call to Policy.getInstance. Otherwise this method returns null.

Returns:Provider

the Provider of this policy, or null.

Annotations

@Override

getType back to summary

getType	back to summary
public String getType() Overrides java.security.Policy.getType. Doc from java.security.Policy.getType. Return the type of this `Policy`. This `Policy` instance will only have a type if it was obtained via a call to `Policy.getInstance`. Otherwise this method returns `null`. Returns:String the type of this `Policy`, or `null`. Annotations @Override

public String getType()

Overrides java.security.Policy.getType.

Doc from java.security.Policy.getType.

Return the type of this Policy.

This Policy instance will only have a type if it was obtained via a call to Policy.getInstance. Otherwise this method returns null.

Returns:String

the type of this Policy, or null.

Annotations

@Override

implies back to summary

implies	back to summary
public boolean implies(ProtectionDomain domain, Permission perm) Overrides java.security.Policy.implies. Doc from java.security.Policy.implies. Evaluates the global policy for the permissions granted to the ProtectionDomain and tests whether the permission is granted. Parameters domain:ProtectionDomain the ProtectionDomain to test perm:Permission the Permission object to be tested for implication. Returns:boolean `true` if "permission" is a proper subset of a permission granted to this ProtectionDomain. Annotations @Override

public boolean implies(ProtectionDomain domain, Permission perm)

Overrides java.security.Policy.implies.

Doc from java.security.Policy.implies.

Evaluates the global policy for the permissions granted to the ProtectionDomain and tests whether the permission is granted.

Parameters

domain:ProtectionDomain: the ProtectionDomain to test
perm:Permission: the Permission object to be tested for implication.

Returns:boolean

true if "permission" is a proper subset of a permission granted to this ProtectionDomain.

Annotations

@Override

refresh back to summary

refresh	back to summary
public void refresh() Overrides java.security.Policy.refresh. Doc from java.security.Policy.refresh. 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. Annotations @Override

public void refresh()

Overrides java.security.Policy.refresh.

Doc from java.security.Policy.refresh.

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.

Annotations

@Override

Modifier and Type	Field and Description
pack-priv final boolean	initialized
pack-priv final Policy	policy References Deprecated `Policy` is deprecated or references (maybe indirectly) at least one deprecated element.

public abstract Class Policy

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Interface Policy.Parameters

private Class Policy.PolicyDelegate

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Policy.PolicyInfo

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

private Class Policy.UnsupportedEmptyCollection

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

Modifier and Type	Field and Description
private Permissions	perms
private static final long	serialVersionUID Hides java.security.PermissionCollection.serialVersionUID.

Modifier and Type	Method and Description
public void	add(Permission the Permission object to add. permission) Implements abstract java.security.PermissionCollection.add. Adds a permission object to the current collection of permission objects.
public Enumeration<Permission>	Returns: an enumeration of all the Permissions. elements() Implements abstract java.security.PermissionCollection.elements. Returns an enumeration of all the Permission objects in the collection.
public boolean	Returns: `true` if "permission" is implied by the permissions in the collection, `false` if not. implies(Permission the Permission object to compare. permission) Implements abstract java.security.PermissionCollection.implies. Checks to see if the specified permission is implied by the collection of Permission objects held in this PermissionCollection.