Treebolic

SQL to XML translator

Le traducteur Treebolic SQL vers XML est un outil qui sert à générer des fichiers XML à partir de données issue d'une base de données.

La syntaxe de la ligne de commande est :

Linux

java -classpath Sql2Xml.jar:Treebolic.jar[:<pilote>] treebolic.in.provider.sql.sql2xml.Sql2XmlTranslator <dossier> <base> [<sqlpropertyfile>]

Windows

java -classpath Sql2Xml.jar;Treebolic.jar[;<pilote>] treebolic.in.provider.sql.sql2xml.Sql2XmlTranslator <dossier> <base> [<fichier-paramètres>]

où

<pilote>

est l'archive Java du pilote JDBC, par exemple mysql-connector-java-3.0.7-stable-bin.jar
Noter que le pont JDBC:ODBC est intégré au JRE depuis la version 1.4.

<dossier>

est le dossier de sortie des fichiers XML

<base>

est le nom de base des fichiers. Les fichiers XML files seront de la forme <base>-<docID>.xml. Par exemple, pour <base> = out, les fichiers seront out-1.xml, out-2.xml, si les IDs de documents sont 1, 2 ...

<fichier-paramètres>

désigne un fichiers de propriété qui décrit un ensemble de documents. Par défaut c'est Sql2XmlTranslator.properties dans le dossier courant.

Par exemple:

java -classpath Sql2Xml.jar;Treebolic.jar treebolic.in.provider.sql.sql2xml.Sql2XmlTranslator . out ODBC.Sql2XmlTranslator.properties

java -classpath Sql2Xml.jar:Treebolic.jar:mysql-connector-java-3.0.7-stable-bin.jar treebolic.in.provider.sql.sql2xml.Sql2XmlTranslator . out mySQL.Sql2XmlTranslator.properties

Le fichier <fichier-paramètres> contient les informations suivantes :

driver=

est la classe dans l'archive Java du pilote qui fait office de pilote pour les librairies JDBC

url=

est l'URL  JDBC pour la base de données (peut inclure le serveur et son port). Noter que ':' doivent être échappés.

user=

est l'identification de l'utilisateur qui interroge la base.

passwd=

est le mot de passe de l'utilisateur

docs_sql=

est la requête SQL qui décrit un ensemble de documents. Voir les informations attendues dans cet ensemble de documents résultat ci-dessous.

Par exemple (mySQL):

#TREEBOLIC-SQL
#Sat Jun 21 17:31:34 CEST 2003

driver=org.gjt.mm.mysql.Driver
url=jdbc\:mysql\://localhost\:3306/animaldom
user=sqlquerier
passwd=sqlquerier

docs_sql=SELECT * FROM Documents;

Par exemple (ODBC):

#TREEBOLIC-SQL
#Sat Jun 21 17:31:34 CEST 2003

#TREEBOLIC_sql
#Sat Jun 21 17:31:34 CEST 2003

driver=sun.jdbc.odbc.JdbcOdbcDriver
url=jdbc\:odbc\:animaldom
user=
passwd=

docs_sql=SELECT * FROM Documents;

L' ensemble de documents résultat (Document ResultSet) doit avoir les champs/colonnes suivants :

id_document

obligatoire

un ID de document utilisé pour suffixer les fichiers XML produits.

nodes_sql

obligatoire

une requête SQL qui décrit l'ensemble des noeuds du document.

edges_sql

obligatoire

une requête SQL qui décrit l'ensemble des arcs du document.

settings_sql

obligatoire

une requête SQL qui décrit l'ensemble des paramètres du document (si plusieurs ensembles sont sélectionnés, seulement le premier sera retenu)

id_field

obligatoire

le nom du champ qui vaut pour l'ID des noeuds Treebolic

path_field

obligatoire

le nom du champ qui vaut pour le chemin (path) des noeuds Treebolic

label_field

obligatoire

le nom du champ qui vaut pour l'étiquette (label) des noeuds Treebolic

from_field

obligatoire

le nom du champ qui vaut pour l'ID du noeud source des arcs Treebolic

to_field

obligatoire

le nom du champ qui vaut pour l'ID du noeud destination source des arcs Treebolic

Les trois requêtes SQL déterminent

Voir les constraintes sur et la sémantique des ensembles-résultats (ResultSets).