ARQ : Jena SPARQL System
========================

ARQ is a complete implementation of SPARQL that can query any Jena model
or graph, including ones stored in databases.

Download
--------

Also available via SVN:
https://svn.apache.org/repos/asf/jena/trunk/jena-arq

Maven:
GroupId: org.apache.jena
ArtifactId: jena-arq

Development repository:
  https://repository.apache.org/content/repositories/snapshots/org/apache/jena/ 

Online demos and services
-------------------------

http://www.sparql.org/

including a SPARQL validator
http://www.sparql.org/validator.html

Documentation
-------------

http://jena.apache.org/documentation/query/index.html

Installation
------------

The apache-jena distribution includes ARQ and all it's dependencies.  It
also includes scripts to run the command line tools.

http://www.apache.org/dist/jena/

Unpack zip : it unpacks into a directory, including the version number.

Set environment variable ARQROOT to the path of this direrctory.

Maven Distribution
------------------
The maven repository contains the following files (for version VER)

jena-arq-VER.jar                 ARQ jar
jena-arq-VER-javadoc.jar         Javadoc
jena-arq-VER-sources.jar         Sources

jena-arq-VER-tests.jar           ARQ testing code
jena-arq-VER-test-sources.jar    Sourecs for test code
jena-arq-VER-tests.zip           Datafiles for tests, and test scripts.

jena-arq-VER.pom                 ARQ POM

jena-arq-VER.zip                 The complete distribution file (if available)
jena-arq-VER-source-release.zip  Complete copy of the codebase at the release.

To run tests, you will need 'jena-arq-VER.jar', 'jena-arq-VER-tests.jar' and all
dependences and to unpack 'jena-arq-VER-tests.zip' to get the "testing" data
directory and test scripts.

Or download the distribution 'jena-arq-VER.zip'. 

Running from the command line
-----------------------------

Some bash and bat scripts are provided to try out SPARQL queries.

In the apache-jena distribution, set JENAROOT.

    export JENAROOT=$PWD

Second, ensure all scripts are executable

    chmod u+x $JENAROOT/bin/*

Command line applications:

sparql   -- Run a SPARQL query.  A wrapper around 'query'.
arq      -- Run an ARQ query.  A wrapper around 'query'.
query    -- Run a query. 
qparse   -- Parse a query
qtest    -- Run tests
rset     -- Read and write result sets (RDF, XML, JSON, text (out only))

For the 'query' command, files ending .rq are assumed to be SPARQL queries
and files ending .arq are ARQ queries, unless the syntax is given
explicitly.  Unknown files are assumed to be SPARQL queries.

sparql --data <some data file> --query query 
sparql --data <some data file> 'Query string'

Default output is a text table for SELECT queries, an RDF model for
DESCRIBE and CONSTRUCT.

Run the script with no argument to get a usage message.

Running commands as Java
------------------------

Set the classpath to "$JENAROOT/lib/*" (Linux) or "$JENAROOT\lib\*;" (Windows).

The arq command line application is:
java -cp ... arq.query ....

ARQ.Net
-------

ARQ has been run under IKVM (http://www.ikvm.net/), using IKVM to
translate the bytecodes to IL and using IKVM as a JVM.

Changes
-------

See ChangeLog.txt

Support and Questions
---------------------

Comments and questions about ARQ to the Jena mailing list 
    users@jena.apache.org

General questions and comments on SPARQL to jena-dev or
    public-sparql-dev@w3.org
    
Formal comments specific to the SPARQL query language,
protocol or result set documents to:
	public-rdf-dawg-comments@w3.org