com.github.ramanrajarathinam:native-utils

A simple library class which helps with loading dynamic libraries stored in the JAR archive. These libraries usualy contain implementation of some methods in native code (using JNI - Java Native Interface).

License	MIT License
Categories	Native Development Tools
GroupId	com.github.ramanrajarathinam
ArtifactId	native-utils
Last Version	1.0.0
Release Date	Aug 28, 2020
Type	jar
Description	com.github.ramanrajarathinam:native-utils A simple library class which helps with loading dynamic libraries stored in the JAR archive. These libraries usualy contain implementation of some methods in native code (using JNI - Java Native Interface).
Project URL	https://github.com/RamanRajarathinam/native-utils
Source Code Management	https://github.com/RamanRajarathinam/native-utils

Download native-utils

Filename	Size
native-utils-1.0.0.pom
native-utils-1.0.0.jar	5 KB
native-utils-1.0.0-sources.jar	5 KB
native-utils-1.0.0-javadoc.jar	24 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.ramanrajarathinam/native-utils/ -->
<dependency>
    <groupId>com.github.ramanrajarathinam</groupId>
    <artifactId>native-utils</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.ramanrajarathinam/native-utils/
implementation 'com.github.ramanrajarathinam:native-utils:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.ramanrajarathinam/native-utils/
implementation ("com.github.ramanrajarathinam:native-utils:1.0.0")

Apache Buildr

'com.github.ramanrajarathinam:native-utils:jar:1.0.0'

Apache Ivy

<dependency org="com.github.ramanrajarathinam" name="native-utils" rev="1.0.0">
  <artifact name="native-utils" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.ramanrajarathinam', module='native-utils', version='1.0.0')
)

Scala SBT

libraryDependencies += "com.github.ramanrajarathinam" % "native-utils" % "1.0.0"

Leiningen

[com.github.ramanrajarathinam/native-utils "1.0.0"]

Dependencies

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

Native Utils

A simple library class which helps with loading dynamic libraries stored in the JAR archive. These libraries usualy contain implementation of some methods in native code (using JNI - Java Native Interface).

Notes

• The temporary file is stored into temp directory specified by java.io.tmpdir (by default it’s the operating system’s temporary directory). It should be automatically deleted when the application exits.
• Although the code has some try-finally section (to be sure that streams are closed properly in case an exception is thrown), it does not catch exceptions. The exception has to be handled by the application. I belive this approach is cleaner and has some benefits.

Usage

To load the dynamic library, just make sure it is packed inside the JAR archive and call method loadLibraryFromJar:

import cz.adamh.NativeUtils;
 
public class HelloJNI {  
    static {   
        try {    
            NativeUtils.loadLibraryFromJar("/resources/libHelloJNI.so");   
        } catch (IOException e) {
            // This is probably not the best way to handle exception :-)    
            e.printStackTrace();
        }    
    }  
 
    public native void hello();    
}

More information

More information can be found in accompanying blog post.

Versions

Version
1.0.0 Aug 28, 2020