Generierte Dokumentation der praktischen Arbeit von Simon Tiffert

main.eingabe.Eingabe Klassenreferenz

Zusammengehörigkeiten von main.eingabe.Eingabe:

[Legende]Aufstellung aller Elemente

---

Ausführliche Beschreibung

Diese Klasse liest die Eingabedaten aus einer Datei aus und erstellt die Matrix, die für die spätere Verarbeitung gebraucht wird.

Version:

Revision

1.23

Autor:

Simon Tiffert

Definiert in Zeile 42 der Datei Eingabe.java.

Öffentliche Methoden
	Eingabe (Matrix matrix, String dateiName) throws UnexpectedCharacterException, UnexpectedLineException, UnknownCharacterException, TooFewCharactersException, TooFewSperrfelderException, FileNotFoundException, IOException, IsSperrfeldException, IsStartpunktException, WrongDimensionException
	Konstruktor, welcher die Matrix übernimmt, die Datei zuweist und mit diesen Daten die Funktion leseDaten() aufruft.
Private Methoden
void	leseDaten (Reader stream) throws UnexpectedCharacterException, UnexpectedLineException, UnknownCharacterException, IOException, TooFewCharactersException, TooFewSperrfelderException, IsSperrfeldException, IsStartpunktException, WrongDimensionException
	Diese Funktion liest die Eingabedatei aus.
Private Attribute
Matrix	matrix
	Feld für Matrix.

---

Beschreibung der Konstruktoren und Destruktoren

main.eingabe.Eingabe.Eingabe (  Matrix  matrix, String  dateiName )  throws UnexpectedCharacterException, UnexpectedLineException, UnknownCharacterException, TooFewCharactersException, TooFewSperrfelderException, FileNotFoundException, IOException, IsSperrfeldException, IsStartpunktException, WrongDimensionException

