📌 Spring JDBC & DataSource 완벽 정리 🚀 실습 + 트러블슈팅

📅 날짜

2024-04-24

---

📝 학습 내용

---

1️⃣ DataSource란?

DataSource는 DB 연결(Connection) 을 효율적으로 관리하기 위한 JDBC 표준 인터페이스입니다.

✅ 왜 DataSource를 사용할까?

• DriverManager 방식은 매번 새로운 연결을 생성 ➔ 비효율적
• DataSource는 커넥션 풀(Connection Pool) 과 함께 사용되어, 연결을 재사용 ➔ 성능 최적화

🔹 실무 적용 방식

• 개발 환경 : DriverManagerDataSource 사용 (간단 설정)
• 운영 환경 : 커넥션 풀 (DBCP, HikariCP) + JNDI 연동

---

2️⃣ Spring JDBC 설정

📂 pom.xml 핵심 의존성

<!-- Spring JDBC -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>5.0.7.RELEASE</version>
</dependency>

<!-- MySQL 드라이버 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>9.2.0</version>
</dependency>

<!-- 커넥션 풀 -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-dbcp2</artifactId>
    <version>2.12.0</version>
</dependency>
<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>6.3.0</version>
</dependency>

⚠️ 주의: MySQL Connector 누락 시 DB 연결 불가!

---

📂 root-context.xml 설정

<!-- DataSource 빈 등록 -->
<bean id="dataSource1" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
    <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost/testDB"/>
    <property name="username" value="root"/>
    <property name="password" value="1234"/>
</bean>

<!-- 패키지 스캔 -->
<context:component-scan base-package="com.example.app.domain.dao" />
<context:component-scan base-package="com.example.app.domain.service" />

---

3️⃣ DAO, Service, Controller 구현

📌 MemoDaoImpl

@Repository
public class MemoDaoImpl {

    @Autowired
    private DataSource dataSource1;  // DataSource 주입

    /**
     * 메모 데이터 삽입
     */
    public int insert(MemoDto memoDto) throws SQLException {
        Connection con = dataSource1.getConnection();  // 커넥션 획득
        PreparedStatement pstmt = con.prepareStatement(
            "INSERT INTO tbl_memo VALUES (?, ?, ?, ?)"
        );
        pstmt.setInt(1, memoDto.getId());
        pstmt.setString(2, memoDto.getText());
        pstmt.setString(3, memoDto.getWriter());
        pstmt.setTimestamp(4, Timestamp.valueOf(memoDto.getCreateAt()));  // LocalDateTime 변환
        return pstmt.executeUpdate();
    }
}

---

📌 MemoServiceImpl

@Service
public class MemoServiceImpl {

    @Autowired
    private MemoDaoImpl memoDaoImpl;

    public boolean registraionMemo(MemoDto memoDto) throws SQLException {
        int result = memoDaoImpl.insert(memoDto);
        return result > 0;  // 성공 여부 반환
    }
}

---

📌 MemoController

@Controller
@RequestMapping("/memo")
@Slf4j
public class MemoController {

    @Autowired
    private MemoServiceImpl memoServiceImpl;

    @PostMapping("/add")
    public void add_post(@Valid MemoDto dto, BindingResult bindingResult, Model model) throws Exception {
        if(bindingResult.hasErrors()) {
            for(FieldError error : bindingResult.getFieldErrors()) {
                model.addAttribute(error.getField(), error.getDefaultMessage());
            }
            return;  // 유효성 실패 시 중단
        }
        boolean isAdded = memoServiceImpl.registraionMemo(dto);
    }

    @GetMapping("/ex")
    public void ex1_1() throws FileNotFoundException {
        throw new FileNotFoundException("파일을 찾을 수 없습니다.");
    }
}

---

4️⃣ 테스트 코드 (JUnit5 + 검증)

@ExtendWith(SpringExtension.class)
@ContextConfiguration("file:src/main/webapp/WEB-INF/spring/root-context.xml")
class DataSourceTests {

    @Autowired
    private MemoDaoImpl memoDaoImpl;

    @Test
    void testInsert() throws Exception {
        int result = memoDaoImpl.insert(new MemoDto(1, "Test", "tester@example.com", LocalDateTime.now(), null));
        assert(result == 1);  // 삽입 성공 여부 확인
    }
}

---

5️⃣ 트러블슈팅 & 실행 로그

🔹 setTimestamp 오류

Cannot convert value of type 'java.time.LocalDateTime' to required type 'java.sql.Timestamp'

➡️ 해결:

pstmt.setTimestamp(4, Timestamp.valueOf(memoDto.getCreateAt()));

---

🔹 SQL 자리수 오류

java.sql.SQLException: Parameter index out of range

➡️ VALUES (?, ?, ?, ?) 자리수 체크!

---

📄 실행 로그

INFO : POST /memo/add... MemoDto(id=123, text=asdfasdf, writer=example@example.com, createAt=2025-04-24T17:11, dateTest=null)

dateTest=null : @InitBinder 주석 처리로 바인딩 안 된 상태

---

🔥 정리

• DataSource 설정 = 성능 최적화의 시작
• 유효성 검사는 반드시 return 처리
• 테스트 코드로 안정성 확보
• 자주 발생하는 에러는 체크리스트화 하자!

---

🔗 참고 자료

• Spring JDBC 공식 문서
• HikariCP
• MySQL Connector/J

---