Save This Page
Home » apache-openjpa-1.1.0-source » org.apache.openjpa.lib » util » [javadoc | source]
org.apache.openjpa.lib.util
abstract public class: J2DoPrivHelper [javadoc | source]
java.lang.Object
   org.apache.openjpa.lib.util.J2DoPrivHelper

Direct Known Subclasses:
    J2DoPriv5Helper

Helper class to obtain the Privilege(Exception)Action object to perform Java 2 doPrivilege security sensitive function call in the following methods: If these methods are used, the following sample usage patterns should be followed to ensure proper privilege is granted: 1) No security risk method call. E.g. private static final String SEP = J2DoPrivHelper.getLineSeparator(); 2) Methods with no exception thrown. PrivilegedAction is returned from J2DoPrivHelper.*Action(). E.g. ClassLoader loader = (ClassLoader) AccessController.doPrivileged( J2DoPrivHelper.getClassLoaderAction(clazz)); ClassLoader loader = (ClassLoader) (System.getSecurityManager() == null) ? clazz.getClassLoader() : AccessController.doPrivileged( J2DoPrivHelper.getClassLoaderAction(clazz)); 3) Methods with exception thrown. PrivilegedExceptionAction is returned from J2DoPrivHelper.*Action(). E.g. try { method = (Method) AccessController.doPrivileged( J2DoPrivHelper.getDeclaredMethodAction(clazz, name, parameterType)); } catch (PrivilegedActionException pae) { throw (NoSuchMethodException) pae.getException(); } try { method = (System.getSecurityManager() == null) ? clazz.getDeclaredMethod(name,parameterType) : (Method) AccessController.doPrivileged( J2DoPrivHelper.getDeclaredMethodAction( clazz, name, parameterType)); } catch (PrivilegedActionException pae) { throw (NoSuchMethodException) pae.getException() }
Method from org.apache.openjpa.lib.util.J2DoPrivHelper Summary:
acceptAction,   bCClassWrite,   deleteAction,   existsAction,   getAbsoluteFileAction,   getAbsolutePathAction,   getBCClassFieldsAction,   getByNameAction,   getCanonicalPathAction,   getClassLoaderAction,   getContentAction,   getContextClassLoaderAction,   getDeclaredFieldAction,   getDeclaredFieldsAction,   getDeclaredMethodAction,   getDeclaredMethodsAction,   getFieldInstructionFieldAction,   getForNameAction,   getLineSeparator,   getParentAction,   getPathSeparator,   getPropertiesAction,   getPropertyAction,   getResourceAction,   getResourceAction,   getResourcesAction,   getSystemClassLoaderAction,   isDirectoryAction,   isFileAction,   lengthAction,   listFilesAction,   loadProjectClassAction,   loadProjectClassAction,   mkdirsAction,   newBCClassLoaderAction,   newBCClassLoaderAction,   newCodeAction,   newDaemonThreadAction,   newFileInputStreamAction,   newFileOutputStreamAction,   newFileOutputStreamAction,   newInstanceAction,   newMultiClassLoaderAction,   newServerSocketAction,   newSocketAction,   newTemporaryClassLoaderAction,   newZipFileAction,   openStreamAction,   renameToAction,   setAccessibleAction,   toURLAction
Methods from java.lang.Object:
equals,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.apache.openjpa.lib.util.J2DoPrivHelper Detail:
 public static final PrivilegedExceptionAction acceptAction(ServerSocket ss) throws IOException 
    Return a PrivilegedExceptionAction object for ServerSocket.accept(). Requires security policy: 'permission java.net.SocketPermission "listen";'
 public static final PrivilegedExceptionAction bCClassWrite(BCClass bc,
    File f) throws IOException 
    Return a PrivilegedExceptionAction object for BCClass.write(). Requires security policy: 'permission java.io.FilePermission "write";'
 public static final PrivilegedAction deleteAction(File f) 
    Return a PrivilegeAction object for f.delete(). Requires security policy: 'permission java.io.FilePermission "delete";'
 public static final PrivilegedAction existsAction(File f) 
    Return a PrivilegeAction object for f.exists(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction getAbsoluteFileAction(File f) 
    Return a PrivilegeAction object for f.getAbsoluteFile(). Requires security policy: 'permission java.util.PropertyPermission "read";'
 public static final PrivilegedAction getAbsolutePathAction(File f) 
    Return a PrivilegeAction object for f.getAbsolutePath(). Requires security policy: 'permission java.util.PropertyPermission "read";'
 public static final PrivilegedAction getBCClassFieldsAction(BCClass bcClass,
    String fieldName) 
    Return a PrivilegeAction object for BCClass.getFields(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedExceptionAction getByNameAction(String hostname) throws UnknownHostException 
    Return a PrivilegedExceptionAction object for InetAdress.getByName(). Requires security policy: 'permission java.net.SocketPermission "connect";'
 public static final PrivilegedExceptionAction getCanonicalPathAction(File f) throws IOException 
    Return a PrivilegedExceptionAction object for f.getCanonicalPath(). Requires security policy: 'permission java.util.PropertyPermission "read";'
 public static final PrivilegedAction getClassLoaderAction(Class clazz) 
    Return a PrivilegeAction object for clazz.getClassloader(). Notes: No doPrivilege wrapping is required in the caller if: "the caller's class loader is not null and the caller's class loader is not the same as or an ancestor of the class loader for the class whose class loader is requested". E.g. this.getClass().getClassLoader(); Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedExceptionAction getContentAction(URLConnection con) throws IOException 
    Return a PrivilegedExceptionAction object con.getContent(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction getContextClassLoaderAction() 
    Return a PrivilegeAction object for Thread.currentThread .getContextClassLoader(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedExceptionAction getDeclaredFieldAction(Class clazz,
    String name) 
    Return a PrivilegedExceptionAction object for clazz.getDeclaredField(). Requires security policy: 'permission java.lang.RuntimePermission "accessDeclaredMembers";'
 public static final PrivilegedAction getDeclaredFieldsAction(Class clazz) 
    Return a PrivilegeAction object for class.getDeclaredFields(). Requires security policy: 'permission java.lang.RuntimePermission "accessDeclaredMembers";'
 public static final PrivilegedExceptionAction getDeclaredMethodAction(Class clazz,
    String name,
    Class[] parameterTypes) 
    Return a PrivilegedExceptionAction object for clazz.getDeclaredMethod(). Requires security policy 'permission java.lang.RuntimePermission "accessDeclaredMembers";'
 public static final PrivilegedAction getDeclaredMethodsAction(Class clazz) 
    Return a PrivilegeAction object for clazz.getDeclaredMethods(). Requires security policy: 'permission java.lang.RuntimePermission "accessDeclaredMembers";'
 public static final PrivilegedAction getFieldInstructionFieldAction(FieldInstruction instruction) 
    Return a PrivilegeAction object for FieldInstruction.getField(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedExceptionAction getForNameAction(String className,
    boolean initializeBoolean,
    ClassLoader classLoader) 
    Return a PrivilegeAction object for Class.forName(). Notes: doPriv of Class.forName call is required only if the input classloader argument is null. E.g. Class.forName("x", false, Collection.class.getClassLoader()); Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final String getLineSeparator() 
    Return the value of the "line.separator" system property. Requires security policy: 'permission java.util.PropertyPermission "read";'
 public static final PrivilegedAction getParentAction(ClassLoader loader) 
    Return a PrivilegeAction object for loader.getParent(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final String getPathSeparator() 
    Return the value of the "path.separator" system property. Requires security policy: 'permission java.util.PropertyPermission "read";'
 public static final PrivilegedAction getPropertiesAction() 
    Return a PrivilegeAction object for System.getProperties(). Requires security policy: 'permission java.util.PropertyPermission "read";'
 public static final PrivilegedAction getPropertyAction(String name) 
    Return a PrivilegeAction object for System.getProperty(). Requires security policy: 'permission java.util.PropertyPermission "read";'
 public static final PrivilegedAction getResourceAction(Class clazz,
    String resource) 
    Return a PrivilegeAction object for clazz.getResource(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction getResourceAction(ClassLoader loader,
    String resource) 
    Return a PrivilegeAction object for loader.getResource(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedExceptionAction getResourcesAction(ClassLoader loader,
    String resource) throws IOException 
    Return a PrivilegedExceptionAction object for loader.getResources(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction getSystemClassLoaderAction() 
    Return a PrivilegeAction object for ClassLoader.getSystemClassLoader(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedAction isDirectoryAction(File f) 
    Return a PrivilegeAction object for f.isDirectory(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction isFileAction(File f) 
    Return a PrivilegeAction object for f.isFile(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction lengthAction(File f) 
    Return a PrivilegeAction object for f.length(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction listFilesAction(File f) 
    Return a PrivilegeAction object for f.listFiles(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction loadProjectClassAction(Project project,
    Class clazz) 
    Return a PrivilegeAction object for Project.loadClass(). Requires security policy: 'permission java.lang.RuntimePermission "createClassLoader";'
 public static final PrivilegedAction loadProjectClassAction(Project project,
    String clazzName) 
    Return a PrivilegeAction object for Project.loadClass(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedAction mkdirsAction(File f) 
    Return a PrivilegeAction object for f.mkdirs(). Requires security policy: 'permission java.io.FilePermission "write";'
 public static final PrivilegedAction newBCClassLoaderAction(Project project) 
 public static final PrivilegedAction newBCClassLoaderAction(Project project,
    ClassLoader parent) 
    Return a PrivilegeAction object for new BCClassLoader(). Requires security policy: 'permission java.lang.RuntimePermission "createClassLoader";'
 public static final PrivilegedAction newCodeAction() 
    Return a PrivilegeAction object for new serp.bytecode.Code(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedAction newDaemonThreadAction(Runnable target,
    String name) 
    Return a PrivilegedAction object for new Thread(). Requires security policy: 'permission java.lang.RuntimePermission "modifyThreadGroup";' 'permission java.lang.RuntimePermission "modifyThread";'
 public static final PrivilegedExceptionAction newFileInputStreamAction(File f) throws FileNotFoundException 
    Return a PrivilegedExceptionAction object for new FileInputStream(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedExceptionAction newFileOutputStreamAction(File f) throws FileNotFoundException 
    Return a PrivilegedExceptionAction object for new FileOutputStream(). Requires security policy: 'permission java.io.FilePermission "write";'
 public static final PrivilegedExceptionAction newFileOutputStreamAction(String f,
    boolean append) throws FileNotFoundException 
    Return a PrivilegedExceptionAction object for new FileOutputStream(). Requires security policy: 'permission java.io.FilePermission "write";'
 public static final PrivilegedExceptionAction newInstanceAction(Class clazz) throws InstantiationException, IllegalAccessException 
    Return a PrivilegedExceptionAction object for clazz.newInstance(). Requires security policy: 'permission java.lang.RuntimePermission "getClassLoader";'
 public static final PrivilegedAction newMultiClassLoaderAction() 
    Return a PrivilegeAction object for new MultiClassLoader(). Requires security policy: 'permission java.lang.RuntimePermission "createClassLoader";'
 public static final PrivilegedExceptionAction newServerSocketAction(int port) throws IOException 
    Return a PrivilegedExceptionAction object for new ServerSocket(). Requires security policy: 'permission java.net.SocketPermission "listen";'
 public static final PrivilegedExceptionAction newSocketAction(InetAddress host,
    int port) throws IOException 
    Return a PrivilegedExceptionAction object for new Socket(). Requires security policy: 'permission java.net.SocketPermission "connect";'
 public static final PrivilegedAction newTemporaryClassLoaderAction(ClassLoader parent) 
    Return a PrivilegeAction object for new TemporaryClassLoader(). Requires security policy: 'permission java.lang.RuntimePermission "createClassLoader";'
 public static final PrivilegedExceptionAction newZipFileAction(File f) throws IOException 
    Return a PrivilegedExceptionAction object for new ZipFile(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedExceptionAction openStreamAction(URL url) throws IOException 
    Return a PrivilegedExceptionAction object for url.openStream(). Requires security policy: 'permission java.io.FilePermission "read";'
 public static final PrivilegedAction renameToAction(File from,
    File to) 
    Return a PrivilegeAction object for f.renameTo(). Requires security policy: 'permission java.io.FilePermission "write";'
 public static final PrivilegedAction setAccessibleAction(AccessibleObject aObj,
    boolean flag) 
    Return a PrivilegeAction object for aObj.setAccessible(). Requires security policy: 'permission java.lang.reflect.ReflectPermission "suppressAccessChecks";'
 public static final PrivilegedExceptionAction toURLAction(File file) throws MalformedURLException 
    Return a PrivilegedExceptionAction object for f.toURL(). Requires security policy: 'permission java.io.FilePermission "read";'