|
|
Glassfish example source code file (ResultSetWrapper40.java)
This example Glassfish source code file (ResultSetWrapper40.java) is included in the DevDaily.com
"Java Source Code
Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.
The Glassfish ResultSetWrapper40.java source code
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 1997-2010 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
* or packager/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at packager/legal/LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package com.sun.gjc.spi.jdbc40;
import com.sun.enterprise.util.i18n.StringManager;
import com.sun.gjc.spi.ManagedConnectionFactory;
import com.sun.gjc.spi.base.ResultSetWrapper;
import java.io.InputStream;
import java.io.Reader;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;
import java.sql.*;
/**
* Wrapper for ResultSet
*/
public class ResultSetWrapper40 extends ResultSetWrapper {
protected final static StringManager localStrings =
StringManager.getManager(ManagedConnectionFactory.class);
/**
* Creates a new instance of ResultSetWrapper for JDBC 4.0
*
* @param stmt Statement that is to be wrapped<br>
* @param rs ResultSet that is to be wraped<br>*
*/
public ResultSetWrapper40(Statement stmt, ResultSet rs) {
super(stmt, rs);
}
/**
* Retrieves the value of the designated column in the current row of this
* <code>ResultSet object as a java.sql.RowId object in the Java
* programming language.
*
* @param columnIndex the first column is 1, the second 2, ...
* @return the column value; if the value is a SQL <code>NULL the
* value returned is <code>null
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public RowId getRowId(int columnIndex) throws SQLException {
return resultSet.getRowId(columnIndex);
}
/**
* Retrieves the value of the designated column in the current row of this
* <code>ResultSet object as a java.sql.RowId object in the Java
* programming language.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @return the column value ; if the value is a SQL <code>NULL the
* value returned is <code>null
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public RowId getRowId(String columnLabel) throws SQLException {
return resultSet.getRowId(columnLabel);
}
/**
* Updates the designated column with a <code>RowId value. The updater
* methods are used to update column values in the current row or the insert
* row. The updater methods do not update the underlying database; instead
* the <code>updateRow or insertRow methods are called
* to update the database.
*
* @param columnIndex the first column is 1, the second 2, ...
* @param x the column value
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateRowId(int columnIndex, RowId x) throws SQLException {
resultSet.updateRowId(columnIndex, x);
}
/**
* Updates the designated column with a <code>RowId value. The updater
* methods are used to update column values in the current row or the insert
* row. The updater methods do not update the underlying database; instead
* the <code>updateRow or insertRow methods are called
* to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was
* not specified, then the label is the name of the column
* @param x the column value
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateRowId(String columnLabel, RowId x) throws SQLException {
resultSet.updateRowId(columnLabel, x);
}
/**
* Retrieves the holdability of this <code>ResultSet object
*
* @return either <code>ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
* @throws SQLException if a database access error occurs
* or this method is called on a closed result set
* @since 1.6
*/
public int getHoldability() throws SQLException {
return resultSet.getHoldability();
}
/**
* Retrieves whether this <code>ResultSet object has been closed. A ResultSet is closed if the
* method close has been called on it, or if it is automatically closed.
*
* @return true if this <code>ResultSet object is closed; false if it is still open
* @throws SQLException if a database access error occurs
* @since 1.6
*/
public boolean isClosed() throws SQLException {
return resultSet.isClosed();
}
/**
* Updates the designated column with a <code>String value.
* It is intended for use when updating <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second 2, ...
* @param nString the value for the column to be updated
* @throws SQLException if the columnIndex is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or if a database access error occurs
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNString(int columnIndex, String nString) throws SQLException {
resultSet.updateNString(columnIndex, nString);
}
/**
* Updates the designated column with a <code>String value.
* It is intended for use when updating <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param nString the value for the column to be updated
* @throws SQLException if the columnLabel is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set;
* the result set concurrency is <CODE>CONCUR_READ_ONLY
* or if a database access error occurs
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNString(String columnLabel, String nString) throws SQLException {
resultSet.updateNString(columnLabel, nString);
}
/**
* Updates the designated column with a <code>java.sql.NClob value.
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second 2, ...
* @param nClob the value for the column to be updated
* @throws SQLException if the columnIndex is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set;
* if a database access error occurs or
* the result set concurrency is <code>CONCUR_READ_ONLY
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNClob(int columnIndex, NClob nClob) throws SQLException {
resultSet.updateNClob(columnIndex, nClob);
}
/**
* Updates the designated column with a <code>java.sql.NClob value.
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param nClob the value for the column to be updated
* @throws SQLException if the columnLabel is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set;
* if a database access error occurs or
* the result set concurrency is <code>CONCUR_READ_ONLY
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNClob(String columnLabel, NClob nClob) throws SQLException {
resultSet.updateNClob(columnLabel, nClob);
}
/**
* Retrieves the value of the designated column in the current row
* of this <code>ResultSet object as a NClob object
* in the Java programming language.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @return a <code>NClob object representing the SQL
* <code>NCLOB value in the specified column
* @throws SQLException if the columnIndex is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set
* or if a database access error occurs
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public NClob getNClob(int columnIndex) throws SQLException {
return resultSet.getNClob(columnIndex);
}
/**
* Retrieves the value of the designated column in the current row
* of this <code>ResultSet object as a NClob object
* in the Java programming language.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @return a <code>NClob object representing the SQL NCLOB
* value in the specified column
* @throws SQLException if the columnLabel is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set
* or if a database access error occurs
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public NClob getNClob(String columnLabel) throws SQLException {
return resultSet.getNClob(columnLabel);
}
/**
* Retrieves the value of the designated column in the current row of
* this <code>ResultSet as a
* <code>java.sql.SQLXML object in the Java programming language.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @return a <code>SQLXML object that maps an SQL XML value
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public SQLXML getSQLXML(int columnIndex) throws SQLException {
return resultSet.getSQLXML(columnIndex);
}
/**
* Retrieves the value of the designated column in the current row of
* this <code>ResultSet as a
* <code>java.sql.SQLXML object in the Java programming language.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @return a <code>SQLXML object that maps an SQL XML value
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public SQLXML getSQLXML(String columnLabel) throws SQLException {
return resultSet.getSQLXML(columnLabel);
}
/**
* Updates the designated column with a <code>java.sql.SQLXML value.
* The updater
* methods are used to update column values in the current row or the insert
* row. The updater methods do not update the underlying database; instead
* the <code>updateRow or insertRow methods are called
* to update the database.
* <p/>
*
* @param columnIndex the first column is 1, the second 2, ...
* @param xmlObject the value for the column to be updated
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs; this method
* is called on a closed result set;
* the <code>java.xml.transform.Result,
* <code>Writer or OutputStream has not been closed
* for the <code>SQLXML object;
* if there is an error processing the XML value or
* the result set concurrency is <code>CONCUR_READ_ONLY. The getCause method
* of the exception may provide a more detailed exception, for example, if the
* stream does not contain valid XML.
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException {
resultSet.updateSQLXML(columnIndex, xmlObject);
}
/**
* Updates the designated column with a <code>java.sql.SQLXML value.
* The updater
* methods are used to update column values in the current row or the insert
* row. The updater methods do not update the underlying database; instead
* the <code>updateRow or insertRow methods are called
* to update the database.
* <p/>
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param xmlObject the column value
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs; this method
* is called on a closed result set;
* the <code>java.xml.transform.Result,
* <code>Writer or OutputStream has not been closed
* for the <code>SQLXML object;
* if there is an error processing the XML value or
* the result set concurrency is <code>CONCUR_READ_ONLY. The getCause method
* of the exception may provide a more detailed exception, for example, if the
* stream does not contain valid XML.
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException {
resultSet.updateSQLXML(columnLabel, xmlObject);
}
/**
* Retrieves the value of the designated column in the current row
* of this <code>ResultSet object as
* a <code>String in the Java programming language.
* It is intended for use when
* accessing <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @return the column value; if the value is SQL <code>NULL, the
* value returned is <code>null
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public String getNString(int columnIndex) throws SQLException {
return resultSet.getNString(columnIndex);
}
/**
* Retrieves the value of the designated column in the current row
* of this <code>ResultSet object as
* a <code>String in the Java programming language.
* It is intended for use when
* accessing <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @return the column value; if the value is SQL <code>NULL, the
* value returned is <code>null
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public String getNString(String columnLabel) throws SQLException {
return resultSet.getNString(columnLabel);
}
/**
* Retrieves the value of the designated column in the current row
* of this <code>ResultSet object as a
* <code>java.io.Reader object.
* It is intended for use when
* accessing <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @return a <code>java.io.Reader object that contains the column
* value; if the value is SQL <code>NULL, the value returned is
* <code>null in the Java programming language.
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public Reader getNCharacterStream(int columnIndex) throws SQLException {
return resultSet.getNCharacterStream(columnIndex);
}
/**
* Retrieves the value of the designated column in the current row
* of this <code>ResultSet object as a
* <code>java.io.Reader object.
* It is intended for use when
* accessing <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @return a <code>java.io.Reader object that contains the column
* value; if the value is SQL <code>NULL, the value returned is
* <code>null in the Java programming language
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public Reader getNCharacterStream(String columnLabel) throws SQLException {
return resultSet.getNCharacterStream(columnLabel);
}
/**
* Updates the designated column with a character stream value, which will have
* the specified number of bytes. The
* driver does the necessary conversion from Java character format to
* the national character set in the database.
* It is intended for use when
* updating <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @param length the length of the stream
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException {
resultSet.updateNCharacterStream(columnIndex, x, length);
}
/**
* Updates the designated column with a character stream value, which will have
* the specified number of bytes. The
* driver does the necessary conversion from Java character format to
* the national character set in the database.
* It is intended for use when
* updating <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param reader the <code>java.io.Reader object containing
* the new column value
* @param length the length of the stream
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException {
resultSet.updateNCharacterStream(columnLabel, reader, length);
}
/**
* Updates the designated column with an ascii stream value, which will have
* the specified number of bytes.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @param length the length of the stream
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException {
resultSet.updateAsciiStream(columnIndex, x, length);
}
/**
* Updates the designated column with a binary stream value, which will have
* the specified number of bytes.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @param length the length of the stream
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException {
resultSet.updateBinaryStream(columnIndex, x, length);
}
/**
* Updates the designated column with a character stream value, which will have
* the specified number of bytes.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @param length the length of the stream
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException {
resultSet.updateCharacterStream(columnIndex, x, length);
}
/**
* Updates the designated column with an ascii stream value, which will have
* the specified number of bytes.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param x the new column value
* @param length the length of the stream
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException {
resultSet.updateAsciiStream(columnLabel, x, length);
}
/**
* Updates the designated column with a binary stream value, which will have
* the specified number of bytes.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param x the new column value
* @param length the length of the stream
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException {
resultSet.updateBinaryStream(columnLabel, x, length);
}
/**
* Updates the designated column with a character stream value, which will have
* the specified number of bytes.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param reader the <code>java.io.Reader object containing
* the new column value
* @param length the length of the stream
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException {
resultSet.updateCharacterStream(columnLabel, reader, length);
}
/**
* Updates the designated column using the given input stream, which
* will have the specified number of bytes.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param inputStream An object that contains the data to set the parameter
* value to.
* @param length the number of bytes in the parameter data.
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException {
resultSet.updateBlob(columnIndex, inputStream, length);
}
/**
* Updates the designated column using the given input stream, which
* will have the specified number of bytes.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param inputStream An object that contains the data to set the parameter
* value to.
* @param length the number of bytes in the parameter data.
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException {
resultSet.updateBlob(columnLabel, inputStream, length);
}
/**
* Updates the designated column using the given <code>Reader
* object, which is the given number of characters long.
* When a very large UNICODE value is input to a <code>LONGVARCHAR
* parameter, it may be more practical to send it via a
* <code>java.io.Reader object. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param reader An object that contains the data to set the parameter value to.
* @param length the number of characters in the parameter data.
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateClob(int columnIndex, Reader reader, long length) throws SQLException {
resultSet.updateClob(columnIndex, reader, length);
}
/**
* Updates the designated column using the given <code>Reader
* object, which is the given number of characters long.
* When a very large UNICODE value is input to a <code>LONGVARCHAR
* parameter, it may be more practical to send it via a
* <code>java.io.Reader object. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was
* not specified, then the label is the name of the column
* @param reader An object that contains the data to set the parameter value to.
* @param length the number of characters in the parameter data.
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateClob(String columnLabel, Reader reader, long length) throws SQLException {
resultSet.updateClob(columnLabel, reader, length);
}
/**
* Updates the designated column using the given <code>Reader
* object, which is the given number of characters long.
* When a very large UNICODE value is input to a <code>LONGVARCHAR
* parameter, it may be more practical to send it via a
* <code>java.io.Reader object. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnIndex the first column is 1, the second 2, ...
* @param reader An object that contains the data to set the parameter value to.
* @param length the number of characters in the parameter data.
* @throws SQLException if the columnIndex is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set,
* if a database access error occurs or
* the result set concurrency is <code>CONCUR_READ_ONLY
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException {
resultSet.updateNClob(columnIndex, reader, length);
}
/**
* Updates the designated column using the given <code>Reader
* object, which is the given number of characters long.
* When a very large UNICODE value is input to a <code>LONGVARCHAR
* parameter, it may be more practical to send it via a
* <code>java.io.Reader object. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param reader An object that contains the data to set the parameter value to.
* @param length the number of characters in the parameter data.
* @throws SQLException if the columnLabel is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set;
* if a database access error occurs or
* the result set concurrency is <code>CONCUR_READ_ONLY
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException {
resultSet.updateNClob(columnLabel, reader, length);
}
/**
* Updates the designated column with a character stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached. The
* driver does the necessary conversion from Java character format to
* the national character set in the database.
* It is intended for use when
* updating <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateNCharacterStream which takes a length parameter.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNCharacterStream(int columnIndex, Reader x) throws SQLException {
resultSet.updateNCharacterStream(columnIndex, x);
}
/**
* Updates the designated column with a character stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached. The
* driver does the necessary conversion from Java character format to
* the national character set in the database.
* It is intended for use when
* updating <code>NCHAR,NVARCHAR
* and <code>LONGNVARCHAR columns.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateNCharacterStream which takes a length parameter.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param reader the <code>java.io.Reader object containing
* the new column value
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException {
resultSet.updateNCharacterStream(columnLabel, reader);
}
/**
* Updates the designated column with an ascii stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateAsciiStream which takes a length parameter.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateAsciiStream(int columnIndex, InputStream x) throws SQLException {
resultSet.updateAsciiStream(columnIndex, x);
}
/**
* Updates the designated column with a binary stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateBinaryStream which takes a length parameter.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBinaryStream(int columnIndex, InputStream x) throws SQLException {
resultSet.updateBinaryStream(columnIndex, x);
}
/**
* Updates the designated column with a character stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateCharacterStream which takes a length parameter.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param x the new column value
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateCharacterStream(int columnIndex, Reader x) throws SQLException {
resultSet.updateCharacterStream(columnIndex, x);
}
/**
* Updates the designated column with an ascii stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateAsciiStream which takes a length parameter.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param x the new column value
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateAsciiStream(String columnLabel, InputStream x) throws SQLException {
resultSet.updateAsciiStream(columnLabel, x);
}
/**
* Updates the designated column with a binary stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateBinaryStream which takes a length parameter.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param x the new column value
* @throws SQLException if the columnLabel is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBinaryStream(String columnLabel, InputStream x) throws SQLException {
resultSet.updateBinaryStream(columnLabel, x);
}
/**
* Updates the designated column with a character stream value.
* The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateCharacterStream which takes a length parameter.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param reader the <code>java.io.Reader object containing
* the new column value
* @throws SQLException if the columnLabel is not valid; if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateCharacterStream(String columnLabel, Reader reader) throws SQLException {
resultSet.updateCharacterStream(columnLabel, reader);
}
/**
* Updates the designated column using the given input stream. The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateBlob which takes a length parameter.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param inputStream An object that contains the data to set the parameter
* value to.
* @throws SQLException if the columnIndex is not valid; if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException {
resultSet.updateBlob(columnIndex, inputStream);
}
/**
* Updates the designated column using the given input stream. The data will be read from the stream
* as needed until end-of-stream is reached.
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateBlob which takes a length parameter.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param inputStream An object that contains the data to set the parameter
* value to.
* @throws SQLException if the columnLabel is not valid; if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException {
resultSet.updateBlob(columnLabel, inputStream);
}
/**
* Updates the designated column using the given <code>Reader
* object.
* The data will be read from the stream
* as needed until end-of-stream is reached. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateClob which takes a length parameter.
*
* @param columnIndex the first column is 1, the second is 2, ...
* @param reader An object that contains the data to set the parameter value to.
* @throws SQLException if the columnIndex is not valid;
* if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateClob(int columnIndex, Reader reader) throws SQLException {
resultSet.updateClob(columnIndex, reader);
}
/**
* Updates the designated column using the given <code>Reader
* object.
* The data will be read from the stream
* as needed until end-of-stream is reached. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateClob which takes a length parameter.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param reader An object that contains the data to set the parameter value to.
* @throws SQLException if the columnLabel is not valid; if a database access error occurs;
* the result set concurrency is <code>CONCUR_READ_ONLY
* or this method is called on a closed result set
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateClob(String columnLabel, Reader reader) throws SQLException {
resultSet.updateClob(columnLabel, reader);
}
/**
* Updates the designated column using the given <code>Reader
* <p/>
* The data will be read from the stream
* as needed until end-of-stream is reached. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateNClob which takes a length parameter.
*
* @param columnIndex the first column is 1, the second 2, ...
* @param reader An object that contains the data to set the parameter value to.
* @throws SQLException if the columnIndex is not valid;
* if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set,
* if a database access error occurs or
* the result set concurrency is <code>CONCUR_READ_ONLY
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNClob(int columnIndex, Reader reader) throws SQLException {
resultSet.updateNClob(columnIndex, reader);
}
/**
* Updates the designated column using the given <code>Reader
* object.
* The data will be read from the stream
* as needed until end-of-stream is reached. The JDBC driver will
* do any necessary conversion from UNICODE to the database char format.
* <p/>
* <p/>
* The updater methods are used to update column values in the
* current row or the insert row. The updater methods do not
* update the underlying database; instead the <code>updateRow or
* <code>insertRow methods are called to update the database.
* <p/>
* <P>Note: Consult your JDBC driver documentation to determine if
* it might be more efficient to use a version of
* <code>updateNClob which takes a length parameter.
*
* @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not
* specified, then the label is the name of the column
* @param reader An object that contains the data to set the parameter value to.
* @throws SQLException if the columnLabel is not valid; if the driver does not support national
* character sets; if the driver can detect that a data conversion
* error could occur; this method is called on a closed result set;
* if a database access error occurs or
* the result set concurrency is <code>CONCUR_READ_ONLY
* @throws SQLFeatureNotSupportedException
* if the JDBC driver does not support
* this method
* @since 1.6
*/
public void updateNClob(String columnLabel, Reader reader) throws SQLException {
resultSet.updateNClob(columnLabel, reader);
}
/**
* Returns an object that implements the given interface to allow access to
* non-standard methods, or standard methods not exposed by the proxy.
* <p/>
* If the receiver implements the interface then the result is the receiver
* or a proxy for the receiver. If the receiver is a wrapper
* and the wrapped object implements the interface then the result is the
* wrapped object or a proxy for the wrapped object. Otherwise return the
* the result of calling <code>unwrap recursively on the wrapped object
* or a proxy for that result. If the receiver is not a
* wrapper and does not implement the interface, then an <code>SQLException is thrown.
*
* @param iface A Class defining an interface that the result must implement.
* @return an object that implements the interface. May be a proxy for the actual implementing object.
* @throws java.sql.SQLException If no object found that implements the interface
* @since 1.6
*/
public <T> T unwrap(Class iface) throws SQLException {
T result;
if (iface.isInstance(this)) {
result = iface.cast(this);
} else {
result = resultSet.unwrap(iface);
}
return result;
}
/**
* Returns true if this either implements the interface argument or is directly or indirectly a wrapper
* for an object that does. Returns false otherwise. If this implements the interface then return true,
* else if this is a wrapper then return the result of recursively calling <code>isWrapperFor on the wrapped
* object. If this does not implement the interface and is not a wrapper, return false.
* This method should be implemented as a low-cost operation compared to <code>unwrap so that
* callers can use this method to avoid expensive <code>unwrap calls that may fail. If this method
* returns true then calling <code>unwrap with the same argument should succeed.
*
* @param iface a Class defining an interface.
* @return true if this implements the interface or directly or indirectly wraps an object that does.
* @throws java.sql.SQLException if an error occurs while determining whether this is a wrapper
* for an object with the given interface.
* @since 1.6
*/
public boolean isWrapperFor(Class<?> iface) throws SQLException {
boolean result;
if (iface.isInstance(this)) {
result = true;
} else {
result = resultSet.isWrapperFor(iface);
}
return result;
}
}
Other Glassfish examples (source code examples)
Here is a short list of links related to this Glassfish ResultSetWrapper40.java source code file:
|
The search page
Other Glassfish source code examples at this package level
Click here to learn more about this project
