|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.jogamp.common.os.NativeLibrary
public class NativeLibrary
Provides low-level, relatively platform-independent access to
shared ("native") libraries. The core library routines
System.load()
and System.loadLibrary()
in general provide suitable functionality for applications using
native code, but are not flexible enough to support certain kinds
of glue code generation and deployment strategies. This class
supports direct linking of native libraries to other shared
objects not necessarily installed on the system (in particular,
via the use of dlopen(RTLD_GLOBAL) on Unix platforms) as well as
manual lookup of function names to support e.g. GlueGen's
ProcAddressTable glue code generation style without additional
supporting code needed in the generated library.
Field Summary |
---|
Fields inherited from interface com.jogamp.common.os.DynamicLookupHelper |
---|
DEBUG, DEBUG_LOOKUP |
Method Summary | |
---|---|
void |
close()
Closes this native library. |
long |
dynamicLookupFunction(String funcName)
Looks up the given function name in this native library. |
static long |
dynamicLookupFunctionGlobal(String funcName)
Looks up the given function name in all loaded libraries. |
static String |
findLibrary(String libName,
ClassLoader loader)
|
long |
getLibraryHandle()
Retrieves the low-level library handle from this NativeLibrary object. |
String |
getLibraryPath()
Retrieves the path under which this library was opened. |
static String |
isValidNativeLibraryName(String libName,
boolean isLowerCaseAlready)
Comparison of prefix and suffix of the given libName's basename is performed case insensitive |
static NativeLibrary |
open(String libName,
ClassLoader loader)
Opens the given native library, assuming it has the same base name on all platforms, looking first in the system's search path, and in the context of the specified ClassLoader, which is used to help find the library in the case of e.g. |
static NativeLibrary |
open(String libName,
ClassLoader loader,
boolean global)
Opens the given native library, assuming it has the same base name on all platforms, looking first in the system's search path, and in the context of the specified ClassLoader, which is used to help find the library in the case of e.g. |
static NativeLibrary |
open(String windowsLibName,
String unixLibName,
String macOSXLibName,
boolean searchSystemPathFirst,
ClassLoader loader)
Opens the given native library, assuming it has the given base names (no "lib" prefix or ".dll/.so/.dylib" suffix) on the Windows, Unix and Mac OS X platforms, respectively, and in the context of the specified ClassLoader, which is used to help find the library in the case of e.g. |
static NativeLibrary |
open(String windowsLibName,
String unixLibName,
String macOSXLibName,
boolean searchSystemPathFirst,
ClassLoader loader,
boolean global)
|
String |
toString()
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Method Detail |
---|
public String toString()
toString
in class Object
public static NativeLibrary open(String libName, ClassLoader loader)
public static NativeLibrary open(String libName, ClassLoader loader, boolean global)
public static NativeLibrary open(String windowsLibName, String unixLibName, String macOSXLibName, boolean searchSystemPathFirst, ClassLoader loader)
public static NativeLibrary open(String windowsLibName, String unixLibName, String macOSXLibName, boolean searchSystemPathFirst, ClassLoader loader, boolean global)
public long dynamicLookupFunction(String funcName)
dynamicLookupFunction
in interface DynamicLookupHelper
public static long dynamicLookupFunctionGlobal(String funcName)
public long getLibraryHandle()
public String getLibraryPath()
public void close()
public static String isValidNativeLibraryName(String libName, boolean isLowerCaseAlready)
libName
- the full path library name with prefix and suffixisLowerCaseAlready
- indicates if libName is already lower-case
public static String findLibrary(String libName, ClassLoader loader)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |