ANTLR
Introduction à ANTLR v3

Installation et configuration

Comment installer ANTLR dans Eclipse

(Dernier test sur Indigo et ANTLR IDE 2.1.2)

1. Installez Eclipse.
2. Téléchargez le fichier binaire complet ANTLR qui inclut ANTLR v2. Extraire dans un répertoire temporaire. Copiez le dossier antlr-nn vers un emplacement permanent approprié, par exemple le même dossier dans lequel Eclipse est installé.
3. Ajoutez le site de mise à jour IDE ANTLR à Eclipse.
   • Dans Eclipse, cliquez sur Aide et sélectionnez Installer un nouveau logiciel.
   • Cliquez sur le bouton Ajouter….
   • Dans la fenêtre Ajouter un référentiel, pour Emplacement, tapez http://antlrv3ide.sourceforge.net/updates et tapez quelque chose comme ANTLR IDE pour le nom et cliquez sur OK pour revenir à la fenêtre Logiciels disponibles.
   • Cochez la case pour ANTLR IDE vn.nn et cliquez dessus jusqu'à ce qu'il soit installé. Eclipse va probablement redémarrer.
4. Configurez l'IDE ANTLR.
   • Dans la fenêtre principale d'Eclipse, cliquez sur Window puis sur Preferences.
   • Dans le volet gauche, développez ANTLR et sélectionnez Générateur.
   • Dans le volet de droite, cliquez sur le bouton Ajouter….
   • Dans la fenêtre Ajouter un package ANTLR, cliquez sur Répertoire… et accédez à l'emplacement du dossier antlr-nn, puis cliquez sur OK.
   • Cliquez sur OK pour fermer la fenêtre Ajouter un package ANTLR.
   • Sélectionnez Générateur de code dans le volet gauche et cliquez sur Dossier relatif au projet dans le volet droit. Tapez un nom de dossier. Exemples: antlr-java ou antlr généré.
   • Sélectionnez d'autres paramètres de configuration, mais NE vérifiez PAS –nfa ou –dfa dans la sous-fenêtre Général de la fenêtre Building. Si cette option est cochée, cela entraînera des erreurs ANTLR empêchant la génération de fichiers Java dans le dossier de sortie.
   • Cliquez sur OK pour fermer la fenêtre Préférences.
5. Créez un nouveau projet Java et activez le support ANTLR.
   • Dans la fenêtre principale d'Eclipse, accédez à Fichier, Nouveau, Projet Java. Cliquez sur Suivant, tapez un nom de projet et cliquez sur Terminer.
   • Pour activer le support ANTLR pour le projet, dans la fenêtre Explorateur de packages (volet gauche), cliquez avec le bouton droit sur le projet que vous venez de créer et sélectionnez Configurer, convertir en projet ANTLR.
   • Ajoutez le fichier JAR complet ANTLR au projet: cliquez avec le bouton droit sur le projet et sélectionnez Propriétés, Chemin de génération Java, cliquez sur Ajouter des fichiers JAR externes, accédez au fichier JAR ANTLR, sélectionnez-le et cliquez sur OK. Cliquez sur OK pour fermer la fenêtre Propriétés du projet.
6. Créez une grammaire ANTLR.
   • Créez une nouvelle grammaire ANTLR: cliquez avec le bouton droit sur le dossier src du projet, puis cliquez sur Fichier, Nouveau, Autre, développez ANTLR et sélectionnez Grammaire combinée. Cliquez sur Suivant, tapez nom de la grammaire, sélectionnez une option de langue et cliquez sur Terminer.
   • Un fichier «.g» est créé avec les options sélectionnées et une règle vide. Ajoutez les options language = Java, @header, @lexer :: header et @members en haut (voir exemple). L'achèvement automatique est le moyen le plus simple de les ajouter (appuyez sur CTRL-espace pour afficher la liste de saisie automatique).
7. Enregistrez la grammaire.
   • Une fois enregistré, un dossier contenant le code Java généré pour la grammaire doit apparaître dans l'explorateur de projet. Si ce n'est pas le cas, assurez-vous que les options –nfa ou –dfa ne sont pas cochées dans les préférences ANTLR sous Général dans la fenêtre du bâtiment (étape 4g). [Confirmez si nécessaire: vérifiez que la variable d'environnement CLASSPATH pointe vers Java7 correspondant à votre installation Eclipse (32 ou 64 bits) et que la variable d'environnement Windows Path était dotée du SDK Java7.]
   • Pour éviter les erreurs Java «ne peuvent pas être résolues en un type», cliquez avec le bouton droit sur le dossier contenant le code Java généré, puis créez un chemin, utilisez-le comme dossier source.

ÉCHANTILLON COMBINÉ GRAMMAIRE

grammar test; //must match filename.g

options {
    language = Java;
}

@header { //parser
    package pkgName; //optional
    import java.<whatever you need>.*;
}

@members { //parser
    // java code here
}

@lexer::header { //lexer
    package pkgName; //optional
    import java.<whatever you need>.*;
}

@lexer::members {
    // java code here
}
/*------------------------------------------------------------------
 * PARSER RULES (convention is all lowercase)
 *------------------------------------------------------------------*/
parserule: LEXRULE;

/*------------------------------------------------------------------
 * LEXER RULES (convention is all uppercase)
 *------------------------------------------------------------------*/
LEXRULE: 'a'..'z';