166 * determines whether an element in this array is an <code>Object</code> or an array. |
166 * determines whether an element in this array is an <code>Object</code> or an array. |
167 * <P> |
167 * <P> |
168 * The majority of methods for setting placeholder parameters take two parameters, |
168 * The majority of methods for setting placeholder parameters take two parameters, |
169 * with the first parameter |
169 * with the first parameter |
170 * indicating which placeholder parameter is to be set, and the second parameter |
170 * indicating which placeholder parameter is to be set, and the second parameter |
171 * giving the value to be set. Methods such as <code>getInt</code>, |
171 * giving the value to be set. Methods such as <code>setInt</code>, |
172 * <code>getString</code>, <code>getBoolean</code>, and <code>getLong</code> fall into |
172 * <code>setString</code>, <code>setBoolean</code>, and <code>setLong</code> fall into |
173 * this category. After these methods have been called, a call to the method |
173 * this category. After these methods have been called, a call to the method |
174 * <code>getParams</code> will return an array with the values that have been set. Each |
174 * <code>getParams</code> will return an array with the values that have been set. Each |
175 * element in the array is an <code>Object</code> instance representing the |
175 * element in the array is an <code>Object</code> instance representing the |
176 * values that have been set. The order of these values in the array is determined by the |
176 * values that have been set. The order of these values in the array is determined by the |
177 * <code>int</code> (the first parameter) passed to the setter method. The values in the |
177 * <code>int</code> (the first parameter) passed to the setter method. The values in the |
3257 * |
3257 * |
3258 * @param parameterName the name of the parameter |
3258 * @param parameterName the name of the parameter |
3259 * @param x the parameter value |
3259 * @param x the parameter value |
3260 * @exception SQLException if a database access error occurs or |
3260 * @exception SQLException if a database access error occurs or |
3261 * this method is called on a closed <code>CallableStatement</code> |
3261 * this method is called on a closed <code>CallableStatement</code> |
3262 * @see #getBoolean |
|
3263 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3262 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3264 * this method |
3263 * this method |
|
3264 * @see #getParams |
3265 * @since 1.4 |
3265 * @since 1.4 |
3266 */ |
3266 */ |
3267 public void setBoolean(String parameterName, boolean x) throws SQLException{ |
3267 public void setBoolean(String parameterName, boolean x) throws SQLException{ |
3268 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3268 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3269 } |
3269 } |
3279 * @param x the parameter value |
3279 * @param x the parameter value |
3280 * @exception SQLException if a database access error occurs or |
3280 * @exception SQLException if a database access error occurs or |
3281 * this method is called on a closed <code>CallableStatement</code> |
3281 * this method is called on a closed <code>CallableStatement</code> |
3282 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3282 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3283 * this method |
3283 * this method |
3284 * @see #getByte |
3284 * @see #getParams |
3285 * @since 1.4 |
3285 * @since 1.4 |
3286 */ |
3286 */ |
3287 public void setByte(String parameterName, byte x) throws SQLException{ |
3287 public void setByte(String parameterName, byte x) throws SQLException{ |
3288 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3288 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3289 } |
3289 } |
3299 * @param x the parameter value |
3299 * @param x the parameter value |
3300 * @exception SQLException if a database access error occurs or |
3300 * @exception SQLException if a database access error occurs or |
3301 * this method is called on a closed <code>CallableStatement</code> |
3301 * this method is called on a closed <code>CallableStatement</code> |
3302 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3302 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3303 * this method |
3303 * this method |
3304 * @see #getShort |
3304 * @see #getParams |
3305 * @since 1.4 |
3305 * @since 1.4 |
3306 */ |
3306 */ |
3307 public void setShort(String parameterName, short x) throws SQLException{ |
3307 public void setShort(String parameterName, short x) throws SQLException{ |
3308 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3308 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3309 } |
3309 } |
3318 * @param x the parameter value |
3318 * @param x the parameter value |
3319 * @exception SQLException if a database access error occurs or |
3319 * @exception SQLException if a database access error occurs or |
3320 * this method is called on a closed <code>CallableStatement</code> |
3320 * this method is called on a closed <code>CallableStatement</code> |
3321 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3321 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3322 * this method |
3322 * this method |
3323 * @see #getInt |
3323 * @see #getParams |
3324 * @since 1.4 |
3324 * @since 1.4 |
3325 */ |
3325 */ |
3326 public void setInt(String parameterName, int x) throws SQLException{ |
3326 public void setInt(String parameterName, int x) throws SQLException{ |
3327 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3327 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3328 } |
3328 } |
3337 * @param x the parameter value |
3337 * @param x the parameter value |
3338 * @exception SQLException if a database access error occurs or |
3338 * @exception SQLException if a database access error occurs or |
3339 * this method is called on a closed <code>CallableStatement</code> |
3339 * this method is called on a closed <code>CallableStatement</code> |
3340 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3340 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3341 * this method |
3341 * this method |
3342 * @see #getLong |
3342 * @see #getParams |
3343 * @since 1.4 |
3343 * @since 1.4 |
3344 */ |
3344 */ |
3345 public void setLong(String parameterName, long x) throws SQLException{ |
3345 public void setLong(String parameterName, long x) throws SQLException{ |
3346 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3346 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3347 } |
3347 } |
3356 * @param x the parameter value |
3356 * @param x the parameter value |
3357 * @exception SQLException if a database access error occurs or |
3357 * @exception SQLException if a database access error occurs or |
3358 * this method is called on a closed <code>CallableStatement</code> |
3358 * this method is called on a closed <code>CallableStatement</code> |
3359 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3359 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3360 * this method |
3360 * this method |
3361 * @see #getFloat |
3361 * @see #getParams |
3362 * @since 1.4 |
3362 * @since 1.4 |
3363 */ |
3363 */ |
3364 public void setFloat(String parameterName, float x) throws SQLException{ |
3364 public void setFloat(String parameterName, float x) throws SQLException{ |
3365 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3365 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3366 } |
3366 } |
3375 * @param x the parameter value |
3375 * @param x the parameter value |
3376 * @exception SQLException if a database access error occurs or |
3376 * @exception SQLException if a database access error occurs or |
3377 * this method is called on a closed <code>CallableStatement</code> |
3377 * this method is called on a closed <code>CallableStatement</code> |
3378 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3378 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3379 * this method |
3379 * this method |
3380 * @see #getDouble |
3380 * @see #getParams |
3381 * @since 1.4 |
3381 * @since 1.4 |
3382 */ |
3382 */ |
3383 public void setDouble(String parameterName, double x) throws SQLException{ |
3383 public void setDouble(String parameterName, double x) throws SQLException{ |
3384 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3384 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3385 } |
3385 } |
3396 * @param x the parameter value |
3396 * @param x the parameter value |
3397 * @exception SQLException if a database access error occurs or |
3397 * @exception SQLException if a database access error occurs or |
3398 * this method is called on a closed <code>CallableStatement</code> |
3398 * this method is called on a closed <code>CallableStatement</code> |
3399 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3399 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3400 * this method |
3400 * this method |
3401 * @see #getBigDecimal |
3401 * @see #getParams |
3402 * @since 1.4 |
3402 * @since 1.4 |
3403 */ |
3403 */ |
3404 public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException{ |
3404 public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException{ |
3405 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3405 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3406 } |
3406 } |
3419 * @param x the parameter value |
3419 * @param x the parameter value |
3420 * @exception SQLException if a database access error occurs or |
3420 * @exception SQLException if a database access error occurs or |
3421 * this method is called on a closed <code>CallableStatement</code> |
3421 * this method is called on a closed <code>CallableStatement</code> |
3422 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3422 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3423 * this method |
3423 * this method |
3424 * @see #getString |
3424 * @see #getParams |
3425 * @since 1.4 |
3425 * @since 1.4 |
3426 */ |
3426 */ |
3427 public void setString(String parameterName, String x) throws SQLException{ |
3427 public void setString(String parameterName, String x) throws SQLException{ |
3428 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3428 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3429 } |
3429 } |
3441 * @param x the parameter value |
3441 * @param x the parameter value |
3442 * @exception SQLException if a database access error occurs or |
3442 * @exception SQLException if a database access error occurs or |
3443 * this method is called on a closed <code>CallableStatement</code> |
3443 * this method is called on a closed <code>CallableStatement</code> |
3444 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3444 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3445 * this method |
3445 * this method |
3446 * @see #getBytes |
3446 * @see #getParams |
3447 * @since 1.4 |
3447 * @since 1.4 |
3448 */ |
3448 */ |
3449 public void setBytes(String parameterName, byte x[]) throws SQLException{ |
3449 public void setBytes(String parameterName, byte x[]) throws SQLException{ |
3450 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3450 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3451 } |
3451 } |
3462 * @param x the parameter value |
3462 * @param x the parameter value |
3463 * @exception SQLException if a database access error occurs or |
3463 * @exception SQLException if a database access error occurs or |
3464 * this method is called on a closed <code>CallableStatement</code> |
3464 * this method is called on a closed <code>CallableStatement</code> |
3465 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3465 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3466 * this method |
3466 * this method |
3467 * @see #getTimestamp |
3467 * @see #getParams |
3468 * @since 1.4 |
3468 * @since 1.4 |
3469 */ |
3469 */ |
3470 public void setTimestamp(String parameterName, java.sql.Timestamp x) |
3470 public void setTimestamp(String parameterName, java.sql.Timestamp x) |
3471 throws SQLException{ |
3471 throws SQLException{ |
3472 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3472 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3710 * <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, |
3710 * <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, |
3711 * <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> |
3711 * <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> |
3712 * or <code>STRUCT</code> data type and the JDBC driver does not support |
3712 * or <code>STRUCT</code> data type and the JDBC driver does not support |
3713 * this data type |
3713 * this data type |
3714 * @see Types |
3714 * @see Types |
3715 * @see #getObject |
3715 * @see #getParams |
3716 * @since 1.4 |
3716 * @since 1.4 |
3717 */ |
3717 */ |
3718 public void setObject(String parameterName, Object x, int targetSqlType, int scale) |
3718 public void setObject(String parameterName, Object x, int targetSqlType, int scale) |
3719 throws SQLException{ |
3719 throws SQLException{ |
3720 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3720 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3738 * <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>, |
3738 * <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>, |
3739 * <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, |
3739 * <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, |
3740 * <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> |
3740 * <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> |
3741 * or <code>STRUCT</code> data type and the JDBC driver does not support |
3741 * or <code>STRUCT</code> data type and the JDBC driver does not support |
3742 * this data type |
3742 * this data type |
3743 * @see #getObject |
3743 * @see #getParams |
3744 * @since 1.4 |
3744 * @since 1.4 |
3745 */ |
3745 */ |
3746 public void setObject(String parameterName, Object x, int targetSqlType) |
3746 public void setObject(String parameterName, Object x, int targetSqlType) |
3747 throws SQLException{ |
3747 throws SQLException{ |
3748 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3748 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3780 * @exception SQLException if a database access error occurs, |
3780 * @exception SQLException if a database access error occurs, |
3781 * this method is called on a closed <code>CallableStatement</code> or if the given |
3781 * this method is called on a closed <code>CallableStatement</code> or if the given |
3782 * <code>Object</code> parameter is ambiguous |
3782 * <code>Object</code> parameter is ambiguous |
3783 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3783 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
3784 * this method |
3784 * this method |
3785 * @see #getObject |
3785 * @see #getParams |
3786 * @since 1.4 |
3786 * @since 1.4 |
3787 */ |
3787 */ |
3788 public void setObject(String parameterName, Object x) throws SQLException{ |
3788 public void setObject(String parameterName, Object x) throws SQLException{ |
3789 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3789 throw new SQLFeatureNotSupportedException("Feature not supported"); |
3790 } |
3790 } |
4062 * @param x the parameter value |
4062 * @param x the parameter value |
4063 * @exception SQLException if a database access error occurs or |
4063 * @exception SQLException if a database access error occurs or |
4064 * this method is called on a closed <code>CallableStatement</code> |
4064 * this method is called on a closed <code>CallableStatement</code> |
4065 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4065 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4066 * this method |
4066 * this method |
4067 * @see #getDate |
4067 * @see #getParams |
4068 * @since 1.4 |
4068 * @since 1.4 |
4069 */ |
4069 */ |
4070 public void setDate(String parameterName, java.sql.Date x) |
4070 public void setDate(String parameterName, java.sql.Date x) |
4071 throws SQLException{ |
4071 throws SQLException{ |
4072 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4072 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4089 * to construct the date |
4089 * to construct the date |
4090 * @exception SQLException if a database access error occurs or |
4090 * @exception SQLException if a database access error occurs or |
4091 * this method is called on a closed <code>CallableStatement</code> |
4091 * this method is called on a closed <code>CallableStatement</code> |
4092 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4092 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4093 * this method |
4093 * this method |
4094 * @see #getDate |
4094 * @see #getParams |
4095 * @since 1.4 |
4095 * @since 1.4 |
4096 */ |
4096 */ |
4097 public void setDate(String parameterName, java.sql.Date x, Calendar cal) |
4097 public void setDate(String parameterName, java.sql.Date x, Calendar cal) |
4098 throws SQLException{ |
4098 throws SQLException{ |
4099 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4099 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4109 * @param x the parameter value |
4109 * @param x the parameter value |
4110 * @exception SQLException if a database access error occurs or |
4110 * @exception SQLException if a database access error occurs or |
4111 * this method is called on a closed <code>CallableStatement</code> |
4111 * this method is called on a closed <code>CallableStatement</code> |
4112 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4112 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4113 * this method |
4113 * this method |
4114 * @see #getTime |
4114 * @see #getParams |
4115 * @since 1.4 |
4115 * @since 1.4 |
4116 */ |
4116 */ |
4117 public void setTime(String parameterName, java.sql.Time x) |
4117 public void setTime(String parameterName, java.sql.Time x) |
4118 throws SQLException{ |
4118 throws SQLException{ |
4119 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4119 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4136 * to construct the time |
4136 * to construct the time |
4137 * @exception SQLException if a database access error occurs or |
4137 * @exception SQLException if a database access error occurs or |
4138 * this method is called on a closed <code>CallableStatement</code> |
4138 * this method is called on a closed <code>CallableStatement</code> |
4139 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4139 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4140 * this method |
4140 * this method |
4141 * @see #getTime |
4141 * @see #getParams |
4142 * @since 1.4 |
4142 * @since 1.4 |
4143 */ |
4143 */ |
4144 public void setTime(String parameterName, java.sql.Time x, Calendar cal) |
4144 public void setTime(String parameterName, java.sql.Time x, Calendar cal) |
4145 throws SQLException{ |
4145 throws SQLException{ |
4146 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4146 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4163 * to construct the timestamp |
4163 * to construct the timestamp |
4164 * @exception SQLException if a database access error occurs or |
4164 * @exception SQLException if a database access error occurs or |
4165 * this method is called on a closed <code>CallableStatement</code> |
4165 * this method is called on a closed <code>CallableStatement</code> |
4166 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4166 * @exception SQLFeatureNotSupportedException if the JDBC driver does not support |
4167 * this method |
4167 * this method |
4168 * @see #getTimestamp |
4168 * @see #getParams |
4169 * @since 1.4 |
4169 * @since 1.4 |
4170 */ |
4170 */ |
4171 public void setTimestamp(String parameterName, java.sql.Timestamp x, Calendar cal) |
4171 public void setTimestamp(String parameterName, java.sql.Timestamp x, Calendar cal) |
4172 throws SQLException{ |
4172 throws SQLException{ |
4173 throw new SQLFeatureNotSupportedException("Feature not supported"); |
4173 throw new SQLFeatureNotSupportedException("Feature not supported"); |