Java ResultSet 操作詳解：游標移動、記錄計數與常見陷阱

ResultSet 游標基本機制

ResultSet 維護一個指向當前資料列的游標，初始位置在第一列之前。next() 將游標下移一列並返回是否有效，false 表示已無資料。

五大核心操作場景

1. 計算查詢結果總筆數

int count = 0;
while (rs.next()) {
    count++;
}
System.out.println("總筆數：" + count);

分頁應用：若單頁固定 50 筆，讀取 50 筆後若 count == 50 表示可能還有下一頁。

2. 判斷結果集是否為空

if (rs.next()) {
    System.out.println("have data");
} else {
    System.out.println("no data");
}

相當於檢查是否至少有一筆記錄。注意：next() 已將游標移至第一列。

3. 避免「少讀一筆」的經典陷阱

錯誤寫法：

if (rs.next()) {          // 游標移至第 1 列
    while (rs.next()) {   // 從第 2 列開始迴圈
        count++;
    }
}

結果：總筆數少 1，第一列資料遺失。

正確寫法一：重置游標

if (rs.next()) {
    rs.beforeFirst();     // 移回第一列之前
    while (rs.next()) {
        count++;
    }
}

正確寫法二：直接迴圈（推薦）

while (rs.next()) {
    count++;
}

4. 正確讀取所有資料

錯誤：

if (rs.next()) {
    while (rs.next()) {
        System.out.println(rs.getString(1)); // 少讀第一列
    }
}

正確：

if (rs.next()) {
    rs.beforeFirst();
    while (rs.next()) {
        System.out.println(rs.getString(1));
    }
}

或直接：

while (rs.next()) {
    System.out.println(rs.getString(1));
}

5. 僅讀取第一筆記錄

if (rs.next()) {
    System.out.println(rs.getString(1)); // 讀取第 1 列
}

ResultSet 遊標控制方法總覽

建立可捲動 ResultSet

Statement stmt = conn.createStatement(
    ResultSet.TYPE_SCROLL_INSENSITIVE,  // 或 TYPE_SCROLL_SENSITIVE
    ResultSet.CONCUR_READ_ONLY          // 或 CONCUR_UPDATABLE
);
ResultSet rs = stmt.executeQuery("SELECT * FROM users");

最佳實踐清單

1. 預設使用 while(rs.next()) 單向遍歷，除非需要反向/隨機存取
2. 避免多次 next() 未重置游標，寧可多呼叫 beforeFirst()
3. 資源關閉順序：ResultSet → Statement → Connection（或使用 try-with-resources）
4. 大量資料考慮分頁查詢（LIMIT/OFFSET 或游標分頁），避免記憶體溢位
5. 列索引從 1 開始，非 0，切記 getString(1) 非 getString(0)

1. 上一篇文章： Spring 框架初學者學習路徑指南：從入門到精通六階段
2. 下一篇文章： Java 中英文排序解決方案：TreeMap 搭配 Collator 實現本地化排序

Java 相關知識

Java 類與物件核心概念詳解：從定義到構造方法實戰

在 Java 程式設計中，類與物件是物件導向程式設計（OOP

Eclipse RCP 開發實戰（一）：快速入門與產品化部署

前言 Rich Client Platform (RCP)

動力節點王勇 DRP 供應鏈管理系統項目視頻教程完整目錄 (292 集)

本教程由國內知名 Java 培訓講師王勇主講，涵蓋從需求分析

Eclipse 插件依賴解析神器：Dependency Walker 自動發現未解析依賴

問題背景 Manifest 中聲明依賴，但插件未加載。PDE