Usunięcie Scanner jako pośrednika w odczytywaniu

Delete ScannerFactory.java

Author: koder95

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

@@ -18,11 +18,6 @@ public interface Interpreter<C extends Context, R> {
      */
     Parser<C, R> getParser();
 
-    /**
-     * @return fabryka {@link java.util.Scanner skanerów}, które standardowo pomagają w przetwarzaniu danych wejściowych
-     */
-    ScannerFactory getScannerFactory();
-
     /**
      * 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
@@ -39,8 +34,7 @@ default R interpret(Readable readable) {
         Parser<C, R> parser = getParser();
         if (parser == null) throw new IllegalStateException("Cannot use readable when parser is null", new NullPointerException());
         Tokenizer tokenizer = parser.getTokenizer();
-        ScannerFactory factory = getScannerFactory();
-        if (tokenizer != null && factory != null) tokenizer.useScanner(factory.create(readable));
+        if (tokenizer != null) tokenizer.setSource(readable);
         else throw new IllegalStateException("Cannot use readable when tokenizer or scanner factory are null", new NullPointerException());
         TerminalExpression<C, R> ast = parser.buildAbstractSyntaxTree();
         return ast.interpret(getContext());

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

@@ -1,40 +1,37 @@
 package pl.koder95.interpreter;
 
 import java.util.Queue;
-import java.util.Scanner;
 import java.util.concurrent.LinkedBlockingQueue;
 
 /**
  * Definiuje sposób podziału danych wejściowych na tokeny.
- * Standardowo korzysta ze {@link Scanner skanera}, aby dzielić i analizować ciąg odczytywanych wartości.
- * Nic nie stoi na przeszkodzie, aby użyć innego sposobu. Wystarczy oprócz implementacji metody {@link #next()}
- * nadpisać metodę {@link #hasNext()}.
+ * Korzysta ze {@link Readable źródła znaków}, aby dostarczać ciąg odczytywanych znaków.
  */
 public abstract class Tokenizer {
 
-    private Scanner scanner;
+    private Readable source;
 
     /**
-     * Tworzy nową instancję tokenizera ustawiając skaner na wartość {@code null}.
-     * Dla poprawnego funkcjonowania należy wywołać metodę {@link #useScanner(Scanner)}.
+     * Tworzy nową instancję tokenizera ustawiając źródło znaków na wartość {@code null}.
+     * Dla poprawnego funkcjonowania należy wywołać metodę {@link #setSource(Readable)}.
      */
     public Tokenizer() {
-        this.scanner = null;
+        this.source = null;
     }
 
     /**
-     * @param scanner skaner używany podczas procesu tokenizacji danych wejściowych
+     * @param source źródło znaków wczytywanych podczas procesu tokenizacji
      */
-    public void useScanner(Scanner scanner) {
-        this.scanner = scanner;
+    public void setSource(Readable source) {
+        this.source = source;
     }
 
     /**
      * Metoda używana podczas procesu tworzenia tokenów w metodzie {@link #next()}.
-     * @return zwraca aktualnie ustawiony skaner
+     * @return zwraca aktualnie ustawione źródło
      */
-    protected final Scanner getScanner() {
-        return scanner;
+    protected final Readable getSource() {
+        return source;
     }
 
     /**
@@ -61,9 +58,7 @@ public Queue<NonTerminalExpression<?>> enqueue() {
      * Sprawdza, czy istnieje możliwość pobrania następnego tokenu.
      * @return {@code true} – jeśli istnieje następny token, {@code false} w przeciwnym razie
      */
-    public boolean hasNext() {
-        return scanner != null && scanner.hasNext();
-    }
+    public abstract boolean hasNext();
 
     /**
      * Przetwarza dane wejściowe i zwraca je w postaci {@link NonTerminalExpression wyrażenia nieterminalnego},

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

@@ -14,9 +14,8 @@
  * Interfejs {@link pl.koder95.interpreter.Interpreter} dostarcza nie tylko
  * {@link pl.koder95.interpreter.Interpreter#interpret(java.lang.Readable) metodę interpretującą odczytywane wartości},
  * ale również implementacje interfejsów {@link pl.koder95.interpreter.Parser parsera},
- * {@link pl.koder95.interpreter.Tokenizer tokenizera} oraz {@link pl.koder95.interpreter.ScannerFactory fabryki skanerów},
+ * oraz {@link pl.koder95.interpreter.Tokenizer tokenizera},
  * które wykorzystywane są podczas budowania drzewa abstrakcyjnej syntaktyki za pomocą metod
- * {@link pl.koder95.interpreter.ScannerFactory#create(java.lang.Readable) create(java.lang.Readable)},
  * {@link pl.koder95.interpreter.Parser#buildAbstractSyntaxTree(java.util.Queue) buildAbstractSyntaxTree(java.util.Queue)}
  * oraz {@link pl.koder95.interpreter.Tokenizer#enqueue() enqueue()}.
  * </p>
@@ -25,7 +24,6 @@
  * @see pl.koder95.interpreter.Expression
  * @see pl.koder95.interpreter.Interpreter
  * @see pl.koder95.interpreter.Parser
- * @see pl.koder95.interpreter.ScannerFactory
  * @see pl.koder95.interpreter.Tokenizer
  */
 package pl.koder95.interpreter;