[Spring] 스프링 MVC와 MyBatis와 연동하기 1 (MVNRepository 사용 방법, Maven, POM 설정)

Spring 프레임워크에서의 MyBatis, Maven

Spring 프레임워크 환경에서 MyBatis를 연동하고자 할 때는 Maven 저장소를 통해 의존성 관리를 손쉽게 할 수 있다. Maven 저장소는 빌드 툴로, 라이브러리 의존성 관리 툴로 활용이 더 많이 되고 있다. 스프링 프레임워크 사용 이전에는 필요한 라이브러리를 일일이 받아 /WEB-INF/lib 폴더와 WAS에 설치해 사용했다. 하지만, 시간이 지남에 따라 버전이 달라져 사용할 수 없는 라이브러리들이 발생할 위험이 있어 메이븐을 통해 보다 쉽게 관리하고자 한다.

 

🔍 MyBatis는 Java Persistance Framework(흔히 SQL 매핑 프레임워크로 분류한다)의 하나로, XML 서술자나 어노테이션을 사용해 저장 프로시저나 SQL문으로 객체를 연결시켜준다. 기존 SQL을 그대로 사용할 수 있다는 장점과 진입장벽이 낮아 JDBC의 대안으로 많이 사용한다. 주요 장점 중 하나는 다른 프레임워크와의 연동을 도와주는 추가적인 라이브러리가 많다는 것.

Spring Framework 상에서의 MyBatis 연동과 관련된 예제에서 살펴볼 구조는 아래와 같다.

🔍 Maven은 아파치의 앤트의 대안으로 나온 자바 프로젝트 관리 도구

 

메이븐의 경우 라이브러리는 프로젝트 내에 기존처럼 설치되는 방식이 아니라 설정 파일인 pom.xml 내부에 위치하게 된다. POM(Project Object Model)을 통해 실제 라이브러리 파일이 존재하는 저장소 서버의 위치와 사용할 라이브러리가 무엇인지 지정해준다.

 

 

 

Maven 기반의 프로젝트는 pom.xml에서 라이브러리의 의존성을 관리한다. (<dependencies> 태그들로 관리된다)

(이때, ojdbc6.jar 파일은 tomcat이 저장된 경로의 lib 폴더 내에 미리 설치해두었다는 전제 하에 진행한다.) 물론 Maven을 통해서도 라이브러리를 다운 받을 수 있다.

라이브러리 목록

MyBatis와 mybatis-spring과의 연동을 위해 필요한 라이브러리 목록은 아래와 같다.

1. Spring-jdbc
2. Spring-tx(transaction)

🔍 위 두 개의 라이브러리는 스프링에서 데이터베이스 처리와 트랜잭션 처리를 담당한다. (해당 라이블리들은 MyBatis와 무관해보이나, 추가하지 않은 경우에 에러를 발생시킬 수 있다.)

1. commons-loggin

Apache 재단의 Connection Pool 기능을 위한 라이브러리

1. commons-dbcp
2. commons-pool

MyBatis와 스프링 연동을 위한 관련 라이브러리

1. mybatis
2. mybatis-spring

MVNRepository

mvnrepository.com/

Maven Repository: Search/Browse/Explore

라이브러리를 다운 받고자 하는 프로젝트의 pom.xml을 열고, 아래 그림 같이 </dependencies> 태그가 끝나기 전에 새로운 라이브러리를 순차적으로 불러와줄 것이다.

pom.xml

 

1. Spring-jdbc

Spring-jdbc 검색 -> 제일 첫 번째 검색 결과인 Spring JDBC 클릭

일단은 현재 스프링 프레임워크의 버전과 릴리즈 버전 사이에서 고민하지말고, 릴리즈 버전을 무시한다. 목록 중 가장 최상단의 Spring JDBC를 선택하고 들어가면, 클립보드에 Maven 탭 아래의 소스 코드를 복사한다. 이때 주석이 불필요하다면 체크박스를 해제해 없애고 복사해온다. (릴리즈 버전을 나중에 변수로 대체할 것이므로 일단은 복사해오는 단계에서 버전 체크를 하지 않는다.)

같은 pom.xml 문서 상단에 보면, 스프링 프레임 워크의 버전을 EL 표기법으로 변수로 나타내고 있다. 그대로 복사해온다.

 

pom.xml 문서 아래에 라이브러리를 순차적으로 적기로 한 곳으로 돌아와, Maven repository에서 가지고 온 소스코드를 붙이고, <version> 태그 사이에 ${org.springframework-version} 을 적용해준다. 이제 일일이 프레임워크 버전에 맞춰 수기로 적지 않아도 된다.

다음 라이브러리를 다운 받기 전에 pom.xml 파일 내에서 빈번하게 사용되는 태그들의 기능에 대해서 짚고 넘어가보자. 각 라이브러리 다운 방식만을 보고 싶다면 아래 POM 파일의 구조 목차는 넘어가도 된다.

POM(Project Object Model) 파일의 구조

