Spring Boot에서 MyBatis 적용

Spring Boot에 MyBatis를 통합해 Oracle DB와 연동하는 전체 레이어 구성을 단계별로 설명하는 튜토리얼이다. pom.xml 의존성 추가부터 SqlSessionFactory 빈 설정, Model/Controller/Service/Mapper 레이어 코드, XML 매퍼 파일 작성까지 실제 조회 REST API를 완성하는 과정을 담는다.

핵심 포인트

MyBatis: SQL 쿼리를 XML 파일로 분리 관리, 조회 결과를 DTO/Map으로 자동 매핑
pom.xml: `mybatis-spring-boot-starter 3.0.0` 의존성 추가
SqlSessionFactoryBean: mapper XML 경로(`classpath:mapper/*.xml`)와 model 패키지를 코드로 지정
@Mapper 인터페이스 + XML mapper: 메서드명을 XML의 id와 매핑, resultType으로 자동 역직렬화
XML SELECT에서 `AS` 별칭으로 스네이크케이스 컬럼을 카멜케이스 DTO 필드에 자동 매핑

상세 정리

MyBatis 장점: SQL을 XML 설정 파일에 분리 → 코드와 쿼리 독립 관리, 복잡한 동적 SQL 작성 용이
application.properties: Oracle JDBC URL(`jdbc:oracle:thin:@localhost:1521/cdb1`), username, password 설정
SqlSessionFactoryBean: `setMapperLocations(PathMatchingResourcePatternResolver().getResources("classpath:mapper/*.xml"))` + `setTypeAliasesPackage(모델 패키지)`
Model: userId, userNm, userPw, userEmail, userPh, userLocation, userFailCount 필드를 가진 POJO
Controller: `@RestController` + `@GetMapping("/api/cnt/test")` → userService.selectUserList() 호출 후 HashMap으로 응답
Service/ServiceImpl: @Autowired UserMapper 생성자 주입, selectUserList() 위임
@Mapper 인터페이스: MyBatis가 스캔해 자동으로 프록시 구현체 생성
XML mapper: `<mapper namespace="...UserMapper"><select id="selectUserList" resultType="User">SELECT USER_ID as userId ... FROM USER_INFO_VIEW</select></mapper>`
typeAliasesPackage 설정 시 XML resultType에 패키지 전체 경로 대신 클래스명(User)만 사용 가능