README

DB2Triples - RDB2RDF Antidot implementation
LGPL Licence 2.1
https://github.com/antidot/db2triples
http://www.antidot.net

References : W3C Working Drafts 29 May 2012
- R2RML: RDB to RDF Mapping Language (http://www.w3.org/TR/2012/WD-r2rml-20120529/)
- A Direct Mapping of Relational Data to RDF (http://www.w3.org/TR/2012/WD-rdb-direct-mapping-20120529/)


Using the library when building a Maven project
===============================================

db2triples is available on Maven Central Repository. Update your Maven "pom.xml":
<dependency>
  <groupId>net.antidot</groupId>
  <artifactId>db2triples</artifactId>
</dependency>

Using the jar file directly
===========================

** Getting the jar **
 
All the jars of all versions can be found on the Maven Central Repository:
http://search.maven.org/#search|ga|1|db2triples
 
** Needed dependency **

OpenRdf Sesame > 2.6.x - http://www.openrdf.org/
Commons-cli > 1.2 - http://commons.apache.org/cli/
Commons-logging > 1.1.1 - http://commons.apache.org/logging/

** Tested JDBC connectors **

MySQL Connector > 5.1.15 - http://www.mysql.com/downloads/connector/j/ 
PostgreSQL Connector > 9.1-901 - http://jdbc.postgresql.org/

** Command line **

According your classpath has the links to all the preceding jars and the 
"db2triples-<version number>.jar", you can launch the lib as follow :

- To call Db2triples :
net.antidot.semantic.rdf.rdb2rdf.main.Db2triples

Building your own jar
=====================

To build DB2Triples jar, you need to use Maven (http://maven.apache.org/)
which will provide to you all the necessary package to compile. The classical
way is the command:

mvn package

This will provide a file "db2triples-<version number>.jar" in the "target"
directory according to default configuration of Maven.


Execute the jar
===============

You can also compile and execute directly the jar from Maven build.
This operation requires to copy dependencies into working folder.

Use following commands :

mvn dependency:copy-dependencies

java -cp target/dependency/*.jar:target/db2triples-<version number>.jar <main function>


Contacts
========

opensource@antidot.net