Konstruktor, welcher die Matrix übernimmt, die Datei zuweist und mit diesen Daten die Funktion leseDaten() aufruft. Parameter: matrix  Zentrale Datenstruktur mit Matrix dateiName  Name der Eingabedatei Ausnahmebehandlung: UnexpectedCharacterException  Unerwartetes Zeichen UnexpectedLineException  Unerwartete Zeile UnknownCharacterException  Unbekanntes Zeichen TooFewCharactersException  Zuwenig Zeichen angegeben TooFewSperrfelderException  Zuwenig Sperrfelder angegeben FileNotFoundException  Datei wurde nicht gefunden IOException  Fehler bei der Eingabe IsSperrfeldException  Doppeldefinition von Sperrfeld IsStartpunktException  Sperrfeld auf Startfeld definiert WrongDimensionException  Falsche Dimensionsangaben Definiert in Zeile 64 der Datei Eingabe.java. Benutzt main.eingabe.Eingabe.leseDaten(). { // Weise übergebene Parameter den Variablen zu this.matrix = matrix; File file = new File(dateiName); // Rufe Funktion zur Abarbeitung auf leseDaten(new FileReader(file)); }

Hier ist der Graph aller Aufrufe für diese Funktion:

---

Dokumentation der Elementfunktionen

void main.eingabe.Eingabe.leseDaten (  Reader  stream  )  throws UnexpectedCharacterException, UnexpectedLineException, UnknownCharacterException, IOException, TooFewCharactersException, TooFewSperrfelderException, IsSperrfeldException, IsStartpunktException, WrongDimensionException [private]

Diese Funktion liest die Eingabedatei aus. Außerdem findet hier ein Teil der Syntaxüberprüfung statt, welche die Eingabedaten auf Korrektheit überprüft. Parameter: stream  Reader auf Eingabedatei Ausnahmebehandlung: UnexpectedCharacterException  Unerwartetes Zeichen UnexpectedLineException  Unerwartete Zeile UnknownCharacterException  Unbekanntes Zeichen TooFewCharactersException  Zuwenig Zeichen angegeben TooFewSperrfelderException  Zuwenig Sperrfelder angegeben FileNotFoundException  Datei wurde nicht gefunden IOException  Fehler bei der Eingabe IsSperrfeldException  Doppeldefinition von Sperrfeld IsStartpunktException  Sperrfeld auf Startfeld definiert WrongDimensionException  Falsche Dimensionsangaben Definiert in Zeile 102 der Datei Eingabe.java. Wird benutzt von main.eingabe.Eingabe.Eingabe(). { // Aktuell gelesene Zeile String zeile = ""; // Anzahl gesperrter Felder int gesperrteFelder = 0; // Koordinaten des aktuellen Punktes int y = 0, x = 0; // Lies die Datei zeilenweise und speichere dabei die // aktuelle Zeilennummer LineNumberReader lineNumber = new MyLineNumberReader(stream, "**"); // StringTokenizer, der einen String in Token aufteilt StringTokenizer st; // Lies die erste Zeile aus der Eingabedatei und verarbeite sie if ((zeile = lineNumber.readLine()) != null) { st = new StringTokenizer(zeile); } // Wenn dies nicht klappt, ist die Datei leer und eine Exception // wird geworfen else { throw new TooFewCharactersException( "" + lineNumber.getLineNumber()); } // Lies die Zahlen, fange ab, wenn dabei Probleme auftauchen try { // Lies die Dimensionsangaben y = Integer.parseInt(st.nextToken()); x = Integer.parseInt(st.nextToken()); } catch (NoSuchElementException e) { throw new TooFewCharactersException( "" + lineNumber.getLineNumber()); } catch (Exception e) { throw new UnknownCharacterException( "" + lineNumber.getLineNumber()); } // Erstelle die Matrix in der Dimension y*x matrix.setMatrix(y, x); // Wenn noch weitere Zeichen in der Zeile sind, werfe Fehler if (st.hasMoreTokens()) { throw new UnexpectedCharacterException( "" + lineNumber.getLineNumber()); } // Lese die zweite Zeile für den Startpunkt // wenn keine Eingabedaten da sind, werfe Exception if ((zeile = lineNumber.readLine()) != null) { st = new StringTokenizer(zeile); } else { throw new TooFewCharactersException( "" + lineNumber.getLineNumber()); } // Lies die Zahlen, fange ab, wenn dabei Probleme auftauchen try { // Lies Koordinaten des Startpunktes y = Integer.parseInt(st.nextToken()) - 1; x = Integer.parseInt(st.nextToken()) - 1; } catch (NoSuchElementException e) { throw new TooFewCharactersException( "" + lineNumber.getLineNumber()); } catch (Exception e) { throw new UnknownCharacterException( "" + lineNumber.getLineNumber()); } // Setze den Startpunkt für die Sprungfolge matrix.setStartpunkt(y, x); // Wenn noch weitere Zeichen in der Zeile sind, werfe Fehler if (st.hasMoreTokens()) { throw new UnexpectedCharacterException( "" + lineNumber.getLineNumber()); } // Lies Anzahl gesperrter Felder ein (optional) if ((zeile = lineNumber.readLine()) != null) { // Lies die Zahl, fange ab, wenn dabei Probleme auftauchen try { gesperrteFelder = Integer.parseInt(zeile); } catch (Exception e) { throw new UnknownCharacterException( "" + lineNumber.getLineNumber()); } // Besetze gesperrte Felder der Matrix mit '-1' for (int i = 0; i < gesperrteFelder; i++) { if ((zeile = lineNumber.readLine()) != null) { st = new StringTokenizer(zeile); // Lies die Zahlen, fange ab, wenn dabei Probleme auftauchen try { // Lies Koordinaten, setze den Punkt in der Matrix y = Integer.parseInt(st.nextToken()) - 1; x = Integer.parseInt(st.nextToken()) - 1; } catch (NoSuchElementException e) { throw new TooFewCharactersException( "" + lineNumber.getLineNumber()); } catch (Exception e) { throw new UnknownCharacterException( "" + lineNumber.getLineNumber()); } // Wenn noch weitere Zeichen in der Zeile sind, werfe Fehler if (st.hasMoreTokens()) { throw new UnexpectedCharacterException( "" + lineNumber.getLineNumber()); } // Setze das ermittelte Sperrfeld matrix.setSperrfeld(y, x); } else { throw new TooFewSperrfelderException(); } } } // Wenn noch weitere Zeichen am Ende der Datei sind, werfe Fehler if (lineNumber.readLine() != null) { throw new UnexpectedLineException( "" + lineNumber.getLineNumber()); } }

---

Dokumentation der Datenelemente

Matrix main.eingabe.Eingabe.matrix [private]

Feld für Matrix. Definiert in Zeile 45 der Datei Eingabe.java.

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

• Eingabe.java

Documentation created with Doxygen 1.3.6	Fri May 14 11:15:39 2004