path: root/src/java/com/jogamp/common/util/cache/TempJarCache.java

/**
 * Copyright 2011 JogAmp Community. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, are
 * permitted provided that the following conditions are met:
 *
 *    1. Redistributions of source code must retain the above copyright notice, this list of
 *       conditions and the following disclaimer.
 *
 *    2. Redistributions in binary form must reproduce the above copyright notice, this list
 *       of conditions and the following disclaimer in the documentation and/or other materials
 *       provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * The views and conclusions contained in the software and documentation are those of the
 * authors and should not be interpreted as representing official policies, either expressed
 * or implied, of JogAmp Community.
 */
package com.jogamp.common.util.cache;

import java.io.File;
import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
import java.security.cert.Certificate;
import java.util.HashMap;
import java.util.Map;
import java.util.jar.JarFile;

import jogamp.common.Debug;

import com.jogamp.common.os.NativeLibrary;
import com.jogamp.common.util.IOUtil;
import com.jogamp.common.util.JarUtil;
import com.jogamp.common.util.SecurityUtil;

public class TempJarCache {
    private static final boolean DEBUG = Debug.debug("TempJarCache");
    
    // A HashMap of native libraries that can be loaded with System.load()
    // The key is the string name of the library as passed into the loadLibrary
    // call; it is the file name without the directory or the platform-dependent
    // library prefix and suffix. The value is the absolute path name to the
    // unpacked library file in nativeTmpDir.
    private static Map<String, String> nativeLibMap;

    public enum LoadState {
        LOOKED_UP, LOADED;
        
        public boolean compliesWith(LoadState o2) {            
            return null != o2 ? compareTo(o2) >= 0 : false;
        }
    }
    private static boolean testLoadState(LoadState has, LoadState exp) {
        if(null == has) {
            return null == exp;
        }
        return has.compliesWith(exp);
    }
    
    // Set of jar files added
    private static Map<URI, LoadState> nativeLibJars;
    private static Map<URI, LoadState> classFileJars;
    private static Map<URI, LoadState> resourceFileJars;

    private static TempFileCache tmpFileCache;
    
    private static boolean staticInitError = false;
    private static volatile boolean isInit = false;
    
    /**
     * Documented way to kick off static initialization.
     * 
     * @return true is static initialization was successful
     */
    public static boolean initSingleton() {
        if (!isInit) { // volatile: ok
            synchronized (TempJarCache.class) {
                if (!isInit) {
                    isInit = true;
                    staticInitError = !TempFileCache.initSingleton();
            
                    if(!staticInitError) {
                        tmpFileCache = new TempFileCache();
                        staticInitError = !tmpFileCache.isValid(); 
                    }
                    
                    if(!staticInitError) {
                        // Initialize the collections of resources
                        nativeLibMap = new HashMap<String, String>();
                        nativeLibJars = new HashMap<URI, LoadState>();
                        classFileJars = new HashMap<URI, LoadState>();
                        resourceFileJars = new HashMap<URI, LoadState>();
                    }
                    if(DEBUG) {
                        System.err.println("TempJarCache.initSingleton(): ok "+(false==staticInitError)+", "+ tmpFileCache.getTempDir());
                    }
                }
            }
        }
        return !staticInitError;
    }
    
    /**
     * This is <b>not recommended</b> since the JNI libraries may still be
     * in use by the ClassLoader they are loaded via {@link System#load(String)}.
     * </p>
     * <p>
     * In JogAmp, JNI native libraries loaded and registered by {@link JNILibLoaderBase} 
     * derivations, where the native JARs might be loaded via {@link JNILibLoaderBase#addNativeJarLibs(Class, String) }. 
     * </p>
     * <p>
     * The only valid use case to shutdown the TempJarCache is at bootstrapping,
     * i.e. when no native library is guaranteed to be loaded. This could be useful
     * if bootstrapping needs to find the proper native library type.
     * </p> 
     *
    public static void shutdown() {
        if (isInit) { // volatile: ok
            synchronized (TempJarCache.class) {
                if (isInit) {
                    if(DEBUG) {
                        System.err.println("TempJarCache.shutdown(): real "+(false==staticInitError)+", "+ tmpFileCache.getTempDir());
                    }
                    isInit = false;
                    if(!staticInitError) {
                        nativeLibMap.clear();
                        nativeLibMap = null;
                        nativeLibJars.clear();
                        nativeLibJars = null;
                        classFileJars.clear();
                        classFileJars = null;
                        resourceFileJars.clear();
                        resourceFileJars = null;
                        
                        tmpFileCache.destroy();
                        tmpFileCache = null;
                    }
                }
            }
        }
    } */
    
