Fluxuri de ieșire

1. OutputStreamclasa

Am explorat recent fluxurile de intrare. Este timpul să vorbim despre fluxurile de ieșire.

Clasa OutputStreameste clasa părinte pentru toate clasele care acceptă ieșirea de octeți. Aceasta este o clasă abstractă care nu face nimic pe cont propriu, dar are clase descendente pentru fiecare ocazie.

Sună extrem de complicat. Pentru a spune mai simplu, această clasă operează pe octeți și nu, de exemplu, caractere sau alte tipuri de date. Iar faptul că este abstract înseamnă că de obicei nu îl folosim, ci mai degrabă una dintre clasele sale descendențe. De exemplu, FileOutputStreamși altele asemenea.

Dar înapoi la OutputStreamclasă. Această clasă are metode pe care toate clasele sale descendente trebuie să le implementeze. Iată pe cele principale:

void write(int b)

void write(byte[] buffer)

void write(byte[] buffer, off, len)

void flush()

void close()

Când creați un obiect dintr-o clasă care moștenește InputStream, de obicei specificați un obiect sursă InputStreamdin care citește datele. Când creați un obiect dintr-o clasă care moștenește OutputStream, de obicei specificați și obiectul țintă sau fluxul în care vor fi scrise datele.

Să trecem pe scurt prin toate metodele clasei OutputStream:

write(int b)metodă

Această metodă scrie un octet (nu un int) în fluxul de ieșire. Valoarea transmisă este transformată într-un octet, iar primii trei octeți ai intului sunt aruncați.

write(byte[] buffer)metodă

Scrie matricea dată de octeți în fluxul de ieșire. Asta este.

write(byte[] buffer, int offset, int length)metodă

Scrie o porțiune din matricea de octeți transmisă în fluxul de ieșire. Variabila offset indică indicele primului element al matricei și lengtheste lungimea subsetului care trebuie scris.

flush()metodă

Metoda flush()este utilizată pentru a forța orice date care pot fi stocate în tampon în fluxul curent să fie scrise în fluxul țintă. Acest lucru este relevant atunci când se utilizează buffering și/sau mai multe obiecte de flux aranjate într-un lanț.

close()metodă

Scrie orice date nescrise în obiectul țintă. Metoda close()nu trebuie apelată dacă utilizați un try-with-resourcesbloc.

Exemplu de copiere a unui fișier

String src = "c:\\projects\\log.txt";
String dest = "c:\\projects\\copy.txt";

try(FileInputStream input = new FileInputStream(src);
FileOutputStream output = new FileOutputStream(dest))
{
   byte[] buffer = new byte[65536]; // 64Kb
   while (input.available() > 0)
   {
      int real = input.read(buffer);
      output.write(buffer, 0, real);
   }
}

2. Writerclasa

Clasa Writereste exact aceeași cu OutputStreamclasa, dar încă o dată o diferență: funcționează cu caractere ( char) în loc de octeți.

Aceasta este o clasă abstractă: nu puteți crea obiecte ale Writerclasei. Scopul său principal este să fie o clasă părinte comună pentru sute de clase descendente și să le ofere metode comune de lucru cu fluxurile de caractere.

Metode ale Writerclasei (și toate clasele sale descendente):

void write(int b)

void write(char[] buffer)

void write(char[] buffer, off, len)

void write(String str)

void write(String str, off, len)

void flush()

void close()

Metodele sunt foarte asemănătoare cu metodele clasei OutputStream, dar funcționează cu caractere în loc de octeți.

Descrierea metodelor:

write(int b)metodă

Această metodă scrie un singur caracter ( char— nu un int) în fluxul de ieșire. Valoarea transmisă este turnată la un char, iar primii doi octeți sunt eliminați.

write(char[] buffer)metodă

Scrie matricea dată de caractere în fluxul de ieșire.

write(char[] buffer, int offset, int length)metodă

Scrie o parte din matricea de caractere transmisă în fluxul de ieșire. Variabila offsetindică indexul primului element al matricei și lengtheste lungimea subsetului care urmează să fie scris.

write(String str)metodă

Scrie șirul dat în fluxul de ieșire.

write(String str, int offset, int length)metodă

Scrie o porțiune din șirul dat în fluxul de ieșire: șirul este convertit într-o matrice de caractere. Variabila offsetindică indexul primului element al matricei și lengtheste lungimea subsetului care urmează să fie scris.

flush()metodă

Metoda flush()este utilizată pentru a forța orice date care pot fi stocate în tampon în fluxul curent să fie scrise în fluxul țintă. Acest lucru este relevant atunci când se utilizează buffering și/sau mai multe obiecte de flux aranjate într-un lanț.

close()metodă

Scrie orice date nescrise în obiectul țintă. Metoda close()nu trebuie apelată dacă utilizați un try-with-resourcesbloc.

Exemplu de program care copiază un fișier text:

String src = "c:\\projects\\log.txt";
String dest = "c:\\projects\\copy.txt";

try(FileReader reader = new FileReader(src);
FileWriter writer = new FileWriter(dest))
{
   char[] buffer = new char[65536]; // 128Kb
   while (reader.ready())
   {
      int real = reader.read(buffer);
      writer.write(buffer, 0, real);
   }
}

StringWriterclasă

Există o altă clasă interesantă care moștenește Writerclasa: se numește StringWriter. Conține un șir mutabil - un StringBufferobiect. Și de fiecare dată când „scrieți” ceva obiectului StringWriter, textul este pur și simplu adăugat în buffer-ul său intern.

Exemplu:

StringWriter writer = new StringWriter();
writer.write("Hello");
writer.write(String.valueOf(123));

String result = writer.toString();

În acest caz, StringWriterclasa este în esență un wrapper peste StringBufferclasă, dar StringWriterclasa este un descendent al Writerclasei stream și poate fi folosită în lanțuri de obiecte stream. Aceasta este o proprietate destul de utilă în practică.