org.apache.river.api.security

Class ProtectionDomainGrant

java.lang.Object

org.apache.river.api.security.PermissionGrant

org.apache.river.api.security.PrincipalGrant

org.apache.river.api.security.ProtectionDomainGrant

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ClassLoaderGrant

class ProtectionDomainGrant
extends PrincipalGrant

ProtectionDomainGrant's become void if serialized, since ProtectionDomain's cannot be serialized.

Since:

3.0.0

Author:

Peter Firmstone

Field Summary

Fields

Modifier and Type	Field and Description
private WeakReference<ProtectionDomain>	domain
private int	hashCode
private static long	serialVersionUID

Fields inherited from class org.apache.river.api.security.PrincipalGrant

nullCS, pals

Constructor Summary

Constructors

Constructor and Description
ProtectionDomainGrant(WeakReference<ProtectionDomain> domain, Principal[] groups, Permission[] perm)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
PermissionGrantBuilder	getBuilderTemplate() Provide a PermissionGrantBuilder, suitable for producing a new PermissionGrant.
int	hashCode()
boolean	implies(ClassLoader cl, Principal[] pal) Checks if this PermissionGrant applies to the passed in ClassLoader and Principal's.
boolean	implies(CodeSource codeSource, Principal[] pal) Checks if this PermissionGrant applies to the passed in CodeSource and Principal's.
boolean	implies(ProtectionDomain pd) A DynamicPolicy implementation can use a PermissionGrant as a container for Dynamic Grant's.
private boolean	impliesClassLoader(ClassLoader cl)
private boolean	impliesCodeSource(CodeSource codeSource)
private boolean	impliesProtectionDomain(ProtectionDomain pd)
boolean	isVoid() Returns true if this PermissionGrant defines no Permissions, or if a PermissionGrant was made to a ProtectionDomain that no longer exists.
private void	readObject(ObjectInputStream stream)
String	toString()
private Object	writeReplace()

Methods inherited from class org.apache.river.api.security.PrincipalGrant

getPrincipals, implies

Methods inherited from class org.apache.river.api.security.PermissionGrant

decorated, getPermissions, isPrivileged

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

domain

private final WeakReference<ProtectionDomain> domain

hashCode

private final int hashCode

Constructor Detail

ProtectionDomainGrant

ProtectionDomainGrant(WeakReference<ProtectionDomain> domain,
                      Principal[] groups,
                      Permission[] perm)

Method Detail

equals

public boolean equals(Object o)

Overrides:

equals in class PrincipalGrant

hashCode

public int hashCode()

Overrides:

hashCode in class PrincipalGrant

toString

public String toString()

Overrides:

toString in class PrincipalGrant

implies

public boolean implies(ProtectionDomain pd)

Description copied from class: PermissionGrant

A DynamicPolicy implementation can use a PermissionGrant as a container for Dynamic Grant's. A PermissionGrant is first asked by the Policy if it applies to a Particular ProtectionDomain, if it does, the Policy calls getPermissions.

Overrides:

implies in class PrincipalGrant

Parameters:

pd - ProtectionDomain

Returns:

true if implies.

See Also:

RevocablePolicy

implies

public boolean implies(ClassLoader cl,
                       Principal[] pal)

Description copied from class: PermissionGrant

Checks if this PermissionGrant applies to the passed in ClassLoader and Principal's. Note that if this method returns false, it doesn't necessarily mean that the grant will not apply to the ClassLoader, since it will depend on the contents of the ClassLoader and that is indeterminate. It just indicates that the grant definitely does apply if it returns true. If this method returns false, follow up using the ProtectionDomain for a more specific test, which may return true.

Overrides:

implies in class PrincipalGrant

implies

public boolean implies(CodeSource codeSource,
                       Principal[] pal)

Description copied from class: PermissionGrant

Checks if this PermissionGrant applies to the passed in CodeSource and Principal's.

Overrides:

implies in class PrincipalGrant

Returns:

true if implies.

impliesProtectionDomain

private boolean impliesProtectionDomain(ProtectionDomain pd)

impliesClassLoader

private boolean impliesClassLoader(ClassLoader cl)

impliesCodeSource

private boolean impliesCodeSource(CodeSource codeSource)

isVoid

public boolean isVoid()

Description copied from class: PermissionGrant

Returns true if this PermissionGrant defines no Permissions, or if a PermissionGrant was made to a ProtectionDomain that no longer exists.

Overrides:

isVoid in class PrincipalGrant

Returns:

true if void.

getBuilderTemplate

public PermissionGrantBuilder getBuilderTemplate()

Description copied from class: PermissionGrant

Provide a PermissionGrantBuilder, suitable for producing a new PermissionGrant.

Overrides:

getBuilderTemplate in class PrincipalGrant

Returns:

PermissionGrantBuilder

writeReplace

private Object writeReplace()

readObject

private void readObject(ObjectInputStream stream)
                 throws InvalidObjectException

Throws:

InvalidObjectException