/* $Id: DataEntryWriter.java,v 1.3.2.1 2006/01/16 22:57:55 eric Exp $ * * ProGuard -- shrinking, optimization, and obfuscation of Java class files. * * Copyright (c) 2002-2006 Eric Lafortune (eric@graphics.cornell.edu) * * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the Free * Software Foundation; either version 2 of the License, or (at your option) * any later version. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for * more details. * * You should have received a copy of the GNU General Public License along * with this program; if not, write to the Free Software Foundation, Inc., * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */package proguard.io;import java.io.*;/** * This interface provides methods for writing data entries, such as ZIP entries * or files. The implementation determines to which type of data entry the * data will be written. * * @author Eric Lafortune */public interface DataEntryWriter{    /**     * Returns an output stream for writing data. The caller must not close     * the output stream; closing the output stream is the responsibility of     * the implementation of this interface.     * @param dataEntry the data entry for which the output stream is to be created.     * @return the output stream. The stream may be <code>null</code> to indicate     *         that the data entry should not be written.     */    public OutputStream getOutputStream(DataEntry dataEntry) throws IOException;    /**     * Returns an output stream for writing data. The caller must not close     * the output stream; closing the output stream is the responsibility of     * the implementation of this interface.     * @param dataEntry the data entry for which the output stream is to be created.     * @param finisher  the optional finisher that will be called before this     *                  class closes the output stream (at some later point in     *                  time) that will be returned (now).     * @return the output stream. The stream may be <code>null</code> to indicate     *         that the data entry should not be written.     */    public OutputStream getOutputStream(DataEntry dataEntry,                                        Finisher  finisher) throws IOException;    /**     * Finishes writing all data entries.     */    public void close() throws IOException;}