1 |
/* CallableStatement.java -- A statement for calling stored procedures. |
/* CallableStatement.java -- A statement for calling stored procedures. |
2 |
Copyright (C) 1999, 2000 Free Software Foundation, Inc. |
Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc. |
3 |
|
|
4 |
This file is part of GNU Classpath. |
This file is part of GNU Classpath. |
5 |
|
|
35 |
obligated to do so. If you do not wish to do so, delete this |
obligated to do so. If you do not wish to do so, delete this |
36 |
exception statement from your version. */ |
exception statement from your version. */ |
37 |
|
|
|
|
|
38 |
package java.sql; |
package java.sql; |
39 |
|
|
40 |
import java.io.InputStream; |
import java.io.InputStream; |
41 |
import java.io.Reader; |
import java.io.Reader; |
42 |
import java.math.BigDecimal; |
import java.math.BigDecimal; |
43 |
|
import java.net.URL; |
44 |
import java.util.Calendar; |
import java.util.Calendar; |
45 |
import java.util.Map; |
import java.util.Map; |
46 |
|
|
47 |
/** |
/** |
48 |
* This interface provides a mechanism for calling stored procedures. |
* This interface provides a mechanism for calling stored procedures. |
49 |
* |
* |
50 |
* @author Aaron M. Renn (arenn@urbanophile.com) |
* @author Aaron M. Renn (arenn@urbanophile.com) |
51 |
*/ |
*/ |
52 |
public interface CallableStatement extends PreparedStatement |
public interface CallableStatement extends PreparedStatement |
53 |
{ |
{ |
54 |
|
/** |
55 |
/*************************************************************************/ |
* This method registers the specified parameter as an output parameter |
56 |
|
* of the specified SQL type. |
57 |
/** |
* |
58 |
* This method tests whether the value of the last parameter that was fetched |
* @param index The index of the parameter to register as output. |
59 |
* was actually a SQL NULL value. |
* @param type The SQL type value from <code>Types</code>. |
60 |
* |
* @exception SQLException If an error occurs. |
61 |
* @return <code>true</code> if the last parameter fetched was a NULL, |
*/ |
62 |
* <code>false</code> otherwise. |
public void registerOutParameter(int parameterIndex, int sqlType) |
63 |
* |
throws SQLException; |
64 |
* @exception SQLException If an error occurs. |
|
65 |
*/ |
/** |
66 |
public abstract boolean |
* This method registers the specified parameter as an output parameter |
67 |
wasNull() throws SQLException; |
* of the specified SQL type and scale. |
68 |
|
* |
69 |
/*************************************************************************/ |
* @param index The index of the parameter to register as output. |
70 |
|
* @param type The SQL type value from <code>Types</code>. |
71 |
/** |
* @param scale The scale of the value that will be returned. |
72 |
* This method returns the value of the specified parameter as a Java |
* @exception SQLException If an error occurs. |
73 |
* <code>String</code>. |
*/ |
74 |
* |
public void registerOutParameter(int parameterIndex, int sqlType, int scale) |
75 |
* @param index The index of the parameter to return. |
throws SQLException; |
76 |
* |
|
77 |
* @return The parameter value as a <code>String</code>. |
/** |
78 |
* |
* This method tests whether the value of the last parameter that was fetched |
79 |
* @exception SQLException If an error occurs. |
* was actually a SQL NULL value. |
80 |
*/ |
* |
81 |
public abstract String |
* @return <code>true</code> if the last parameter fetched was a NULL, |
82 |
getString(int index) throws SQLException; |
* <code>false</code> otherwise. |
83 |
|
* @exception SQLException If an error occurs. |
84 |
/*************************************************************************/ |
*/ |
85 |
|
public boolean wasNull() throws SQLException; |
86 |
/** |
|
87 |
* This method returns the value of the specified parameter as a Java |
/** |
88 |
* <code>Object</code>. |
* This method returns the value of the specified parameter as a Java |
89 |
* |
* <code>String</code>. |
90 |
* @param index The index of the parameter to return. |
* |
91 |
* |
* @param index The index of the parameter to return. |
92 |
* @return The parameter value as an <code>Object</code>. |
* @return The parameter value as a <code>String</code>. |
93 |
* |
* @exception SQLException If an error occurs. |
94 |
* @exception SQLException If an error occurs. |
*/ |
95 |
*/ |
public String getString(int parameterIndex) throws SQLException; |
96 |
public abstract Object |
|
97 |
getObject(int index) throws SQLException; |
/** |
98 |
|
* This method returns the value of the specified parameter as a Java |
99 |
/*************************************************************************/ |
* <code>boolean</code>. |
100 |
|
* |
101 |
/** |
* @param index The index of the parameter to return. |
102 |
* This method returns the value of the specified parameter as a Java |
* @return The parameter value as a <code>boolean</code>. |
103 |
* <code>Object</code>. |
* @exception SQLException If an error occurs. |
104 |
* |
*/ |
105 |
* @param index The index of the parameter to return. |
public boolean getBoolean(int parameterIndex) throws SQLException; |
106 |
* @param map The mapping to use for conversion from SQL to Java types. |
|
107 |
* |
/** |
108 |
* @return The parameter value as an <code>Object</code>. |
* This method returns the value of the specified parameter as a Java |
109 |
* |
* <code>byte</code>. |
110 |
* @exception SQLException If an error occurs. |
* |
111 |
*/ |
* @param index The index of the parameter to return. |
112 |
public abstract Object |
* @return The parameter value as a <code>byte</code>. |
113 |
getObject(int index, Map map) throws SQLException; |
* @exception SQLException If an error occurs. |
114 |
|
*/ |
115 |
/*************************************************************************/ |
public byte getByte(int parameterIndex) throws SQLException; |
116 |
|
|
117 |
/** |
/** |
118 |
* This method returns the value of the specified parameter as a Java |
* This method returns the value of the specified parameter as a Java |
119 |
* <code>boolean</code>. |
* <code>short</code>. |
120 |
* |
* |
121 |
* @param index The index of the parameter to return. |
* @param index The index of the parameter to return. |
122 |
* |
* @return The parameter value as a <code>short</code>. |
123 |
* @return The parameter value as a <code>boolean</code>. |
* @exception SQLException If an error occurs. |
124 |
* |
*/ |
125 |
* @exception SQLException If an error occurs. |
public short getShort(int parameterIndex) throws SQLException; |
126 |
*/ |
|
127 |
public abstract boolean |
/** |
128 |
getBoolean(int index) throws SQLException; |
* This method returns the value of the specified parameter as a Java |
129 |
|
* <code>int</code>. |
130 |
/*************************************************************************/ |
* |
131 |
|
* @param index The index of the parameter to return. |
132 |
/** |
* @return The parameter value as a <code>int</code>. |
133 |
* This method returns the value of the specified parameter as a Java |
* @exception SQLException If an error occurs. |
134 |
* <code>byte</code>. |
*/ |
135 |
* |
public int getInt(int parameterIndex) throws SQLException; |
136 |
* @param index The index of the parameter to return. |
|
137 |
* |
/** |
138 |
* @return The parameter value as a <code>byte</code>. |
* This method returns the value of the specified parameter as a Java |
139 |
* |
* <code>long</code>. |
140 |
* @exception SQLException If an error occurs. |
* |
141 |
*/ |
* @param index The index of the parameter to return. |
142 |
public abstract byte |
* @return The parameter value as a <code>long</code>. |
143 |
getByte(int index) throws SQLException; |
* @exception SQLException If an error occurs. |
144 |
|
*/ |
145 |
/*************************************************************************/ |
public long getLong(int parameterIndex) throws SQLException; |
146 |
|
|
147 |
/** |
/** |
148 |
* This method returns the value of the specified parameter as a Java |
* This method returns the value of the specified parameter as a Java |
149 |
* <code>short</code>. |
* <code>float</code>. |
150 |
* |
* |
151 |
* @param index The index of the parameter to return. |
* @param index The index of the parameter to return. |
152 |
* |
* @return The parameter value as a <code>float</code>. |
153 |
* @return The parameter value as a <code>short</code>. |
* @exception SQLException If an error occurs. |
154 |
* |
*/ |
155 |
* @exception SQLException If an error occurs. |
public float getFloat(int parameterIndex) throws SQLException; |
156 |
*/ |
|
157 |
public abstract short |
/** |
158 |
getShort(int index) throws SQLException; |
* This method returns the value of the specified parameter as a Java |
159 |
|
* <code>double</code>. |
160 |
/*************************************************************************/ |
* |
161 |
|
* @param index The index of the parameter to return. |
162 |
/** |
* @return The parameter value as a <code>double</code>. |
163 |
* This method returns the value of the specified parameter as a Java |
* @exception SQLException If an error occurs. |
164 |
* <code>int</code>. |
*/ |
165 |
* |
public double getDouble(int parameterIndex) throws SQLException; |
166 |
* @param index The index of the parameter to return. |
|
167 |
* |
/** |
168 |
* @return The parameter value as a <code>int</code>. |
* This method returns the value of the specified parameter as a Java |
169 |
* |
* <code>BigDecimal</code>. |
170 |
* @exception SQLException If an error occurs. |
* |
171 |
*/ |
* @param parameterIndex The index of the parameter to return. |
172 |
public abstract int |
* @param scale The number of digits to the right of the decimal to return. |
173 |
getInt(int index) throws SQLException; |
* @return The parameter value as a <code>BigDecimal</code>. |
174 |
|
* @exception SQLException If an error occurs. |
175 |
/*************************************************************************/ |
* @deprecated Use getBigDecimal(int parameterIndex) |
176 |
|
* or getBigDecimal(String parameterName) instead. |
177 |
/** |
*/ |
178 |
* This method returns the value of the specified parameter as a Java |
public BigDecimal getBigDecimal(int parameterIndex, int scale) |
179 |
* <code>long</code>. |
throws SQLException; |
180 |
* |
|
181 |
* @param index The index of the parameter to return. |
/** |
182 |
* |
* This method returns the value of the specified parameter as a Java |
183 |
* @return The parameter value as a <code>long</code>. |
* byte array. |
184 |
* |
* |
185 |
* @exception SQLException If an error occurs. |
* @param parameterIndex The index of the parameter to return. |
186 |
*/ |
* @return The parameter value as a byte array |
187 |
public abstract long |
* @exception SQLException If an error occurs. |
188 |
getLong(int index) throws SQLException; |
*/ |
189 |
|
public byte[] getBytes(int parameterIndex) throws SQLException; |
190 |
/*************************************************************************/ |
|
191 |
|
/** |
192 |
/** |
* This method returns the value of the specified parameter as a Java |
193 |
* This method returns the value of the specified parameter as a Java |
* <code>java.sql.Date</code>. |
194 |
* <code>float</code>. |
* |
195 |
* |
* @param index The index of the parameter to return. |
196 |
* @param index The index of the parameter to return. |
* @return The parameter value as a <code>java.sql.Date</code>. |
197 |
* |
* @exception SQLException If an error occurs. |
198 |
* @return The parameter value as a <code>float</code>. |
*/ |
199 |
* |
public Date getDate(int parameterIndex) throws SQLException; |
200 |
* @exception SQLException If an error occurs. |
|
201 |
*/ |
/** |
202 |
public abstract float |
* This method returns the value of the specified parameter as a Java |
203 |
getFloat(int index) throws SQLException; |
* <code>java.sql.Time</code>. |
204 |
|
* |
205 |
/*************************************************************************/ |
* @param index The index of the parameter to return. |
206 |
|
* @return The parameter value as a <code>java.sql.Time</code>. |
207 |
/** |
* @exception SQLException If an error occurs. |
208 |
* This method returns the value of the specified parameter as a Java |
*/ |
209 |
* <code>double</code>. |
public Time getTime(int parameterIndex) throws SQLException; |
210 |
* |
|
211 |
* @param index The index of the parameter to return. |
/** |
212 |
* |
* This method returns the value of the specified parameter as a Java |
213 |
* @return The parameter value as a <code>double</code>. |
* <code>java.sql.Timestamp</code>. |
214 |
* |
* |
215 |
* @exception SQLException If an error occurs. |
* @param index The index of the parameter to return. |
216 |
*/ |
* @return The parameter value as a <code>java.sql.Timestamp</code>. |
217 |
public abstract double |
* @exception SQLException If an error occurs. |
218 |
getDouble(int index) throws SQLException; |
*/ |
219 |
|
public Timestamp getTimestamp(int parameterIndex) throws SQLException; |
220 |
/*************************************************************************/ |
|
221 |
|
/** |
222 |
/** |
* This method returns the value of the specified parameter as a Java |
223 |
* This method returns the value of the specified parameter as a Java |
* <code>Object</code>. |
224 |
* <code>BigDecimal</code>. |
* |
225 |
* |
* @param parameterIndex The index of the parameter to return. |
226 |
* @param index The index of the parameter to return. |
* @return The parameter value as an <code>Object</code>. |
227 |
* |
* @exception SQLException If an error occurs. |
228 |
* @return The parameter value as a <code>BigDecimal</code>. |
* @since 1.2 |
229 |
* |
*/ |
230 |
* @exception SQLException If an error occurs. |
public Object getObject(int parameterIndex) throws SQLException; |
231 |
*/ |
|
232 |
public abstract BigDecimal |
/** |
233 |
getBigDecimal(int index) throws SQLException; |
* This method returns the value of the specified parameter as a Java |
234 |
|
* <code>BigDecimal</code>. |
235 |
/*************************************************************************/ |
* |
236 |
|
* @param parameterIndex The index of the parameter to return. |
237 |
/** |
* @return The parameter value as a <code>BigDecimal</code>. |
238 |
* This method returns the value of the specified parameter as a Java |
* @exception SQLException If an error occurs. |
239 |
* <code>BigDecimal</code>. |
* @since 1.2 |
240 |
* |
*/ |
241 |
* @param index The index of the parameter to return. |
public BigDecimal getBigDecimal(int parameterIndex) throws SQLException; |
242 |
* @param scale The number of digits to the right of the decimal to return. |
|
243 |
* |
/** |
244 |
* @return The parameter value as a <code>BigDecimal</code>. |
* This method returns the value of the specified parameter as a Java |
245 |
* |
* <code>Object</code>. |
246 |
* @exception SQLException If an error occurs. |
* |
247 |
*/ |
* @param index The index of the parameter to return. |
248 |
public abstract BigDecimal |
* @param map The mapping to use for conversion from SQL to Java types. |
249 |
getBigDecimal(int index, int scale) throws SQLException; |
* @return The parameter value as an <code>Object</code>. |
250 |
|
* @exception SQLException If an error occurs. |
251 |
/*************************************************************************/ |
* @since 1.2 |
252 |
|
*/ |
253 |
/** |
public Object getObject(int index, Map map) throws SQLException; |
254 |
* This method returns the value of the specified parameter as a Java |
|
255 |
* byte array. |
/** |
256 |
* |
* This method returns the value of the specified parameter as a Java |
257 |
* @param index The index of the parameter to return. |
* <code>Ref</code>. |
258 |
* |
* |
259 |
* @return The parameter value as a byte array |
* @param index The index of the parameter to return. |
260 |
* |
* @return The parameter value as a <code>Ref</code>. |
261 |
* @exception SQLException If an error occurs. |
* @exception SQLException If an error occurs. |
262 |
*/ |
* @since 1.2 |
263 |
public abstract byte[] |
*/ |
264 |
getBytes(int index) throws SQLException; |
public Ref getRef(int index) throws SQLException; |
265 |
|
|
266 |
/*************************************************************************/ |
/** |
267 |
|
* This method returns the value of the specified parameter as a Java |
268 |
/** |
* <code>Blob</code>. |
269 |
* This method returns the value of the specified parameter as a Java |
* |
270 |
* <code>java.sql.Date</code>. |
* @param index The index of the parameter to return. |
271 |
* |
* @return The parameter value as a <code>Blob</code>. |
272 |
* @param index The index of the parameter to return. |
* @exception SQLException If an error occurs. |
273 |
* |
* @since 1.2 |
274 |
* @return The parameter value as a <code>java.sql.Date</code>. |
*/ |
275 |
* |
public Blob getBlob(int index) throws SQLException; |
276 |
* @exception SQLException If an error occurs. |
|
277 |
*/ |
/** |
278 |
public abstract java.sql.Date |
* This method returns the value of the specified parameter as a Java |
279 |
getDate(int index) throws SQLException; |
* <code>Clob</code>. |
280 |
|
* |
281 |
/*************************************************************************/ |
* @param index The index of the parameter to return. |
282 |
|
* @return The parameter value as a <code>Clob</code>. |
283 |
/** |
* @exception SQLException If an error occurs. |
284 |
* This method returns the value of the specified parameter as a Java |
* @since 1.2 |
285 |
* <code>java.sql.Date</code>. |
*/ |
286 |
* |
public Clob getClob(int index) throws SQLException; |
287 |
* @param index The index of the parameter to return. |
|
288 |
* @param calendar The <code>Calendar</code> to use for timezone and locale. |
/** |
289 |
* |
* This method returns the value of the specified parameter as a Java |
290 |
* @return The parameter value as a <code>java.sql.Date</code>. |
* <code>Array</code>. |
291 |
* |
* |
292 |
* @exception SQLException If an error occurs. |
* @param parameterIndex The index of the parameter to return. |
293 |
*/ |
* @return The parameter value as a <code>Array</code>. |
294 |
public abstract java.sql.Date |
* @exception SQLException If an error occurs. |
295 |
getDate(int index, Calendar calendar) throws SQLException; |
* @since 1.2 |
296 |
|
*/ |
297 |
/*************************************************************************/ |
public Array getArray(int index) throws SQLException; |
298 |
|
|
299 |
/** |
/** |
300 |
* This method returns the value of the specified parameter as a Java |
* This method returns the value of the specified parameter as a Java |
301 |
* <code>java.sql.Time</code>. |
* <code>java.sql.Date</code>. |
302 |
* |
* |
303 |
* @param index The index of the parameter to return. |
* @param parameterIndex The index of the parameter to return. |
304 |
* |
* @param cal The <code>Calendar</code> to use for timezone and locale. |
305 |
* @return The parameter value as a <code>java.sql.Time</code>. |
* @return The parameter value as a <code>java.sql.Date</code>. |
306 |
* |
* @exception SQLException If an error occurs. |
307 |
* @exception SQLException If an error occurs. |
* @since 1.2 |
308 |
*/ |
*/ |
309 |
public abstract java.sql.Time |
public Date getDate(int parameterIndex, Calendar cal) throws SQLException; |
310 |
getTime(int index) throws SQLException; |
|
311 |
|
/** |
312 |
/*************************************************************************/ |
* This method returns the value of the specified parameter as a Java |
313 |
|
* <code>java.sql.Time</code>. |
314 |
/** |
* |
315 |
* This method returns the value of the specified parameter as a Java |
* @param parameterIndex The index of the parameter to return. |
316 |
* <code>java.sql.Time</code>. |
* @param cal The <code>Calendar</code> to use for timezone and locale. |
317 |
* |
* @return The parameter value as a <code>java.sql.Time</code>. |
318 |
* @param index The index of the parameter to return. |
* @exception SQLException If an error occurs. |
319 |
* @param calendar The <code>Calendar</code> to use for timezone and locale. |
* @since 1.2 |
320 |
* |
*/ |
321 |
* @return The parameter value as a <code>java.sql.Time</code>. |
public Time getTime(int parameterIndex, Calendar cal) throws SQLException; |
322 |
* |
|
323 |
* @exception SQLException If an error occurs. |
/** |
324 |
*/ |
* This method returns the value of the specified parameter as a Java |
325 |
public abstract java.sql.Time |
* <code>java.sql.Timestamp</code>. |
326 |
getTime(int index, Calendar calendar) throws SQLException; |
* |
327 |
|
* @param index The index of the parameter to return. |
328 |
/*************************************************************************/ |
* @return The parameter value as a <code>java.sql.Timestamp</code>. |
329 |
|
* @exception SQLException If an error occurs. |
330 |
/** |
* @since 1.2 |
331 |
* This method returns the value of the specified parameter as a Java |
*/ |
332 |
* <code>java.sql.Timestamp</code>. |
public Timestamp getTimestamp(int parameterIndex, Calendar cal) |
333 |
* |
throws SQLException; |
334 |
* @param index The index of the parameter to return. |
|
335 |
* |
/** |
336 |
* @return The parameter value as a <code>java.sql.Timestamp</code>. |
* This method registers the specified parameter as an output parameter |
337 |
* |
* of the specified SQL type. |
338 |
* @exception SQLException If an error occurs. |
* |
339 |
*/ |
* @param index The index of the parameter to register as output. |
340 |
public abstract java.sql.Timestamp |
* @param type The SQL type value from <code>Types</code>. |
341 |
getTimestamp(int index) throws SQLException; |
* @param name The user defined data type name. |
342 |
|
* @exception SQLException If an error occurs. |
343 |
/*************************************************************************/ |
* @since 1.2 |
344 |
|
*/ |
345 |
/** |
public void registerOutParameter(int paramIndex, int sqlType, |
346 |
* This method returns the value of the specified parameter as a Java |
String typeName) |
347 |
* <code>java.sql.Timestamp</code>. |
throws SQLException; |
348 |
* |
|
349 |
* @param index The index of the parameter to return. |
/** |
350 |
* @param calendar The <code>Calendar</code> to use for timezone and locale. |
* This method registers the specified parameter as an output parameter |
351 |
* |
* of the specified SQL type. |
352 |
* @return The parameter value as a <code>java.sql.Timestamp</code>. |
* |
353 |
* |
* @param parameterName The name of the parameter to register as output. |
354 |
* @exception SQLException If an error occurs. |
* @param sqlType The SQL type value from <code>Types</code>. |
355 |
*/ |
* @exception SQLException If an error occurs. |
356 |
public abstract java.sql.Timestamp |
* @since 1.4 |
357 |
getTimestamp(int index, Calendar calendar) throws SQLException; |
*/ |
358 |
|
public void registerOutParameter(String parameterName, int sqlType) |
359 |
/*************************************************************************/ |
throws SQLException; |
360 |
|
|
361 |
/** |
/** |
362 |
* This method returns the value of the specified parameter as a Java |
* This method registers the specified parameter as an output parameter |
363 |
* <code>Ref</code>. |
* of the specified SQL type. This version of registerOutParameter is used |
364 |
* |
* for NUMERIC or DECIMAL types. |
365 |
* @param index The index of the parameter to return. |
* |
366 |
* |
* @param parameterName The name of the parameter to register as output. |
367 |
* @return The parameter value as a <code>Ref</code>. |
* @param sqlType The SQL type value from <code>Types</code>. |
368 |
* |
* @param scale Number of digits to the right of the decimal point. |
369 |
* @exception SQLException If an error occurs. |
* @exception SQLException If an error occurs. |
370 |
*/ |
* @since 1.4 |
371 |
public abstract Ref |
*/ |
372 |
getRef(int index) throws SQLException; |
public void registerOutParameter(String parameterName, int sqlType, |
373 |
|
int scale) |
374 |
/*************************************************************************/ |
throws SQLException; |
375 |
|
|
376 |
/** |
|
377 |
* This method returns the value of the specified parameter as a Java |
/** |
378 |
* <code>Blob</code>. |
* This method registers the specified parameter as an output parameter |
379 |
* |
* of the specified SQL type. This version of registerOutParameter is used |
380 |
* @param index The index of the parameter to return. |
* for user-named or REF types. If the type of the output parameter does |
381 |
* |
* not have such a type, the typeName argument is ignored. |
382 |
* @return The parameter value as a <code>Blob</code>. |
* |
383 |
* |
* @param parameterName The name of the parameter to register as output. |
384 |
* @exception SQLException If an error occurs. |
* @param sqlType The SQL type value from <code>Types</code>. |
385 |
*/ |
* @param typeName The SQL structured type name. |
386 |
public abstract Blob |
* @exception SQLException If an error occurs. |
387 |
getBlob(int index) throws SQLException; |
* @since 1.4 |
388 |
|
*/ |
389 |
/*************************************************************************/ |
public void registerOutParameter(String parameterName, int sqlType, |
390 |
|
String typeName) |
391 |
/** |
throws SQLException; |
392 |
* This method returns the value of the specified parameter as a Java |
|
393 |
* <code>Clob</code>. |
/** |
394 |
* |
* @since 1.4 |
395 |
* @param index The index of the parameter to return. |
*/ |
396 |
* |
public URL getURL(int parameterIndex) throws SQLException; |
397 |
* @return The parameter value as a <code>Clob</code>. |
|
398 |
* |
/** |
399 |
* @exception SQLException If an error occurs. |
* @since 1.4 |
400 |
*/ |
*/ |
401 |
public abstract Clob |
public void setURL(String parameterName, URL val) throws SQLException; |
402 |
getClob(int index) throws SQLException; |
|
403 |
|
/** |
404 |
/*************************************************************************/ |
* @since 1.4 |
405 |
|
*/ |
406 |
/** |
public void setNull(String parameterName, int sqlType) throws SQLException; |
407 |
* This method returns the value of the specified parameter as a Java |
|
408 |
* <code>Array</code>. |
/** |
409 |
* |
* @since 1.4 |
410 |
* @param index The index of the parameter to return. |
*/ |
411 |
* |
public void setBoolean(String parameterName, boolean x) throws SQLException; |
412 |
* @return The parameter value as a <code>Array</code>. |
|
413 |
* |
/** |
414 |
* @exception SQLException If an error occurs. |
* @since 1.4 |
415 |
*/ |
*/ |
416 |
public abstract Array |
public void setByte(String parameterName, byte x) throws SQLException; |
417 |
getArray(int index) throws SQLException; |
|
418 |
|
/** |
419 |
/*************************************************************************/ |
* @since 1.4 |
420 |
|
*/ |
421 |
/** |
public void setShort(String parameterName, short x) throws SQLException; |
422 |
* This method registers the specified parameter as an output parameter |
|
423 |
* of the specified SQL type. |
/** |
424 |
* |
* @since 1.4 |
425 |
* @param index The index of the parameter to register as output. |
*/ |
426 |
* @param type The SQL type value from <code>Types</code>. |
public void setInt(String parameterName, int x) throws SQLException; |
427 |
* |
|
428 |
* @exception SQLException If an error occurs. |
/** |
429 |
*/ |
* @since 1.4 |
430 |
public abstract void |
*/ |
431 |
registerOutParameter(int index, int type) throws SQLException; |
public void setLong(String parameterName, long x) throws SQLException; |
432 |
|
|
433 |
/*************************************************************************/ |
/** |
434 |
|
* @since 1.4 |
435 |
/** |
*/ |
436 |
* This method registers the specified parameter as an output parameter |
public void setFloat(String parameterName, float x) throws SQLException; |
437 |
* of the specified SQL type. |
|
438 |
* |
/** |
439 |
* @param index The index of the parameter to register as output. |
* @since 1.4 |
440 |
* @param type The SQL type value from <code>Types</code>. |
*/ |
441 |
* @param name The user defined data type name. |
public void setDouble(String parameterName, double x) throws SQLException; |
442 |
* |
|
443 |
* @exception SQLException If an error occurs. |
/** |
444 |
*/ |
* @since 1.4 |
445 |
public abstract void |
*/ |
446 |
registerOutParameter(int index, int type, String name) throws SQLException; |
public void setBigDecimal(String parameterName, BigDecimal x) |
447 |
|
throws SQLException; |
448 |
/*************************************************************************/ |
|
449 |
|
/** |
450 |
/** |
* @since 1.4 |
451 |
* This method registers the specified parameter as an output parameter |
*/ |
452 |
* of the specified SQL type and scale. |
public void setString(String parameterName, String x) throws SQLException; |
453 |
* |
|
454 |
* @param index The index of the parameter to register as output. |
/** |
455 |
* @param type The SQL type value from <code>Types</code>. |
* @since 1.4 |
456 |
* @param scale The scale of the value that will be returned. |
*/ |
457 |
* |
public void setBytes(String parameterName, byte[] x) throws SQLException; |
458 |
* @exception SQLException If an error occurs. |
|
459 |
*/ |
/** |
460 |
public abstract void |
* @since 1.4 |
461 |
registerOutParameter(int index, int type, int scale) throws SQLException; |
*/ |
462 |
|
public void setDate(String parameterName, Date x) throws SQLException; |
463 |
} // interface CallableStatement |
|
464 |
|
/** |
465 |
|
* @since 1.4 |
466 |
|
*/ |
467 |
|
public void setTime(String parameterName, Time x) throws SQLException; |
468 |
|
|
469 |
|
/** |
470 |
|
* @since 1.4 |
471 |
|
*/ |
472 |
|
public void setTimestamp(String parameterName, Timestamp x) |
473 |
|
throws SQLException; |
474 |
|
|
475 |
|
/** |
476 |
|
* @since 1.4 |
477 |
|
*/ |
478 |
|
public void setAsciiStream(String parameterName, InputStream x, int length) |
479 |
|
throws SQLException; |
480 |
|
|
481 |
|
/** |
482 |
|
* @since 1.4 |
483 |
|
*/ |
484 |
|
public void setBinaryStream(String parameterName, InputStream x, int length) |
485 |
|
throws SQLException; |
486 |
|
|
487 |
|
/** |
488 |
|
* @since 1.4 |
489 |
|
*/ |
490 |
|
public void setObject(String parameterName, Object x, int targetSqlType, |
491 |
|
int scale) |
492 |
|
throws SQLException; |
493 |
|
|
494 |
|
/** |
495 |
|
* @since 1.4 |
496 |
|
*/ |
497 |
|
public void setObject(String parameterName, Object x, int targetSqlType) |
498 |
|
throws SQLException; |
499 |
|
|
500 |
|
/** |
501 |
|
* @since 1.4 |
502 |
|
*/ |
503 |
|
public void setObject(String parameterName, Object x) throws SQLException; |
504 |
|
|
505 |
|
/** |
506 |
|
* @since 1.4 |
507 |
|
*/ |
508 |
|
public void setCharacterStream(String parameterName, Reader reader, |
509 |
|
int length) |
510 |
|
throws SQLException; |
511 |
|
|
512 |
|
/** |
513 |
|
* @since 1.4 |
514 |
|
*/ |
515 |
|
public void setDate(String parameterName, Date x, Calendar cal) |
516 |
|
throws SQLException; |
517 |
|
|
518 |
|
/** |
519 |
|
* @since 1.4 |
520 |
|
*/ |
521 |
|
public void setTime(String parameterName, Time x, Calendar cal) |
522 |
|
throws SQLException; |
523 |
|
|
524 |
|
/** |
525 |
|
* @since 1.4 |
526 |
|
*/ |
527 |
|
public void setTimestamp(String parameterName, Timestamp x, Calendar cal) |
528 |
|
throws SQLException; |
529 |
|
|
530 |
|
/** |
531 |
|
* @since 1.4 |
532 |
|
*/ |
533 |
|
public void setNull(String parameterName, int sqlType, String typeName) |
534 |
|
throws SQLException; |
535 |
|
|
536 |
|
/** |
537 |
|
* @since 1.4 |
538 |
|
*/ |
539 |
|
public String getString(String parameterName) throws SQLException; |
540 |
|
|
541 |
|
/** |
542 |
|
* @since 1.4 |
543 |
|
*/ |
544 |
|
public boolean getBoolean(String parameterName) throws SQLException; |
545 |
|
|
546 |
|
/** |
547 |
|
* @since 1.4 |
548 |
|
*/ |
549 |
|
public byte getByte(String parameterName) throws SQLException; |
550 |
|
|
551 |
|
/** |
552 |
|
* @since 1.4 |
553 |
|
*/ |
554 |
|
public short getShort(String parameterName) throws SQLException; |
555 |
|
|
556 |
|
/** |
557 |
|
* @since 1.4 |
558 |
|
*/ |
559 |
|
public int getInt(String parameterName) throws SQLException; |
560 |
|
|
561 |
|
/** |
562 |
|
* @since 1.4 |
563 |
|
*/ |
564 |
|
public long getLong(String parameterName) throws SQLException; |
565 |
|
|
566 |
|
/** |
567 |
|
* @since 1.4 |
568 |
|
*/ |
569 |
|
public float getFloat(String parameterName) throws SQLException; |
570 |
|
|
571 |
|
/** |
572 |
|
* @since 1.4 |
573 |
|
*/ |
574 |
|
public double getDouble(String parameterName) throws SQLException; |
575 |
|
|
576 |
|
/** |
577 |
|
* @since 1.4 |
578 |
|
*/ |
579 |
|
public byte[] getBytes(String parameterName) throws SQLException; |
580 |
|
|
581 |
|
/** |
582 |
|
* @since 1.4 |
583 |
|
*/ |
584 |
|
public Date getDate(String parameterName) throws SQLException; |
585 |
|
|
586 |
|
/** |
587 |
|
* @since 1.4 |
588 |
|
*/ |
589 |
|
public Time getTime(String parameterName) throws SQLException; |
590 |
|
|
591 |
|
/** |
592 |
|
* @since 1.4 |
593 |
|
*/ |
594 |
|
public Timestamp getTimestamp(String parameterName) throws SQLException; |
595 |
|
|
596 |
|
/** |
597 |
|
* @since 1.4 |
598 |
|
*/ |
599 |
|
public Object getObject(String parameterName) throws SQLException; |
600 |
|
|
601 |
|
/** |
602 |
|
* @since 1.4 |
603 |
|
*/ |
604 |
|
public BigDecimal getBigDecimal(String parameterName) throws SQLException; |
605 |
|
|
606 |
|
/** |
607 |
|
* @since 1.4 |
608 |
|
*/ |
609 |
|
public Object getObject(String parameterName, Map map) throws SQLException; |
610 |
|
|
611 |
|
/** |
612 |
|
* @since 1.4 |
613 |
|
*/ |
614 |
|
public Ref getRef(String parameterName) throws SQLException; |
615 |
|
|
616 |
|
/** |
617 |
|
* @since 1.4 |
618 |
|
*/ |
619 |
|
public Blob getBlob(String parameterName) throws SQLException; |
620 |
|
|
621 |
|
/** |
622 |
|
* @since 1.4 |
623 |
|
*/ |
624 |
|
public Clob getClob(String parameterName) throws SQLException; |
625 |
|
|
626 |
|
/** |
627 |
|
* @since 1.4 |
628 |
|
*/ |
629 |
|
public Array getArray(String parameterName) throws SQLException; |
630 |
|
|
631 |
|
/** |
632 |
|
* @since 1.4 |
633 |
|
*/ |
634 |
|
public Date getDate(String parameterName, Calendar cal) throws SQLException; |
635 |
|
|
636 |
|
/** |
637 |
|
* @since 1.4 |
638 |
|
*/ |
639 |
|
public Time getTime(String parameterName, Calendar cal) throws SQLException; |
640 |
|
|
641 |
|
/** |
642 |
|
* @since 1.4 |
643 |
|
*/ |
644 |
|
public Timestamp getTimestamp(String parameterName, Calendar cal) |
645 |
|
throws SQLException; |
646 |
|
|
647 |
|
/** |
648 |
|
* @since 1.4 |
649 |
|
*/ |
650 |
|
public URL getURL(String parameterName) throws SQLException; |
651 |
|
} |