org.apache.catalina.security
Class SecurityUtil

java.lang.Object
  org.apache.catalina.security.SecurityUtil

public final class SecurityUtil
extends Object

This utility class associates a Subject to the current AccessControlContext. When a SecurityManager is used, * the container will always associate the called thread with an AccessControlContext * containing only the principal of the requested Servlet/Filter. This class uses reflection to invoke the invoke methods.

Author:

Jean-Francois Arcand

Constructor Summary

SecurityUtil()

Method Summary

static void	doAsPrivilege(String methodName, Filter targetObject) Perform work as a particular Subject.
static void	doAsPrivilege(String methodName, Filter targetObject, Class<?>[] targetType, Object[] targetArguments) Perform work as a particular Subject.
static void	doAsPrivilege(String methodName, Filter targetObject, Class<?>[] targetType, Object[] targetArguments, Principal principal) Perform work as a particular Subject.
static void	doAsPrivilege(String methodName, Servlet targetObject) Perform work as a particular Subject.
static void	doAsPrivilege(String methodName, Servlet targetObject, Class<?>[] targetType, Object[] targetArguments) Perform work as a particular Subject.
static void	doAsPrivilege(String methodName, Servlet targetObject, Class<?>[] targetType, Object[] targetArguments, Principal principal) Perform work as a particular Subject.
static boolean	isPackageProtectionEnabled() Return the SecurityManager only if Security is enabled AND package protection mechanism is enabled.
static void	remove(Object cachedObject) Remove the object from the cache.

Methods inherited from class java.lang.Object

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

Constructor Detail

SecurityUtil

public SecurityUtil()

Method Detail

doAsPrivilege

public static void doAsPrivilege(String methodName,
                                 Servlet targetObject)
                          throws Exception

Perform work as a particular Subject. Here the work will be granted to a null subject.

Parameters:

methodName - the method to apply the security restriction

targetObject - the Servlet on which the method will be called.

Throws:

Exception

doAsPrivilege

public static void doAsPrivilege(String methodName,
                                 Servlet targetObject,
                                 Class<?>[] targetType,
                                 Object[] targetArguments)
                          throws Exception

Perform work as a particular Subject. Here the work will be granted to a null subject.

Parameters:

methodName - the method to apply the security restriction

targetObject - the Servlet on which the method will be called.

targetType - Class array used to instantiate a Method object.

targetArguments - Object array contains the runtime parameters instance.

Throws:

Exception

doAsPrivilege

public static void doAsPrivilege(String methodName,
                                 Servlet targetObject,
                                 Class<?>[] targetType,
                                 Object[] targetArguments,
                                 Principal principal)
                          throws Exception

Perform work as a particular Subject. Here the work will be granted to a null subject.

Parameters:

methodName - the method to apply the security restriction

targetObject - the Servlet on which the method will be called.

targetType - Class array used to instantiate a Method object.

targetArguments - Object array contains the runtime parameters instance.

principal - the Principal to which the security privilege apply..

Throws:

Exception

doAsPrivilege

public static void doAsPrivilege(String methodName,
                                 Filter targetObject)
                          throws Exception

Perform work as a particular Subject. Here the work will be granted to a null subject.

Parameters:

methodName - the method to apply the security restriction

targetObject - the Filter on which the method will be called.

Throws:

Exception

doAsPrivilege

public static void doAsPrivilege(String methodName,
                                 Filter targetObject,
                                 Class<?>[] targetType,
                                 Object[] targetArguments)
                          throws Exception

Perform work as a particular Subject. Here the work will be granted to a null subject.

Parameters:

methodName - the method to apply the security restriction

targetObject - the Filter on which the method will be called.

targetType - Class array used to instantiate a Method object.

targetArguments - Object array contains the runtime parameters instance.

Throws:

Exception

doAsPrivilege

public static void doAsPrivilege(String methodName,
                                 Filter targetObject,
                                 Class<?>[] targetType,
                                 Object[] targetArguments,
                                 Principal principal)
                          throws Exception

Perform work as a particular Subject. Here the work will be granted to a null subject.

Parameters:

methodName - the method to apply the security restriction

targetObject - the Filter on which the method will be called.

targetType - Class array used to instantiate a Method object.

targetArguments - Object array contains the runtime parameters instance.

principal - the Principal to which the security privilege apply

Throws:

Exception

remove

public static void remove(Object cachedObject)

Remove the object from the cache.

Parameters:

cachedObject - The object to remove

isPackageProtectionEnabled

public static boolean isPackageProtectionEnabled()

Return the SecurityManager only if Security is enabled AND package protection mechanism is enabled.