com.jogamp.common.os.DynamicLibraryBundle

All Implemented Interfaces:: DynamicLookupHelper

public class DynamicLibraryBundle extends Object implements DynamicLookupHelper

Provides bundling of:

The to-be-glued native library, eg OpenGL32.dll. From here on this is referred as the Tool.
The JNI glue-code native library, eg jogl_desktop.dll. From here on this is referred as the Glue

An DynamicLibraryBundleInfo instance is being passed in the constructor, providing the required information about the tool and glue libraries. The ClassLoader of it's implementation is also being used to help locating the native libraries.

An instance provides a complete DynamicLookupHelper to reset the ProcAddressTable.
At construction, it:

loads the Tool native library via NativeLibrary's open method
loads the Glue native library
resolves the Tool's GetProcAddress. (optional)

Field Summary

Fields

Modifier and Type

Field

Description

protected final List<NativeLibrary>

nativeLibraries

Fields inherited from interface com.jogamp.common.os.DynamicLookupHelper
DEBUG, DEBUG_LOOKUP
Constructor Summary

Constructors

Constructor

Description

DynamicLibraryBundle(DynamicLibraryBundleInfo info)

Instantiates and loads all NativeLibrarys incl.
Method Summary

Modifier and Type

Method

Description

final void

claimAllLinkPermission()

final void

destroy()

Unload all NativeLibrarys, and remove all references.

final long

dynamicLookupFunction(String funcName)

Returns the function handle for function 'funcName'.

final DynamicLibraryBundleInfo

getBundleInfo()

static RunnableExecutor

getDefaultRunnableExecutor()

Returns an AWT-EDT RunnableExecutor implementation if AWT is available, otherwise RunnableExecutor.currentThreadExecutor.

final int

getGlueLibLoadedNumber()

final int

getGlueLibNumber()

protected final long

getToolGetProcAddressHandle()

final int

getToolLibLoadedNumber()

final int

getToolLibNumber()

final boolean

isFunctionAvailable(String funcName)

Queries whether function 'funcName' is available.

final boolean

isGlueLibComplete()

final boolean

isGlueLibLoaded(int i)

final boolean

isLibComplete()

final boolean

isToolLibComplete()

final boolean

isToolLibLoaded()

final boolean

isToolLibLoaded(int i)

protected static final NativeLibrary

loadFirstAvailable(List<String> libNames, ClassLoader loader, boolean global)

final void

releaseAllLinkPermission()

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- nativeLibraries
  
  protected final List<NativeLibrary> nativeLibraries
Constructor Details
- DynamicLibraryBundle
  
  public DynamicLibraryBundle(DynamicLibraryBundleInfo info)
  
  Instantiates and loads all NativeLibrarys incl. JNI libraries.
  The ClassLoader of the DynamicLibraryBundleInfo implementation class is being used to help locating the native libraries.
Method Details
- getDefaultRunnableExecutor
  
  public static RunnableExecutor getDefaultRunnableExecutor()
  
  Returns an AWT-EDT RunnableExecutor implementation if AWT is available, otherwise RunnableExecutor.currentThreadExecutor.
- destroy
  
  public final void destroy()
  
  Unload all NativeLibrarys, and remove all references.
- isLibComplete
  
  public final boolean isLibComplete()
- getToolLibNumber
  
  public final int getToolLibNumber()
- getToolLibLoadedNumber
  
  public final int getToolLibLoadedNumber()
- isToolLibComplete
  
  public final boolean isToolLibComplete()
  Returns:
  
  true if all tool libraries are loaded, otherwise false.
  
  See Also:
  
  DynamicLibraryBundleInfo.getToolLibNames()
- isToolLibLoaded
  
  public final boolean isToolLibLoaded()
- isToolLibLoaded
  
  public final boolean isToolLibLoaded(int i)
- getGlueLibNumber
  
  public final int getGlueLibNumber()
- getGlueLibLoadedNumber
  
  public final int getGlueLibLoadedNumber()
- isGlueLibComplete
  
  public final boolean isGlueLibComplete()
  Returns:
  
  true if the last entry has been loaded, while ignoring the preload dependencies. Otherwise false.
  
  See Also:
  
  DynamicLibraryBundleInfo.getGlueLibNames()
- isGlueLibLoaded
  
  public final boolean isGlueLibLoaded(int i)
- getBundleInfo
  
  public final DynamicLibraryBundleInfo getBundleInfo()
- getToolGetProcAddressHandle
  
  protected final long getToolGetProcAddressHandle() throws SecurityException
  
  Throws:
  
  SecurityException
- loadFirstAvailable
  
  protected static final NativeLibrary loadFirstAvailable(List<String> libNames, ClassLoader loader, boolean global) throws SecurityException
  
  Throws:
  
  SecurityException
- claimAllLinkPermission
  
  public final void claimAllLinkPermission() throws SecurityException
  
  Specified by:
  
  claimAllLinkPermission in interface DynamicLookupHelper
  
  Throws:
  
  SecurityException - if user is not granted access for the library set.
- releaseAllLinkPermission
  
  public final void releaseAllLinkPermission() throws SecurityException
  
  Specified by:
  
  releaseAllLinkPermission in interface DynamicLookupHelper
  
  Throws:
  
  SecurityException - if user is not granted access for the library set.
- dynamicLookupFunction
  
  public final long dynamicLookupFunction(String funcName) throws SecurityException
  
  Description copied from interface: DynamicLookupHelper
  
  Returns the function handle for function 'funcName'.
  
  Specified by:
  
  dynamicLookupFunction in interface DynamicLookupHelper
  
  Throws:
  
  SecurityException - if user is not granted access for the library set.
- isFunctionAvailable
  
  public final boolean isFunctionAvailable(String funcName) throws SecurityException
  
  Description copied from interface: DynamicLookupHelper
  
  Queries whether function 'funcName' is available.
  
  Specified by:
  
  isFunctionAvailable in interface DynamicLookupHelper
  
  Throws:
  
  SecurityException - if user is not granted access for the library set.

Class DynamicLibraryBundle

Field Summary

Fields inherited from interface com.jogamp.common.os.DynamicLookupHelper

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Details

nativeLibraries

Constructor Details

DynamicLibraryBundle

Method Details

getDefaultRunnableExecutor

destroy

isLibComplete

getToolLibNumber

getToolLibLoadedNumber

isToolLibComplete

isToolLibLoaded

isToolLibLoaded

getGlueLibNumber

getGlueLibLoadedNumber

isGlueLibComplete

isGlueLibLoaded

getBundleInfo

getToolGetProcAddressHandle

loadFirstAvailable

claimAllLinkPermission

releaseAllLinkPermission

dynamicLookupFunction

isFunctionAvailable