7.3Formatierte Textausgaben 
Um mit einem Writer oder OutputStream komfortabel Zeichenfolgen – zum Beispiel String-Repräsentationen primitiver Datentypen – zu erzeugen, ist eine Menge Schreibaufwand nötig, da ein einfacher Writer nur Zeichen bzw. Strings und ein simpler OutputStream sogar nur Bytes oder Byte-Folgen schreibt. Dieser Abschnitt stellt die beiden Klassen PrintWriter und PrintStream vor, die das Erzeugen textueller Ausgaben vereinfachen und das Ergebnis in einen Zielstrom oder in eine Datei schreiben.
7.3.1Die Klassen PrintWriter und PrintStream
Schon in den ersten Programmen haben wir ein PrintStream-Objekt verwendet – doch vermutlich, ohne es zu wissen. Es steckte im out-Attribut der Klasse System. Typisch für PrintStream und PrintWriter sind die vielen überladenen Methoden namens print(…), println(…), printf(…) und format(…), die unterschiedliche Datentypen annehmen und eine String-Repräsentation erzeugen. Anders als viele Stromklassen erzeugen die Klassen bei Schreibproblemen keine IOException, sondern setzen intern ein Flag, das durch die Methode checkError() nach außen kommt.
Abbildung 7.2UML-Diagramme der Klassen PrintStream und PrintWriter
[zB]Beispiel
Schreibe eine Zeichenkette und die String-Repräsentation des aktuellen Datums in eine Datei:
Listing 7.11com/tutego/insel/io/stream/WriteInFile.java, main()
StandardCharsets.ISO_8859_1.name() ) ) {
out.println( "Hallo Welt!" );
out.print( "Es ist " );
out.printf( "%tT Uhr.", new Date() );
}
catch ( FileNotFoundException | UnsupportedEncodingException e ) {
e.printStackTrace();
}
Obwohl die Methoden selbst keine Ausnahmen auslösen können, kann es doch dieser spezielle Konstruktor, der in eine Datei schreibt.
Konstruktoren
Die Konstruktoren von PrintStream und PrintWriter erwarten entweder ein Objekt vom Typ OutputStream, Writer (nur PrintWriter), File oder einen String für den Namen der Datei, in die die Ausgabe geschrieben wird. Mit den beiden zuletzt genannten Konstruktoren wird der PrintWriter/PrintStream nicht als Dekorator um einen existierenden Writer/Stream eingesetzt; es muss also kein FileWriter in den Konstruktor von PrintWriter bzw. kein FileOutputStream im Konstruktor von PrintStream gesetzt werden, um in eine Datei zu schreiben. Technisch gesehen ist ein PrintStream eine Unterklasse von FilterOutputStream (interessanterweise gilt das für die Klasse PrintWriter nicht, die eine direkte Unterklasse von Writer ist.)
extends Writer extends FilterOutputStream
implements Appendable, Closeable
PrintWriter(File file) throws FileNotFoundException
PrintStream(File file) throws FileNotFoundException
PrintWriter(String fileName)
PrintStream(String fileName)
PrintWriter(Writer out)
PrintWriter(OutputStream out)
PrintStream(OutputStream out)
Erzeugt einen neuen PrintWriter bzw. PrintStream, der in die angegebene Datei – die entweder durch den Dateinamen oder ein File-Objekt gegeben ist –, den Writer bzw. OutputStream schreibt. Bei einem Zeilenende wird nicht automatisch in den Puffer geschrieben.
Auto-Flush
Die Ausgabe in den PrintWriter und PrintStream ist so lange gepuffert, bis flush() ausgeführt wird. Das Verhalten lässt sich mit einem Schalter ändern, denn einige Konstruktoren nehmen optional ein »Auto-Flush« an, das bestimmt, ob die Daten bei einem println(…) oder einem printf(…) bzw. format(…) mit explizitem »%n« aus dem Puffer gespült werden. So schreibt println("Hallo") auf jeden Fall den String in den Datenstrom, wenn der Konstruktor mit autoFlush gleich true aufgerufen wurde, und es bleiben keine Daten im Puffer. Für den PrintStream gilt zusätzlich beim aktivierten Auto-Flush, dass bei jedem Byte »\n« in der Zeichenkette der Puffer geleert wird, also auch bei Zeichen, die über die write(…)-Methoden geschrieben werden.
extends Writer extends FilterOutputStream
implements Appendable, Closeable
PrintWriter(Writer out, boolean autoFlush)
PrintWriter(OutputStream out, boolean autoFlush)
PrintStream(OutputStream out, boolean autoFlush)
Erzeugt einen neuen PrintWriter bzw. PrintStream, der automatisch bei autoFlush gleich true auf ein »\n« im Strom achtet und im Puffer befindliche Daten wegschreibt.
Zeichenkodierung und Konvertierungen
Standardmäßig nutzt der PrintWriter die voreingestellte Zeichenkodierung der Plattform, um Unicodezeichen anzunehmen und sie als Byte weiterzureichen. Eine explizite Kodierung lässt sich angeben.
extends Writer extends FilterOutputStream
implements Appendable, Closeable
PrintWriter(File file, String csn)
throws FileNotFoundException, UnsupportedEncodingExceptionPrintStream(File file, String csn)
throws FileNotFoundException, UnsupportedEncodingExceptionPrintWriter(String fileName, String csn)
throws FileNotFoundException, UnsupportedEncodingExceptionPrintStream(String fileName, String csn)
throws FileNotFoundException, UnsupportedEncodingException
Erzeugt einen neuen PrintWriter zum Schreiben in Dateien mit den angegebenen Kodierungen.PrintStream(OutputStream out, boolean autoFlush, String encoding)
throws UnsupportedEncodingException
Erzeugt einen PrintStream mit gewünschter Pufferleerung und Zeichenkodierung.
[»]Hinweis
Die Zeichenkodierung sollte immer explizit angegeben werden!
Methodenübersicht
Als Methoden bieten PrintWriter und PrintStream im Wesentlichen das Gleiche: eine Reihe von print(…)-, println(…)-, format(…)-, printf(…)- sowie append(…)-Methoden aus Appendable.
extends Writer extends FilterOutputStream
implements Appendable, Closeable
void print(boolean b)
void print(char c)
void print(char[] s)
void print(double d)
void print(float f)
void print(int i)
void print(String s)
Schreibt boolean, ein einzelnes Zeichen, ein Array von Zeichen, Fließkommazahlen, Ganzzahlen oder einen String. Ist das char-Feld null, gibt es eine NullPointerException.void print(Object o)
Ruft o.toString() auf und gibt das Ergebnis aus, wenn o ungleich null ist. Sonst ist die Ausgabe null.void println()
Schreibt Zeilenvorschubzeichen.void println(boolean b)
void println(char c)
void println(char[] s)
void println(double d)
void println(float f)
void println(int i)
void println(String s)
Schreibt den Datentyp wie print(…) und schließt die Zeile mit einem Zeilenendezeichen ab.PrintWriter/PrintStream format(Locale l, String format, Object... args)
PrintWriter/PrintStream format(String format, Object... args)
PrintWriter/PrintStream printf(Locale l, String format, Object... args)
PrintWriter/PrintStream printf(String format, Object... args)
Gibt eine nach dem Formatierungs-String gegebene Zeichenfolge aus. Ist das Format null, folgt eine NullPointerException; bei inkorrektem Formatierungs-String folgt eine IllegalFormatException.PrintWriter/PrintStream append(char c)
PrintWriter/PrintStream append(CharSequence csq)
PrintWriter/PrintStream append(CharSequence csq, int start, int end)
Schreibt Zeichen, Felder von Zeichen oder einen String. Die append(…)-Methoden stammen aus der Schnittstelle Appendable.void close()
Schließt den Stream. Ist eine Methode aus Closeable.void flush()
Schreibt gepufferte Daten. Ist eine Methode aus Flushable.
Der PrintWriter und PrintStream implementieren als typischer Writer und OutputStream noch die write(…)-Methoden; einmal mit char und einmal mit byte.
Umgang im Fehlerfall
Keine der Methoden löst eine IOException aus (nur die Konstruktoren können eine FileNotFoundException, also eine IOException auslösen). Intern fangen der PrintWriter und PrintStream eine mögliche IOException ab und setzen ein internes Flag trouble, auf das der Programmablauf jedoch keinen weiteren Einfluss hat. (Daher musste auch die Methode write(String) neu deklariert werden, da die Methode write(String) der Writer-Klasse eine IOException auslöst.) Den Fehlerstatus erfragt checkError().
extends Writer extends FilterOutputStream
implements Appendable, Closeable
boolean checkError()
Schreibt mit flush() gepufferte Daten und testet, ob intern bei der Verarbeitung eine IOException (außer InterruptedIOException) aufgetreten ist oder manuell setError() aufgerufen wurde. Die Abfrage ist wichtig, da die Klasse keine Ein-/Ausgabe-Exception auslöst.protected void setError()
Setzt den Fehlerstatus auf true. Mit der protected-Methode können Unterklassen eines PrintWriter den Fehlerstatus setzen, den checkError() einbezieht.protected void clearError()
Löscht den internen Fehlerstatus.
7.3.2System.out, System.err und System.in
Beim Aufbau der System-Klasse erzeugt Java automatisch drei Stream-Objekte, die üblicherweise die Eingaben über die Tastatur und Ausgaben über den Bildschirm repräsentieren:
System.in ist das Standardeingabegerät. System.in ist ein Exemplar der Klasse InputStream (genauer gesagt vom Typ BufferedInputStream).
System.out und System.err stehen für das Standardausgabegerät für normale Ausgaben und Fehlerausgaben. Sie sind Exemplare von PrintStream.
[»]Hinweis
Wird ein Programm von der Konsole aus aufgerufen, so können mithilfe so genannter Umleitungen auch Datenströme von Dateien in das (und aus dem) Java-Programm gelenkt werden, sodass dann System.in und System.out/System.err automatisch Dateiströme sind und somit nicht mehr auf die Konsole gehen. Das kann etwa so aussehen:
static final InputStream in
Dies ist der Standardeingabestrom. Er ist immer geöffnet und nimmt die Benutzereingaben normalerweise über die Tastatur entgegen.static final PrintStream out
Der Standardausgabestrom. Er ist immer geöffnet und normalerweise mit der Bildschirmausgabe verbunden.static final PrintStream err
Der Standard-Fehlerausgabestrom. Er wurde eingeführt, um die Fehlermeldungen von den Ausgabemeldungen zu unterscheiden. Auch wenn der Ausgabekanal umgeleitet wird, bleiben diese Meldungen erreichbar.
[zB]Beispiel
In eigenen Projekten gibt es selten die Notwendigkeit für PrintStream, da die Bytes nicht in einer speziellen Kodierung geschrieben werden. Wir stützen uns auf die Klasse PrintWriter, die die abstrakte Klasse Writer erweitert. Das Attribut System.out bleibt weiterhin vom Typ PrintStream, und die Deklaration PrintWriter o = System.out ist falsch.
Wenn die Standardkodierung in Ordnung ist, kann PrintStream für Debug-Code auf die Konsole mittels System.out verwendet werden. Sonst ist PrintWriter eine bessere Wahl, da er auch nach System.out schreiben kann:
Schreibarbeit sparen *
Natürlich ist es Schreibarbeit, immer System.out.printXXX(…) angeben zu müssen, so wie in:
System.out.println( 1.234 );
System.out.println( "Die drei Fragezeichen sind toll." );
Eine Möglichkeit, das Ganze abzukürzen, besteht darin, das statische import zu nutzen. Doch auch mit einem Verweis können wir uns Arbeit sparen. Das funktioniert, da System.out ein Objekt vom Typ PrintStream ist:
o.println( "Neu!" );
o.println( "Jetzt noch weniger zu schreiben." );
o.println( "Hilft auch Gelenken wieder auf die Sprünge!" );
Ströme umlenken *
Die Ströme hinter System.out, System.err und System.in sind vom Laufzeitsystem vorbelegt und lassen sich ändern. Dazu deklariert die Klasse System drei statische Methoden:
static void setOut(PrintStream out)
static void setErr(PrintStream err)
Der Standardausgabekanal/Fehlerkanal wird auf den angegebenen PrintStream gesetzt.static void setIn(InputStream in)
Der Eingabestrom kann umgesetzt werden, um beispielsweise aus einer Datei oder Netzwerkverbindung Daten zu beziehen, die an in anliegen sollen.
[zB]Beispiel
Setze den Eingabestrom auf einen Latin-1-String mit drei Zeilen:
"1\n2\n3\n".getBytes(StandardCharsets.ISO_8859_1) ) );
Für Applikationen ist es nur möglich, über die drei genannten Methoden die Standardeingabe auf einen beliebigen InputStream und die Standardausgabe auf einen beliebigen PrintStream umzuleiten. Sehr erstaunlich in der System-Klasse ist die Tatsache, dass die Attribute in, out und err final sind und daher eigentlich nicht geändert werden können. Hier greift das JDK tief in die Trickkiste.
Den Bildschirm löschen und Textausgaben optisch aufwerten *
Die Java-Umgebung setzt keine spezielle grafische Architektur und kein spezielles Terminal voraus. Als systemunabhängige Programmiersprache bietet Java außer der einfachen Textausgabe keine Möglichkeit, die Farben für die Textzeichen zu ändern, den Cursor zu setzen oder den Bildschirm zu löschen.
Ein VT100-Terminal speichert neben dem Text auch Attribute, und es existieren unterschiedliche Kontrollsequenzen, sodass die Konsole Text formatiert ausgeben kann. Wir können bei einem VT100-Terminal Kontrollzeichen über System.out ausgeben und so zum Beispiel den Bildschirm löschen.
Diese Kontrollzeichen sind kryptisch, und so gibt es eine Curses-Bibliothek, mit der Entwickler auf einem VT100-Terminal Zeichenattribute auf der Konsole ändern, den Cursor zum Wandern bringen und einfache ASCII-Fenster erstellen können. Unter Unix implementiert ncurses die Funktionalität – unter Windows gibt es Vergleichbares als PDCurses. Zwei bekanntere Open-Source-Bibliotheken bieten Java-Zugriff auf die Curses-Bibliothek: CHARVA (http://www.pitman.co.za/projects/charva/) und Jcurzez (http://www.nongnu.org/jcurzez/).
