Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Merge branches 'master' and 'master' of github.com:simgrid/simgrid
[simgrid.git] / src / bindings / java / org / simgrid / NativeLib.java
index 4e61de9..6739dba 100644 (file)
@@ -1,5 +1,4 @@
-/* Copyright (c) 2014. The SimGrid Team.
- * All rights reserved.                                                     */
+/* Copyright (c) 2014-2017. The SimGrid Team. All rights reserved.          */
 
 /* This program is free software; you can redistribute it and/or modify it
  * under the terms of the license (GNU LGPL) which comes with this package. */
@@ -8,21 +7,140 @@ package org.simgrid;
 
 import java.io.FileOutputStream;
 import java.io.InputStream;
+import java.io.IOException;
 import java.io.OutputStream;
 import java.io.File;
-
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+/** Helper class loading the native functions of SimGrid that we use for downcalls 
+ * 
+ * Almost all org.simgrid.msg.* classes contain a static bloc (thus executed when the class is loaded) 
+ * containing a call to this.
+ */
 public final class NativeLib {
+       private static boolean isNativeInited = false;
+       private static Path tempDir = null; // where the embeeded libraries are unpacked before loading them
+
+       /** A static-only "class" don't need no constructor */
+       private NativeLib() {
+               throw new IllegalAccessError("Utility class");
+       }
+
+       /** Hidden debug main() function 
+        * 
+        * It is not the Main-Class defined in src/bindings/java/MANIFEST.in (org.simgrid.msg.Msg is),
+        * so it won't get executed by default. But that's helpful to debug linkage errors, if you
+        * know that it exists. It's used by cmake during the configure, to inform the user.
+        */
+       public static void main(String[] args) {
+               System.out.println("This jarfile searches the native code under: " +getPath());
+       }
+       
+       /** Main function loading all the native classes that we need */
+       public static void nativeInit() {
+               if (isNativeInited)
+                       return;
+
+               if (System.getProperty("os.name").toLowerCase().startsWith("win"))
+                       NativeLib.nativeInit("winpthread-1");
+
+               NativeLib.nativeInit("simgrid");
+               NativeLib.nativeInit("simgrid-java");
+               isNativeInited = true;
+       }
+
+       /** Helper function trying to load one requested library */
+       public static void nativeInit(String name) {
+               Throwable cause = null;
+               try {
+                       /* Prefer the version of the library bundled into the jar file and use it */
+                       if (loadLibAsStream(name))
+                               return;
+               } catch (UnsatisfiedLinkError|SecurityException|IOException e) {
+                       cause = e;
+               }
+               
+               /* If not found, try to see if we can find a version on disk */
+               try {
+                       System.loadLibrary(name);
+                       return;
+               } catch (UnsatisfiedLinkError systemException) { /* don't care */ }
+               
+               System.err.println("\nCannot load the bindings to the "+name+" library in path "+getPath()+" and no usable SimGrid installation found on disk.");
+               if (cause != null) {
+                       if (cause.getMessage().matches(".*libcgraph.so.*"))
+                               System.err.println("HINT: Try to install the libcgraph package (sudo apt-get install libcgraph).");
+                       else if (cause.getMessage().matches(".*libboost_context.so.*"))
+                               System.err.println("HINT: Try to install the boost-context package (sudo apt-get install libboost-context-dev).");
+                       else
+                               System.err.println("Try to install the missing dependencies, if any. Read carefully the following error message.");
+
+                       System.err.println();
+                       cause.printStackTrace();
+               } else {
+                       System.err.println("This jar file does not seem to fit your system, and no usable SimGrid installation found on disk.");
+               }
+               System.exit(1);
+       }
 
-       public static String getPath() {
+       /** Try to extract the library from the jarfile before loading it */
+       private static boolean loadLibAsStream (String name) throws IOException, UnsatisfiedLinkError {
+               String path = NativeLib.getPath();
+               
+               // We must write the lib onto the disk before loading it -- stupid operating systems
+               if (tempDir == null) {
+                       tempDir = Files.createTempDirectory("simgrid-java-");
+                       // don't leak the files on disk, but remove it on JVM shutdown
+                       Runtime.getRuntime().addShutdownHook(new Thread(new FileCleaner(tempDir.toFile())));
+               }
+               
+               /* For each possible filename of the given library on all possible OSes, try it */
+               for (String filename : new String[] 
+                  { name, 
+                    "lib"+name+".so",               /* linux */
+                    name+".dll", "lib"+name+".dll", /* windows (pure and mingw) */
+                    "lib"+name+".dylib"             /* mac osx */}) {
+                                               
+                       File fileOut = new File(tempDir.toFile().getAbsolutePath() + File.separator + filename);
+                       try ( // Try-with-resources. These stream will be autoclosed when needed.
+                               InputStream in = NativeLib.class.getClassLoader().getResourceAsStream(path+filename);
+                               OutputStream out = new FileOutputStream(fileOut);
+                       ) {
+                               if (in == null)
+                                       continue; // Try the next name: no such file found
+                               
+                               /* copy the library in position */  
+                               byte[] buffer = new byte[4096]; 
+                               int bytesRead; 
+                               while ((bytesRead = in.read(buffer)) != -1)     // Read until EOF
+                                       out.write(buffer, 0, bytesRead); 
+                               
+                               out.close(); // Windows cannot open it twice, so close it first. Shame.
+                               
+                               /* load that shit */
+                               System.load(fileOut.getAbsolutePath());
+                               
+                               /* It loaded! we're good */
+                               return true;
+                               
+                       }
+               }
+               
+               /* No suitable name found */
+               return false;
+       }
+
+       /** Find where to search for the library in the jar -- keep it aligned with where cmake puts it! */
+       private static String getPath() {
+               // Inspiration: https://github.com/xerial/snappy-java/blob/develop/src/main/java/org/xerial/snappy/OSInfo.java
                String prefix = "NATIVE";
                String os = System.getProperty("os.name");
                String arch = System.getProperty("os.arch");
 
                if (arch.matches("^i[3-6]86$"))
                        arch = "x86";
-               else if (arch.equalsIgnoreCase("x86_64"))
-                       arch = "amd64";
-               else if (arch.equalsIgnoreCase("AMD64"))
+               else if ("x86_64".equalsIgnoreCase(arch) || "AMD64".equalsIgnoreCase(arch))
                        arch = "amd64";
 
                if (os.toLowerCase().startsWith("win")){
@@ -35,102 +153,25 @@ public final class NativeLib {
 
                return prefix + "/" + os + "/" + arch + "/";
        }
-       public static void nativeInit(String name) {
-               try {
-                       /* Prefer the version of the library bundled into the jar file and use it */
-                       loadLib(name);
-               } catch (SimGridLibNotFoundException e) {
-                       /* If not found, try to see if we can find a version on disk */
-                       try {
-                               System.loadLibrary(name);
-                       } catch (UnsatisfiedLinkError e2) {
-                               System.err.println("Cannot load the bindings to the "+name+" library in path "+getPath());
-                               e.printStackTrace();
-                               System.err.println("This jar file does not seem to fit your system, and I cannot find an installation of SimGrid.");
-                               System.exit(1);
-                       }
-               }
-       }
-
-       private static void loadLib (String name) throws SimGridLibNotFoundException {
-               String Path = NativeLib.getPath();
-
-               String filename=name;
-               InputStream in = NativeLib.class.getClassLoader().getResourceAsStream(Path+filename);
-
-               if (in == null) {
-                       filename = "lib"+name+".so";
-                       in = NativeLib.class.getClassLoader().getResourceAsStream(Path+filename);
-               }
-               if (in == null) {
-                       filename = name+".dll";
-                       in =  NativeLib.class.getClassLoader().getResourceAsStream(Path+filename);
-               }
-               if (in == null) {
-                       filename = "lib"+name+".dll";
-                       in =  NativeLib.class.getClassLoader().getResourceAsStream(Path+filename);
-               }
-               if (in == null) {
-                       filename = "lib"+name+".dylib";
-                       in =  NativeLib.class.getClassLoader().getResourceAsStream(Path+filename);
-               }
-               if (in == null) {
-                       throw new SimGridLibNotFoundException("Cannot find library "+name+" in path "+Path+". Sorry, but this jar does not seem to be usable on your machine.");
-               }
-               try {
-                       // We must write the lib onto the disk before loading it -- stupid operating systems
-                       File fileOut = new File(filename);
-                       fileOut = File.createTempFile(name+"-", ".tmp");
-                       // don't leak the file on disk, but remove it on JVM shutdown
-                       Runtime.getRuntime().addShutdownHook(new Thread(new FileCleaner(fileOut.getAbsolutePath())));
-                       OutputStream out = new FileOutputStream(fileOut);
-
-                       /* copy the library in position */  
-                       byte[] buffer = new byte[4096]; 
-                       int bytes_read; 
-                       while ((bytes_read = in.read(buffer)) != -1)     // Read until EOF
-                               out.write(buffer, 0, bytes_read); 
-
-                       /* close all file descriptors, and load that shit */
-                       in.close();
-                       out.close();
-                       System.load(fileOut.getAbsolutePath());
-               } catch (Exception e) {
-                       System.err.println("Error while extracting the native library from the jar: ");
-                       e.printStackTrace();
-                       throw new SimGridLibNotFoundException("Cannot load the bindings to the "+name+" library in path "+getPath(),   e);
-               }
-       }
-
-       /* A hackish mechanism used to remove the file containing our library when the JVM shuts down */
+       
+       /** A hackish mechanism used to remove the file containing our library when the JVM shuts down */
        private static class FileCleaner implements Runnable {
-               private String target;
-               public FileCleaner(String name) {
-                       target = name;
+               private File dir;
+               public FileCleaner(File dir) {
+                       this.dir = dir;
                }
+               @Override
                public void run() {
                        try {
-                               new File(target).delete();
+                               for (File f : dir.listFiles())
+                                       if (! f.delete() && !f.getAbsolutePath().contains("appveyor")) // Be silent on AppVeyor to not break the tests. Ugly trick :)
+                                               System.out.println("Unable to clean temporary file "+f.getAbsolutePath()+" during shutdown.");
+                               if (! dir.delete() && !dir.getAbsolutePath().contains("appveyor") )
+                                       System.out.println("Unable to clean temporary file "+dir.getAbsolutePath()+" during shutdown.");                                
                        } catch(Exception e) {
-                               System.out.println("Unable to clean temporary file "+target+" during shutdown.");
+                               System.out.println("Unable to clean temporary file "+dir.getAbsolutePath()+" during shutdown: "+e.getCause());
                                e.printStackTrace();
                        }
-               }    
-       }
-
-
-       public static void main(String[] args) {
-               System.out.println("This jarfile searches the native code under: " +getPath());
+               }
        }
 }
-
-class SimGridLibNotFoundException extends Exception {
-       private static final long serialVersionUID = 1L;
-       public SimGridLibNotFoundException(String msg) {
-               super(msg);
-       }
-
-       public SimGridLibNotFoundException(String msg, Exception e) {
-               super(msg,e);
-       }
-}
\ No newline at end of file