Pierwsza wersja interpretera

Author: koder95

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

@@ -0,0 +1,17 @@
+package pl.koder95.interpreter;
+
+/**
+ * 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
+ */
+public interface Client<I extends Interpreter<C, R>, C extends Context, R> {
+
+    /**
+     * Tworzy nową instancję {@link Interpreter interpretera}.
+     * @param context {@link Context kontekst} obsługiwany przez utworzony interpreter
+     * @return nowa instancja {@link Interpreter interpretera}
+     */
+    I newInterpreter(C context);
+}

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

@@ -0,0 +1,10 @@
+package pl.koder95.interpreter;
+
+/**
+ * Interfejs kontekstu, w jakim interpretowane będą wyrażenia.
+ * Języki formalne mogą mieć gramatykę niekontekstową lub kontekstową. Z tego powodu ten interfejs nie posiada żadnych
+ * metod do implementacji i idealnie nadaje się do zastosowania w gramatykach bezkontekstowych w aktualnej formie.
+ * Rozszerzenie interfejsu z dodaniem własnych metod umożliwi wykorzystanie go w gramatykach kontekstowych.
+ */
+public interface Context {
+}

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

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

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

@@ -0,0 +1,13 @@
+package pl.koder95.interpreter;
+
+public interface Interpreter<C extends Context, R> {
+
+    C getContext();
+
+    Expression<C,R> buildAbstractSyntaxTree(String expression);
+
+    default R interpret(String expression) {
+        Expression<C, R> ast = buildAbstractSyntaxTree(expression);
+        return ast.interpret(getContext());
+    }
+}

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

@@ -0,0 +1,8 @@
+package pl.koder95.interpreter;
+
+public non-sealed interface NonTerminalExpression<C extends Context, R> extends Expression<C, R> {
+    @Override
+    default R interpret(C context) {
+        throw new UnsupportedOperationException();
+    }
+}

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

@@ -0,0 +1,22 @@
+package pl.koder95.interpreter;
+
+/**
+ * Wyjątek wyrzucany w przypadku błędów syntaktycznych podczas działania interpretera.
+ */
+public class SyntaxException extends IllegalArgumentException {
+
+    public SyntaxException() {
+    }
+
+    public SyntaxException(String message) {
+        super(message);
+    }
+
+    public SyntaxException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    public SyntaxException(Throwable cause) {
+        super(cause);
+    }
+}

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

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