Java - L'API InMemorySQL

Pour manipuler des objets Java avec des requêtes SQL

L'API Stream en Java 8 ou l'API Linq en C# permettent de manipuler des collections d'objets en s'inspirant du langage SQL, mais ces concepts, bien que très puissants imitent le SQL sans forcément supporter l'ensemble de son potentiel.

Imaginez que vous ayez un ensemble de collection à manipuler : utiliser des fonctions d'agrégat (COUNT(), MIN(), MAX(), SUM(), AVG()), réaliser des jointures externes (LEFT/RIGHT/FULL) etc... Y arriverez-vous de manière aisée avec l'API Stream ou Linq ? Ne préféreriez-vous pas simplement réaliser cela à partir d'une simple requête SQL ?

L'API InMemorySQL a été créée afin de simplifier ce type de manipulation avancée, sans ré-inventer le SQL mais en le ré-utilisant, vos collections représentent tout simplement des tables (avec des alias t1, t2, tn etc) sur lesquels vous pourrez effectuer un ensemble d'opérations SQL puis en retirer une nouvelle collection d'objet.

Voici un exemple d'utilisation :
import fr.ekinci.dbmsreplication.inmemorysql.InMemorySQL;
//...

String sqlRequest = "SELECT t1.id_d1 AS id_d1, t1.attr2 AS attr2, t1.attr3 AS attr3, t2.id_d2 AS id_d2, t2.attr4 AS attr4, t3.id_d3 AS id_d3, t3.attr5 AS attr5 " +
" FROM t1" +
" LEFT JOIN t2" +
" ON t1.id_d1 = t2.id_d1" +
" LEFT JOIN t3" +
" ON t2.id_d2 = t3.id_d3" +
" ORDER BY t1.id_d1, t2.id_d2, t3.id_d3";

List ldb1 = new ArrayList<>(); // remplir
Set ldb2 = new HashSet<>(); // remplir
Collection ldb3 = new ArrayList<>(); // remplir

List result = new InMemorySQL()
.add(Dumb1.class, ldb1) // ldb1 aura pour alias t1
.add(Dumb2.class, ldb2) // ldb2 aura pour alias t2
.add(Dumb3.class, ldb3) // ldb3 aura pour alias t3
.executeQuery(ReturnDumb.class, sqlRequest);

N'hésitez pas à importer le projet grâce à Maven (ou autres outils de gestion de dépendances) :

com.github.gokan-ekinci
dbms-replication
1.0



L'API InMemorySQL vous permet :

• D'utiliser les fonctionnalités SQL standard de votre choix (COUNT(), MIN(), MAX(), SUM(), AVG(), INNER JOIN, LEFT/RIGHT JOIN etc). InMemorySQL utilise l'implémentation HSQLDB/HyperSQL.
  
• D'utiliser des placeholders, la méthode executeQuery() possède la signature suivante : executeQuery(yourReturnType : Class, sqlQuery : String, placeholders : Object...)
  
• D'utiliser des classes sans aucune contrainte particulière. Il n'y a pas de configuration, interface, annotation ou classe à utiliser sur les classes que vous manipulez.
  

• Cette API utilise vos attributs (pas vos getters), l'API retrouve les attributs de votre instance ainsi que ceux des super classes dont votre instance hérite.
  
  
• Vos collections/listes auront automatiquement pour alias t1, t2, tn, tn+1 (par ordre d'ajout).
  
  
• Vos classes (les classes DumbN dans l'exemple du dessus) auront un minimum de contrainte :
  
  
• Manipuler uniquement les champs de type primitif/Wrapper (sauf char/Character), et String.
  
• Utiliser le type java.sql.Timestamp pour les champs de type date.