Druga wersja interpretatora

Author: koder95

src/main/java/pl/koder95/interpreter/Client.java

@@ -2,11 +2,11 @@
 
 /**
  * Interfejs klienta, który rozpoczyna tworzenie instancji {@link Interpreter interpretera} zależnego od podanego kontekstu.
- * @param <I> typ {@link Interpreter interpretera} zwracanego przez klienta
  * @param <C> typ {@link Context kontekstu}, jaki obsługiwany jest przez interpreter
  * @param <R> typ obiektu zwracanego przez interpreter
+ * @param <I> typ {@link Interpreter interpretera} zwracanego przez klienta
  */
-public interface Client<I extends Interpreter<C, R>, C extends Context, R> {
+public interface Client<C extends Context, R, I extends Interpreter<C, R>> {
 
     /**
      * Tworzy nową instancję {@link Interpreter interpretera}.

src/main/java/pl/koder95/interpreter/Expression.java

@@ -1,6 +1,6 @@
 package pl.koder95.interpreter;
 
-public sealed interface Expression<C extends Context, R> permits TerminalExpression, NonTerminalExpression {
+public sealed interface Expression permits TerminalExpression, NonTerminalExpression {
 
-    R interpret(C context);
+    String asString();
 }

src/main/java/pl/koder95/interpreter/Interpreter.java

@@ -1,13 +1,34 @@
 package pl.koder95.interpreter;
 
+/**
+ * Interfejs dostarcza metody do zbudowania drzewa abstrakcyjnej syntaktyki (AST) i interpretowania tej syntaktyki.
+ *
+ * @param <C> typ {@link Context kontekstu}
+ * @param <R> typ obiektu zwracanego przez interpreter
+ */
 public interface Interpreter<C extends Context, R> {
 
+    /**
+     * @return kontekst używany podczas interpretacji wyrażeń terminalnych
+     */
     C getContext();
 
-    Expression<C,R> buildAbstractSyntaxTree(String expression);
+    /**
+     * Buduje drzewo abstrakcyjnej syntaktyki.
+     * @param expression wyrażenie
+     * @return wyrażenie terminalne najwyższego poziomu
+     */
+    TerminalExpression<C,R> buildAbstractSyntaxTree(String expression);
 
+    /**
+     * Dokonuje interpretacji danych wejściowych korzystając z {@link Context kontekstu}. Dane najpierw są tokenizowane
+     * i zamieniane na {@link NonTerminalExpression wyrażenia nieterminalne}, aby zbudować z nich drzewo abstrakcyjnej
+     * syntaktyki (AST).
+     *
+     * @return wynik interpretacji
+     */
     default R interpret(String expression) {
-        Expression<C, R> ast = buildAbstractSyntaxTree(expression);
+        TerminalExpression<C, R> ast = buildAbstractSyntaxTree(expression);
         return ast.interpret(getContext());
     }
 }

src/main/java/pl/koder95/interpreter/NonTerminalExpression.java

@@ -1,8 +1,12 @@
 package pl.koder95.interpreter;
 
-public non-sealed interface NonTerminalExpression<C extends Context, R> extends Expression<C, R> {
+import java.util.Objects;
+
+public non-sealed interface NonTerminalExpression<T> extends Expression {
+    T getObject();
+
     @Override
-    default R interpret(C context) {
-        throw new UnsupportedOperationException();
+    default String asString() {
+        return Objects.toString(getObject());
     }
 }

src/main/java/pl/koder95/interpreter/TerminalExpression.java

@@ -1,4 +1,5 @@
 package pl.koder95.interpreter;
 
-public non-sealed interface TerminalExpression<C extends Context, R> extends Expression<C, R> {
+public non-sealed interface TerminalExpression<C extends Context, R> extends Expression {
+    R interpret(C context);
 }