Package com.kenai.jffi
Class Library
- java.lang.Object
-
- com.kenai.jffi.Library
-
public final class Library extends Object
Represents a native library
-
-
Field Summary
Fields Modifier and Type Field Description static int
GLOBAL
All symbols in the library are made available to other librariesstatic int
LAZY
Perform lazy binding.static int
LOCAL
Symbols in this library are not made available to other librariesstatic int
NOW
Resolve all symbols when loading the library
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
finalize()
static Library
getCachedInstance(String name, int flags)
Gets a handle for the named library.static Library
getDefault()
Gets a handle to the default library.static String
getLastError()
Gets the current error string from dlopen/LoadLibrary.long
getSymbolAddress(String name)
Gets the address of a symbol within theLibrary
.static Library
openLibrary(String name, int flags)
Gets a handle for the named library.
-
-
-
Field Detail
-
LAZY
public static final int LAZY
Perform lazy binding. Only resolve symbols as needed- See Also:
- Constant Field Values
-
NOW
public static final int NOW
Resolve all symbols when loading the library- See Also:
- Constant Field Values
-
LOCAL
public static final int LOCAL
Symbols in this library are not made available to other libraries- See Also:
- Constant Field Values
-
GLOBAL
public static final int GLOBAL
All symbols in the library are made available to other libraries- See Also:
- Constant Field Values
-
-
Method Detail
-
getDefault
public static final Library getDefault()
Gets a handle to the default library.- Returns:
- A
Library
instance representing the default library.
-
getCachedInstance
public static final Library getCachedInstance(String name, int flags)
Gets a handle for the named library.- Parameters:
name
- The name or path of the library to open.flags
- The library flags (e.g.LAZY, NOW, LOCAL, GLOBAL
)- Returns:
- A
Library
instance representing the named library, ornull
if the library could not be opened.
-
openLibrary
public static final Library openLibrary(String name, int flags)
Gets a handle for the named library. Note This will not cache the instance, nor will it return a cached instance. Only use when you really need a new handle for the library.- Parameters:
name
- The name or path of the library to open.flags
- The library flags (e.g.LAZY, NOW, LOCAL, GLOBAL
)- Returns:
- A
Library
instance representing the named library, or null if the library cannot be opened.
-
getSymbolAddress
public final long getSymbolAddress(String name)
Gets the address of a symbol within theLibrary
.- Parameters:
name
- The name of the symbol to locate.- Returns:
- The address of the symbol within the current address space.
-
getLastError
public static final String getLastError()
Gets the current error string from dlopen/LoadLibrary.- Returns:
- A
String
describing the last error.
-
-