commit addbf64bdd7b1e38527258e86d48aeee63f786c5
Author: zlohbierdcul <82916072+zlohbierdcul@users.noreply.github.com>
Date: Tue Dec 20 10:32:34 2022 +0100
initial commit
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..b72ba61
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,6 @@
+# IntelliJ
+*.iml
+.idea
+
+# build folders
+out/
diff --git a/resources/roboter.pdf b/resources/roboter.pdf
new file mode 100644
index 0000000..dd85d84
Binary files /dev/null and b/resources/roboter.pdf differ
diff --git a/src/Main.java b/src/Main.java
new file mode 100644
index 0000000..3e59c38
--- /dev/null
+++ b/src/Main.java
@@ -0,0 +1,5 @@
+public class Main {
+ public static void main(String[] args) {
+ System.out.println("Hello world!");
+ }
+}
\ No newline at end of file
diff --git a/src/tpe/exceptions/roboter/Robot.java b/src/tpe/exceptions/roboter/Robot.java
new file mode 100644
index 0000000..5358b2b
--- /dev/null
+++ b/src/tpe/exceptions/roboter/Robot.java
@@ -0,0 +1,11 @@
+/* (c) 2012 Thomas Smits */
+package tpe.exceptions.roboter;
+
+/**
+ * Interface für Roboter.
+ *
+ * @author Thomas Smits
+ */
+public interface Robot extends RobotControl, RobotInstructions {
+ // keine eigenen Methoden
+}
diff --git a/src/tpe/exceptions/roboter/RobotControl.java b/src/tpe/exceptions/roboter/RobotControl.java
new file mode 100644
index 0000000..ae70012
--- /dev/null
+++ b/src/tpe/exceptions/roboter/RobotControl.java
@@ -0,0 +1,74 @@
+package tpe.exceptions.roboter;
+
+import tpe.exceptions.roboter.exceptions.RobotException;
+
+/**
+ * Das Interface repräsentiert einen einfachen Roboter mit seinen Funktionen.
+ *
+ * Jeder produzierte Roboter hat einen Namen, der vom Besteller frei gewählt
+ * werden kann. Der Name bleibt über die gesamte Lebensdauer des Roboters
+ * unveränderlich. Man kann einen Roboter jederzeit über die
+ * getName()
-Methode nach seinem Namen fragen.
+ *
+ * Zusätzlich zum frei gewählten Namen, hat jeder Roboter noch eine
+ * Seriennummer. Diese wird bei der Produktion festgelegt und hat einen vom
+ * Roboter-Typ abhängigen Bereich möglicher Werte. Innerhalb des Bereiches wird
+ * die Seriennummer zufällig vergeben. Die Seriennummer kann auch bei
+ * ausgeschalteten Roboter über getId()
gelesen werden.
+ *
+ * Ein Roboter hat einen Hauptschalter, der mithilfe der
+ * triggerPowerSwitch()
-Methode bedient werden kann. Direkt nach
+ * der Produktion ist der Roboter ausgeschaltet. Drückt man einmal auf den
+ * Schalter, wird er eingeschaltet. Ein weiterer Druck schaltet ihn wieder aus, usw.
+ *
+ * Die aktuelle Position des Hauptschalters kann man mit der Methode
+ * isPowerOn()
abfragen. Hierbei bedeutet true
, dass
+ * der Roboter eingeschaltet ist und false
, dass er nicht
+ * eingeschaltet ist.
+ *
+ * Falls ein Fehler auftritt, kann der Nutzer des Roboters den letzten
+ * aufgetretenen Fehler über eine Blackbox (Fehlerspeicher) auslesen. Dies
+ * geschieht mithilfe der getLastException()
-Methode. Der
+ * Fehlerspeicher kann auch bei ausgeschaltetem Roboter benutzt werden. Gab es
+ * noch keinen Fehler, ist der Fehlerspeicher leer (null
).
+ *
+ * Alle Methoden dieses Interfaces können auch auf einem Roboter aufgerufen
+ * werden, der ausgeschaltet ist (d.h. wenn isPowerOn()
== false).
+ */
+public interface RobotControl {
+
+ /**
+ * Gibt die ID (Seriennummer) des Roboters zurück.
+ *
+ * @return Eine eindeutige Identifikation in Form einer Zahl.
+ */
+ public int getId();
+
+ /**
+ * Gibt den Namen des Roboter-Exemplars zurück.
+ *
+ * @return Der Name des Roboters.
+ */
+ public String getName();
+
+ /**
+ * Betätigen den An-/Ausschaltknopf.
+ */
+ public void triggerPowerSwitch();
+
+ /**
+ * Prüft ob der Roboter eingeschaltet ist.
+ *
+ * @return true
bedeutet, dass der Roboter eingeschaltet ist,
+ * false
, dass er nicht eingeschaltet ist.
+ */
+ public boolean isPowerOn();
+
+ /**
+ * Ruft die zuletzt aufgetretene Ausnahme aus der Blackbox ab.
+ *
+ * @return zuletzt aufgetretene Ausnahme oder null
falls noch
+ * keine aufgetreten ist.
+ */
+ public RobotException getLastException();
+}
diff --git a/src/tpe/exceptions/roboter/RobotInstructions.java b/src/tpe/exceptions/roboter/RobotInstructions.java
new file mode 100644
index 0000000..9426eb9
--- /dev/null
+++ b/src/tpe/exceptions/roboter/RobotInstructions.java
@@ -0,0 +1,49 @@
+package tpe.exceptions.roboter;
+
+import tpe.exceptions.roboter.exceptions.RobotException;
+import tpe.exceptions.roboter.exceptions.RobotIllegalStateException;
+import tpe.exceptions.roboter.exceptions.RobotMagicValueException;
+
+/**
+ * Das Interface repräsentiert den Befehlssatz eines einfachen Roboters.
+ *
+ * Jeder Roboter kann zwei grundlegende Operationen durchführen: das Umwandeln
+ * einer Menge von Zahlen in einen String (speak(...)
) und das
+ * sortieren eines Arrays von Zahlen (think(...)
). Wie genau das
+ * Sortieren oder die Umwandlung erfolgt, hängt vom jeweiligen Typ des Roboters ab.
+ *
+ * Zu beachten ist, dass die Methoden dieses Interfaces nur auf Robotern benutzt
+ * werden können, die eingeschaltet sind. Versucht man sie auf einem
+ * ausgeschalteten Roboter zu benutzen, werfen sie eine {@link RobotIllegalStateException}.
+ *
+ * Weiterhin haben alle Roboter einen kleinen technischen Defekt, der dazu führt
+ * dass die Methoden dieses Interfaces abstürzen, wenn in den Eingabedaten ein
+ * spezieller Wert vorkommt. Immer wenn (speak(...)
) oder (
+ * think(...)
) mit einem Array aufgerufen werden, das irgendwo die
+ * Zahl {@literal 42} enthält, verweigern sie ihren Dienst und werfen eine
+ * {@link RobotMagicValueException}.
+ */
+public interface RobotInstructions {
+
+ /**
+ * Gibt ein Array von Zahlen als String zurück. Die Zahlen werden
+ * nicht sortiert.
+ *
+ * @param zahlen Zahlen, die ausgegeben werden sollen.
+ * @return Zahlen als String
+ * @throws RobotException wenn der Roboter in einem ungültigen Zustand ist,
+ * oder das Array nicht seinen Vorstellungen entspricht.
+ */
+ public String speak(int[] zahlen) throws RobotException;
+
+ /**
+ * Sortiert ein Array von Zahlen. Die Reihenfolge hängt von dem Typ des
+ * Roboters ab.
+ *
+ * @param zahlen Zahlen, die sortiert werden sollen.
+ * @return Sortierte Zahlen
+ * @throws RobotException wenn der Roboter in einem ungültigen Zustand ist,
+ * oder das Array nicht seinen Vorstellungen entspricht.
+ */
+ public int[] think(int[] zahlen) throws RobotException;
+}
diff --git a/src/tpe/exceptions/roboter/exceptions/RobotException.java b/src/tpe/exceptions/roboter/exceptions/RobotException.java
new file mode 100644
index 0000000..b2f26b0
--- /dev/null
+++ b/src/tpe/exceptions/roboter/exceptions/RobotException.java
@@ -0,0 +1,4 @@
+package tpe.exceptions.roboter.exceptions;
+
+public class RobotException extends Throwable {
+}
diff --git a/src/tpe/exceptions/roboter/exceptions/RobotIllegalStateException.java b/src/tpe/exceptions/roboter/exceptions/RobotIllegalStateException.java
new file mode 100644
index 0000000..8c58beb
--- /dev/null
+++ b/src/tpe/exceptions/roboter/exceptions/RobotIllegalStateException.java
@@ -0,0 +1,4 @@
+package tpe.exceptions.roboter.exceptions;
+
+public class RobotIllegalStateException extends Throwable {
+}
diff --git a/src/tpe/exceptions/roboter/exceptions/RobotMagicValueException.java b/src/tpe/exceptions/roboter/exceptions/RobotMagicValueException.java
new file mode 100644
index 0000000..5f68000
--- /dev/null
+++ b/src/tpe/exceptions/roboter/exceptions/RobotMagicValueException.java
@@ -0,0 +1,4 @@
+package tpe.exceptions.roboter.exceptions;
+
+public class RobotMagicValueException extends Throwable {
+}