java.security
Class ProtectionDomain

java.lang.Object
  java.security.ProtectionDomain

public class ProtectionDomain
extends Object

This class represents a domain in which classes from the same source (URL) and signed by the same keys are stored. All the classes inside are given the same permissions.

Note: a class can only belong to one and only one protection domain.

Constructor Summary

ProtectionDomain(CodeSource codesource, PermissionCollection permissions)
Contructs a protection domain from the given code source and the permissions that that should be granted to the classes which are encapsulated in it.

ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)
Contructs a protection domain from the given code source and the permissions.

Method Summary

ClassLoader	getClassLoader() Returns the ClassLoader associated with the ProtectionDomain
CodeSource	getCodeSource() Answers the code source of this domain.
PermissionCollection	getPermissions() Answers the permissions that should be granted to the classes which are encapsulated in this domain.
Principal[]	getPrincipals() Returns the Principals associated with this ProtectionDomain.
boolean	implies(Permission perm) Determines whether the permission collection of this domain implies the argument permission.
String	toString() Answers a string containing a concise, human-readable description of the receiver.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ProtectionDomain

public ProtectionDomain(CodeSource codesource,
                        PermissionCollection permissions)

Contructs a protection domain from the given code source and the permissions that that should be granted to the classes which are encapsulated in it.

Parameters:

codesource - the CodeSource associated with this domain

permissions - the Permissions associated with this domain

See Also:

CodeSource, PermissionCollection

ProtectionDomain

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

Contructs a protection domain from the given code source and the permissions. This constructor also allows the association of a ClassLoader and group of Principals.

Parameters:

codesource - the CodeSource associated with this domain

permissions - the Permissions associated with this domain

classloader - the ClassLoader associated with this domain

principals - the Principals associated with this domain

See Also:

CodeSource, PermissionCollection, Principal

Method Detail

getCodeSource

public final CodeSource getCodeSource()

Answers the code source of this domain.

Returns:

java.security.CodeSource the code source of this domain

getPermissions

public final PermissionCollection getPermissions()

Answers the permissions that should be granted to the classes which are encapsulated in this domain.

Returns:

java.security.PermissionCollection collection of permissions associated with this domain.

getPrincipals

public final Principal[] getPrincipals()

Returns the Principals associated with this ProtectionDomain. A change to the returned array will not impact the ProtectionDomain.

Returns:

Principals[] Principals associated with the ProtectionDomain.

getClassLoader

public final ClassLoader getClassLoader()

Returns the ClassLoader associated with the ProtectionDomain

Returns:

ClassLoader associated ClassLoader

implies

public boolean implies(Permission perm)

Determines whether the permission collection of this domain implies the argument permission.

Parameters:

perm - java.security.Permission the permission to check.

Returns:

boolean true if this permission collection implies the argument and false otherwise.

toString

public String toString()

Answers a string containing a concise, human-readable description of the receiver.

Overrides:

toString in class Object

Returns:

String a printable representation for the receiver.