Java OutputStreamWriter-klasse

Ontdek hoe je Java's OutputStreamWriter gebruikt om karakter- en byte-streams te bruggen, met real-world code-snippets.

De OutputStreamWriter-klasse, onderdeel van java.io, fungeert als brug die karaktermdata vertaalt naar bytedata. Het breidt de abstracte Writer-klasse uit en werkt hand-in-hand met byte-streams zoals FileOutputStream.

Omdat sommige Unicode-karakters meerdere bytes beslaan, zorgt OutputStreamWriter ervoor dat de karaktekodering correct wordt toegepast bij het schrijven naar een bytestream.

Een OutputStreamWriter aanmaken

Begin met het importeren van de benodigde klassen:

import java.io.OutputStreamWriter;
import java.io.FileOutputStream;
import java.nio.charset.Charset;

Instantieer een FileOutputStream om een bestand te targeten, en wrap het met een OutputStreamWriter. De standaardconstructor gebruikt het platformstandaard-charset, maar je kunt expliciet UTF-8 of UTF-16 instellen voor consistentie across omgevingen:

// Standaard charset
OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream("output.txt"));
// Expliciete UTF-8
OutputStreamWriter writerUtf8 = new OutputStreamWriter(
    new FileOutputStream("output_utf8.txt"), Charset.forName("UTF-8"));

Kernmethoden van OutputStreamWriter

OutputStreamWriter implementeert alle abstracte methoden van Writer. De meest gebruikte methoden:

write()-methode

• write(int c) – Schrijft een enkel karakter
• write(char[] cbuf) – Schrijft een array karakters
• write(String str) – Schrijft een string

Voorbeeld: Tekst naar een bestand schrijven

import java.io.FileOutputStream;
import java.io.OutputStreamWriter;

public class Main {
    public static void main(String[] args) {
        String data = "Dit is een regel tekst in het bestand.";
        try {
            FileOutputStream fileOut = new FileOutputStream("output.txt");
            OutputStreamWriter writer = new OutputStreamWriter(fileOut, Charset.forName("UTF-8"));
            writer.write(data);
            writer.flush();
            writer.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Dit programma creëert output.txt met de inhoud:

Dit is een regel tekst in het bestand.

getEncoding()-methode

Gebruik getEncoding() om het charset op te vragen dat momenteel in gebruik is:

FileOutputStream bestand = new FileOutputStream("output.txt");
OutputStreamWriter standaardWriter = new OutputStreamWriter(bestand);
OutputStreamWriter utf8Writer = new OutputStreamWriter(bestand, Charset.forName("UTF-8"));
System.out.println("Standaard encoding: " + standaardWriter.getEncoding());
System.out.println("UTF-8 encoding: " + utf8Writer.getEncoding());

Output

Standaard encoding: Cp1252
UTF-8 encoding: UTF-8

Wanneer geen charset gespecificeerd is, wordt het platformstandaard geretourneerd. Expliciet instellen garandeert consistent gedrag.

Tip: Gebruik Charset.forName() voor nauwkeurige controle; zie de officiële Java Charset API voor details.

close()-methode

Roep altijd close() aan om systeembronnen vrij te geven. Eenmaal gesloten, kan de writer niet meer gebruikt worden.

Extra nuttige methoden

Voor een complete referentie, raadpleeg de officiële Java OutputStreamWriter Javadoc.