ANTLR
Einführung in ANTLR v3

Installation und Einrichtung

So installieren Sie ANTLR in Eclipse

(Zuletzt getestet mit Indigo und ANTLR IDE 2.1.2)

1. Installieren Sie Eclipse.
2. Laden Sie den ANTLR-Binärdatenträger herunter , der ANTLR v2 enthält. Extrahieren Sie in ein temporäres Verzeichnis. Kopieren Sie den antlr-nn-Ordner an einen geeigneten dauerhaften Speicherort, z. B. den Ordner, in dem Eclipse installiert ist.
3. Fügen Sie Eclipse eine ANTLR IDE-Aktualisierungssite hinzu.
   • Klicken Sie in Eclipse auf Hilfe und wählen Sie Neue Software installieren.
   • Klicken Sie auf die Schaltfläche Hinzufügen.
   • Geben Sie im Fenster Repository hinzufügen für Standort http://antlrv3ide.sourceforge.net/updates ein, und geben Sie ANTLR IDE für den Namen ein. Klicken Sie auf OK, um zum Fenster Available Software zurückzukehren.
   • Aktivieren Sie das Kontrollkästchen für ANTLR IDE vn.nn und klicken Sie auf, bis es installiert ist. Eclipse wird wahrscheinlich neu starten.
4. Konfigurieren Sie die ANTLR-IDE.
   • Klicken Sie im Eclipse-Hauptfenster auf Fenster und dann auf Einstellungen.
   • Erweitern Sie im linken Bereich ANTLR, und wählen Sie Generator aus.
   • Klicken Sie im rechten Fensterbereich auf die Schaltfläche Hinzufügen.
   • Klicken Sie im Fenster ANTLR-Paket hinzufügen auf Verzeichnis…, navigieren Sie zum Speicherort des Ordners antlr-nn und klicken Sie auf OK.
   • Klicken Sie auf OK, um das Fenster ANTLR-Paket hinzufügen zu schließen.
   • Wählen Sie im linken Bereich Code Generator aus, und klicken Sie im rechten Bereich auf relativen Ordner "Projekt". Geben Sie einen Ordnernamen ein. Beispiele: antlr-java oder antlr-generiert.
   • Wählen Sie andere Konfigurationsparameter aus, überprüfen Sie jedoch NICHT -nfa oder –dfa unter Allgemein im Gebäudefenster. Wenn diese Option aktiviert ist, werden ANTLR-Fehler verursacht, die die Generierung von Java-Dateien im Ausgabeordner verhindern.
   • Klicken Sie auf OK, um das Fenster "Einstellungen" zu schließen.
5. Erstellen Sie ein neues Java-Projekt und aktivieren Sie die ANTLR-Unterstützung.
   • Gehen Sie im Eclipse-Hauptfenster zu Datei, Neu, Java-Projekt. Klicken Sie auf Weiter, geben Sie einen Projektnamen ein und klicken Sie auf Fertig stellen.
   • Um die ANTLR-Unterstützung für das Projekt zu aktivieren, klicken Sie im Paket-Explorer-Fenster (linker Bereich) mit der rechten Maustaste auf das soeben erstellte Projekt und wählen Sie Konfigurieren, In ANTLR-Projekt konvertieren.
   • Fügen Sie dem Projekt die ANTLR complete-JAR-Datei hinzu: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie Eigenschaften, Java-Erstellungspfad, klicken Sie auf Externe JARs hinzufügen…, navigieren Sie zur ANTLR-JAR-Datei, wählen Sie sie aus und klicken Sie auf OK. Klicken Sie auf OK, um das Eigenschaftenfenster des Projekts zu schließen.
6. Erstellen Sie eine ANTLR-Grammatik.
   • Erstellen Sie eine neue ANTLR-Grammatik: Klicken Sie mit der rechten Maustaste auf den Ordner src des Projekts, dann auf Datei, Neu, Andere, erweitern Sie ANTLR, und wählen Sie Kombinierte Grammatik aus. Klicken Sie auf Weiter, geben Sie den Namen der Grammatik ein, wählen Sie eine Option für die Sprache aus und klicken Sie auf Fertig stellen.
   • Eine ".g" -Datei wird mit den ausgewählten Optionen und einer leeren Regel erstellt. Fügen Sie oben die Anweisungen options = Java, @header, @lexer :: header und @members hinzu (siehe Beispiel). Die automatische Vervollständigung ist die einfachste Möglichkeit, diese hinzuzufügen (drücken Sie die STRG-Leertaste, um die Liste der automatischen Vervollständigungen aufzurufen).
7. Speichern Sie die Grammatik.
   • Beim Speichern sollte ein Ordner mit generiertem Java-Code für die Grammatik im Projekt-Explorer angezeigt werden. Wenn dies nicht der Fall ist, stellen Sie sicher, dass die Optionen -nfa oder -dfa in den ANTLR-Einstellungen unter Allgemein im Gebäudefenster nicht aktiviert sind (Schritt 4g). [Überprüfen Sie, ob diese erforderlich sind: Markieren Sie die CLASSPATH-Umgebungsvariable, die auf Java7 zeigt, das Ihrer Eclipse-Installation (32 oder 64 Bit) entspricht, und die Windows Path-Umgebungsvariable hatte Java7 SDK.]
   • Um zu vermeiden, dass Java-Fehler nicht in einen Typ aufgelöst werden können, klicken Sie mit der rechten Maustaste auf den Ordner, der den generierten Java-Code enthält. Klicken Sie dann auf Build Path (Pfad erstellen) und Als Quellordner verwenden.

BEISPIEL KOMBINIERTE GRAMMARBEIT

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';