Description of how to use the toolkit and examples

Since this project is mainly aimed at building a general purpose Web Archiving Toolkit these packages do not contain any applications, instead they are intended to be used as building blocks.

Used as a Maven Dependency

If you want to use JWAT from any build environment that supports artifacts the following can be used.

<dependency>
  <groupId>org.jwat</groupId>
  <artifactId>jwat</artifactId>
  <version>0.8.0-SNAPSHOT</version>
  <type>pom</type>
</dependency>

Used as jars.

If you want to use the jars by themselves you can just download them and place them in the classpath.

You should be able to find them on the Sonatype Maven Repository.

Usage:

The WARC reader can be used to read either all the records in a file sequentially or select records in random order.

Both scenarios are supported by the various factory and reader methods.

Compression:

Besides uncompressed WARC files, GZip compressed files are also supported.

GZip compression is only supported on WARC files where each record is compressed individually and concatenated into one file and not the case where the whole WARC file and all it's records are GZip'ed as a whole. The later mostly because this makes random access to individual record highly ineffective.