OpenJDK 27 · java.security.ProtectionDomain · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
private final ClassLoader	classloader
private final CodeSource	codesource
private boolean	hasAllPerm
private PermissionCollection	permissions
private final Principal[]	principals
private final boolean	staticPermissions

Constructor Summary

Access Constructor and Description

Access	Constructor and Description
public	ProtectionDomain(CodeSource the codesource associated with this domain codesource, PermissionCollection the permissions granted to this domain permissions) Creates a new `ProtectionDomain` with the given `CodeSource` and permissions.
public	ProtectionDomain(CodeSource the `CodeSource` associated with this domain codesource, PermissionCollection the permissions granted to this domain permissions, ClassLoader the `ClassLoader` associated with this domain classloader, Principal[] the array of `Principal` objects associated with this domain. The contents of the array are copied to protect against subsequent modification. principals) Creates a new `ProtectionDomain` qualified by the given `CodeSource`, permissions, `ClassLoader` and array of principals.

public

ProtectionDomain(CodeSource

the codesource associated with this domain

codesource, PermissionCollection

the permissions granted to this domain

permissions)

Creates a new ProtectionDomain with the given CodeSource and permissions.

public

ProtectionDomain(CodeSource

the CodeSource associated with this domain

codesource, PermissionCollection

the permissions granted to this domain

permissions, ClassLoader

the ClassLoader associated with this domain

classloader, Principal[]

the array of Principal objects associated with this domain. The contents of the array are copied to protect against subsequent modification.

principals)

Creates a new ProtectionDomain qualified by the given CodeSource, permissions, ClassLoader and array of principals.

Method Summary

Modifier and Type	Method and Description
public final ClassLoader	Returns: the `ClassLoader` of this domain which may be `null`. getClassLoader() Returns the `ClassLoader` of this domain.
public final CodeSource	Returns: the `CodeSource` of this domain which may be `null`. getCodeSource() Returns the `CodeSource` of this domain.
public final PermissionCollection	Returns: the static set of permissions for this domain which may be `null`. getPermissions() Returns the static permissions granted to this domain.
public final Principal[]	Returns: a non-null array of principals for this domain. Returns a new array each time this method is called. getPrincipals() Returns an array of principals for this domain.
public boolean	Returns: `true` if `perm` is implied by this `ProtectionDomain`. implies(Permission the `Permission` object to check. perm) Check and see if this `ProtectionDomain` implies the permissions expressed in the `Permission` object.
public final boolean	Returns: `true` if this domain contains only static permissions. staticPermissionsOnly() Returns `true` if this domain contains only static permissions and does not check the current `Policy`.
public String	toString() Overrides java.lang.Object.toString. Convert a `ProtectionDomain` to a `String`.

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

Field Detail

classloader	back to summary
private final ClassLoader classloader

codesource	back to summary
private final CodeSource codesource

hasAllPerm	back to summary
private boolean hasAllPerm

permissions	back to summary
private PermissionCollection permissions

principals	back to summary
private final Principal[] principals

staticPermissions	back to summary
private final boolean staticPermissions

Constructor Detail

ProtectionDomain back to summary

ProtectionDomain	back to summary
public ProtectionDomain(CodeSource codesource, PermissionCollection permissions) Creates a new `ProtectionDomain` with the given `CodeSource` and permissions. If permissions is not `null`, then `setReadOnly()` will be called on the passed in permissions. The permissions granted to this domain are static, i.e. invoking the `staticPermissionsOnly()` method returns `true`. They contain only the ones passed to this constructor and the current policy will not be consulted. API Note Installing a system-wide `Policy` object is no longer supported. The current policy is always a `Policy` object that grants no permissions. Parameters codesource:CodeSource the codesource associated with this domain permissions:PermissionCollection the permissions granted to this domain

public ProtectionDomain(CodeSource codesource, PermissionCollection permissions)

Creates a new ProtectionDomain with the given CodeSource and permissions. If permissions is not null, then setReadOnly() will be called on the passed in permissions.

The permissions granted to this domain are static, i.e. invoking the staticPermissionsOnly() method returns true. They contain only the ones passed to this constructor and the current policy will not be consulted.

API Note

Installing a system-wide Policy object is no longer supported. The current policy is always a Policy object that grants no permissions.

Parameters

codesource:CodeSource: the codesource associated with this domain
permissions:PermissionCollection: the permissions granted to this domain

ProtectionDomain back to summary

ProtectionDomain	back to summary
public ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals) Creates a new `ProtectionDomain` qualified by the given `CodeSource`, permissions, `ClassLoader` and array of principals. If permissions is not `null`, then `setReadOnly()` will be called on the passed in permissions. The permissions granted to this domain are dynamic, i.e. invoking the `staticPermissionsOnly()` method returns `false`. They include both the static permissions passed to this constructor, and any permissions granted to this domain by the current policy. API Note Installing a system-wide `Policy` object is no longer supported. The current policy is always a `Policy` object that grants no permissions. Parameters codesource:CodeSource the `CodeSource` associated with this domain permissions:PermissionCollection the permissions granted to this domain classloader:ClassLoader the `ClassLoader` associated with this domain principals:Principal[] the array of `Principal` objects associated with this domain. The contents of the array are copied to protect against subsequent modification. Since 1.4 See Also `Policy#getPermissions(ProtectionDomain)`

public ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)

Creates a new ProtectionDomain qualified by the given CodeSource, permissions, ClassLoader and array of principals. If permissions is not null, then setReadOnly() will be called on the passed in permissions.

The permissions granted to this domain are dynamic, i.e. invoking the staticPermissionsOnly() method returns false. They include both the static permissions passed to this constructor, and any permissions granted to this domain by the current policy.

API Note

Installing a system-wide Policy object is no longer supported. The current policy is always a Policy object that grants no permissions.

Parameters

codesource:CodeSource: the CodeSource associated with this domain
permissions:PermissionCollection: the permissions granted to this domain
classloader:ClassLoader: the ClassLoader associated with this domain
principals:Principal[]: the array of Principal objects associated with this domain. The contents of the array are copied to protect against subsequent modification.

Since

1.4

Method Detail

getClassLoader back to summary

getClassLoader	back to summary
public final ClassLoader getClassLoader() Returns the `ClassLoader` of this domain. Returns:ClassLoader the `ClassLoader` of this domain which may be `null`. Since 1.4

public final ClassLoader getClassLoader()

Returns the ClassLoader of this domain.

Returns:ClassLoader: the ClassLoader of this domain which may be null.
Since: 1.4

getCodeSource back to summary

getCodeSource	back to summary
public final CodeSource getCodeSource() Returns the `CodeSource` of this domain. Returns:CodeSource the `CodeSource` of this domain which may be `null`. Since 1.2

public final CodeSource getCodeSource()

Returns the CodeSource of this domain.

Returns:CodeSource: the CodeSource of this domain which may be null.
Since: 1.2

getPermissions back to summary

getPermissions	back to summary
public final PermissionCollection getPermissions() Returns the static permissions granted to this domain. Returns:PermissionCollection the static set of permissions for this domain which may be `null`. See Also `Policy#refresh`, `Policy#getPermissions(ProtectionDomain)`

public final PermissionCollection getPermissions()

Returns the static permissions granted to this domain.

Returns:PermissionCollection: the static set of permissions for this domain which may be null.
See Also: Policy#refresh, Policy#getPermissions(ProtectionDomain)

getPrincipals	back to summary
public final Principal[] getPrincipals() Returns an array of principals for this domain. Returns:Principal[] a non-null array of principals for this domain. Returns a new array each time this method is called. Since 1.4

getPrincipals

back to summary

public final Principal[] getPrincipals()

Returns an array of principals for this domain.

Returns:Principal[]: a non-null array of principals for this domain. Returns a new array each time this method is called.
Since: 1.4

implies back to summary

implies	back to summary
public boolean implies(Permission perm) Check and see if this `ProtectionDomain` implies the permissions expressed in the `Permission` object. The set of permissions evaluated is a function of whether the `ProtectionDomain` was constructed with a static set of permissions or it was bound to a dynamically mapped set of permissions. If the `staticPermissionsOnly()` method returns `true`, then the permission will only be checked against the `PermissionCollection` supplied at construction. Otherwise, the permission will be checked against the combination of the `PermissionCollection` supplied at construction and the current policy. API Note Installing a system-wide `Policy` object is no longer supported. The current policy is always a `Policy` object that grants no permissions. Parameters perm:Permission the `Permission` object to check. Returns:boolean `true` if `perm` is implied by this `ProtectionDomain`. Annotations @SuppressWarnings:removal

public boolean implies(Permission perm)

Check and see if this ProtectionDomain implies the permissions expressed in the Permission object.

The set of permissions evaluated is a function of whether the ProtectionDomain was constructed with a static set of permissions or it was bound to a dynamically mapped set of permissions.

If the staticPermissionsOnly() method returns true, then the permission will only be checked against the PermissionCollection supplied at construction.

Otherwise, the permission will be checked against the combination of the PermissionCollection supplied at construction and the current policy.

API Note

Installing a system-wide Policy object is no longer supported. The current policy is always a Policy object that grants no permissions.

Parameters

perm:Permission: the Permission object to check.

Returns:boolean

true if perm is implied by this ProtectionDomain.

Annotations

@SuppressWarnings:removal

staticPermissionsOnly back to summary

staticPermissionsOnly	back to summary
public final boolean staticPermissionsOnly() Returns `true` if this domain contains only static permissions and does not check the current `Policy`. API Note Installing a system-wide `Policy` object is no longer supported. The current policy is always a `Policy` object that grants no permissions. Returns:boolean `true` if this domain contains only static permissions. Since 9

public final boolean staticPermissionsOnly()

Returns true if this domain contains only static permissions and does not check the current Policy.

API Note

Installing a system-wide Policy object is no longer supported. The current policy is always a Policy object that grants no permissions.

Returns:boolean: true if this domain contains only static permissions.
Since: 9

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Convert a `ProtectionDomain` to a `String`. Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Convert a ProtectionDomain to a String.

Annotations

@Override

public Class ProtectionDomain

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail