Tutoriel pour construire un écosystème Eclipse de développement Java d'applications sémantiques avec Jena

• 1 - Dans la fenêtre de la classe BonjourDeJena, entrez le code suivant :

package tutorieljena;

import com.hp.hpl.jena.rdf.model.Model;

public class BonjourDeJena {

    public static void main(String[] args) {
        Model monModele = ModelFactory.createDefaultModel();
    }
}

Notez les indicateurs en rouge. Ils servent à informer le développeur des erreurs constatées par l'IDE. Dans l'exemple plus bas, le message qui apparaît en passant la souris au-dessus de Model, indique que le type n'est pas valide. Cette erreur provient de la non-intégration des bibliothèques de Jena à l'IDE.

L'ajout des bibliothèques de Jena est réalisé par les préférences de l'IDE. Voici les étapes de l'ajout des bibliothèques de Jena.

• 1 - Exécutez la commande Fenêtre -> Preferences.
• 2 - Dans le dialogue Préférences, choisissez : Java + Chemin de Compilation + Bibliothèque utilisateur ; puis cliques sur Nouveau…

• 3 - Entrez le nom BibJena ; puis cliquez OK

• 4 - Ajouter les fichiers Jar de Jena en cliquant sur Ajout des fichiers JAR externes.
• 5 - Naviguer jusqu'au répertoire lib de Jena (C:\Jena\apache-jena-2.12.1\lib).
• 6 - Sélectionnez l'ensemble des fichiers jar ; puis cliquez Ouvrir

• 7 - Aperçu

Pour chaque fichier Jar, il est possible d'y associer le code source correspondant.

• 1 - Défilez la barre déroulante et localisez le fichier jena-core-2.12.1.jar.
• 2 - Sélectionnez Connexion de la source ; puis cliquez Modifier

• 3 - Sélectionnez External Location ; puis cliquez Fichier externe.
• 4 - Dans le répertoire C:\Jena\apache-jena-2.12.1\lib-src sélectionnez le fichier jena-core-2.12.1-sources.jar ; puis cliquez Ouvrir…

• 5 - Refaire la même opération pour les fichiers : jena-arq-2.12.1-sources.jar, jena-iri-1.1.1-sources.jar, jena-sdb-1.5.1-sources.jar, jena-tdb-1.1.1-sources.jar.
• 6 - Aperçu; puis cliquez OK

• 1 - De retour à l'édition du projet.
• 2 - Avec le bouton de droite de la souris, sélectionnez le projet TutorielJena.
• 3 - Choisir l'élément de menu Chemin de génération->Ajouter des bibliothèques

• 4 - Choisir Bibliothèque utilisateur; puis Suivant

• 5 - Sélectionnez BibJena ; puis Terminer

• 6 - Aperçu

Après l'ajout de BibJena, le projet a été recompilé par Eclipse. Cependant, une erreur est toujours identifiée à la classe ModelFactory. Cette erreur est corrigée par la procédure qui suit.

En déplaçant le curseur au-dessus de l'erreur, l'IDE présente une fenêtre de dialogue contextuel qui propose quelques solutions de correction. Parmi les propositions, le correctif importer ModelFactory (com.hp.hpl.jena.rdf.model) est présenté.

• 1 - Choisissez le correctif importer ModelFactory (com.hp.hpl.jena.rdf.model).

La ligne import com.hp.hpl.jena.rdf.model.ModelFactory est automatiquement ajoutée et les erreurs sont corrigées.

Dans l'éditeur, complétez le code suivant :

package tutorieljena;

import com.hp.hpl.jena.rdf.model.Model;
import com.hp.hpl.jena.rdf.model.ModelFactory;
import com.hp.hpl.jena.rdf.model.Property;
import com.hp.hpl.jena.rdf.model.Resource;

public class BonjourDeJena {
  public static void main(String[] args) {
    Model monModele = ModelFactory.createDefaultModel();
    // Créer une ressource MESSAGE
    Resource message = monModele.createResource("http://webtutoriel/message");
    // Créer une propriété VALEUR
    Property valeurProp = monModele.createProperty("http://webtutoriel/valeur");
    // Assigner une valeur à la ressource
    message.addProperty(valeurProp, "Bonjour à tous");
    // Imprimer le contenu du modèle dans la syntaxe TTL 
    monModele.write( System.out , "TTL");
  }
}

