flux de sortie

1. OutputStreamclasse

Nous venons tout juste d'explorer les flux d'entrée. Il est temps de parler des flux de sortie.

La OutputStreamclasse est la classe parente de toutes les classes prenant en charge la sortie d'octets. Il s'agit d'une classe abstraite qui ne fait rien par elle-même, mais elle a des classes descendantes pour chaque occasion.

Cela semble extrêmement compliqué. Pour le dire plus simplement, cette classe fonctionne sur des octets, et non, par exemple, sur des caractères ou d'autres types de données. Et le fait qu'il soit abstrait signifie que nous ne l'utilisons généralement pas, mais plutôt l'une de ses classes descendantes. Par exemple, FileOutputStreametc.

Mais revenons à la OutputStreamclasse. Cette classe a des méthodes que toutes ses classes descendantes doivent implémenter. Voici les principaux :

void write(int b)

void write(byte[] buffer)

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

void flush()

void close()

Lorsque vous créez un objet d'une classe qui hérite de InputStream, vous spécifiez généralement un objet source à InputStreampartir duquel lit les données. Lorsque vous créez un objet d'une classe qui hérite de OutputStream, vous spécifiez également généralement l'objet ou le flux cible dans lequel les données seront écrites.

Passons brièvement en revue toutes les méthodes de la OutputStreamclasse :

write(int b)méthode

Cette méthode écrit un octet (pas un int) dans le flux de sortie. La valeur transmise est convertie en un octet et les trois premiers octets de l'int sont ignorés.

write(byte[] buffer)méthode

Écrit le tableau d'octets donné dans le flux de sortie. C'est ça.

write(byte[] buffer, int offset, int length)méthode

Écrit une partie du tableau d'octets transmis dans le flux de sortie. La variable offset indique l'index du premier élément du tableau, et lengthest la longueur du sous-ensemble à écrire.

flush()méthode

La flush()méthode est utilisée pour forcer toutes les données potentiellement mises en mémoire tampon dans le flux actuel à être écrites dans le flux cible. Ceci est pertinent lors de l'utilisation de la mise en mémoire tampon et/ou de plusieurs objets de flux disposés en chaîne.

close()méthode

Écrit toutes les données non écrites dans l'objet cible. La close()méthode n'a pas besoin d'être appelée si vous utilisez un try-with-resourcesbloc.

Exemple de copie d'un fichier

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. Writerclasse

La Writerclasse est exactement la même que la OutputStreamclasse, mais juste une différence encore une fois : elle fonctionne avec des caractères ( char) au lieu d'octets.

Il s'agit d'une classe abstraite : vous ne pouvez pas créer d'objets de la Writerclasse. Son objectif principal est d'être une classe parente commune pour des centaines de classes descendantes et de leur donner des méthodes communes pour travailler avec des flux de caractères.

Méthodes de la Writerclasse (et de toutes ses classes descendantes) :

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()

Les méthodes sont très similaires aux méthodes de la OutputStreamclasse, mais elles fonctionnent avec des caractères au lieu d'octets.

Description des méthodes :

write(int b)méthode

Cette méthode écrit un seul caractère ( char— pas un int) dans le flux de sortie. La valeur transmise est convertie en a charet les deux premiers octets sont ignorés.

write(char[] buffer)méthode

Écrit le tableau de caractères donné dans le flux de sortie.

write(char[] buffer, int offset, int length)méthode

Écrit une partie du tableau de caractères transmis dans le flux de sortie. La offsetvariable indique l'index du premier élément du tableau, et lengthest la longueur du sous-ensemble à écrire.

write(String str)méthode

Écrit la chaîne donnée dans le flux de sortie.

write(String str, int offset, int length)méthode

Écrit une partie de la chaîne donnée dans le flux de sortie : la chaîne est convertie en un tableau de caractères. La offsetvariable indique l'index du premier élément du tableau, et lengthest la longueur du sous-ensemble à écrire.

flush()méthode

La flush()méthode est utilisée pour forcer toutes les données potentiellement mises en mémoire tampon dans le flux actuel à être écrites dans le flux cible. Ceci est pertinent lors de l'utilisation de la mise en mémoire tampon et/ou de plusieurs objets de flux disposés en chaîne.

close()méthode

Écrit toutes les données non écrites dans l'objet cible. La close()méthode n'a pas besoin d'être appelée si vous utilisez un try-with-resourcesbloc.

Exemple de programme qui copie un fichier texte :

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);
   }
}

StringWriterclasse

Il existe une autre classe intéressante qui hérite de la Writerclasse : elle s'appelle StringWriter. Il contient une chaîne mutable — un StringBufferobjet. Et chaque fois que vous "écrivez" quelque chose dans l' StringWriterobjet, le texte est simplement ajouté à son tampon interne.

Exemple:

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

String result = writer.toString();

Dans ce cas, la StringWriterclasse est essentiellement un wrapper sur la StringBufferclasse, mais la StringWriterclasse est un descendant de la Writerclasse stream, et elle peut être utilisée dans des chaînes d'objets stream. C'est une propriété assez utile dans la pratique.