Extract the files of the given jar file.

If extractNativeLibraries is true, native libraries are added to the given nativeLibMap with the base name to temp file location.
A file is identified as a native library, if it's name complies with the running platform's native library naming scheme.
Root entries are favored over non root entries in case of naming collisions.
Example on a Unix like machine:

  mylib.jar!/sub1/libsour.so   -> sour  (mapped, unique name)
  mylib.jar!/sub1/libsweet.so           (dropped, root entry favored)
  mylib.jar!/libsweet.so       -> sweet (mapped, root entry favored)
  mylib.jar!/sweet.dll         ->       (dropped, not a unix library name)

In order to be compatible with Java Web Start, we need to extract all root entries from the jar file.
In this case, set all flags to true extractNativeLibraries . extractClassFiles, extractOtherFiles.

Parameters

nativeLibraryPath:String

if not null, only extracts native libraries within this path.

The Class's Jar Uri jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class Jar basename gluegen-rt.jar will be returned.

sub_protocol may be "file", "http", etc..

Parameters

classJarUri:Uri

as retrieved w/ getJarUri("com.jogamp.common.GlueGenVersion", cl), i.e. jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class

Returns:Uri.Encoded

gluegen-rt.jar

Exceptions

IllegalArgumentException:

if the Uri doesn't match the expected formatting or is null

See Also

IOUtil#getClassURL(String, ClassLoader)

The Class's com.jogamp.common.GlueGenVersion Uri jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class Jar basename gluegen-rt.jar will be returned.

sub_protocol may be "file", "http", etc..

Parameters

clazzBinName:String

com.jogamp.common.GlueGenVersion

Returns:Uri.Encoded

gluegen-rt.jar

Exceptions

IllegalArgumentException:

if the Uri doesn't match the expected formatting

IOException:

if the class's Jar file could not been found by the ClassLoader.

URISyntaxException:

if the Uri could not be translated into a RFC 2396 Uri

See Also

IOUtil#getClassURL(String, ClassLoader)

The Class's Jar Uri jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class Jar file's entry /com/jogamp/common/GlueGenVersion.class will be returned.

Parameters

classJarUri:Uri

as retrieved w/ getJarUri("com.jogamp.common.GlueGenVersion", cl), i.e. jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class

Returns:Uri.Encoded

/com/jogamp/common/GlueGenVersion.class

See Also

IOUtil#getClassURL(String, ClassLoader)

Parameters

jarFileUri:Uri

jar:file:/some/path/gluegen-rt.jar!/

jarEntry:Uri.Encoded

com/jogamp/common/GlueGenVersion.class

Returns:Uri

jar:file:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class

Exceptions

IllegalArgumentException:

null arguments

Parameters

clazzBinName:String

com.jogamp.common.util.cache.TempJarCache

cl:ClassLoader

domain

Returns:JarFile

JarFile containing the named class within the given ClassLoader

Exceptions

IOException:

if the class's Jar file could not been found by the ClassLoader

IllegalArgumentException:

null arguments

URISyntaxException:

if the Uri could not be translated into a RFC 2396 Uri

See Also

getJarFileUri(String, ClassLoader)

Parameters

jarFileUri:Uri

jar:file:/some/path/gluegen-rt.jar!/

Returns:JarFile

JarFile as named by Uri within the given ClassLoader

Exceptions

IOException:

if the Jar file could not been found

IllegalArgumentException:

null arguments

The Class's "com.jogamp.common.GlueGenVersion" Uri jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class" Jar file Uri jar:sub_protocol:/some/path/gluegen-rt.jar!/ will be returned.

sub_protocol may be "file", "http", etc..

Parameters

clazzBinName:String

"com.jogamp.common.GlueGenVersion"

Returns:Uri

"jar:sub_protocol:/some/path/gluegen-rt.jar!/"

Exceptions

IllegalArgumentException:

if the Uri doesn't match the expected formatting or null arguments

IOException:

