/*
Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.
The MySQL Connector/J is licensed under the terms of the GPLv2
<http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>, like most MySQL Connectors.
There are special exceptions to the terms and conditions of the GPLv2 as it is applied to
this software, see the FLOSS License Exception
<http://www.mysql.com/about/legal/licensing/foss-exception.html>.
This program is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software Foundation; version 2
of the License.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this
program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth
Floor, Boston, MA 02110-1301 USA
*/
package com.mysql.jdbc;
import java.io.InputStream;
import java.io.Reader;
import java.io.UnsupportedEncodingException;
import java.sql.NClob;
import java.sql.RowId;
import java.sql.SQLException;
import java.sql.SQLXML;
import com.mysql.jdbc.Connection;
import com.mysql.jdbc.Field;
import com.mysql.jdbc.NotUpdatable;
import com.mysql.jdbc.RowData;
import com.mysql.jdbc.Statement;
import com.mysql.jdbc.StringUtils;
import com.mysql.jdbc.UpdatableResultSet;
public class JDBC4UpdatableResultSet extends UpdatableResultSet {
public JDBC4UpdatableResultSet(String catalog, Field[] fields, RowData tuples,
MySQLConnection conn, StatementImpl creatorStmt) throws SQLException {
super(catalog, fields, tuples, conn, creatorStmt);
}
public void updateAsciiStream(int columnIndex, InputStream x) throws SQLException {
throw new NotUpdatable();
}
public void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException {
throw new NotUpdatable();
}
public void updateBinaryStream(int columnIndex, InputStream x) throws SQLException {
throw new NotUpdatable();
}
public void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException {
throw new NotUpdatable();
}
public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException {
throw new NotUpdatable();
}
public void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException {
throw new NotUpdatable();
}
public void updateCharacterStream(int columnIndex, Reader x) throws SQLException {
throw new NotUpdatable();
}
public void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException {
throw new NotUpdatable();
}
public void updateClob(int columnIndex, Reader reader) throws SQLException {
throw new NotUpdatable();
}
public void updateClob(int columnIndex, Reader reader, long length) throws SQLException {
throw new NotUpdatable();
}
public void updateNCharacterStream(int columnIndex, Reader x) throws SQLException {
throw new NotUpdatable();
}
public void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException {
updateNCharacterStream(columnIndex, x, (int) length);
}
public void updateNClob(int columnIndex, Reader reader) throws SQLException {
throw new NotUpdatable();
}
public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException {
throw new NotUpdatable();
}
public void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException {
throw new NotUpdatable();
}
public void updateRowId(int columnIndex, RowId x) throws SQLException {
throw new NotUpdatable();
}
public void updateAsciiStream(String columnLabel, InputStream x) throws SQLException {
updateAsciiStream(findColumn(columnLabel), x);
}
public void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException {
updateAsciiStream(findColumn(columnLabel), x, length);
}
public void updateBinaryStream(String columnLabel, InputStream x) throws SQLException {
updateBinaryStream(findColumn(columnLabel), x);
}
public void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException {
updateBinaryStream(findColumn(columnLabel), x, length);
}
public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException {
updateBlob(findColumn(columnLabel), inputStream);
}
public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException {
updateBlob(findColumn(columnLabel), inputStream, length);
}
public void updateCharacterStream(String columnLabel, Reader reader) throws SQLException {
updateCharacterStream(findColumn(columnLabel), reader);
}
public void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException {
updateCharacterStream(findColumn(columnLabel), reader, length);
}
public void updateClob(String columnLabel, Reader reader) throws SQLException {
updateClob(findColumn(columnLabel), reader);
}
public void updateClob(String columnLabel, Reader reader, long length) throws SQLException {
updateClob(findColumn(columnLabel), reader, length);
}
public void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException {
updateNCharacterStream(findColumn(columnLabel), reader);
}
public void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException {
updateNCharacterStream(findColumn(columnLabel), reader, length);
}
public void updateNClob(String columnLabel, Reader reader) throws SQLException {
updateNClob(findColumn(columnLabel), reader);
}
public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException {
updateNClob(findColumn(columnLabel), reader, length);
}
public void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException {
updateSQLXML(findColumn(columnLabel), xmlObject);
}
/**
* JDBC 4.0 Update a column with a character stream value. The updateXXX()
* methods are used to update column values in the current row, or the
* insert row. The updateXXX() methods do not update the underlying
* database, instead the updateRow() or 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
*
* @exception SQLException
* if a database-access error occurs
*/
public synchronized void updateNCharacterStream(int columnIndex,
java.io.Reader x, int length) throws SQLException {
String fieldEncoding = this.fields[columnIndex - 1].getCharacterSet();
if (fieldEncoding == null || !fieldEncoding.equals("UTF-8")) {
throw new SQLException(
"Can not call updateNCharacterStream() when field's character set isn't UTF-8");
}
if (!this.onInsertRow) {
if (!this.doingUpdates) {
this.doingUpdates = true;
syncUpdate();
}
((com.mysql.jdbc.JDBC4PreparedStatement)this.updater).setNCharacterStream(columnIndex, x, length);
} else {
((com.mysql.jdbc.JDBC4PreparedStatement)this.inserter).setNCharacterStream(columnIndex, x, length);
if (x == null) {
this.thisRow.setColumnValue(columnIndex - 1, null);
} else {
this.thisRow.setColumnValue(columnIndex - 1, STREAM_DATA_MARKER);
}
}
}
/**
* JDBC 4.0 Update a column with a character stream value. The updateXXX()
* methods are used to update column values in the current row, or the
* insert row. The updateXXX() methods do not update the underlying
* database, instead the updateRow() or insertRow() methods are called to
* update the database.
*
* @param columnName
* the name of the column
* @param reader
* the new column value
* @param length
* of the stream
*
* @exception SQLException
* if a database-access error occurs
*/
public synchronized void updateNCharacterStream(String columnName,
java.io.Reader reader, int length) throws SQLException {
updateNCharacterStream(findColumn(columnName), reader, length);
}
/**
* @see ResultSet#updateNClob(int, NClob)
*/
public void updateNClob(int columnIndex, java.sql.NClob nClob)
throws SQLException {
String fieldEncoding = this.fields[columnIndex - 1].getCharacterSet();
if (fieldEncoding == null || !fieldEncoding.equals("UTF-8")) {
throw new SQLException("Can not call updateNClob() when field's character set isn't UTF-8");
}
if (nClob == null) {
updateNull(columnIndex);
} else {
updateNCharacterStream(columnIndex, nClob.getCharacterStream(),
(int) nClob.length());
}
}
/**
* @see ResultSet#updateClob(int, Clob)
*/
public void updateNClob(String columnName, java.sql.NClob nClob)
throws SQLException {
updateNClob(findColumn(columnName), nClob);
}
/**
* JDBC 4.0 Update a column with NATIONAL CHARACTER. The updateXXX() methods
* are used to update column values in the current row, or the insert row.
* The updateXXX() methods do not update the underlying database, instead
* the updateRow() or 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
*
* @exception SQLException
* if a database-access error occurs
*/
public synchronized void updateNString(int columnIndex, String x)
throws SQLException {
String fieldEncoding = this.fields[columnIndex - 1].getCharacterSet();
if (fieldEncoding == null || !fieldEncoding.equals("UTF-8")) {
throw new SQLException("Can not call updateNString() when field's character set isn't UTF-8");
}
if (!this.onInsertRow) {
if (!this.doingUpdates) {
this.doingUpdates = true;
syncUpdate();
}
((com.mysql.jdbc.JDBC4PreparedStatement)this.updater).setNString(columnIndex, x);
} else {
((com.mysql.jdbc.JDBC4PreparedStatement)this.inserter).setNString(columnIndex, x);
if (x == null) {
this.thisRow.setColumnValue(columnIndex - 1, null);
} else {
this.thisRow.setColumnValue(columnIndex - 1, StringUtils.getBytes(x,
this.charConverter, fieldEncoding,
this.connection.getServerCharacterEncoding(),
this.connection.parserKnowsUnicode(), getExceptionInterceptor()));
}
}
}
/**
* JDBC 4.0 Update a column with NATIONAL CHARACTER. The updateXXX() methods
* are used to update column values in the current row, or the insert row.
* The updateXXX() methods do not update the underlying database, instead
* the updateRow() or insertRow() methods are called to update the database.
*
* @param columnName
* the name of the column
* @param x
* the new column value
*
* @exception SQLException
* if a database-access error occurs
*/
public synchronized void updateNString(String columnName, String x)
throws SQLException {
updateNString(findColumn(columnName), x);
}
public int getHoldability() throws SQLException {
throw SQLError.notImplemented();
}
/**
* JDBC 4.0 Get a NCLOB column.
*
* @param columnIndex
* the first column is 1, the second is 2, ...
*
* @return an object representing a NCLOB
*
* @throws SQLException
* if an error occurs
*/
protected java.sql.NClob getNativeNClob(int columnIndex)
throws SQLException {
String stringVal = getStringForNClob(columnIndex);
if (stringVal == null) {
return null;
}
return getNClobFromString(stringVal, columnIndex);
}
/**
* JDBC 4.0
*
* <p>
* Get the value of a column in the current row as a java.io.Reader.
* </p>
*
* @param columnIndex
* the column to get the value from
*
* @return the value in the column as a java.io.Reader.
*
* @throws SQLException
* if an error occurs
*/
public Reader getNCharacterStream(int columnIndex) throws SQLException {
String fieldEncoding = this.fields[columnIndex - 1].getCharacterSet();
if (fieldEncoding == null || !fieldEncoding.equals("UTF-8")) {
throw new SQLException(
"Can not call getNCharacterStream() when field's charset isn't UTF-8");
}
return getCharacterStream(columnIndex);
}
/**
* JDBC 4.0
*
* <p>
* Get the value of a column in the current row as a java.io.Reader.
* </p>
*
* @param columnName
* the column name to retrieve the value from
*
* @return the value as a java.io.Reader
*
* @throws SQLException
* if an error occurs
*/
public Reader getNCharacterStream(String columnName) throws SQLException {
return getNCharacterStream(findColumn(columnName));
}
/**
* JDBC 4.0 Get a NCLOB column.
*
* @param i
* the first column is 1, the second is 2, ...
*
* @return an object representing a NCLOB
*
* @throws SQLException
* if an error occurs
*/
public NClob getNClob(int columnIndex) throws SQLException {
String fieldEncoding = this.fields[columnIndex - 1].getCharacterSet();
if (fieldEncoding == null || !fieldEncoding.equals("UTF-8")) {
throw new SQLException(
"Can not call getNClob() when field's charset isn't UTF-8");
}
if (!this.isBinaryEncoded) {
String asString = getStringForNClob(columnIndex);
if (asString == null) {
return null;
}
return new com.mysql.jdbc.JDBC4NClob(asString, getExceptionInterceptor());
}
return getNativeNClob(columnIndex);
}
/**
* JDBC 4.0 Get a NCLOB column.
*
* @param colName
* the column name
*
* @return an object representing a NCLOB
*
* @throws SQLException
* if an error occurs
*/
public NClob getNClob(String columnName) throws SQLException {
return getNClob(findColumn(columnName));
}
private final java.sql.NClob getNClobFromString(String stringVal,
int columnIndex) throws SQLException {
return new com.mysql.jdbc.JDBC4NClob(stringVal, getExceptionInterceptor());
}
/**
* JDBC 4.0
*
* Get the value of a column in the current row as a Java String
*
* @param columnIndex
* the first column is 1, the second is 2...
*
* @return the column value, null for SQL NULL
*
* @exception SQLException
* if a database access error occurs
*/
public String getNString(int columnIndex) throws SQLException {
String fieldEncoding = this.fields[columnIndex - 1].getCharacterSet();
if (fieldEncoding == null || !fieldEncoding.equals("UTF-8")) {
throw new SQLException(
"Can not call getNString() when field's charset isn't UTF-8");
}
return getString(columnIndex);
}
/**
* JDBC 4.0
*
* The following routines simply convert the columnName into a columnIndex
* and then call the appropriate routine above.
*
* @param columnName
* is the SQL name of the column
*
* @return the column value
*
* @exception SQLException
* if a database access error occurs
*/
public String getNString(String columnName) throws SQLException {
return getNString(findColumn(columnName));
}
public RowId getRowId(int columnIndex) throws SQLException {
throw SQLError.notImplemented();
}
public RowId getRowId(String columnLabel) throws SQLException {
return getRowId(findColumn(columnLabel));
}
public SQLXML getSQLXML(int columnIndex) throws SQLException {
return new JDBC4MysqlSQLXML(this, columnIndex, getExceptionInterceptor());
}
public SQLXML getSQLXML(String columnLabel) throws SQLException {
return getSQLXML(findColumn(columnLabel));
}
private String getStringForNClob(int columnIndex) throws SQLException {
String asString = null;
String forcedEncoding = "UTF-8";
try {
byte[] asBytes = null;
if (!this.isBinaryEncoded) {
asBytes = getBytes(columnIndex);
} else {
asBytes = getNativeBytes(columnIndex, true);
}
if (asBytes != null) {
asString = new String(asBytes, forcedEncoding);
}
} catch (UnsupportedEncodingException uee) {
throw SQLError.createSQLException("Unsupported character encoding "
+ forcedEncoding, SQLError.SQL_STATE_ILLEGAL_ARGUMENT, getExceptionInterceptor());
}
return asString;
}
public synchronized boolean isClosed() throws SQLException {
return this.isClosed;
}
/**
* 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</code> 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</code> so that callers can use this method to avoid
* expensive <code>unwrap</code> calls that may fail. If this method
* returns true then calling <code>unwrap</code> with the same argument
* should succeed.
*
* @param interfaces
* 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 {
checkClosed();
// This works for classes that aren't actually wrapping
// anything
return iface.isInstance(this);
}
/**
* Returns an object that implements the given interface to allow access to
* non-standard methods, or standard methods not exposed by the proxy. The
* result may be either the object found to implement the interface or a
* proxy for that object. If the receiver implements the interface then that
* is the object. If the receiver is a wrapper and the wrapped object
* implements the interface then that is the object. Otherwise the object is
* the result of calling <code>unwrap</code> recursively on the wrapped
* object. If the receiver is not a wrapper and does not implement the
* interface, then an <code>SQLException</code> 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(java.lang.Class<T> iface) throws java.sql.SQLException {
try {
// This works for classes that aren't actually wrapping
// anything
return iface.cast(this);
} catch (ClassCastException cce) {
throw SQLError.createSQLException("Unable to unwrap to " + iface.toString(),
SQLError.SQL_STATE_ILLEGAL_ARGUMENT, getExceptionInterceptor());
}
}
}