1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
Zstd-jni
========
[](https://github.com/luben/zstd-jni/actions)
[](http://codecov.io/github/luben/zstd-jni?branch=master)
[](https://lgtm.com/projects/g/luben/zstd-jni/context:cpp)
[](https://lgtm.com/projects/g/luben/zstd-jni/context:java)
[](https://lgtm.com/projects/g/luben/zstd-jni/alerts)
[](https://search.maven.org/artifact/com.github.luben/zstd-jni/)
[](https://www.javadoc.io/doc/com.github.luben/zstd-jni)
Overview
--------
JNI bindings for **Zstd** native library that provides fast and high
compression lossless algorithm for Android, Java and all JVM languages:
* static compress/decompress methods
* implementation of InputStream and OutputStream for transparent compression
of data streams fully compatible with the "zstd" program.
* minimal performance overhead
Zstd
----
**Zstd**, short for Zstandard, is a new lossless compression algorithm, which
provides both good compression ratio _and_ speed for your standard compression
needs. "Standard" translates into everyday situations which neither look for
highest possible ratio (which LZMA and ZPAQ cover) nor extreme speeds (which
LZ4 covers).
**Zstd** is developed by Yann Collet and the source is available at:
https://github.com/facebook/zstd
The motivation for development, the algorithm used and its properties are
explained in the blog post that introduces the library:
http://fastcompression.blogspot.com/2015/01/zstd-stronger-compression-algorithm.html
Status and availability
-----------------------
**Zstd** is production ready with a stable format.
**Zstd-jni** is tracking the release branch of **Zstd** (master) with
compatibility support for the legacy formats (since version 0.4).
**Zstd-jni** version uses the base **Zstd** version with **Zstd-jni** release
appended with a dash, e.g. "1.2.0-2" is the second **Zstd-jni** release based
on **Zstd** version 1.2.0.
Limitations
-----------
The Java classes cannot be renamed/minimized/relocated. JVM linking the native
library depends on the class name that is trying to link the native part, so
changing the class names will lead to failed linking at runtime.
Building and dependencies
-------------------------
**Zstd-jni** uses SBT for building the library and running the tests.
The build system depends on Scala and the tests depend on ScalaTest and
ScalaCheck but the produced JAR does not have any dependencies. It also
embeds the native library.
Compile and test:
```
$ ./sbt compile test package
```
If you want to publish it to you local ivy2 repository:
```
$ ./sbt publishLocal
```
Binary releases
---------------
The binary releases are architecture dependent because we are embedding the
native library in the provided Jar file. Currently they are built for
*linux-amd64*, *linux-i386*, *linux-aarch64*, *linux-armhf*, *linux-ppc64*,
*linux-ppc64le*, *linux-mips64*, *linux-s390x*, *win-amd64*, *win-x86*,
*darwin-x86_64* (MacOS X), *darwin-aarch64*, *freebsd-amd64*, and *freebsd-i386*.
More builds will be available if I get access to more platforms.
You can find published releases on Maven Central.
<dependency>
<groupId>com.github.luben</groupId>
<artifactId>zstd-jni</artifactId>
<version>VERSION</version>
</dependency>
sbt dependency:
libraryDependencies += "com.github.luben" % "zstd-jni" % "VERSION"
Single architecture classified jars are also published. They can be used like:
<dependency>
<groupId>com.github.luben</groupId>
<artifactId>zstd-jni</artifactId>
<version>VERSION</version>
<classifier>linux_amd64</classifier>
</dependency>
or for sbt:
libraryDependencies += "com.github.luben" % "zstd-jni" % "VERSION" classifier "linux_amd64"
Link for direct download if you don't use a dependency manager:
- https://repo1.maven.org/maven2/com/github/luben/zstd-jni/
If there is not yet a binary release compatible with your platform look how
to build it locally under the [Building](#building-and-dependencies) section.
Android support
---------------
Zstd-jni is usable in Android applications by importing the sources in Android
Studio. I guess using git sub-modules will also work.
Android archive (*zstd-jni.aar*) is also published on maven central. You will need
to add the repository in your build.gradle, e.g.:
allprojects {
repositories {
jcenter()
mavenCentral()
}
}
as it is not added by default by Android Studio. And then add dependency on the
prebuilt android archive (aar):
dependencies {
implementation "com.github.luben:zstd-jni:VERSION@aar"
testImplementation "com.github.luben:zstd-jni:VERSION"
}
For example Android app and how to declare dependencies and use zstd-jni, consult
the 2nd and 3rd commit of: https://github.com/luben/ZstdAndroidExample
License
-------
The code for these JNI bindings is licenced under 2-clause BSD license.
The native **Zstd** library is licensed under 3-clause BSD license or
GPL2. See the LICENSE file and LICENSE and COPYRIGHT in src/main/native
for full copyright and conditions.
|