if the class's Jar file could not been found by the ClassLoader

URISyntaxException:

if the Uri could not be translated into a RFC 2396 Uri

See Also

IOUtil#getClassURL(String, ClassLoader)

Parameters

baseUri:Uri

file:/some/path/

jarFileName:Uri.Encoded

gluegen-rt.jar (Uri encoded)

Returns:Uri

jar:file:/some/path/gluegen-rt.jar!/

Exceptions

IllegalArgumentException:

null arguments

Parameters

jarSubUri:Uri

file:/some/path/gluegen-rt.jar

Returns:Uri

jar:file:/some/path/gluegen-rt.jar!/

Exceptions

IllegalArgumentException:

null arguments

Parameters

jarSubUriS:Uri.Encoded

file:/some/path/gluegen-rt.jar (Uri encoded)

Returns:Uri

jar:file:/some/path/gluegen-rt.jar!/

Exceptions

IllegalArgumentException:

null arguments

The Class's "com.jogamp.common.GlueGenVersion" Uri jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class" will be returned.

sub_protocol may be "file", "http", etc..

Parameters

clazzBinName:String

"com.jogamp.common.GlueGenVersion"

cl:ClassLoader

ClassLoader to locate the JarFile

Returns:Uri

"jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class"

Exceptions

IllegalArgumentException:

if the Uri doesn't match the expected formatting or null arguments

IOException:

if the class's Jar file could not been found by the ClassLoader

URISyntaxException:

if the Uri could not be translated into a RFC 2396 Uri

See Also

IOUtil#getClassURL(String, ClassLoader)

Return a map from native-lib-base-name to entry-name.

See getRelativeOf(Class, com.jogamp.common.net.Uri.Encoded, com.jogamp.common.net.Uri.Encoded).

Parameters

classFromJavaJar:Class<?>

URI encoded!

cutOffInclSubDir:String

URI encoded!

relResPath:String

URI encoded!

Locates the Jar file Uri of a given resource relative to a given class's Jar's Uri.

  class's jar url path + cutOffInclSubDir + relResPath,

  classFromJavaJar = com.lighting.Test (in: file:/storage/TestLighting.jar)
  cutOffInclSubDir = lights/
  relResPath       = LightAssets.jar
  Result           : file:/storage/lights/LightAssets.jar

  classFromJavaJar = com.lighting.Test (in: file:/storage/lights/TestLighting.jar)
  cutOffInclSubDir = lights/
  relResPath       = LightAssets.jar
  Result           : file:/storage/lights/LightAssets.jar

Parameters

classFromJavaJar:Class<?>

Used to get the root Uri for the class's Jar Uri.

cutOffInclSubDir:Uri.Encoded

The cut off included sub-directory prepending the relative resource path. If the root Uri includes cutOffInclSubDir, it is no more added to the result.

relResPath:Uri.Encoded

The relative resource path. (Uri encoded)

Returns:Uri

The resulting resource Uri, which is not tested.

Returns true if the Class's "com.jogamp.common.GlueGenVersion" is loaded from a JarFile and hence has a Jar URI like URI jar:sub_protocol:/some/path/gluegen-rt.jar!/com/jogamp/common/GlueGenVersion.class".

sub_protocol may be "file", "http", etc..

Parameters

clazzBinName:String

"com.jogamp.common.GlueGenVersion"

Returns:boolean

true if the class is loaded from a Jar file, otherwise false.

See Also

getJarUri(String, ClassLoader)

Setting a custom Resolver instance.

Parameters

r:JarUtil.Resolver

Resolver to use after querying class file URLs from the classloader.

Exceptions

IllegalArgumentException:

if the passed resolver is null

IllegalStateException:

if the resolver has already been set.

SecurityException:

if the security manager doesn't have the setFactory permission

Validate the certificates for each native Lib in the jar file. Throws an IOException if any certificate is not valid.

       Certificate[] rootCerts = Something.class.getProtectionDomain().
                                       getCodeSource().getCertificates();