Skip to content

Commit b372a81

Browse files
committed
README.md: fix dead Google Code links
Update links to `framing_format.txt` to Google's snappy GitHub project
1 parent 0812a50 commit b372a81

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

README.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,31 @@
11
The snappy-java is a Java port of the snappy
22
<http://code.google.com/p/snappy/>, a fast C++ compresser/decompresser developed by Google.
33

4-
## Features
4+
## Features
55
* Fast compression/decompression around 200~400MB/sec.
6-
* Less memory usage. SnappyOutputStream uses only 32KB+ in default.
6+
* Less memory usage. SnappyOutputStream uses only 32KB+ in default.
77
* JNI-based implementation to achieve comparable performance to the native C++ version.
88
* Although snappy-java uses JNI, it can be used safely with multiple class loaders (e.g. Tomcat, etc.).
99
* Compression/decompression of Java primitive arrays (`float[]`, `double[]`, `int[]`, `short[]`, `long[]`, etc.)
10-
* Portable across various operating systems; Snappy-java contains native libraries built for Window/Mac/Linux (64-bit). snappy-java loads one of these libraries according to your machine environment (It looks system properties, `os.name` and `os.arch`).
11-
* Simple usage. Add the snappy-java-(version).jar file to your classpath. Then call compression/decompression methods in `org.xerial.snappy.Snappy`.
12-
* [Framing-format support](http://snappy.googlecode.com/svn/trunk/framing_format.txt) (Since 1.1.0 version)
10+
* Portable across various operating systems; Snappy-java contains native libraries built for Window/Mac/Linux (64-bit). snappy-java loads one of these libraries according to your machine environment (It looks system properties, `os.name` and `os.arch`).
11+
* Simple usage. Add the snappy-java-(version).jar file to your classpath. Then call compression/decompression methods in `org.xerial.snappy.Snappy`.
12+
* [Framing-format support](https://github.com/google/snappy/blob/master/framing_format.txt) (Since 1.1.0 version)
1313
* OSGi support
1414
* [Apache License Version 2.0](http://www.apache.org/licenses/LICENSE-2.0). Free for both commercial and non-commercial use.
1515

16-
## Performance
16+
## Performance
1717
* Snappy's main target is very high-speed compression/decompression with reasonable compression size. So the compression ratio of snappy-java is modest and about the same as `LZF` (ranging 20%-100% according to the dataset).
1818

1919
* Here are some [benchmark results](https://github.com/ning/jvm-compressor-benchmark/wiki), comparing
2020
snappy-java and the other compressors
21-
`LZO-java`/`LZF`/`QuickLZ`/`Gzip`/`Bzip2`. Thanks [Tatu Saloranta @cotowncoder](http://twitter.com/#!/cowtowncoder) for providing the benchmark suite.
21+
`LZO-java`/`LZF`/`QuickLZ`/`Gzip`/`Bzip2`. Thanks [Tatu Saloranta @cotowncoder](http://twitter.com/#!/cowtowncoder) for providing the benchmark suite.
2222
* The benchmark result indicates snappy-java is the fastest compreesor/decompressor in Java: http://ning.github.com/jvm-compressor-benchmark/results/canterbury-roundtrip-2011-07-28/index.html
2323
* The decompression speed is twice as fast as the others: http://ning.github.com/jvm-compressor-benchmark/results/canterbury-uncompress-2011-07-28/index.html
2424

2525

26-
## Download
26+
## Download
2727

28-
* [Release Notes](Milestone.md)
28+
* [Release Notes](Milestone.md)
2929

3030
The current stable version is available from here:
3131
* Release version: http://central.maven.org/maven2/org/xerial/snappy/snappy-java/
@@ -51,7 +51,7 @@ libraryDependencies += "org.xerial.snappy" % "snappy-java" % "1.1.2"
5151
```
5252

5353

54-
## Usage
54+
## Usage
5555
First, import `org.xerial.snapy.Snappy` in your Java code:
5656

5757
```java
@@ -65,15 +65,15 @@ String input = "Hello snappy-java! Snappy-java is a JNI-based wrapper of "
6565
+ "Snappy, a fast compresser/decompresser.";
6666
byte[] compressed = Snappy.compress(input.getBytes("UTF-8"));
6767
byte[] uncompressed = Snappy.uncompress(compressed);
68-
68+
6969
String result = new String(uncompressed, "UTF-8");
7070
System.out.println(result);
7171
```
7272

73-
In addition, high-level methods (`Snappy.compress(String)`, `Snappy.compress(float[] ..)` etc. ) and low-level ones (e.g. `Snappy.rawCompress(.. )`, `Snappy.rawUncompress(..)`, etc.), which minimize memory copies, can be used.
73+
In addition, high-level methods (`Snappy.compress(String)`, `Snappy.compress(float[] ..)` etc. ) and low-level ones (e.g. `Snappy.rawCompress(.. )`, `Snappy.rawUncompress(..)`, etc.), which minimize memory copies, can be used.
7474

7575
### Stream-based API
76-
Stream-based compressor/decompressor `SnappyOutputStream`/`SnappyInputStream` are also available for reading/writing large data sets. `SnappyFramedOutputStream`/`SnappyFramedInputStream` can be used for the [framing format](https://code.google.com/p/snappy/source/browse/trunk/framing_format.txt).
76+
Stream-based compressor/decompressor `SnappyOutputStream`/`SnappyInputStream` are also available for reading/writing large data sets. `SnappyFramedOutputStream`/`SnappyFramedInputStream` can be used for the [framing format](https://github.com/google/snappy/blob/master/framing_format.txt).
7777

7878
* See also [Javadoc API](https://oss.sonatype.org/service/local/repositories/releases/archive/org/xerial/snappy/snappy-java/1.1.2/snappy-java-1.1.2-javadoc.jar/!/index.html)
7979

@@ -82,15 +82,15 @@ Stream-based compressor/decompressor `SnappyOutputStream`/`SnappyInputStream` ar
8282

8383
| Write\Read | `Snappy.uncompress` | `SnappyInputStream` | `SnappyFramedInputStream` |
8484
| --------------- |:-------------------:|:------------------:|:-----------------------:|
85-
| `Snappy.compress` | ok | ok | x |
85+
| `Snappy.compress` | ok | ok | x |
8686
| `SnappyOutputStream` | x | ok | x |
8787
| `SnappyFramedOutputStream` | x | x | ok |
8888

8989
### Setting classpath
9090
If you have snappy-java-(VERSION).jar in the current directory, use `-classpath` option as follows:
9191

9292
$ javac -classpath ".;snappy-java-(VERSION).jar" Sample.java # in Windows
93-
or
93+
or
9494
$ javac -classpath ".:snappy-java-(VERSION).jar" Sample.java # in Mac or Linux
9595

9696

@@ -102,15 +102,15 @@ Post bug reports or feature request to the Issue Tracker: <https://github.com/xe
102102
Public discussion forum is here: [Xerial Public Discussion Group)[http://groups.google.com/group/xerial?hl=en]
103103

104104

105-
## Building from the source code
105+
## Building from the source code
106106
See the [installation instruction](https://github.com/xerial/snappy-java/blob/develop/INSTALL). Building from the source code is an option when your OS platform and CPU architecture is not supported. To build snappy-java, you need Git, JDK (1.6 or higher), g++ compiler (mingw in Windows) etc.
107107

108108
$ git clone https://github.com/xerial/snappy-java.git
109109
$ cd snappy-java
110110
$ make
111-
111+
112112
When building on Solaris use
113-
113+
114114
$ gmake
115115

116116
A file `target/snappy-java-$(version).jar` is the product additionally containing the native library built for your platform.
@@ -187,7 +187,7 @@ For the details of sbt usage, see my blog post: [Building Java Projects with sbt
187187
## Miscellaneous Notes
188188
### Using snappy-java with Tomcat 6 (or higher) Web Server
189189

190-
Simply put the snappy-java's jar to WEB-INF/lib folder of your web application. Usual JNI-library specific problem no longer exists since snappy-java version 1.0.3 or higher can be loaded by multiple class loaders.
190+
Simply put the snappy-java's jar to WEB-INF/lib folder of your web application. Usual JNI-library specific problem no longer exists since snappy-java version 1.0.3 or higher can be loaded by multiple class loaders.
191191

192192
----
193193
Snappy-java is developed by [Taro L. Saito](http://www.xerial.org/leo). Twitter [@taroleo](http://twitter.com/#!/taroleo)

0 commit comments

Comments
 (0)