    /**
     * @return true if this class has been properly initialized, ie. is in use, otherwise false.
     */
    public static boolean isInitialized() {
        return isInit && !staticInitError;
    }
    
    /* package */ static void checkInitialized() {
        if(!isInit) {
            throw new RuntimeException("initSingleton() has to be called first.");
        }
    }
    
    public static TempFileCache getTempFileCache() {
        checkInitialized();
        return tmpFileCache;
    }
    
    public synchronized static boolean checkNativeLibs(URI jarURI, LoadState exp) throws IOException {
        checkInitialized();
        if(null == jarURI) {
            throw new IllegalArgumentException("jarURI is null");
        }
        return testLoadState(nativeLibJars.get(jarURI), exp);
    }    

    public synchronized static boolean checkClasses(URI jarURI, LoadState exp) throws IOException {
        checkInitialized();
        if(null == jarURI) {
            throw new IllegalArgumentException("jarURI is null");
        }
        return testLoadState(classFileJars.get(jarURI), exp);
    }    

    public synchronized static boolean checkResources(URI jarURI, LoadState exp) throws IOException {
        checkInitialized();
        if(null == jarURI) {
            throw new IllegalArgumentException("jarURI is null");
        }
        return testLoadState(resourceFileJars.get(jarURI), exp);
    }
    
    /**
     * Adds native libraries, if not yet added.
     * 
     * @param certClass if class is certified, the JarFile entries needs to have the same certificate 
     * @param jarURI
     * @param nativeLibraryPath if not null, only extracts native libraries within this path.
     * @return true if native libraries were added or previously loaded from given jarURI, otherwise false
     * @throws IOException if the <code>jarURI</code> could not be loaded or a previous load attempt failed
     * @throws SecurityException
     * @throws URISyntaxException 
     * @throws IllegalArgumentException 
     */
    public synchronized static final boolean addNativeLibs(Class<?> certClass, URI jarURI, String nativeLibraryPath) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException {        
        final LoadState nativeLibJarsLS = nativeLibJars.get(jarURI);
        if( !testLoadState(nativeLibJarsLS, LoadState.LOOKED_UP) ) { 
            nativeLibJars.put(jarURI, LoadState.LOOKED_UP);
            final JarFile jarFile = JarUtil.getJarFile(jarURI);
            if(DEBUG) {
                System.err.println("TempJarCache: addNativeLibs: "+jarURI+": nativeJar "+jarFile.getName());
            }
            validateCertificates(certClass, jarFile);
            final int num = JarUtil.extract(tmpFileCache.getTempDir(), nativeLibMap, jarFile, nativeLibraryPath, true, false, false); 
            nativeLibJars.put(jarURI, LoadState.LOADED);
            return num > 0;
        } else if( testLoadState(nativeLibJarsLS, LoadState.LOADED) ) {
            return true;
        }
        throw new IOException("TempJarCache: addNativeLibs: "+jarURI+", previous load attempt failed");
    }
    
