Interpreter vereinfacht (d2864f20) · Commits · ERZ / SWE_de.bsvrz.sys.funclib.bitctrl

subprojects/de.bsvrz.sys.funclib.bitctrl/src/main/java/de/bsvrz/sys/funclib/bitctrl/interpreter/AbstractHandler.java

deleted100644 → 0

+0 −42

Original line number	Diff line number	Diff line
		/*
		* BitCtrl-Funktionsbibliothek
		* Copyright (C) 2015 BitCtrl Systems GmbH
		*
		* This library is free software; you can redistribute it and/or modify it under
		* the terms of the GNU Lesser General Public License as published by the Free
		* Software Foundation; either version 2.1 of the License, or (at your option)
		* any later version.
		*
		* This library is distributed in the hope that it will be useful, but WITHOUT
		* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
		* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
		* details.
		*
		* You should have received a copy of the GNU Lesser General Public License
		* along with this library; if not, write to the Free Software Foundation, Inc.,
		* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
		*
		* Contact Information:
		* BitCtrl Systems GmbH
		* Weißenfelser Straße 67
		* 04229 Leipzig
		* Phone: +49 341-490670
		* mailto: info@bitctrl.de
		*/

		package de.bsvrz.sys.funclib.bitctrl.interpreter;

		import java.util.Arrays;
		import java.util.List;

		/**
		* Abstrakte Implementierung eines Handlers zur Ausführung von Operationen.
		* Die Klasse implementiert einige Funktionen der Schnittstelle Handler um die
		* Implementierung konkreter Handler-Klassen zu erleichtern.
		*
		* @author BitCtrl Systems GmbH, Peuker, Schumann
		* @deprecated Defaultimplementierung und statische Methoden nach {@link Handler} verschoben.
		*/
		@Deprecated
		public abstract class AbstractHandler implements Handler {
		}

subprojects/de.bsvrz.sys.funclib.bitctrl/src/main/java/de/bsvrz/sys/funclib/bitctrl/interpreter/Ausdruck.java

+15 −46

