GNU Classpath (0.20) | |
Frames | No Frames |
1: /* SQLOutput.java -- Write SQL values to a stream 2: Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc. 3: 4: This file is part of GNU Classpath. 5: 6: GNU Classpath is free software; you can redistribute it and/or modify 7: it under the terms of the GNU General Public License as published by 8: the Free Software Foundation; either version 2, or (at your option) 9: any later version. 10: 11: GNU Classpath is distributed in the hope that it will be useful, but 12: WITHOUT ANY WARRANTY; without even the implied warranty of 13: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14: General Public License for more details. 15: 16: You should have received a copy of the GNU General Public License 17: along with GNU Classpath; see the file COPYING. If not, write to the 18: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 19: 02110-1301 USA. 20: 21: Linking this library statically or dynamically with other modules is 22: making a combined work based on this library. Thus, the terms and 23: conditions of the GNU General Public License cover the whole 24: combination. 25: 26: As a special exception, the copyright holders of this library give you 27: permission to link this library with independent modules to produce an 28: executable, regardless of the license terms of these independent 29: modules, and to copy and distribute the resulting executable under 30: terms of your choice, provided that you also meet, for each linked 31: independent module, the terms and conditions of the license of that 32: module. An independent module is a module which is not derived from 33: or based on this library. If you modify this library, you may extend 34: this exception to your version of the library, but you are not 35: obligated to do so. If you do not wish to do so, delete this 36: exception statement from your version. */ 37: 38: 39: package java.sql; 40: 41: import java.io.InputStream; 42: import java.io.Reader; 43: import java.math.BigDecimal; 44: import java.net.URL; 45: 46: /** 47: * This interface provides methods for writing Java types to a SQL stream. 48: * It is used for implemented custom type mappings for user defined data 49: * types. 50: * 51: * @author Aaron M. Renn (arenn@urbanophile.com) 52: */ 53: public interface SQLOutput 54: { 55: /** 56: * This method writes the specified Java <code>String</code> 57: * to the SQL stream. 58: * 59: * @param value The value to write to the stream. 60: * @exception SQLException If an error occurs. 61: */ 62: void writeString(String x) throws SQLException; 63: 64: /** 65: * This method writes the specified Java <code>boolean</code> 66: * to the SQL stream. 67: * 68: * @param value The value to write to the stream. 69: * @exception SQLException If an error occurs. 70: */ 71: void writeBoolean(boolean x) throws SQLException; 72: 73: /** 74: * This method writes the specified Java <code>byte</code> 75: * to the SQL stream. 76: * 77: * @param value The value to write to the stream. 78: * @exception SQLException If an error occurs. 79: */ 80: void writeByte(byte x) throws SQLException; 81: 82: /** 83: * This method writes the specified Java <code>short</code> 84: * to the SQL stream. 85: * 86: * @param value The value to write to the stream. 87: * @exception SQLException If an error occurs. 88: */ 89: void writeShort(short x) throws SQLException; 90: 91: /** 92: * This method writes the specified Java <code>int</code> 93: * to the SQL stream. 94: * 95: * @param value The value to write to the stream. 96: * @exception SQLException If an error occurs. 97: */ 98: void writeInt(int x) throws SQLException; 99: 100: /** 101: * This method writes the specified Java <code>long</code> 102: * to the SQL stream. 103: * 104: * @param value The value to write to the stream. 105: * @exception SQLException If an error occurs. 106: */ 107: void writeLong(long x) throws SQLException; 108: 109: /** 110: * This method writes the specified Java <code>float</code> 111: * to the SQL stream. 112: * 113: * @param value The value to write to the stream. 114: * @exception SQLException If an error occurs. 115: */ 116: void writeFloat(float x) throws SQLException; 117: 118: /** 119: * This method writes the specified Java <code>double</code> 120: * to the SQL stream. 121: * 122: * @param value The value to write to the stream. 123: * @exception SQLException If an error occurs. 124: */ 125: void writeDouble(double x) throws SQLException; 126: 127: /** 128: * This method writes the specified Java <code>BigDecimal</code> 129: * to the SQL stream. 130: * 131: * @param value The value to write to the stream. 132: * @exception SQLException If an error occurs. 133: */ 134: void writeBigDecimal(BigDecimal x) throws SQLException; 135: 136: /** 137: * This method writes the specified Java <code>byte</code> array 138: * to the SQL stream. 139: * 140: * @param value The value to write to the stream. 141: * @exception SQLException If an error occurs. 142: */ 143: void writeBytes(byte[] x) throws SQLException; 144: 145: /** 146: * This method writes the specified Java <code>java.sql.Date</code> 147: * to the SQL stream. 148: * 149: * @param value The value to write to the stream. 150: * @exception SQLException If an error occurs. 151: */ 152: void writeDate(Date x) throws SQLException; 153: 154: /** 155: * This method writes the specified Java <code>java.sql.Time</code> 156: * to the SQL stream. 157: * 158: * @param value The value to write to the stream. 159: * @exception SQLException If an error occurs. 160: */ 161: void writeTime(Time x) throws SQLException; 162: 163: /** 164: * This method writes the specified Java <code>java.sql.Timestamp</code> 165: * to the SQL stream. 166: * 167: * @param value The value to write to the stream. 168: * @exception SQLException If an error occurs. 169: */ 170: void writeTimestamp(Timestamp x) throws SQLException; 171: 172: /** 173: * This method writes the specified Java character stream 174: * to the SQL stream. 175: * 176: * @param value The value to write to the stream. 177: * @exception SQLException If an error occurs. 178: */ 179: void writeCharacterStream(Reader x) throws SQLException; 180: 181: /** 182: * This method writes the specified ASCII text stream 183: * to the SQL stream. 184: * 185: * @param value The value to write to the stream. 186: * @exception SQLException If an error occurs. 187: */ 188: void writeAsciiStream(InputStream x) throws SQLException; 189: 190: /** 191: * This method writes the specified uninterpreted binary byte stream 192: * to the SQL stream. 193: * 194: * @param value The value to write to the stream. 195: * @exception SQLException If an error occurs. 196: */ 197: void writeBinaryStream(InputStream x) throws SQLException; 198: 199: /** 200: * This method writes the specified Java <code>SQLData</code> object 201: * to the SQL stream. 202: * 203: * @param value The value to write to the stream. 204: * @exception SQLException If an error occurs. 205: */ 206: void writeObject(SQLData x) throws SQLException; 207: 208: /** 209: * This method writes the specified Java SQL <code>Ref</code> object 210: * to the SQL stream. 211: * 212: * @param value The value to write to the stream. 213: * @exception SQLException If an error occurs. 214: */ 215: void writeRef(Ref x) throws SQLException; 216: 217: /** 218: * This method writes the specified Java SQL <code>Blob</code> object 219: * to the SQL stream. 220: * 221: * @param value The value to write to the stream. 222: * @exception SQLException If an error occurs. 223: */ 224: void writeBlob(Blob x) throws SQLException; 225: 226: /** 227: * This method writes the specified Java SQL <code>Clob</code> object 228: * to the SQL stream. 229: * 230: * @param value The value to write to the stream. 231: * @exception SQLException If an error occurs. 232: */ 233: void writeClob(Clob x) throws SQLException; 234: 235: /** 236: * This method writes the specified Java SQL <code>Struct</code> object 237: * to the SQL stream. 238: * 239: * @param value The value to write to the stream. 240: * @exception SQLException If an error occurs. 241: */ 242: void writeStruct(Struct x) throws SQLException; 243: 244: /** 245: * This method writes the specified Java SQL <code>Array</code> object 246: * to the SQL stream. 247: * 248: * @param value The value to write to the stream. 249: * @exception SQLException If an error occurs. 250: */ 251: void writeArray(Array x) throws SQLException; 252: 253: /** 254: * @since 1.4 255: */ 256: void writeURL(URL x) throws SQLException; 257: }
GNU Classpath (0.20) |