All Packages Class Hierarchy This Package Previous Next Index
Class com.imaginary.sql.msql.MsqlResultSet
com.imaginary.sql.msql.MsqlResultSet
- public abstract class MsqlResultSet
Acts as an abstract base class for all of the different kinds of result
sets supported by mSQL-JDBC.
Last modified $Date: 1999/07/09 23:16:35 $
- Version:
- $Revision: 1.1.2.1.2.2 $
- Author:
- George Reese (borg@imaginary.com)
-
log
-
-
clearWarnings()
- mSQL does not generate warnings, so this method is a NO-OP
-
close()
- A NO-OP for this base class.
-
complete()
- This method is called to mark a result set as complete.
-
getAsciiStream(String)
- For performance reasons, you should get values by column
number when at all possible.
-
getBigDecimal(int)
-
-
getBigDecimal(int, int)
-
Deprecated.
-
getBigDecimal(String)
- Avoid getting columns by name whenever possible.
-
getBigDecimal(String, int)
- Avoid getting columns by name whenever possible.
Deprecated.
-
getBinaryStream(String)
- Avoid getting columns by name whenever possible.
-
getBoolean(String)
- Avoid getting columns by name whenever possible.
-
getByte(String)
- Avoid getting columns by name whenever possible.
-
getBytes(String)
- Avoid getting columns by name whenever possible.
-
getCharacterStream(int)
-
-
getCharacterStream(String)
- Avoid getting columns by name whenever possible.
-
getCursorName()
-
-
getDate(int)
- mSQL 1.0 does not support a date type, but 2.0 does.
-
getDate(int, Calendar)
- mSQL 1.0 does not support a date type, but 2.0 does.
-
getDate(String)
- Avoid getting columns by name whenever possible.
-
getDate(String, Calendar)
- Avoid getting columns by name whenever possible.
-
getDouble(int)
-
-
getDouble(String)
- Avoid getting columns by name whenever possible.
-
getEncoding()
-
-
getFloat(int)
-
-
getFloat(String)
- Avoid getting columns by name whenever possible.
-
getInt(int)
-
-
getInt(String)
- Avoid getting columns by name whenever possible.
-
getLong(int)
-
-
getLong(String)
- Avoid getting columns by name whenever possible.
-
getObject(int)
-
-
getObject(String)
- Avoid getting columns by name whenever possible.
-
getRow()
-
-
getShort(int)
-
-
getShort(String)
- Avoid getting columns by name whenever possible.
-
getStatement()
-
-
getString(String)
- Avoid getting columns by name whenever possible.
-
getTime(int)
-
-
getTime(int, Calendar)
-
-
getTime(String)
- Avoid getting columns by name whenever possible.
-
getTime(String, Calendar)
- Avoid getting columns by name whenever possible.
-
getTimestamp(int)
-
Timestamps are not really supported in mSQL.
-
getTimestamp(int, Calendar)
-
Timestamps are not really supported in mSQL.
-
getTimestamp(String)
-
Timestamps are not really supported in mSQL.
-
getTimestamp(String, Calendar)
-
Timestamps are not really supported in mSQL.
-
getUnicodeStream(String)
- Avoid getting columns by name whenever possible.
Deprecated.
-
getWarnings()
- mSQL does not generate warnings, so this method always returns null.
-
isAfterLast()
- Determines if the driver is positioned after the last row.
-
isBeforeFirst()
- Because of the way the driver works, isAfterLast() == isBeforeFirst().
log
protected MsqlLog log
clearWarnings
public void clearWarnings() throws SQLException
- mSQL does not generate warnings, so this method is a NO-OP
- Throws: SQLException
- this is never thrown
close
public void close() throws SQLException
- A NO-OP for this base class.
- Throws: SQLException
- this is never thrown
complete
public void complete()
- This method is called to mark a result set as complete.
getAsciiStream
public InputStream getAsciiStream(String cname) throws SQLException
- For performance reasons, you should get values by column
number when at all possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- an ASCII input stream for the column
- Throws: SQLException
- thrown when the column cannot be read
getBigDecimal
public BigDecimal getBigDecimal(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the column being sought
- Returns:
- the specified column as a BigDecimal
- Throws: SQLException
- thrown when the column cannot be read
getBigDecimal
public BigDecimal getBigDecimal(int column) throws SQLException
- Parameters:
- column - the column number of the desired column
- Returns:
- the specified column as a BigDecimal
- Throws: SQLException
- thrown when the column cannot be read
getBigDecimal
public BigDecimal getBigDecimal(String cname,
int scale) throws SQLException
- Note: getBigDecimal() is deprecated.
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the column being sought
- scale - the scale with which the BigDecimal should be constructed
- Returns:
- the specified column as a BigDecimal
- Throws: SQLException
- thrown when the column cannot be read
getBigDecimal
public BigDecimal getBigDecimal(int column,
int scale) throws SQLException
- Note: getBigDecimal() is deprecated.
- Parameters:
- column - the column number of the desired column
- scale - the scale with which the BigDecimal should be constructed
- Returns:
- the specified column as a BigDecimal
- Throws: SQLException
- thrown when the column cannot be read
getBinaryStream
public InputStream getBinaryStream(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as an InputStream
- Throws: SQLException
- thrown in the event of an error
reading the column
getBoolean
public boolean getBoolean(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a boolean
- Throws: SQLException
- thrown in the event of an error
reading the column
getByte
public byte getByte(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a byte
- Throws: SQLException
- thrown in the event of an error
reading the column
getBytes
public byte[] getBytes(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a byte array
- Throws: SQLException
- thrown in the event of an error
reading the column
getCharacterStream
public Reader getCharacterStream(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a Reader
- Throws: SQLException
- thrown in the event of an error
reading the column
getCharacterStream
public Reader getCharacterStream(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a Reader
- Throws: SQLException
- thrown in the event of an error
reading the column
getCursorName
public String getCursorName() throws SQLException
- Returns:
- the cursor name
- Throws: SQLException
- this is always thrown as mSQL does
not support named cursors
getDate
public Date getDate(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a Date
- Throws: SQLException
- thrown in the event of an error
reading the column
getDate
public Date getDate(int column) throws SQLException
- mSQL 1.0 does not support a date type, but 2.0 does. This method
allows any version of mSQL to store dates as a CHAR type. It also
allows mSQL 2.0 to store them as TEXT or DATE types. If you choose to
store your date as a CHAR or TEXT type for any reason, you must store
the date as a long converted into a CHAR or in DD-Mon-YYYY.
- Parameters:
- column - the number of desired column
- Returns:
- a Date representation of the specified column
- Throws: SQLException
- a database error occurred
getDate
public Date getDate(String cname,
Calendar cal) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- cal - the Calendar to use in constructing the Date
- Returns:
- the column as a Date
- Throws: SQLException
- thrown in the event of an error
reading the column
getDate
public Date getDate(int column,
Calendar cal) throws SQLException
- mSQL 1.0 does not support a date type, but 2.0 does. This method
allows any version of mSQL to store dates as a CHAR type. It also
allows mSQL 2.0 to store them as TEXT or DATE types. If you choose to
store your date as a CHAR or TEXT type for any reason, you must store
the date as a long converted into a CHAR or in DD-Mon-YYYY.
- Parameters:
- column - the number of desired column
- cal - the Calendar to use in constructing the date
- Returns:
- a Date representation of the specified column
- Throws: SQLException
- a database error occurred
getDouble
public double getDouble(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a double
- Throws: SQLException
- thrown in the event of an error
reading the column
getDouble
public double getDouble(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a double
- Throws: SQLException
- thrown in the event of an error
reading the column
getEncoding
public String getEncoding()
getFloat
public float getFloat(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a float
- Throws: SQLException
- thrown in the event of an error
reading the column
getFloat
public float getFloat(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a float
- Throws: SQLException
- thrown in the event of an error
reading the column
getInt
public int getInt(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as an int
- Throws: SQLException
- thrown in the event of an error
reading the column
getInt
public int getInt(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as an int
- Throws: SQLException
- thrown in the event of an error
reading the column
getLong
public long getLong(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a long
- Throws: SQLException
- thrown in the event of an error
reading the column
getLong
public long getLong(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a long
- Throws: SQLException
- thrown in the event of an error
reading the column
getObject
public Object getObject(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a Java object based on the standard
SQL -> Java mapping
- Throws: SQLException
- thrown in the event of an error
reading the column
getObject
public Object getObject(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a Java object based on the standard
SQL -> Java mapping
- Throws: SQLException
- thrown in the event of an error
reading the column
getRow
public abstract int getRow() throws SQLException
getShort
public short getShort(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a short
- Throws: SQLException
- thrown in the event of an error
reading the column
getShort
public short getShort(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a short
- Throws: SQLException
- thrown in the event of an error
reading the column
getStatement
public Statement getStatement() throws SQLException
- Returns:
- the Statement that generated this result set
- Throws: SQLException
- this is never thrown
getString
public String getString(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a Java String
- Throws: SQLException
- thrown in the event of an error
reading the column
getTime
public Time getTime(String cname) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a Time object
- Throws: SQLException
- thrown in the event of an error
reading the column
getTime
public Time getTime(int column) throws SQLException
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a Java String
- Throws: SQLException
- thrown in the event of an error
reading the column
getTime
public Time getTime(String cname,
Calendar cal) throws SQLException
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- cal - the Calendar to use in creating the Time object
- Returns:
- the column as a Time object
- Throws: SQLException
- thrown in the event of an error
reading the column
getTime
public Time getTime(int column,
Calendar cal) throws SQLException
- Parameters:
- column - the number of the desired column
- cal - the Calendar to use in creating the Time object
- Returns:
- the column as a Java String
- Throws: SQLException
- thrown in the event of an error
reading the column
getTimestamp
public Timestamp getTimestamp(String cname) throws SQLException
-
Timestamps are not really supported in mSQL. To make use of
them, store timestamps in char fields.
Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as a Timestamp
- Throws: SQLException
- thrown in the event of an error
reading the column
getTimestamp
public Timestamp getTimestamp(int column) throws SQLException
-
Timestamps are not really supported in mSQL. To make use of
them, store timestamps in char fields.
- Parameters:
- column - the number of the desired column
- Returns:
- the column as a Timestamp
- Throws: SQLException
- thrown in the event of an error
reading the column
getTimestamp
public Timestamp getTimestamp(String cname,
Calendar cal) throws SQLException
-
Timestamps are not really supported in mSQL. To make use of
them, store timestamps in char fields.
Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- cal - this is currently ignored
- Returns:
- the column as a Timestamp
- Throws: SQLException
- thrown in the event of an error
reading the column
getTimestamp
public Timestamp getTimestamp(int column,
Calendar c) throws SQLException
-
Timestamps are not really supported in mSQL. To make use of
them, store timestamps in char fields.
- Parameters:
- column - the number of the desired column
- c - this is currently ignored
- Returns:
- the column as a Timestamp
- Throws: SQLException
- thrown in the event of an error
reading the column
getUnicodeStream
public InputStream getUnicodeStream(String cname) throws SQLException
- Note: getUnicodeStream() is deprecated.
use the getCharacterStream()
- Avoid getting columns by name whenever possible.
- Parameters:
- cname - the name of the desired column
- Returns:
- the column as an InputStream
- Throws: SQLException
- thrown in the event of an error
reading the column
getWarnings
public SQLWarning getWarnings() throws SQLException
- mSQL does not generate warnings, so this method always returns null.
- Returns:
- null
- Throws: SQLException
- this is never thrown
isAfterLast
public boolean isAfterLast() throws SQLException
- Determines if the driver is positioned after the last row.
- Returns:
- true if the result set is positioned after the last row
- Throws: SQLException
- this is never thrown
isBeforeFirst
public boolean isBeforeFirst() throws SQLException
- Because of the way the driver works, isAfterLast() == isBeforeFirst().
- Returns:
- true if the result set is positioned before the first row
- Throws: SQLException
- this is never thrown
All Packages Class Hierarchy This Package Previous Next Index