01: /*
02: * HA-JDBC: High-Availability JDBC
03: * Copyright (c) 2004-2007 Paul Ferraro
04: *
05: * This library is free software; you can redistribute it and/or modify it
06: * under the terms of the GNU Lesser General Public License as published by the
07: * Free Software Foundation; either version 2.1 of the License, or (at your
08: * option) any later version.
09: *
10: * This library is distributed in the hope that it will be useful, but WITHOUT
11: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
13: * for more details.
14: *
15: * You should have received a copy of the GNU Lesser General Public License
16: * along with this library; if not, write to the Free Software Foundation,
17: * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18: *
19: * Contact: ferraro@users.sourceforge.net
20: */
21: package net.sf.hajdbc.sql;
22:
23: import java.io.File;
24: import java.io.InputStream;
25: import java.io.Reader;
26: import java.sql.SQLException;
27:
28: /**
29: * Provides temp file support for serializing data for streams.
30: * Any files created by this object are deleted when {@link #close()} is called.
31: *
32: * @author Paul Ferraro
33: * @version $Revision: 1612 $
34: * @since 1.0
35: */
36: public interface FileSupport {
37: /**
38: * Create a file from the specified binary input stream.
39: * @param inputStream a binary stream of data
40: * @return a temporary file
41: * @throws SQLException if an IO error occurs
42: */
43: public File createFile(InputStream inputStream) throws SQLException;
44:
45: /**
46: * Create a file from the specified character input stream
47: * @param reader a character stream of data
48: * @return a temporary file
49: * @throws SQLException if an IO error occurs
50: */
51: public File createFile(Reader reader) throws SQLException;
52:
53: /**
54: * Returns a reader for the specified file.
55: * @param file a temp file
56: * @return a reader
57: * @throws SQLException if IO error occurs
58: */
59: public Reader getReader(File file) throws SQLException;
60:
61: /**
62: * Returns an input stream for the specified file.
63: * @param file a temp file
64: * @return an input stream
65: * @throws SQLException if IO error occurs
66: */
67: public InputStream getInputStream(File file) throws SQLException;
68:
69: /**
70: * Deletes any files created by this object.
71: */
72: public void close();
73: }
|