[LG U+ 유레카 3기] MyBatis 실습 준비 | Maven 환경 세팅 정리

❶ 상황 설명

MyBatis 실습(ch01~ch03)을 진행하기 전에 가장 중요한 단계는 개발 환경 세팅과 폴더 구조 이해이다.
MyBatis는 단순히 코드만 작성한다고 돌아가지 않는다. Java가 설치되어 있어야 하고, Maven이 의존성을 관리해야 하며, 프로젝트 내부의 src/main/java와 src/main/resources가 각자 역할을 나눠서 협력해야 한다.

---

❷ JDK 설치 및 환경 변수 설정

MyBatis는 Java로 동작하기 때문에 JDK(Java Development Kit)가 필수다. JDK 17 버전 이상을 권장한다.

① JDK 다운로드

1. Oracle JDK 다운로드 페이지로 이동
2. Windows x64 Installer 다운로드 후 설치
3. 설치 경로 예시 : C:\Program Files\Java\jdk-17

② 환경 변수 설정 (Windows 기준)

1. 시작 메뉴 → “환경 변수 편집” 검색 → 시스템 환경 변수 편집 클릭
2. 환경 변수 → 시스템 변수에서 새로 만들기 클릭
3. 변수 이름 : JAVA_HOME
4. 변수 값 : JDK 설치 경로 (예: C:\Program Files\Java\jdk-17)
5. 시스템 변수의 Path 선택 → 편집 → %JAVA_HOME%\bin 추가

확인 명령어 (터미널 / CMD)
---------------------------------
> java -version
> javac -version

정상 출력 시 MyBatis 및 Maven 실행 준비 완료 ✅

---

❸ Maven 설치 및 설정

Maven은 자바 프로젝트의 빌드(Build)와 의존성(Dependency) 관리 도구다.
MyBatis, MySQL 드라이버, log4j 같은 외부 라이브러리를 Maven이 자동으로 다운로드해준다.

① Maven 다운로드

1. Maven 공식 사이트에서 “Binary zip archive” 버전 다운로드
2. 예: apache-maven-3.9.6-bin.zip
3. 압축 해제 → 경로 예시: C:\apache-maven-3.9.6

② 환경 변수 설정

1. 변수 이름 : MAVEN_HOME
2. 변수 값 : C:\apache-maven-3.9.6
3. Path 변수에 %MAVEN_HOME%\bin 추가

확인 명령어
---------------------------------
> mvn -v
Apache Maven 3.9.6 ...

버전 정보가 뜨면 Maven도 성공적으로 설치된 것이다.

---

❹ src 폴더 구조 이해하기

MyBatis를 Maven 프로젝트로 만들면 아래와 같은 기본 구조가 자동 생성된다.

📦 src
 ┣ 📂 main
 ┃ ┣ 📂 java               ← 자바 코드(.java 파일)
 ┃ ┃ ┗ 📂 ch01, ch02, ch03  ← 각 실습 패키지
 ┃ ┣ 📂 resources           ← 설정파일(.xml, .properties 등)
 ┃ ┃ ┣ 📜 mybatis-config.xml
 ┃ ┃ ┗ 📂 mapper / ch01 / ch02 / ch03
 ┗ 📂 test                  ← 테스트용 코드(JUnit 등)

📘 java 폴더

비즈니스 로직, DAO, DTO, 서비스, 실행 코드를 담는 폴더.
즉, 프로그램의 동작을 담당하는 순수 자바 코드가 이곳에 위치한다.
예시: Book.java, BookMapper.java, BookApp.java 등

📗 resources 폴더

MyBatis의 핵심은 “SQL을 XML로 분리”하는 것.
따라서 SQL 문장, 환경 설정, 매퍼 연결 같은 파일이 모두 이곳에 들어간다.
즉, 설정과 데이터 리소스 관리 영역이다.

예시:

• mybatis-config.xml → 전역 설정
• BookMapper.xml → SQL 매퍼 파일
• log4j.xml → 로그 설정

---

❺ pom.xml 설정

Maven이 사용할 라이브러리를 등록하는 파일이다. MyBatis + MySQL + log4j 조합을 기본 세팅으로 구성한다.

<dependencies>
  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.15</version>
  </dependency>
  
  <dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.33</version>
  </dependency>

  <dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
  </dependency>
</dependencies>

Maven이 .m2 폴더(로컬 저장소)에 자동으로 jar 파일을 다운로드하며, 개발자는 직접 jar를 추가하지 않아도 된다.

---

❻ IDE 설정 확인

1. IDE(Project) 우클릭 → “Maven → Update Project” 실행
2. 에러 발생 시 “File → Project Structure → SDK = JDK 17” 확인
3. src/main/java와 src/main/resources가 Source Root / Resource Root로 설정되어 있는지 확인

---

❼ 핵심 요약

✅ JDK : 자바 실행을 위한 기본 도구, JAVA_HOME 환경 변수 필수
✅ Maven : 프로젝트 빌드 & 라이브러리 자동 관리 도구
✅ java 폴더 : 실행 로직 (코드 중심)
✅ resources 폴더 : 설정/SQL/XML 등 외부 자원 중심
✅ 폴더 구조 : 코드와 설정을 분리해 유지보수성을 높임
✅ pom.xml : 의존성(Dependency) 관리의 중심 파일

이 준비가 끝나야 MyBatis ch01~ch03 실습이 매끄럽게 진행된다