www.infkoffler.com - Site de cours d'informatique

Accueil

Java Standard Edition

Java EE 5

Visual Basic .Net 2005

Cours Javascript - DOM - DHTML

Nouveautés sur le site

Contacts

Accueil > Java Standard Edition > E/S(9):Flux de caractères: FilterReader et FilterWriter

____________________________________________________________________________________________________

Connexion

Les entrées-sorties(9) - Les classes héritant de Reader et Writer: FilterReader et FilterWriter

Sommaire :

I) Généralités
II) FilterReader( java.io)
III) FilterWriter(java.io)

I) Généralités

Les classes de base pour les filtres, en ce qui concerne les flux de caractères, sont FilterReader et FilterWriter (java.io)

Nous ne reviendrons pas sur le principe des filtres, qui a été expliqué pour les flux d'octets( FilterInputStream et FilterOutputStream).

FilterReader et FilterWriter sont des classes abstraites, dont le filtre ne fait rien. Comme pour les filtres de flux d'octets, les filtres sont eux-mêmes des flux. Ici FilterReader est lui-même un flux de caractères en entrée (Reader); et FilterWriter est un flux de caractères en sortie(Writer).

II) FilterReader( java.io)

La classe de base pour les filtres de caractères en entrée. Elle est abstraite.
Le code source est très court et simple. Le filtre ne filtre rien, il ne fait que redonner le flux d'origine.
Le flux d'origine est gardé dans un attribut protected, appelé "in".

Le code source se passe de commentaires.
Il y a un seul constructeur, qui demande un objet Reader(le flux à filtrer).

/*
 * @(#)FilterReader.java	1.19 05/11/17
 *
 * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 */

package java.io;

/**
 * Abstract class for reading filtered character streams.
 * The abstract class <code>FilterReader</code> itself
 * provides default methods that pass all requests to 
 * the contained stream. Subclasses of <code>FilterReader</code>
 * should override some of these methods and may also provide
 * additional methods and fields.
 *
 * @version 	1.19, 05/11/17
 * @author	Mark Reinhold
 * @since	JDK1.1
 */

public abstract class FilterReader extends Reader {

/**
     * The underlying character-input stream.
     */
    protected Reader in;

/**
     * Creates a new filtered reader.
     *
     * @param in  a Reader object providing the underlying stream.
     * @throws NullPointerException if <code>in</code> is <code>null</code>
     */
    protected FilterReader(Reader in) {
	super(in);
	this.in = in;
    }

/**
     * Reads a single character.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public int read() throws IOException {
	return in.read();
    }

/**
     * Reads characters into a portion of an array.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public int read(char cbuf[], int off, int len) throws IOException {
	return in.read(cbuf, off, len);
    }

/**
     * Skips characters.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public long skip(long n) throws IOException {
	return in.skip(n);
    }

/**
     * Tells whether this stream is ready to be read.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public boolean ready() throws IOException {
	return in.ready();
    }

/**
     * Tells whether this stream supports the mark() operation.
     */
    public boolean markSupported() {
	return in.markSupported();
    }

/**
     * Marks the present position in the stream.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public void mark(int readAheadLimit) throws IOException {
	in.mark(readAheadLimit);
    }

/**
     * Resets the stream.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public void reset() throws IOException {
	in.reset();
    }

public void close() throws IOException {
	in.close();
    }

}

III) FilterWriter(java.io)

C'est la classe de base pour les flux de caractères en sortie. Elle est abstraite.
Elle est exactement sur le même modèle que FilterReader.
Le code source est très court et facile. Le filtre ne fait que redonner les données du flux d'origine.

package java.io;

/**
 * Abstract class for writing filtered character streams.
 * The abstract class <code>FilterWriter</code> itself
 * provides default methods that pass all requests to the
 * contained stream. Subclasses of <code>FilterWriter</code>
 * should override some of these methods and may also 
 * provide additional methods and fields.
 *
 * @version 	1.18, 05/11/17
 * @author	Mark Reinhold
 * @since	JDK1.1
 */

public abstract class FilterWriter extends Writer {

/**
     * The underlying character-output stream.
     */
    protected Writer out;

/**
     * Create a new filtered writer.
     *
     * @param out  a Writer object to provide the underlying stream.
     * @throws NullPointerException if <code>out</code> is <code>null</code>
     */
    protected FilterWriter(Writer out) {
	super(out);
	this.out = out;
    }

/**
     * Writes a single character.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public void write(int c) throws IOException {
	out.write(c);
    }

/**
     * Writes a portion of an array of characters.
     *
     * @param  cbuf  Buffer of characters to be written
     * @param  off   Offset from which to start reading characters
     * @param  len   Number of characters to be written
     *
     * @exception  IOException  If an I/O error occurs
     */
    public void write(char cbuf[], int off, int len) throws IOException {
	out.write(cbuf, off, len);
    }

/**
     * Writes a portion of a string.
     *
     * @param  str  String to be written
     * @param  off  Offset from which to start reading characters
     * @param  len  Number of characters to be written
     *
     * @exception  IOException  If an I/O error occurs
     */
    public void write(String str, int off, int len) throws IOException {
	out.write(str, off, len);
    }

/**
     * Flushes the stream.
     *
     * @exception  IOException  If an I/O error occurs
     */
    public void flush() throws IOException {
	out.flush();
    }

public void close() throws IOException {
	out.close();
    }

}

RETOUR HAUT