    /**
     * Adds native classes, if not yet added.
     * 
     * TODO class access pending
     * needs Classloader.defineClass(..) access, ie. own derivation - will do when needed ..
     * 
     * @param certClass if class is certified, the JarFile entries needs to have the same certificate 
     * @param jarURI
     * @throws IOException if the <code>jarURI</code> could not be loaded or a previous load attempt failed
     * @throws SecurityException
     * @throws URISyntaxException 
     * @throws IllegalArgumentException 
     */
    public synchronized static final void addClasses(Class<?> certClass, URI jarURI) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException {
        final LoadState classFileJarsLS = classFileJars.get(jarURI);
        if( !testLoadState(classFileJarsLS, LoadState.LOOKED_UP) ) { 
            classFileJars.put(jarURI, LoadState.LOOKED_UP);
            final JarFile jarFile = JarUtil.getJarFile(jarURI);
            if(DEBUG) {
                System.err.println("TempJarCache: addClasses: "+jarURI+": nativeJar "+jarFile.getName());
            }
            validateCertificates(certClass, jarFile);
            JarUtil.extract(tmpFileCache.getTempDir(), null, jarFile, 
                            null /* nativeLibraryPath */, false, true, false); 
            classFileJars.put(jarURI, LoadState.LOADED);
        } else if( !testLoadState(classFileJarsLS, LoadState.LOADED) ) {
            throw new IOException("TempJarCache: addClasses: "+jarURI+", previous load attempt failed");
        }
    }
    
    /**
     * Adds native resources, if not yet added.
     * 
     * @param certClass if class is certified, the JarFile entries needs to have the same certificate 
     * @param jarURI
     * @return
     * @throws IOException if the <code>jarURI</code> could not be loaded or a previous load attempt failed
     * @throws SecurityException
     * @throws URISyntaxException 
     * @throws IllegalArgumentException 
     */
    public synchronized static final void addResources(Class<?> certClass, URI jarURI) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException {        
        final LoadState resourceFileJarsLS = resourceFileJars.get(jarURI);
        if( !testLoadState(resourceFileJarsLS, LoadState.LOOKED_UP) ) { 
            resourceFileJars.put(jarURI, LoadState.LOOKED_UP);
            final JarFile jarFile = JarUtil.getJarFile(jarURI);
            if(DEBUG) {
                System.err.println("TempJarCache: addResources: "+jarURI+": nativeJar "+jarFile.getName());
            }
            validateCertificates(certClass, jarFile);
            JarUtil.extract(tmpFileCache.getTempDir(), null, jarFile, 
                            null /* nativeLibraryPath */, false, false, true); 
            resourceFileJars.put(jarURI, LoadState.LOADED);
        } else if( !testLoadState(resourceFileJarsLS, LoadState.LOADED) ) {
            throw new IOException("TempJarCache: addResources: "+jarURI+", previous load attempt failed");
        }
    }
    
    /**
     * Adds all types, native libraries, class files and other files (resources)
     * if not yet added.
     *  
     * TODO class access pending
     * needs Classloader.defineClass(..) access, ie. own derivation - will do when needed ..
     * 
     * @param certClass if class is certified, the JarFile entries needs to have the same certificate 
     * @param jarURI
     * @throws IOException if the <code>jarURI</code> could not be loaded or a previous load attempt failed
     * @throws SecurityException
     * @throws URISyntaxException 
     * @throws IllegalArgumentException 
     */
    public synchronized static final void addAll(Class<?> certClass, URI jarURI) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException {
        checkInitialized();
        if(null == jarURI) {
            throw new IllegalArgumentException("jarURI is null");
        }
        final LoadState nativeLibJarsLS = nativeLibJars.get(jarURI);
        final LoadState classFileJarsLS = classFileJars.get(jarURI);
        final LoadState resourceFileJarsLS = resourceFileJars.get(jarURI);
        if( !testLoadState(nativeLibJarsLS, LoadState.LOOKED_UP) || 
            !testLoadState(classFileJarsLS, LoadState.LOOKED_UP) || 
            !testLoadState(resourceFileJarsLS, LoadState.LOOKED_UP) ) {
            
            final boolean extractNativeLibraries = !testLoadState(nativeLibJarsLS, LoadState.LOADED);
            final boolean extractClassFiles = !testLoadState(classFileJarsLS, LoadState.LOADED);
            final boolean extractOtherFiles = !testLoadState(resourceFileJarsLS, LoadState.LOOKED_UP);
            
            // mark looked-up (those who are not loaded)
            if(extractNativeLibraries) {
                nativeLibJars.put(jarURI, LoadState.LOOKED_UP);
            }
            if(extractClassFiles) {
                classFileJars.put(jarURI, LoadState.LOOKED_UP);
            }
            if(extractOtherFiles) {
                resourceFileJars.put(jarURI, LoadState.LOOKED_UP);
            }
            
            final JarFile jarFile = JarUtil.getJarFile(jarURI);
            if(DEBUG) {
                System.err.println("TempJarCache: addAll: "+jarURI+": nativeJar "+jarFile.getName());
            }
            validateCertificates(certClass, jarFile);
            JarUtil.extract(tmpFileCache.getTempDir(), nativeLibMap, jarFile, 
                            null /* nativeLibraryPath */, extractNativeLibraries, extractClassFiles, extractOtherFiles);
            
            // mark loaded (those were just loaded)
            if(extractNativeLibraries) {
                nativeLibJars.put(jarURI, LoadState.LOADED);
            }
            if(extractClassFiles) {
                classFileJars.put(jarURI, LoadState.LOADED);
            }
            if(extractOtherFiles) {
                resourceFileJars.put(jarURI, LoadState.LOADED);
            }
        } else if( !testLoadState(nativeLibJarsLS, LoadState.LOADED) || 
                   !testLoadState(classFileJarsLS, LoadState.LOADED) || 
                   !testLoadState(resourceFileJarsLS, LoadState.LOADED) ) {
            throw new IOException("TempJarCache: addAll: "+jarURI+", previous load attempt failed");            
        }
    }
    
