01: /*
02: * ProGuard -- shrinking, optimization, obfuscation, and preverification
03: * of Java bytecode.
04: *
05: * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu)
06: *
07: * This program is free software; you can redistribute it and/or modify it
08: * under the terms of the GNU General Public License as published by the Free
09: * Software Foundation; either version 2 of the License, or (at your option)
10: * any later version.
11: *
12: * This program is distributed in the hope that it will be useful, but WITHOUT
13: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
15: * more details.
16: *
17: * You should have received a copy of the GNU General Public License along
18: * with this program; if not, write to the Free Software Foundation, Inc.,
19: * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20: */
21: package proguard.io;
22:
23: import java.io.*;
24:
25: /**
26: * This interface provides methods for writing data entries, such as ZIP entries
27: * or files. The implementation determines to which type of data entry the
28: * data will be written.
29: *
30: * @author Eric Lafortune
31: */
32: public interface DataEntryWriter {
33: /**
34: * Returns an output stream for writing data. The caller must not close
35: * the output stream; closing the output stream is the responsibility of
36: * the implementation of this interface.
37: * @param dataEntry the data entry for which the output stream is to be created.
38: * @return the output stream. The stream may be <code>null</code> to indicate
39: * that the data entry should not be written.
40: */
41: public OutputStream getOutputStream(DataEntry dataEntry)
42: throws IOException;
43:
44: /**
45: * Returns an output stream for writing data. The caller must not close
46: * the output stream; closing the output stream is the responsibility of
47: * the implementation of this interface.
48: * @param dataEntry the data entry for which the output stream is to be created.
49: * @param finisher the optional finisher that will be called before this
50: * class closes the output stream (at some later point in
51: * time) that will be returned (now).
52: * @return the output stream. The stream may be <code>null</code> to indicate
53: * that the data entry should not be written.
54: */
55: public OutputStream getOutputStream(DataEntry dataEntry,
56: Finisher finisher) throws IOException;
57:
58: /**
59: * Finishes writing all data entries.
60: */
61: public void close() throws IOException;
62: }
|