Jena 2 Preview 1 Release

Jena: A Java API for Semantic Web Applications

Readme for version j2p1

Hewlett Packard Laboratories, Bristol

Overview

Jena is a java API for manipulating RDF graphs. Its features include:

statement centric methods for manipulating an RDF model as a set of RDF triples
resource centric methods for manipulating an RDF model as a set of resources with properties
cascading method calls for more convenient programming
built in support for RDF containers - bag, alt and seq
enhanced resources - the application can extend the behaviour of resources
integrated parsers and writers for RDF/XML (ARP), N3 and N-TRIPLES

This jena toolkit includes a number of components:

RDF Model API
ARP parser compliant with latest working group recommendations
integrated query language (RDQL)
Support for datatype literals
Experimental support for RDFS inference

This version of the Jena toolkit is a preview release of Jena 2. It has considerably less functionality than the current Jena 1 release (no DAML support, no persistenence support, no reification support). It is newer and thus less well tested in the field. However, it does have fully compliant support for datatyped literals, parsers and writers that are fully conformant with the RDFCore WG last call drafts and a preview of the proposed support for RDFS inference. The Jena team intend to complete the functionality missing from Jena 1 as soon as possible.

The Jena team do not recommend migrating from Jena 1 to Jena 2 at this time. However, we do encourage folks to try out Jena 2 and provide feedback on ease of migrating existing code and experience, especially with the new features such as datatypes and the preliminary inference SPI.

Whilst the intention is maintain the present API through the migration from Jena 1 to Jena 2, we are taking the opportunity to make some minor changes that folks have requested. These are described in the document Migrating from Jena 1 to Jena2. You may notice the javadoc is a lot smaller. This is largely because we are trying to not include classes which are internal to the operation of Jena.

Earlier and more recent versions may be available from the Jena web site - http://www.hpl.hp.com/semweb.

Installation

unzip the distribution file into a convenient directory, JENAROOT.

set the class path to include:

  
  JENAROOT/lib/jena.jar
  JENAROOT/lib/xerces.jar 
  JENAROOT/lib/icu4j.jar 
  JENAROOT/lib/concurrent-1.3.0.jar   // if using RDQL query support
  JENAROOT/lib/jakarta-oro-2.0.5.jar  // if using RDQL query support
  JENAROOT/lib/db3-3-11.jar           // if using Berkeley DB interface
  JENAROOT/lib/antlr.debug.jar
  JENAROOT/lib/sesame-client.jar      // if using Jena-Sesame query engine
  JENAROOT/lib/junit.jar
  JENAROOT/lib/rdf-api-2001-01-19.jar

Test the distribution by running the regression tests, either:

ant test                      // if you have ant configured to run junit

test.bat                      // on windows

test.sh                       // on unix

You may see some warnings, but the tests should run.

Applications

The Jena distribution includes some convenience applications.

jena.rdfcopy will read an RDF file in either RDF/XML, N3 or n-triple format and write it to standard out in either RDF/XML, N3 or n-triple format. It can be used to translate between different RDF serialization formats.

jena.rdfcompare will read two RDF files, in either RDF/XML, N3 or n-triple format and test whether they are equal.

jena.rdfquery will execute an RDQL query on an RDF data file, in either RDF/XML or n-triple format and print the table of results in text or HTML. It can also be used to query a Jena model held in a BerkeleyDB persistent store.

jena.rdfparse is command line interface to the ARP RDF/XML parser.

jena.n3 is a command line interfacec to Jena's N3 parser.

jena.schemagen takes and RDF Schema and generates the java source code for a constant class containing constants for all the classes and properties defined in that schema.

These programs can be set use use a proxy to traverse a firewall by setting system properties. To use a socks proxy include the following in the command line:

   -DsocksProxyHost=<your-proxy-domain-name-or-ip-address>

To use an http proxy include the following on the command line:

   -DproxySet=true -DproxyHost=<your-proxy> -DproxyPort=<your-proxy-port-number>

Getting started with jena

For the core java RDF API the key package to look at is com.hp.hpl.rdf..model. This package defines all of the key interfaces which the different implementations (jena.mem, jena.bdb, jena.common) conform to.

The jena subsystems

ARP parser: ARP is a new RDF parser designed to be compliant with the latest working group recommendations. ARP is the default parser for jena. It can also be run standalone. For more information on ARP see the documentation in doc/ARP.
RDQL query language: RDQL is a query engine for Jena. It provides the SquishQL language (see the grammar file for exact details). See README_RDQL, RDQL_Usage.html, RDQL_Examples.html and rdql_grammar.html, for condensed documentation.

Reasoning Subsystem: The Jena2 reasoner subsystem is designed to allow a range of inference engines to be plugged into Jena. Such reasoners are primarily used to derive additional RDF assertions which are entailed from some base RDF together with any optional ontology information and the axioms and rules associated with the reasoner. In addition, they can be used to test global properties of an RDF graph such as consistency.; Currently, the reasoning subsystem requires using the SPI layer code. See the reasoner documentation for more details.

License

Jena is distributed under a BSD style open source license.

It includes software developed by the Apache Software Foundation (http://www.apache.org/), both in the form of jar files and source code.

Acknowledgements

Jena is built on top of other sub-systems which we gratefully acknowledge: