13.8 Vermittler zwischen Byte-Streams und Unicode-Strömen 
13.8.1 Datenkonvertierung durch den OutputStreamWriter 
Die Klasse OutputStreamWriter ist sehr interessant, da sie Konvertierungen der Zeichen nach einer Zeichenkodierung vornimmt. So wird sie, unterstützt durch die einzige Unterklasse FileWriter, für Ausgaben in Dateien noch wichtiger. Jeder OutputStreamWriter konvertiert auf diese Weise Zeichenströme von einer Zeichenkodierung (etwa EBCDIC) in die andere (etwa Latin-1). Die Zeichenkodierung kann im Konstruktor eines OutputStreamWriter-Objekts angegeben werden. Ohne Angabe ist es der Standardkonvertierer, der in den Systemeigenschaften unter dem Schlüssel file.encoding geschrieben ist. Die Kodierung der Zeichen nimmt ein StreamEncoder im Paket sun.nio.cs vor.
class java.io.OutputStreamWriter
extends Writer |
- OutputStreamWriter( OutputStream out ) Erzeugt einen OutputStreamWriter, der die Standardkodierung verwendet.
- OutputStreamWriter( OutputStream out, Charset|CharsetEncoder cs ) Erzeugt einen OutputStreamWriter mit einem Charset oder einem CharsetEncoder.
- OutputStreamWriter( OutputStream out, String enc ) Erzeugt einen OutputStreamWriter mit der vorgegebenen Kodierung.
- void close() Schließt den Datenstrom.
- void flush() Schreibt den gepufferten Strom.
- String getEncoding() Liefert die Kodierung des Datenstroms als String.
- void write( char[] cbuf, int off, int len ) Schreibt Zeichen des Felds.
- void write( int c ) Schreibt ein einzelnes Zeichen.
- void write( String str, int off, int len ) Schreibt den Teil eines Strings.
FileWriter, OutputStreamWriter und FileOutputStream
OutputStreamWriter ist die Basisklasse für die konkrete Klasse FileWriter und ist für die Konvertierung der Zeichen in Bytefolgen verantwortlich. Die Konstruktoren bauen ein FileOutputStream-Objekt auf und füttern damit den Konstruktor von OutputStreamWriter. Die write()-Methoden vom OutputStreamWriter konvertieren die Zeichen in Bytes, die letztendlich der FileOutputStream schreibt.
public class FileWriter extends OutputStreamWriter
{
public FileWriter(String fileName) throws IOException {
super(new FileOutputStream(fileName));
}
public FileWriter(String fileName, boolean append)
throws IOException {
super(new FileOutputStream(fileName, append));
}
...
}13.8.2 Automatische Konvertierungen mit dem InputStreamReader
Die konkrete Klasse InputStreamReader nimmt eine Konvertierung zwischen Byte- und Zeichen-Streams vor. Sie arbeitet wie ein OutputStreamWriter und konvertiert die Daten mit Hilfe eines sun.nio.cs.StreamDecoder.
class java.io.InputStreamReader
extends Reader |
- InputStreamReader( InputStream in ) Erzeugt einen InputStreamReader mit der Standardkodierung.
- InputStreamReader( InputStream in, String enc ) throws UnsupportedEncodingException Erzeugt einen InputStreamReader, der die angegebene Zeichenkodierung anwendet.
- String getEncoding() Liefert einen String mit dem Namen der Kodierung zurück. Der Name ist kanonisch und kann sich daher von dem String, der im Konstruktor übergeben wurde, unterscheiden.
- int read() throws IOException Liest ein einzelnes Zeichen oder gibt –1 zurück, falls der Stream am Ende ist.
- int read( char[] cbuf, int off, int len ) throws IOException Liest einen Teil eines Feldes.
- boolean ready() throws IOException Kann vom Stream gelesen werden. Ein InputStreamReader ist bereit, wenn der Eingabepuffer nicht leer ist oder Bytes des darunter befindlichen InputStreams anliegen.
Wie wir an dieser Stelle bemerken, unterstützt ein reiner InputStream kein mark() und reset(). Da FileReader die einzige Klasse in der Java-Bibliothek ist, die einen InputStreamReader erweitert und diese Klasse ebenfalls kein mark() beziehungsweise reset() unterstützt, lässt sich sagen, dass kein InputStreamReader der Standardbibliothek Positionsmarkierungen erlaubt.
Vergleich Reader und InputStream
Ein InputStreamReader eignet sich gut für die Umwandlung von äußeren Byte-Quellen. Wir erinnern uns, dass Java standardmäßig 16-Bit-Unicode-Zeichen verwendet, aber viele Computersysteme nur mit 8-Bit-ASCII-Zeichen arbeiten. Wenn wir also ein einzelnes Zeichen lesen, muss die passende Konvertierung in das richtige Zeichenformat gesichert sein. Der einfachste Weg besteht darin, ein Zeichen zu lesen und es in ein char – allerdings ohne Konvertierung – zu casten, beispielsweise wie folgt:
InputStream fis = new FileInputStream( "file.txt" ); DataInputStream dis = new DataInputStream( fis ); char c = (char) dis.readByte();
Da die Lösung keine Konvertierung durchführt, ist dieser Weg nicht so gut. Empfehlenswert ist die Verwendung eines InputStreamReader, der die acht Bits in ein Unicode-Zeichen portiert:
InputStream fis = new FileInputStream( "file.txt" ); InputStreamReader isr = new InputStreamReader( fis ); char c = (char) isr.read();
Die Klasse FileReader ist eine Unterklasse von InputStreamReader, die direkt eine Datei öffnet und den FileInputStream für uns anlegt.