JAVA ResultSet 사용법, 쿼리 결과를 정확하게 읽는 방법

🔎 ResultSet이란 무엇인가요

자바에서 데이터베이스 쿼리를 실행하면, 그 결과는 ResultSet이라는 객체에 담깁니다.
이 객체는 JDBC에서 제공하는 인터페이스로, SQL의 SELECT 쿼리 결과를 테이블 형태로 담고 있으며, 각 행(row)과 열(column)에 접근할 수 있도록 설계되어 있습니다.

쉽게 말하면, SELECT 결과를 메모리에 저장해두고 필요할 때 next()를 통해 한 줄씩 이동하면서 필요한 데이터를 꺼내 쓰는 구조라고 볼 수 있습니다.
즉, ResultSet은 단순한 데이터 저장소가 아닌, 데이터 탐색용 커서 역할을 하는 객체입니다.

• 📊SELECT 쿼리 결과는 ResultSet에 저장됩니다
• 👣행 이동은 next() 메서드를 통해 수행됩니다
• 🧾열 값은 getString(), getInt() 등으로 추출합니다

ResultSet은 커서를 처음에는 첫 행보다 앞에 위치시키고, next()가 호출될 때마다 다음 행으로 이동합니다.
이 방식 덕분에 반복문과 함께 사용하면 전체 결과를 순차적으로 쉽게 처리할 수 있습니다.

🔁 next()와 반복문으로 데이터 순회하기

ResultSet에서 데이터를 읽기 위해 가장 먼저 사용하는 메서드는 next()입니다.
이 메서드는 커서를 다음 행으로 이동시키며, 해당 행이 존재하면 true를 반환합니다.
따라서 반복문 안에서 next()를 조건문으로 사용하면 모든 행을 순차적으로 읽을 수 있습니다.

다음은 대표적인 반복 구조 예시입니다.

ResultSet rs = stmt.executeQuery("SELECT id, name FROM users");

while (rs.next()) {
    int id = rs.getInt("id");
    String name = rs.getString("name");
    System.out.println(id + " - " + name);
}

위 코드는 데이터베이스에서 가져온 모든 사용자 정보를 출력합니다.
핵심은 while(rs.next()) 구문이 모든 행을 순회할 수 있도록 커서를 이동시킨다는 점입니다.

• 🔁next()는 커서를 다음 행으로 이동시킵니다
• 📍while 루프를 통해 여러 행을 순차 처리할 수 있습니다
• ✅next()가 false를 반환하면 더 이상 데이터가 없습니다

이 구조는 ResultSet을 사용하는 가장 일반적인 패턴이며, 실무에서도 거의 모든 반복 조회에서 활용됩니다.
처음 접하는 분이라도 이 기본 패턴만 익히면 데이터 처리에 어려움이 없을 거예요.

📥 getString, getInt 등으로 데이터 추출

ResultSet에서 원하는 값을 읽을 때는 get 계열 메서드를 사용합니다.
대표적으로는 getString(), getInt(), getDouble(), getDate() 등이 있으며, 데이터 타입에 따라 적절한 메서드를 선택해야 합니다.

각 메서드는 SQL 컬럼의 이름 또는 인덱스를 인자로 받아 해당 위치의 값을 반환합니다.
예를 들어 사용자 테이블에서 이름(name)과 나이(age)를 조회하는 경우는 다음과 같습니다.

String name = rs.getString("name");
int age = rs.getInt("age");

만약 컬럼 순서를 알고 있다면 인덱스를 기준으로 접근할 수도 있습니다.
단, 인덱스는 1부터 시작하는 점에 유의하세요.

• 📌문자열은 getString()으로 읽습니다
• 🔢정수형 값은 getInt()를 사용합니다
• 📅날짜는 getDate()로 추출할 수 있습니다

get 계열 메서드는 SQL에서 반환되는 데이터의 실제 타입과 일치해야 하며, 타입이 맞지 않을 경우 예외가 발생할 수 있습니다.
이 점을 유의해 정확한 데이터 타입으로 데이터를 꺼내도록 합시다.

📌 컬럼 이름 vs 인덱스 접근 방식

ResultSet에서 값을 꺼낼 때는 컬럼 이름 또는 컬럼 인덱스를 사용할 수 있습니다.
이 두 방식은 각각 장단점이 존재하며, 상황에 따라 적절하게 선택해야 합니다.

🔖 컬럼 이름으로 접근하는 방식

가장 직관적인 방식으로, 쿼리 결과에서 컬럼명을 그대로 사용할 수 있어 가독성이 좋고 유지보수가 편리합니다.
쿼리가 변경되더라도 컬럼명이 동일하면 코드 수정을 최소화할 수 있는 장점이 있습니다.

String name = rs.getString("name");

🔢 인덱스로 접근하는 방식

컬럼 순서에 따라 숫자 인덱스를 지정하는 방식으로, 약간 더 빠른 성능을 기대할 수 있습니다.
하지만 쿼리의 SELECT 순서가 바뀌면 코드를 함께 수정해야 하는 불편함이 있습니다.

String name = rs.getString(2); // 두 번째 컬럼

• 📝가독성과 유지보수를 중시한다면 컬럼 이름을 사용하세요
• ⚡성능이 중요하고 쿼리가 고정되어 있다면 인덱스도 활용할 수 있습니다

실무에서는 대부분 컬럼 이름을 사용하는 방식이 권장됩니다.
유지보수성과 코드의 명확성을 고려했을 때, 장기적으로 안전하고 효율적인 선택이기 때문입니다.

⚠️ 실무에서 흔한 실수와 주의점

ResultSet을 사용할 때 초보자뿐 아니라 숙련된 개발자도 자주 겪는 실수가 몇 가지 있습니다.
이 실수들은 데이터 누락, 성능 저하, 예외 발생 등 다양한 문제로 이어질 수 있기 때문에 주의가 필요합니다.

• ⛔next() 호출 없이 get 메서드를 사용하려는 경우
• 💥컬럼명 오타로 인한 SQLException 발생
• 🔄반복문 안에서 rs.next()를 여러 번 호출하여 행을 건너뛰는 오류
• 🧹ResultSet.close()를 누락해 리소스 누수 발생

특히 rs.next()를 호출하지 않고 바로 데이터를 읽으려 하면 커서가 아무 위치에도 있지 않기 때문에 예외가 발생합니다.
반드시 반복문 또는 조건문으로 커서를 이동시킨 후 값을 추출해야 합니다.

이러한 실수들은 대부분 사소한 습관에서 비롯됩니다.
기본 원리를 이해하고 반복문 패턴, 예외 처리, 리소스 관리를 습관화하면 안정적인 코드 작성이 가능합니다.

❓ 자주 묻는 질문 (FAQ)