20230628 java.sql.ResultSet

介绍

• java.sql.ResultSet
• public interface ResultSet extends Wrapper, AutoCloseable
• 结果集
• 结果集支持滚动，支持更新，默认不开启

API

常量

FetchDirection

• FETCH_FORWARD : 1000
• FETCH_REVERSE : 1001
• FETCH_UNKNOWN : 1002

resultSetType

• TYPE_FORWARD_ONLY : 1003
  • 结果集不能滚动（默认值）
• TYPE_SCROLL_INSENSITIVE : 1004
  • 结果集可以滚动，但对数据库变化不敏感
• TYPE_SCROLL_SENSITIVE : 1005
  • 结果集可以滚动，且对数据库变化敏感

resultSetConcurrency

• CONCUR_READ_ONLY : 1007
  • 结果集不能用于更新数据库 （默认值）
• CONCUR_UPDATABLE : 1008
  • 结果集可以用于更新数据库

resultSetHoldability

• HOLD_CURSORS_OVER_COMMIT : 1
• CLOSE_CURSORS_AT_COMMIT : 2

public

• next

  • 将结果集中的当前行向前移动一行。如果已经到达最后一行的后面， 返回 false
  • 注意，初始情况下必须调用该方法才能转到第一行

• previous

• close

• isClosed

• getStatement

  • Statement

• getType

  • 是否支持滚动和对数据库变化敏感
  • resultSetType

• getConcurrency

  • 是否支持更新
  • resultSetConcurrency

• getHoldability

  • 保持能力，指在连接关闭之后是否保持打开状态
  • resultSetHoldability

• setFetchDirection, getFetchDirection

  • 获取行的方向，默认向前（FETCH_FORWARD）
  • 向前可以理解成向下
  • FetchDirection

• findColumn

  • 根据给定的列名，返回该列的序号

• getCursorName

• getMetaData

  • 结果集的元数据
  • ResultSetMetaData

• refreshRow

• setFetchSize, getFetchSize

• wasNull

• getWarnings

• clearWarnings

get

• getString
• getBoolean
• getByte
• getShort
• getInt
• getLong
• getFloat
• getDouble
• getBytes
• getDate
• getTime
• getTimestamp
• getAsciiStream
• getBinaryStream
• getObject
• getCharacterStream
• getArray
• getBigDecimal
• getBlob
• getClob
• getNCharacterStream
• getNClob
• getNString
• getRef
• getURL
• getSQLXML
  • XML 数据
• getRowId
  • 描述行位置的 ROWID 值

update

• updateArray
• updateAsciiStream
• updateBigDecimal
• updateBinaryStream
• updateBlob
• updateBoolean
• updateByte
• updateBytes
• updateCharacterStream
• updateClob
• updateDate
• updateDouble
• updateFloat
• updateInt
• updateLong
• updateNCharacterStream
• updateNClob
• updateNString
• updateNull
• updateObject
• updateRef
• updateRowId
• updateSQLXML
• updateShort
• updateString
• updateTime
• updateTimestamp

其他 update

• insertRow

• updateRow

• deleteRow

• cancelRowUpdates

  • 可以在调用 updateRow 前调用，取消掉对当前行的更新

• rowInserted

• rowUpdated

• rowDeleted

• moveToInsertRow

  • 插入前调用，将游标移动到插入行

• moveToCurrentRow

  • 插入后调用，将游标移动到之前的位置

Cursor 光标

• beforeFirst

  • 移动到第一行前

• first

  • 移动到第一行

• last

  • 移动到最后一行

• afterLast

  • 移动到最后一行之后

• isBeforeFirst

• isFirst

• isLast

• isAfterLast

• absolute

  • 将光标移动到此 ResultSet 对象中的给定行号
  • 行号为正，移动到给定行号
  • 行号为负，移动到相对于结果集末尾的绝对行位置
  • 行号为 0 ，移动到第一行前
  • 如果尝试将游标定位到结果集中的第一行/最后一行之外，则游标将位于第一行之前或最后一行之后

• relative

  • 将光标移动相对行数（正数或负数）。
  • 尝试超出结果集中的第一行/最后一行会将光标定位在第一行/最后一行之前/之后。
  • 调用 relative(0) 是有效的，但不会改变光标位置。

• getRow

  • 当前行号
  • 第一行是数字 1
  • 第一行前是数字 0