[Day 2] SpringBoot + Vue.js에 MyBatis 끼얹기

이렇게 세팅 바보가 되어있을지 미처 저는 몰랐습니다.

공부 시급해짐... 오늘부터 최강야구 집에서 보지 않겠습니다.

 

1. pom.xml 수정

지난번에 SpringBoot Project 생성 시, MyBatis에 대한 dependency를 추가하지 않았기 때문에 추가해줘야 한다.

프로젝트 우클릭 > Spring > Add Starters > MyBatis Framework 추가

난 이미 추가해버려서 코드가 동일하지만, 왼쪽과 오른쪽을 맞춰주면 된다.

 

2. application.properties 수정

src/main/resources 파일 밑에 있는 application.properties 파일을 수정한다.

 

application.properties

#db connection(Oracle)
spring.datasource.url=jdbc:oracle:thin:@localhost:1521:xe
spring.datasource.username=오라클 db 사용자 id
spring.datasource.password=비밀번호
spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver
spring.sql.init.encoding=UTF-8

#mapper.xml location
mybatis.mapper-locations:classpath*:com/insa/insaSystem/mapper/*.xml
mybatis.configuration.map-underscore-to-camel-case=true

spring.datasource.hikari.maximum-pool-size=5

spring.datasource.url은 port와 sid를 수정하지 않았다면 그대로 사용하면 될 듯 싶다.

mybatis.mapper-locations는 mapper xml파일이 있는 경로를 적어주면 되는데,

이 때 classpath는 src/main/resources 를 의미한다.

 

mybatis.configuration.map-underscore-to-camel-case=true: 언더바를 camel case로 변환하는 설정이다.
DB는 대소문자 구별이 없으므로 언더바를 이용해 단어의 결합을 구분, java는 대소문자를 구분하므로 camel case방식을 사용하기 때문에 서로 이름이 다르게 되는데 이를 같은 이름으로 인식하여 매핑되도록 변환하는 설정이다.

(출처 : https://velog.io/@0829kuj/%EC%8A%A4%ED%94%84%EB%A7%81%EC%88%98%EC%97%85-15%EC%9D%BC%EC%B0%A8)

 

spring.datasource.hikari.maximum-pool-size는 말그대로 hikari의 최대 커넥션 풀의 크기를 지정해준다. 스프링부트 버전에 따라 자동으로 hikari가 설치가 된다고 본 것 같은데, 사실 에러 수정하다가 냅다 추가한거라 현재상황에서는 필요 없는 것 같기도...

 

※ classpath 경로 찾아보기 (←이거 때문에 에러난 사람 That's me)

프로젝트 우클릭 > Build Path > Configure Build Path ... > Source 탭 클릭 classpath는 위 java build path의 source 폴더를 모두 검색?한다. 헌데 나는 resources 파일이 해당 경로에 포함되어있지 않아서 xml 파일 경로를 찾지 못해서...온갖 에러를 발생시켰다. resources 파일 아래에 .xml 파일을 위치시킬거라면! 꼭 확인해볼 것!!!!

 

3. sql Bean 추가 → ProjectApplication.java

 

ProjectApplication.java

@SpringBootApplication(exclude = {MybatisAutoConfiguration.class})
@MapperScan(basePackages="com.insa.insaSystem.mapper")
public class ProjectApplication {

	public static void main(String[] args) {
		SpringApplication.run(InsaSystemApplication.class, args);
	}
	
	@Bean
	public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
		
		SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
		
		sessionFactory.setDataSource(dataSource);
		sessionFactory.setMapperLocations(
				new PathMatchingResourcePatternResolver().getResources("classpath*:com/insa/insaSystem/mapper/*.xml")
		);
		return sessionFactory.getObject();
	}
	
	@Bean
	public SqlSessionTemplate sqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {
		return new SqlSessionTemplate(sqlSessionFactory);
	}

}

@MapperScan basePackages에는 mapper 또는 dao에 해당하는 package를 작성한다.

sessionFactory MapperLocations에는 프로퍼티에 작성한 .xml 경로를 작성해준다.

 

4. Mapper interface, Mapper.xml 작성

 

TestMapper.java (

@Mapper
public interface TestMapper {
	
	public String testDB(@Param("rank") int rank) throws Exception;
}

DB에 연결이 잘 되는지 확인하기 위해서 testDB라는 interface를 만들어주었다.

사실, input Parameter 필요없는데.... 삽질하느라 이것저것 시도해보느라 넣어줬다.

 

해당 interface가 mapper라는걸 알려줘야하기 때문에 @Mapper 어노테이션을 사용한다.

 

testMapper.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.insa.insaSystem.mapper.testDao">
	
	<select id="testDB" parameterType="java.lang.Integer" resultType="java.lang.String">
		SELECT TEST_COL
		FROM TEST_TABLE
		WHERE RANK_COL = #{rank}
	</select>

</mapper>

.xml 파일 쿼리 id와 interface에서 작성한 메소드명이 같아야한다.

 

↓ Error Log

@Select 어노테이션

 

사실 위에 코드와는 상관 없지만, 어노테이션에 이해 없이 냅다 에러 없애겠다고 썼다가

ORA-00900 : invalid SQL statement 에러를 맛보았기 때문에 정리해본다.

 

@Select @Insert @Update 와 같은 어노테이션은 xml 파일을 거치지 않고 쿼리를 사용할 수 있도록 지원한다.

내가 구글링 할 때에는 정적쿼리를 사용할 때 쓴다고 봤는데, 지금 또 구글링해보니 아닌 것 같다.

 

@Mapper
public interface TestMapper {
	
	@Select("SELECT TEST_COL FROM TEST_TABLE WHERE RANK_COL = 1")
	public String testDB(@Param("rank") int rank) throws Exception;
}

와 같은 형태로 사용하는 것이다.

 

이때 나는 resources 경로설정이 제대로 되어있지 않아서 xml 경로를 찾지 못하는 상태였고,

해당 어노테이션을 사용하면 에러가 나지 않는다는 말만 듣고, @Select("testDB")

쿼리 ID를 냅다 써버렸다. 일단 SQL 에러가 나니, SQL 연결은 된거 아닌가!!하는 기쁨과 함께 말이다.

 

어쩐지...이런 어노테이션 없이도 마이바티스를 쓸 수 있는데 스프링부트라 쓰는건가 싶었다.

공부하자...윤귤시...

 

4. service.java, serviceImpl.java 작성 후, DB 연동 test

 

ProjectService.java

public interface TestService {
	public String test(int rank) throws Exception;
}

 

ProjectServiceImpl.java

Service
public class TestServiceImpl implements TestService{
	
	@Autowired
	testMapper testMapper;
	
	@Override
	public String test(int rank) throws Exception {
		return testMapper.testDB(rank);
	}
}

 

ProjectController.java

@Controller
public class ProejctController {
	
	@Autowired
	TestService testService;
	
	@RequestMapping(value = "/", method=RequestMethod.GET)
	public ModelAndView home() throws Exception {
		ModelAndView mv = new ModelAndView();
		
		mv.setViewName("index.html");
		
		int rank = 1;
		String test = testService.test(rank);
		
		System.out.println("DB 연동 확인용");
		System.out.println();
		System.out.println(test);
		
		return mv;
	}
}

 

작성 후, SpringBoot 내장 톰캣을 실행시키면

정상적으로 작동함을 알 수 있다.