    public synchronized static final String findLibrary(String libName) {
        checkInitialized();
        // try with mapped library basename first
        String path = nativeLibMap.get(libName);
        if(null == path) {
            // if valid library name, try absolute path in temp-dir
            if(null != NativeLibrary.isValidNativeLibraryName(libName, false)) {    
                final File f = new File(tmpFileCache.getTempDir(), libName);
                if(f.exists()) {
                    path = f.getAbsolutePath();
                }
            }
        }
        return path;
    }
    
    /** TODO class access pending
     * needs Classloader.defineClass(..) access, ie. own derivation - will do when needed .. 
    public static Class<?> findClass(String name, ClassLoader cl) throws IOException, ClassFormatError {
        checkInitialized();
        final File f = new File(nativeTmpFileCache.getTempDir(), IOUtil.getClassFileName(name));
        if(f.exists()) {
            Class.forName(fname, initialize, loader)
            URL url = new URL(f.getAbsolutePath());
            byte[] b = IOUtil.copyStream2ByteArray(new BufferedInputStream( url.openStream() ));
            MyClassLoader mcl = new MyClassLoader(cl);
            return mcl.defineClass(name, b, 0, b.length);
        }
        return null;
    } */
    
    public synchronized static final String findResource(String name) {
        checkInitialized();
        final File f = new File(tmpFileCache.getTempDir(), name);
        if(f.exists()) {
            return f.getAbsolutePath();
        }
        return null;
    }
    
    public synchronized static final URI getResource(String name) throws URISyntaxException {
        checkInitialized();
        final File f = new File(tmpFileCache.getTempDir(), name);
        if(f.exists()) {
            return IOUtil.toURISimple(f);
        }
        return null;
    }
        
    private static void validateCertificates(Class<?> certClass, JarFile jarFile) throws IOException, SecurityException {
        if(null == certClass) {
            throw new IllegalArgumentException("certClass is null");
        }
        final Certificate[] rootCerts = SecurityUtil.getCerts(certClass);
        if( null != rootCerts ) {
            // Only validate the jarFile's certs with ours, if we have any.
            // Otherwise we may run uncertified JARs (application).
            // In case one tries to run uncertified JARs, the wrapping applet/JNLP
            // SecurityManager will kick in and throw a SecurityException.
            JarUtil.validateCertificates(rootCerts, jarFile);
            if(DEBUG) {
                System.err.println("TempJarCache: validateCertificates: OK - Matching rootCerts in given class "+certClass.getName()+", nativeJar "+jarFile.getName());
            }            
        } else if(DEBUG) {
            System.err.println("TempJarCache: validateCertificates: OK - No rootCerts in given class "+certClass.getName()+", nativeJar "+jarFile.getName());
        }
    }    
}