Après avoir créé le modèle monModele, le programme appelle la création de la ressource message et de la propriété valeurProp. Par la suite, le programme associe la valeur " Bonjour à tous " à la ressource message. Le programme se termine par l'impression du modèle en format Turtle TTL à la console.

En cliquant le bouton () , le programme BonjourDeJena est exécuté et le résultat est présenté dans la vue Console.

• 1 - Sélectionnez WebContent avec le bouton droit de la souris.
• 2 - Sélectionnez Nouveau -> Fichier

• 3 - Dans le nom du fichier, entrez bonjour.ttl ; puis cliquez Terminer

• 4 - Dans la fenêtre de texte, entrez le code suivant :

<http://webtutoriel/message> <http://webtutoriel/valeur> "Bonjour le monde" .

Puis fermez le fichier bonjour.ttl

Cette étape permet d'indiquer le projet à publier par serveur web.

• 1 - Exécutez la commande Fichier -> Nouveau -> Autres.
• 2 - Dans l'assistant sélectionnez Serveur + Serveur puis cliquez Suivant

• 3 - Sélectionnez Aperçu HTTP ; puis Suivant

• 4 - Dans Nouveau Serveur Sélectionnez WebTutoriel ; cliquez Ajouter ; puis Terminer

• 5 - Aperçu

Dans la vue Serveurs, il est constaté que le serveur @localhost est prêt à diffuser le contenu de WebTutoriel.

• 6 - Cliquez sur le bouton ( ) en triangle vert pour démarrer le serveur :

  • à l'état [Démarré, Synchronisé] le graphe est en état de diffusion sur le serveur ;
  • le bouton ( ) permet d'arrêter le serveur ;
  • après le départ, le message suivant apparaît à la console :
    « Le graphe est publié à l'adresse http://localhost:8080/WebTutoriel/bonjour.ttl ».

Pour coder le programme de lecture du graphe à partir du web, réalisez les étapes suivantes :

• 1 - Sélectionnez avec le bouton droit de la souris, le paquetage Java tutorieljena.
• 2 - Exécutez Nouveau -> Classe

• 3 - Dans l'assistant Nouvelle classe Java, entrez le nom BonjourDeJenaWeb, puis Terminer.
• 4 - Entrez le code suivant dans l'éditeur de classe

package tutorieljena;

import com.hp.hpl.jena.rdf.model.Model;
import com.hp.hpl.jena.rdf.model.ModelFactory;
import com.hp.hpl.jena.rdf.model.Property;
import com.hp.hpl.jena.rdf.model.Resource;

public class BonjourDeJenaWeb {
  public static void main(String[] args) {
    // Créer mon modèle
    Model monModele = ModelFactory.createDefaultModel();
    // Lire le contenu du fichier bonjour.ttl à partir du web et
    // mettre le contenu dans monModel
    monModele.read( "http://localhost:8080/WebTutoriel/bonjour.ttl");
    // Obtenir la ressource "message"
    Resource message = monModele.getResource("http://webtutoriel/message");
    // Obtenir la propriété "valeurProp"
    Property valeurProp = monModele.getProperty("http://webtutoriel/valeur");
    // Obtenir la valeur associée au message 
    String valeur = message.getProperty(valeurProp).getString();
    // Présenter la valeur associée au message
    System.out.println("La valeur du message est: " + valeur.toString());
    // Présenter le contenu de monModele en format RDF/XML
    monModele.write( System.out , "RDF/XML");
  }
}

En prévision d'exécuter le programme, il est nécessaire de s'assurer que le serveur HTTP soit à l'état : [Démarré, Synchronisé]

Réalisez les étapes suivantes pour exécuter la classe BonjourDeJenaWeb :

• 1 - Avec le bouton de droite de la souris, Cliquez la classe BonjourDeJenaWeb.java ;
• 2 - Sélectionnez Exécuter en tant que -> Application Java

• 3 - Observez le résultat : Le message Bonjour le monde, contenu dans le fichier ainsi que le contenu de monModele sont présentés dans la Console

En tant qu'exercice de validation, il est proposé de réaliser les étapes suivantes :

• 1 - Dans le fichier bonjour.ttl, remplacez la valeur du message par commentaire de votre choix ;
• 2 - Sauvez le fichier ;
• 3 - Attendez la disponibilité du serveur ;
• 4 - Exécutez la classe BonjourDeJenaWeb.java ;
• 5 - Observez si le message apparaît correctement à la Console.