ANTLR
TestRig / grun

Setup TestRig

ANTLR zawiera narzędzie testujące w swojej bibliotece wykonawczej, narzędzie to może być używane do wyświetlania informacji opisujących, w jaki sposób parsowanie jest wykonywane w celu dopasowania danych wejściowych do zdefiniowanych reguł w pliku gramatyki.

Aby skorzystać z tego narzędzia zawartego w pliku jar ANTLR, należy skonfigurować ścieżkę klas systemu, aby umożliwić dostęp zarówno do narzędzia ANTLR, jak i biblioteki wykonawczej:

export CLASSPATH=".:/usr/local/lib/antlr-4.5.3-complete.jar:$CLASSPATH"

Uwaga: Upewnij się, że kropka poprzedza dowolną ścieżkę, aby maszyna wirtualna Java nie widziała klas w bieżącym katalogu roboczym.

Aliasów można używać w systemach Linux / MAC / Unix, aby uprościć używane polecenia:

alias antlr4='java -jar /usr/local/lib/antlr-4.5.3-complete.jar' 
//or any directory where your jar is located

Uwaga: konfiguracja aliasów i ścieżki klas w systemie Windows może być bardziej skomplikowana, zobacz tutaj, aby uzyskać bardziej szczegółowe informacje.

Dostęp do TestRig

Po skonfigurowaniu aliasu możesz skonfigurować TestRig w następujący sposób, ponownie zaleca się użycie aliasu, ponieważ zmniejsza on czas wymagany do wykonania akcji:

alias grun='java org.antlr.v4.runtime.misc.TestRig'

Jeśli nie chcesz konfigurować aliasu w systemie Windows, możesz uzyskać dostęp do TestRig, uruchamiając następujące polecenie w tej samej lokalizacji, co katalog jar ANTLR:

java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.runtime.misc.TestRig
//or
java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig

Aby uruchomić TestRig na gramatyce, możesz przekazać parametry gramatyki w następujący sposób:

grun yourGrammar yourRule -tree //using the setup alias
java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig yourGrammar YourRule -tree //on windows with no alias
java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig yourGrammar Hello r -tree
//Windows with the grammar Hello.g4 starting from the rule 'r'.

Buduj gramatykę za pomocą wizualnego drzewa analizy

Określenie opcji wiersza polecenia -gui podczas uruchamiania gramatyki ANTLR na platformie testowej spowoduje wyświetlenie okna z wizualną reprezentacją parsowanego drzewa. Na przykład:

Biorąc pod uwagę następującą gramatykę:

JSON.g4

/** Taken from "The Definitive ANTLR 4 Reference" by Terence Parr */

// Derived from http://json.org
grammar JSON;

json
   : value
   ;

object
   : '{' pair (',' pair)* '}'
   | '{' '}'
   ;

pair
   : STRING ':' value
   ;

array
   : '[' value (',' value)* ']'
   | '[' ']'
   ;

value
   : STRING
   | NUMBER
   | object
   | array
   | 'true'
   | 'false'
   | 'null'
   ;


STRING
   : '"' (ESC | ~ ["\\])* '"'
   ;
fragment ESC
   : '\\' (["\\/bfnrt] | UNICODE)
   ;
fragment UNICODE
   : 'u' HEX HEX HEX HEX
   ;
fragment HEX
   : [0-9a-fA-F]
   ;
NUMBER
   : '-'? INT '.' [0-9] + EXP? | '-'? INT EXP | '-'? INT
   ;
fragment INT
   : '0' | [1-9] [0-9]*
   ;
// no leading zeros
fragment EXP
   : [Ee] [+\-]? INT
   ;
// \- since - means "range" inside [...]
WS
   : [ \t\n\r] + -> skip
   ;

Biorąc pod uwagę następujący plik JSON:

przyklad.json

{
  "name": "John Doe",
  "age": 25,
  "address": {
    "streetAddress": "21 2nd Street",
    "city": "New York",
    "state": "NY",
    "postalCode": "10021-3100"
  },
  "phoneNumbers": [
    {
      "type": "home",
      "number": "212 555-1234"
    },
    {
      "type": "mobile",
      "number": "123 456-7890"
    }
  ],
  "children": [],
  "spouse": null
}

Następująca składnia wiersza poleceń:

export CLASSPATH=".:/usr/local/lib/antlr-4.0-complete.jar:$CLASSPATH"                                                                                      
alias antlr4='java -jar /usr/local/lib/antlr-4.0-complete.jar'                                                                                             
alias grun='java org.antlr.v4.runtime.misc.TestRig'

antlr4 -o . -lib . -no-listener -no-visitor  JSON.g4; javac *.java; grun JSON json -gui example.json

spowoduje wygenerowanie plików .java i .tokens , a także skompilowanych plików .class :

JSON.g4                        JSONLexer.class                JSONListener.java JSONParser$PairContext.class   JSON.tokens                    JSONLexer.java JSONParser$ArrayContext.class  JSONParser$ValueContext.class  JSONBaseListener.class JSONLexer.tokens               JSONParser$JsonContext.class   JSONParser.class
JSONBaseListener.java          JSONListener.class
JSONParser$ObjectContext.class JSONParser.java

oraz następujące drzewo analizy: