스프링 게시판 만들기 #3. 스프링과 데이터 베이스 연동

다음 글 : #4. 게시물 목록 페이지 구현
이전 글 : #2. 깃허브 연동 및 데이터 베이스 준비

스프링 게시판 만들기 #1~3 깃허브 링크
스프링 게시판 만들기 (전체) 깃허브 링크

데이터 베이스가 준비되었으니, 스프링과 데이터 베이스를 연동해주겠습니다. 이번 게시물의 내용은 스프링에 마리아 DB (+MySQL) 연동과 비슷하지만, 약간 다른 부분이 있어서 새로 작성했습니다.

데이터 베이스에서 만든 테이블과 같은 형태의 VO(Value Object)를 먼저 만들어 보겠습니다. 지금 당장 VO를 사용하진 않으나, 데이터 베이스를 만들면

src/main/java 패키지를 우클릭한 후 New → Package를 선택합니다.

이름(Name)에 com.board.domain을 입력하고 완료(Finish) 버튼을 클릭합니다.

com.board.domain 패키지가 생성되었습니다.

com.board.domain 패키지를 우클릭하고 New → Class를 선택합니다.

이름(Name)에 BoardVO를 입력하고 완료(Finish) 버튼을 클릭합니다.

VO의 이름은 특별한 규칙은 없으나, 역할명에 맞도록 작성해주시면 됩니다.

BoardVO가 만들어 졌습니다.

내부에 tbl_board 테이블을 만들 때 사용한 쿼리를 넣고 주석처리했습니다.

이렇게 하는 이유는 VO를 만들 때 테이블과 똑같이 만들어줘야하다보니 확인하기 쉽도록, 그리고 다른 사람이 이 VO를 보더라도 어느 테이블을 사용하는지 바로 알 수 있기 때문입니다.

하지만 그냥 주석을 걸어두기만 해도 되는거라, 굳이 이렇게할 필요는 없습니다.

테이블의 컬럼과 동일한 명칭과 데이터형으로 변수를 만들어줍니다.

private int bno;
private String title;
private String content;
private String writer;
private Date regDate;
private int viewCnt;

이렇게 작성하면 Date 부분에 자료형 에러가 발생하는데, Ctrl + Shift + O 를 누릅니다.

Java.util.Date를 선택하고 완료(Finish) 버튼을 클릭합니다.

그러면 방금 선택했던 자료형이 임포트(import)된걸 확인할 수 있습니다.

스프링 상단 메뉴에서 Source → Generate Getters and Setters를 선택합니다.

Select All 버튼을 클릭하고, 생성(Generate) 버튼을 클릭합니다.

모든 변수에 대한 Getter와 Setter가 생성되었습니다.

Getter와 Setter가 있어야 VO의 데이터를 사용할 수 있으므로, 이 작업은 필수입니다.

pom.xml파일을 열고, 하단 탭에서 pom.xml을 선택합니다.

</dependencies> 위에 코드를 추가합니다.

<!-- maria db -->
<dependency>
    <groupId>org.mariadb.jdbc</groupId>
    <artifactId>mariadb-java-client</artifactId>
    <version>2.3.0</version>
</dependency>

<!-- org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.4.1</version>
</dependency>

<!-- mybatis-spring -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>1.3.0</version>
</dependency>

<!-- spring-jdbc -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>${org.springframework-version}</version>
</dependency>

이 코드는 MavenRepository에서 찾을 수 있으며, 스프링과 마리아 DB(MySQL)의 연동을 할 수 있게 해줍니다.

src → main → webapp → WEB-INF → spring 에서 root-context.xml 파일을 열고, Namespaces 탭을 선택한 뒤 화면 처럼 beans, context, jdbc, mybatis에 체크합니다.

root-context.xml의 Source탭을 선택합니다.

데이터 베이스에 접속할 수 있도록 빈(bean) 코드를 추가합니다.

<bean
 class="org.springframework.jdbc.datasource.DriverManagerDataSource"
 id="dataSource">
 <property name="driverClassName" value="org.mariadb.jdbc.Driver" />
 <property name="url" value="jdbc:mariadb://127.0.0.1:3306" />
 <property name="username" value="kuzuro" />
 <property name="password" value="1111" />
</bean>

<bean id="sqlSessionFactory"
 class="org.mybatis.spring.SqlSessionFactoryBean">
 <property name="dataSource" ref="dataSource" />
 <property name="configLocation" value="classpath:/mybatis-config.xml" />
 <property name="mapperLocations" value="classpath:mappers/**/*Mapper.xml" />
</bean>

<bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate" destroy-method="clearCache">
 <constructor-arg name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>

다른 코드는 수정할 필요가 없으나, username과 password는 자신의 데이터 베이스 설정에 맞도록 수정해야합니다.

마이바티스 설정을 위한 xml파일이 필요합니다.

src/main/resources를 우클릭하고 New → Other를 선택합니다.

xml로 검색하면 바로 찾을 수 있습니다. XML File를 선택하고 다음(Next) 버튼을 클릭합니다.

경로가 src → main → resoureces인걸 확인하고, 파일 이름(File name)에 mybatis-config을 입력한 뒤 완료(Finish) 버튼을 클릭합니다. 확장자(.xml)는 있든 없든 상관없이 생성됩니다.

만약, root-context.xml에서 마이바티스(mybatis) 설정 파일이름을 mybatis-config.xml이 아닌 다른 이름으로 했다면, 그 이름으로 해주시면 됩니다.

마이바티스 사이트를 참고하여 기본 코드를 입력합니다.

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

</configuration>

이번엔 매퍼(mapper)를 추가합니다.

src/main/resources를 우클릭하고 New → Folder를 선택합니다.

경로가 src → main → resoureces인걸 확인하고, 폴더 이름(Folder name)에 mappers을 입력한 뒤 완료(Finish) 버튼을 클릭합니다.

생성된 mappers 폴더를 우클릭하고 New → Other를 선택합니다.

XML File을 선택하고 다음(Next) 버튼을 클릭합니다.

경로가 src → main → resoureces → mappers인걸 확인하고, 파일 이름(File name)에 boardMapper를 입력한 뒤 완료(Finish) 버튼을 클릭합니다. 확장자(.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.board.mappers.board">

</mapper>

이때, 네임스페이스(namespace)는 각각의 매퍼를 구분하는 고유명이 됩니다.

프로젝트를 우클릭한 뒤 Runs As → Runs on Server를 선택하여 실행해봅니다.

root-context.xml에 등록한 빈(bean)에 맞는 마아바티스 설정 파일과 매퍼 폴더가 없는 경우, 즉 mybatis-config.xml과 mappers 폴더가 없는 경우 에러가 발생하며 프로젝트가 실행되지 않습니다.

프로젝트가 정상적으로 실행되었습니다. 이상 없이 잘 된것 같습니다.

다음 글 : #4. 게시물 목록 페이지 구현
이전 글 : #2. 깃허브 연동 및 데이터 베이스 준비

스프링 게시판 만들기 #1~3 깃허브 링크
스프링 게시판 만들기 (전체) 깃허브 링크