Original line number	Diff line number	Diff line
		@@ -26,9 +26,7 @@

		package de.bsvrz.sys.funclib.bitctrl.interpreter;

		import java.util.HashSet;
		import java.util.List;
		import java.util.Set;
		import java.util.*;

		/**
		* Basisklasse aller Symbole des Interpeters.
		@@ -37,14 +35,6 @@ import java.util.Set;
		*/
		public interface Ausdruck<T> {

		/**
		* Behelfsklasse, um ein paar nützliche statische Methoden im Interface
		* unterzubringen.
		*
		* @author BitCtrl Systems GmbH, Schumann
		*/
		final class Info {

		/**
		* Bestimmt Rekursiv die Menge der Termsymbole im Ausdruck, die
		* Variablen darstellen.
		@@ -53,48 +43,27 @@ public interface Ausdruck<T> {
		* Ein beliebiger Ausdruck
		* @return Menge der Variablennamen
		*/
		public static Set<String> getVariablen(final Ausdruck<?> ausdruck) {
		// TODO Als statische Methode von Ausdruck umformulieren

		Set<String> variablen;

		variablen = new HashSet<>();
		static Set<String> getVariablen(final Ausdruck<?> ausdruck) {
		Set<String> variablen = new HashSet<>();
		if (ausdruck instanceof Variable) {
		// Wir sind an einem Termsymbol angekommen, was Variable ist
		variablen.add(((Variable) ausdruck).getName());
		} else if (ausdruck.getNachfolger() != null) {
		// Ausdruck ist kein Terminalsymbol
		} else {
		for (final Ausdruck<?> a : ausdruck.getNachfolger()) {
		// Rekursion
		variablen.addAll(getVariablen(a));
		}
		}

		return variablen;
		}

		/**
		* Konstruktor.
		*/
		private Info() {
		// privater Standardkonstruktor, wird nie verwendet
		}
		}

		/**
		* Gibt eine Liste der verschachtelten Ausdrücke zurück.
		* <p>
		* <em>Hinweis:</em> Terminalsymbole liefern keine leere Liste sondern
		* {@code null} zurück. Eine leere Liste ist demnach ein Hinweis auf
		* einen unvollständigen Syntaxbaum.
		*
		* @return Liste der Ausdrücke <em>direkt</em> unter diesen Ausdruck.
		* Die Methode arbeiten im Gegensatz zu {@link #interpret(Kontext)}
		* nicht rekursiv.
		*/
		default List<? extends Ausdruck<?>> getNachfolger() {
		// TODO Literal#getNachfolger() sollte nicht null, sondern leere Liste für Terminalsymbole zurüchgeben, damit es sich neutral verhält!
		return null;
		return Collections.emptyList();
		}

		/**

subprojects/de.bsvrz.sys.funclib.bitctrl/src/main/java/de/bsvrz/sys/funclib/bitctrl/interpreter/Handler.java

+8 −10

Original line number	Diff line number	Diff line
		@@ -33,11 +33,11 @@ import java.util.*;
		* implementieren. Statt jeder Operation eine eigene Klasse zu geben, werden mit
		* Hilfe des Musters <em>Besucher</em> alle Operationen in einer Klasse
		* gebündelt. Neue Operationen können durch implementieren dieser
		* Schnittstelle definiert werden. Siehe auch {@link AbstractHandler}
		* Schnittstelle definiert werden. Siehe auch {@link Handler}
		*
		* @author BitCtrl Systems GmbH, Schumann
		*/
		public interface Handler {
		public abstract class Handler {

		/**
		* Liefert den n-ten Operanden aus einer Liste von Operanden.<br>
		@@ -50,7 +50,7 @@ public interface Handler {
		* Der Index des gesuchten Operanden
		* @return Den Operand oder {@code null}
		*/
		static Object getOperand(List<?> operanden, int index) {
		public static Object getOperand(List<?> operanden, int index) {
		Object ergebnis = null;

		if ((operanden != null) && (operanden.size() > index)) {
		@@ -65,7 +65,7 @@ public interface Handler {
		*
		* @return Liste von Operatoren
		*/
		Operator[] getHandledOperators();
		public abstract Operator[] getHandledOperators();

		/**
		* Führt eine Operation mit der Liste der Operanden aus. Die Liste der
		@@ -77,7 +77,7 @@ public interface Handler {
		* Liste der Operanden
		* @return Wert der Operation, abhängig von Operator und Operanden
		*/
		Object perform(Operator operator, List<?> operanden);
		public abstract Object perform(Operator operator, List<?> operanden);

		/**
		* Führt eine Operation mit dem Operanden aus.
		@@ -88,7 +88,7 @@ public interface Handler {
		* Operandenliste
		* @return Wert der Operation, abhängig von Operator und Operand
		*/
		default Object perform(Operator operator, Object... operanden) {
		public Object perform(Operator operator, Object... operanden) {
		return perform(operator, Arrays.asList(operanden));
		}

		@@ -102,9 +102,7 @@ public interface Handler {
		* Liste von Operanden
		* @return das Ergebnis der Überprüfung
		*/
		HandlerValidation validiereHandler(Operator operator, List<?> operanden);

		// TODO Methode validierehandler() sollte nicht public sein, weil sie fehlschlägt bei verschachtelten Ausdrücken: UND(true, ODER(true, false); UND hat nicht zwei Booleans als Operanden
		protected abstract HandlerValidation validiereHandler(Operator operator, List<?> operanden);

		/**
		* Prüft ob der Handler die angegebene Operation auf dem Operanden
		@@ -116,7 +114,7 @@ public interface Handler {
		* Operandenliste
		* @return das Ergebnis der Überprüfung
		*/
		default HandlerValidation validiereHandler(Operator operator, Object... operanden) {
		protected HandlerValidation validiereHandler(Operator operator, Object... operanden) {
		return validiereHandler(operator, Arrays.asList(operanden));
		}

subprojects/de.bsvrz.sys.funclib.bitctrl/src/main/java/de/bsvrz/sys/funclib/bitctrl/interpreter/Literal.java

+1 −13

Original line number	Diff line number	Diff line
		@@ -32,21 +32,9 @@ package de.bsvrz.sys.funclib.bitctrl.interpreter;
		* der Typsicherheit innerhalb der Softwareeinheit.
		*
		* @author BitCtrl Systems GmbH, Uwe Peuker
		* @deprecated Das Interface hat keinen Wert und wird auch nicht verwendet.
		*/
		@Deprecated
		public interface Literal<T> extends Ausdruck<T> {

		/**
		* Gibt den Wert des Literals zurück.
		*
		* @return Der Wert
		* @deprecated Die Methode ist logisch identisch mit {@link #interpret(Kontext)}. Sie wird nie
		* verwendet und ist immer <code>return interpret(null);</code> implementiert.
		*/
		@Deprecated
		default T getWert() {
		return interpret(null);
		}
		// tagging interface

		}

subprojects/de.bsvrz.sys.funclib.bitctrl/src/main/java/de/bsvrz/sys/funclib/bitctrl/interpreter/Variable.java

+1 −0

Original line number	Diff line number	Diff line
		@@ -43,4 +43,5 @@ public interface Variable<T> extends Ausdruck<T> {
		* @return den Name
		*/
		String getName();

		}