== what is FeDeRate? ==

FeDeRate provides a SPARQL endpoint over the Direct Graph derived from a particular Relational Database.

The SPARQL query is compiled on the fly to a SQL query targetting the RDB schema (so it's as fast as SQL itself).

Please read http://www.w3.org/2001/sw/rdb2rdf/directGraph/ to understand the Direct Graph (this is a work in progress).

== description of the sub-projects ==

FeDeRate is the main project, ruling several sub-projects. The dependencies between them can be found in `project/build/FeDeRate.scala`. Each project has its own directory. Here is a short description of each of them:

FeDeRate
|-- rdf                → the RDF model, as in http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#section-Graph-syntax
|-- rdb                → the Relational Database model, used to describe the schema and the data (no SQL request at that point)
|-- sql                → a SQL parser, restricted to CREATE and INSERT statements
|-- sparql             → the SPARQL 1.0 model + its (almost) complete parser
|-- directmapping      → the Direct Mapping, as defined in http://www.w3.org/2001/sw/rdb2rdf/directGraph/
|-- sparql2sparql      → SPARQL to SPARQL rewriting, based on SPIN (aka. SPARQL CONSTRUCT)
|-- sparql2sparql2sql  → SPARQL to SPARQL to SQL rewriting, composing sparql2sparql and sparql2sql
|-- sparql2sql         → SPARQL to SQL rewriting, targetting the Direct Mapping of a Relational Database
|-- sparql2sqlendpoint → a SPARQL endpoint to access the Direct Mapping of a Relational Database

== how to generate a standalone JAR ==

You can easily generate a standalone JAR file embedding all you need: the Direct Mapping, a SPARQL endpoint, Jetty, MySQL driver, PostgreSQL driver, etc. You only need Java 1.6 and SBT.

$ sbt "project sparql2sqlendpointjar" proguard

You can then directly execute the JAR:

$ java -jar sparql2sqlendpointjar/target/scala_2.8.0/sparql2sqlendpointjar_2.8.0-1.0.minara

TODO
* propose a JAR ready to be downloaded
* propose a way to override the default DB values

== how to geek with FeDeRate? ==

* you only need Java 1.6
* download and install sbt http://code.google.com/p/simple-build-tool/
* sbt update test

TODO
* explain how to develop with Jetty and automatic reload
* explain how to modify the default values