Maîtriser Java StringWriter : Utilisation, méthodes et exemples pratiques

Maîtriser Java StringWriter : Utilisation, méthodes et exemples pratiques

La classe StringWriter, dans le package java.io, étend la classe abstraite Writer et permet d'écrire des données caractères dans un tampon de chaîne mutable. Ce tampon peut s'agrandir selon les besoins et être converti en String standard via toString().

Note : En Java, un tampon de chaîne se comporte comme une chaîne mutable, son contenu peut être modifié. toString() récupère sa valeur actuelle comme String immuable.

---

Créer un StringWriter

Importez la classe :

import java.io.StringWriter;

Puis créez l'objet :

// StringWriter avec capacité par défaut
StringWriter output = new StringWriter();

Vous pouvez aussi spécifier une taille initiale si vous anticipez beaucoup de données :

// StringWriter avec capacité prédéfinie
StringWriter output = new StringWriter(int taille);

L'argument taille détermine la capacité initiale du tampon interne.

---

Méthodes principales de StringWriter

Méthode write()

• write(int c) – écrit un seul caractère
• write(char[] cbuf) – écrit un tableau de caractères
• write(String str) – écrit une chaîne

---

Exemple : Utilisation de StringWriter

import java.io.StringWriter;

public class Main {
    public static void main(String[] args) {
        String donnees = "Ceci est le texte dans la chaîne.";
        try {
            StringWriter output = new StringWriter();
            output.write(donnees);
            System.out.println("Données dans StringWriter : " + output);
            output.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Sortie

Données dans StringWriter : Ceci est le texte dans la chaîne.

write() ajoute les données au tampon interne, et le contenu est affiché via output.toString().

Accès aux données du tampon

• getBuffer() – renvoie l'instance StringBuffer sous-jacente
• toString() – renvoie le contenu du tampon comme String simple

Exemple :

import java.io.StringWriter;

public class Main {
    public static void main(String[] args) {
        String donnees = "Ceci sont les données originales";
        try {
            StringWriter output = new StringWriter();
            output.write(donnees);
            StringBuffer sb = output.getBuffer();
            System.out.println("StringBuffer : " + sb);
            String str = output.toString();
            System.out.println("String : " + str);
            output.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Sortie

StringBuffer : Ceci sont les données originales
String : Ceci sont les données originales

Méthode close()

Appeler close() sur un StringWriter ne libère pas de ressources n'empêche les écritures futures ; l'objet reste utilisable après fermeture.

---

Méthodes supplémentaires de StringWriter

Méthode	Description
flush()	Assure que toutes les données en tampon sont écrites (sans effet réel pour StringWriter)
append()	Ajoute un caractère ou chaîne au tampon courant

Pour la référence complète, consultez la documentation officielle Java.