Startseite / I/O / InputStream.transferTo()
I/O Einsteiger

InputStream.transferTo()

Einen InputStream mit einem einzigen Aufruf in einen OutputStream kopieren.

Code-Vergleich
✕ Java 8 
byte[] buf = new byte[8192];
int n;
while ((n = input.read(buf)) != -1) {
    output.write(buf, 0, n);
}
✓ Java 9+ 
input.transferTo(output);
Problem mit diesem Code entdeckt? Sag uns Bescheid.
Warum der moderne Weg gewinnt
📏

Eine Zeile

Die gesamte Lese-/Schreibschleife durch einen einzigen Methodenaufruf ersetzen.

⚡

Optimiert

Die interne Puffergröße ist auf Performance ausgelegt.

🛡️

Keine Fehler

Keine Off-by-one-Fehler beim Puffer-Management.

Alter Ansatz
Manuelle Kopierschleife
Moderner Ansatz
transferTo()
Seit JDK
9
Schwierigkeitsgrad
Einsteiger
JDK-Unterstützung
InputStream.transferTo()
Verfügbar

Seit JDK 9 allgemein verfügbar (Sept. 2017)

Wie es funktioniert

transferTo() liest alle Bytes aus dem Eingabestream und schreibt sie in den Ausgabestream. Kein Puffer-Management, keine Schleife. Es wird ein optimierter interner Puffer verwendet.

Zugehörige Dokumentation
InputStream.transferTo() ↗
Verwandte Muster
I/O Einsteiger

Writing files

Java 8
try (FileWriter fw =
        new FileWriter("out.txt");
    BufferedWriter bw =
        new BufferedWriter(fw)) {
    bw.write(content);
}
Java 11+
Files.writeString(
    Path.of("out.txt"),
    content
);
Hover für Modernes ➜
JDK 11+ →
I/O Experte

Deserialization filters

Java 8
// Dangerous: accepts any class
ObjectInputStream ois =
    new ObjectInputStream(input);
Object obj = ois.readObject();
// deserialization attacks possible!
Java 9+
ObjectInputFilter filter =
    ObjectInputFilter.Config
    .createFilter(
        "com.myapp.*;!*"
    );
ois.setObjectInputFilter(filter);
Object obj = ois.readObject();
Hover für Modernes ➜
JDK 9+ →
I/O Einsteiger

Try-with-resources improvement

Java 8
Connection conn = getConnection();
// Must re-declare in try
try (Connection c = conn) {
    use(c);
}
Java 9+
Connection conn = getConnection();
// Use existing variable directly
try (conn) {
    use(conn);
}
Hover für Modernes ➜
JDK 9+ →
Teilen 𝕏 🦋 in ⬡