아래는 pom.xml 코드의 일부

	<modelVersion>4.0.0</modelVersion>
	<groupId>com.project</groupId>
	<artifactId>ex</artifactId>
	<name>MyProject</name>
	<packaging>war</packaging>
	<version>1.0.0-BUILD-SNAPSHOT</version>
	<properties>
		<java-version>1.6</java-version>
		<org.springframework-version>3.1.1.RELEASE</org.springframework-version>
		<org.aspectj-version>1.6.10</org.aspectj-version>
		<org.slf4j-version>1.6.6</org.slf4j-version>
	</properties>
    <dependencies>
    ..
    </dependencies>
    <build>
	..
    ..
    </build>

    

• <groupId> : 프로젝트를 구분할 목적으로 쓴다. 도메인 명이 들어간다.
• <artifactId> : 프로젝트를 구분할 목적으로 쓴다. 프로젝트 명이 들어간다.
  • 처음 프로젝트 생성할 때 com.project.ex로 정해주었다면, 폴더에서도 아래처럼 나올 것이다.

• <properties> : POM 내에서 공통적으로 사용하는 값을 설정할 수 있다. 때문에 이 POM 파일 내에서 ${org.springframework-version}처럼 사용할 수 있다.
• <repositories> : 라이브러리를 받아올 저장소를 지정할 수 있다. (optional)
  • 현재 위 코드 소스에는 없는 태그이지만, 만일 필요한 라이브러리를 사용하기 위해 직접 저장소를 추가해야 한다면, 사용하는 태그. pom.xml 아래 탭에서 Dependencies, Effective POM.. 같은 탭들을 볼 수 있는데, Effective POM에서 기본적으로 Maven이 제공하는 pom.xml 설정과 사용자가 새로이 지정한 설정을 한군데에서 합한 모습으로 확인할 수 있다.

 

• <dependencies> : 프로젝트에서 사용할 라이브러리를 지정한다.
• <build> : 프로젝트 빌드 방법을 지정한다.
• <scope> : optional. 아래 코드처럼 test 때만 필요하고, 배포 때는 불필요한 라이브러리의 경우, <scope> 태그로 지정해줄 수 있다. 그 외 다른 scope는 아래와 같다.
  • compile : default. 컴파일 및 배포 시 같이 제공된다.
  • provided : WAS에서 제공된다. 컴파일 시에는 필요하지만, 배포 시에는 빠지는 라이브러리일 경우.
  • runtime : 컴파일 시에는 불필요하지만, 실행 시에는 사용되는 라이브러리.
  • test : 테스트때만 사용
  • system : 저장소에서 관리하지 않고 직접 관리하는 jar 파일을 지정
  • import : 다른 pom 설정 파일에서 정의된 의존 관계를 이 프로젝트로 가지고 올 떄 사용.

https://codenboxautomationlab.com/maven/

		<!-- Test -->
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.7</version>
			<scope>test</scope>
		</dependency>     

 

2. Spring-tx(transaction)

 

		<!-- https://mvnrepository.com/artifact/org.springframework/spring-tx -->
		<dependency>
		    <groupId>org.springframework</groupId>
		    <artifactId>spring-tx</artifactId>
		    <version>${org.springframework-version}</version>
		</dependency>
				

 

3. commons-loggin

commons-loggin을 검색해 3번째 Apache Commons Logging을 클릭해 들어가 아래 소스코드처럼 1.2 버전을 다운 받는다. (2020-10-21 기준)

		<!-- https://mvnrepository.com/artifact/commons-logging/commons-logging -->
		<dependency>
		    <groupId>commons-logging</groupId>
		    <artifactId>commons-logging</artifactId>
		    <version>1.2</version>
		</dependency>

4. commons-dbcp

commons-dbcp 검색 -> 2번째 결과인 Commons DBCP

<!-- https://mvnrepository.com/artifact/commons-dbcp/commons-dbcp -->
<dependency>
    <groupId>commons-dbcp</groupId>
    <artifactId>commons-dbcp</artifactId>
    <version>1.4</version>
</dependency>

5. commons-pool

Commons Pool -> 최상단의 1.6 버전을 골랐다.

<!-- https://mvnrepository.com/artifact/commons-pool/commons-pool -->
<dependency>
    <groupId>commons-pool</groupId>
    <artifactId>commons-pool</artifactId>
    <version>1.6</version>
</dependency>

6. mybatis & mybatis-spring

mybatis와 mybatis spring을 모두 받아줄 것이다.

		<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
		<dependency>
		    <groupId>org.mybatis</groupId>
		    <artifactId>mybatis</artifactId>
		    <version>3.4.6</version>
		</dependency>
		
		<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis-spring -->
		<dependency>
		    <groupId>org.mybatis</groupId>
		    <artifactId>mybatis-spring</artifactId>
		    <version>1.3.2</version>
		</dependency>

 

이제 필요한 모든 라이브러리가 전부 받아졌다. 저장을 잘 한 뒤, 아래의 Dependencies 탭을 눌러 모든 라이브러리가 문제가 없는지 확인해볼 단계인데, 나는 라이브러리 다운 과정에서 아래처럼 Missing artifact org.springframework:spring-jdbc:jar${ org.springframework-vers ..같은 오류 메세지가 났다.

EL 표기시에 브레이스 사이에 스페이스가 만든 오류였으니, 같은 오류를 발견했다면 ${org.springframework-version}처럼 스페이스 없이 제대로 붙여주자.

 

참고 자료

Maven 저장소와 의존성 관리