Site de référence : www.kobject.net
KObject est un produit Open source sous licence GNU LGPL, disponible sur la forge logicielle sourceforge.net.

Principales fonctionnalités :

• Mapping relationnel/Objet
• Mise en place de MVC2 pour J2ee

• Base de données
• Librairie Kolibrary-1.0.0.23f-beta1
• Fichier de configuration config.ko

• Documentation KObject

Vous disposez de :

• Eclipse Juno J2EE
• Kobject-library1.0.0.23f-beta1
• Mysql Server
• Driver JDBC pour Mysql

Nous allons travailler à partir d'un cas simple, et assez couramment utilisé :

• Un SI composé de produits, classés en catégories (1 CIF).
• Des commandes de produits effectuées, dont le détail est stocké dans des lignes (1 CIM).

Mise en place la configuration logicielle.

• Créer un nouveau Dynamic Web Project dans Eclipse
• Intégrer le jar de Kobject et le driver JDBC pour mysql dans le dossier WebContent/WEB-INF/lib
• Copier le fichier de configuration de Kobject (config.ko) à la racine du projet.
• copier le fichier de configuration d'ehCache ehCache.xml dans le dossier src

• Créer la base de données ormK sur votre serveur Mysql en exécutant le script de création (la base est créée dans le script).

Afficher le concepteur pour visualiser les tables, et les relations : Pour chaque table, notez les contraintes d'intégrité :

1. d'entité (clé primaire)
2. référentielle (relations)

Exemple :

Produit :

• id (primary key)
• idCategorie (foreign key references categorie.id)

Placer le fichier de configuration de KObject à la racine du projet, et ouvrez le :

Vérifiez les paramètres de connexion à Mysql.

config.ko

base=ormK
classes=
controlClass=
cssFile=WebContent/css/css.properties
dbOptions=
dbType=mysql
debug=SQL
erFile=WebContent/conf/validation/er.properties
footerURL=WEB-INF/footer.jsp
headerURL=WEB-INF/header.jsp
host=127.0.0.1
koDateFormat=dd/MM/yyyy
mappingFile=WebContent/conf/mox.xml
messagesFile=WebContent/conf/validation/messages.properties
nullValue= 
package=metier
password=
port=3306
sqlDateFormat=yyyy-MM-dd
useSetters=false
user=root
validationFile=WebContent/conf/kox.xml
webApp=false
useCache=false
cacheType=1

Modèle relationnel :

Modèle Objet (diagramme de classes) correspondant :

Nous allons modifier le modèle Objet pour le rendre compatible avec KObject et permettre le mapping, en ajoutant les membres qui serviront de clés étrangères (habituellement inutiles dans le monde Objet) :

La persistance des données est mise en place par Héritage et introspection. Les classes métier doivent hériter de la classe KObject.

Ci-dessous le début de l'implémentation des classes :

Les principes de construction des classes métiers à mapper avec KObject sont les suivants :

• A chaque champ de la base correspond un membre de données de la classe
• les types de données java et sql doivent être compatibles (consulter la documentation KObject pour voir la correspondance entre les types)
• La classe doit être un java Bean pour permettre à KObject de travailler :
  • elle doit disposer d'un constructeur sans paramètre initialisant le membre keyFields définissant les champs présents dans la clé primaire
  • Chacun de ses membres doit disposer d'accesseurs

Observation du chargement d'un objet, par l'intermédiaire de sa clé primaire.

Interrogation de données avec KObject :

Remplacez la boucle d'affichage des produits par :

	System.out.println(categories.showWithMask("{libelle}:\n{produits}\n"));

Remplacer le lien belongsTo sur la classe Produit par :

belongsTo(KCategorie.class).setLazy(true);

Exécutez à nouveau le programme.