프로젝트에 MyBatis 추가하기 (Maven/Gradle 설정)

1. Maven 설정 방법

pom.xml에 MyBatis 관련 의존성 추가

<!-- MyBatis + Spring Boot -->
<dependency>
  <groupId>org.mybatis.spring.boot</groupId>
  <artifactId>mybatis-spring-boot-starter</artifactId>
  <version>3.0.2</version> <!-- 최신 버전 확인 권장 -->
</dependency>

<!-- MySQL 예시 (DB 드라이버) -->
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-j</artifactId>
  <version>8.0.33</version>
</dependency>

---

2. Gradle 설정 방법

build.gradle에 다음 코드 추가

 

// MyBatis + Spring Boot
implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.2'

// MySQL 예시
implementation 'mysql:mysql-connector-j:8.0.33'

---

3. 기본 설정 파일 추가

application.yml 또는 application.properties

 

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: yourpassword
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis:
  mapper-locations: classpath:/mappers/**/*.xml
  type-aliases-package: com.example.project.domain

 

또는 application.properties:

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

mybatis.mapper-locations=classpath:/mappers/**/*.xml
mybatis.type-aliases-package=com.example.project.domain

---

4. 프로젝트 디렉터리 구조 예시

src/main/java
└── com/example/project
    ├── domain       ← VO 또는 DTO 클래스
    ├── mapper       ← Mapper 인터페이스
    └── service      ← 비즈니스 로직

src/main/resources
└── mappers
    └── UserMapper.xml ← SQL 정의 XML

---

5. Mapper 인터페이스 작성

@Mapper
public interface UserMapper {
    User selectUserById(int id);
}

 

※ @MapperScan("com.example.project.mapper") 설정으로 자동 스캔할 수 있어요.

---

마지막 점검 체크리스트

• 의존성 추가 완료 (Maven or Gradle)
• DB 드라이버 설정 확인
• application.yml 또는 .properties 설정
• Mapper XML 파일의 경로 확인
• Mapper 인터페이스에 @Mapper 또는 @MapperScan 적용