[Spring-Framework] 6. Maven, Hibernate 5.4, Servlet, MySQL 8 연동(CRUD) - (1)
Hibernate 5.4 이상에서 ORM기반의 데이터베이스를 사용하는 방법에 대해서 소개하겠다.
글을 작성하게 된 계기는 인터넷을 검색해보니깐, 워낙 오래된 Hibernate 버전을 기준으로 현실성이 없는 복잡한 구현의 글이 많아서 쉽고 간단하게 작성할 수 없겠느냐는 생각을 갖고 좀 더 쉽고 적응하기 쉽도록 만들어보고자 작성하게 되었다.
글을 2부로 구성하였다.
조금 태스트를 하면서 느낀 소감은 iBatis나 SQL이 훨씬 사용하기에는 편리하다.
절차지향적인 언어인 SQL 사용하는 게 나쁜 건만 아니라고 본다.
조금 양이 많을 수 밖에 없어서 불가피하게 두 개의 글로 나누었으니 참고하길 바란다.
Hibernate(하이버네이트)란?
하이버네이트 ORM은 자바 언어를 위한 객체 관계 매핑 프레임워크이다.
객체 지향 도메인 모델을 관계형 데이터베이스로 매핑하기 위한 프레임워크를 제공한다.
하이버네이트는 GNU LGPL 2.1로 배포되는 자유 소프트웨어이다.
https://hibernate.org/
ORM(Object-relational mapping)이란?
ORM(Object-relational mapping)을 단순하게 표현하면 객체와 관계와의 설정이라 할 수 있다.
ORM에서 말하는 객체(Object)의 의미는 우리가 흔히 알고 있는 OOP(Object_Oriented Programming)의 그 객체를 의미한다는 것을 쉽게 유추할 수 있을 것이다. 그렇다면 과연 관계라는 것이 의미하는 것은 무엇일까?
지극히 기초적인 이야기지만 개발자가 흔히 사용하고 있는 관계형 데이터베이스를 의미한다.
[환경]
- 운영체제: Microsoft Windows 10
- 웹서버: Apache-tomcat-9.0.37 (http://tomcat.apache.org/)
- IDE: Spring Tool-Suite 4-4.7.2 Releases (https://spring.io/tools)
* JBoss -> Hibernate만 설치할 것(필수) - Help->Eclipse Marketplace
- 데이터베이스: MySQL 8.0.21 Windows 64bit (https://dev.mysql.com/downloads/mysql/)
* Library: Connector/J 8.0.21
- 개발 라이브러리:
* Maven
* hibernate-entitymanager (5.4.21 Final)
- https://mvnrepository.com/artifact/org.hibernate/hibernate-entitymanager
* javax.inject (1)
* javax.servlet-api (4.0.1)
- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api
* mysql-connector-java (8.0.21)
- https://mvnrepository.com/artifact/mysql/mysql-connector-java
1. MySQL Server - 설치하기
아래의 사이트에 접속한다.
https://dev.mysql.com/downloads/mysql/
설치 방법은 워낙 간단하고, 잡음이 적은 프로그램이므로 짧게 정리하였다.
그림 1) MySQL Server 8.0.21 - 설치하기
그림 2) MySQL Server 8.0.21 - 설치하기
2. 테이블 설계 (emptable, student)
dto 또는 model 영역 중 하나의 작업으로 두 개의 테이블을 설계하였다.
"emptable", "student"
그림 3) 데이터베이스 테이블 생성 - emptable
그림 4) 데이터베이스 테이블 생성 - student
CREATE TABLE `emptable` (
`empno` INT NOT NULL AUTO_INCREMENT,
`name` VARCHAR(20) NULL,
`address` VARCHAR(100) NULL,
`createdate` DATE NULL,
PRIMARY KEY (`empno`));
INSERT INTO `emptable` (`name`, `address`, `createdate`) VALUES ('하하', '안녕', '20-09-1');
CREATE TABLE `student` (
`studentno` INT NOT NULL AUTO_INCREMENT,
`name` VARCHAR(45) NULL,
`address` VARCHAR(100) NULL,
`createdate` DATE NULL,
PRIMARY KEY (`studentno`))
ENGINE = InnoDB
DEFAULT CHARACTER SET = utf8
COLLATE = utf8_unicode_ci;
INSERT INTO `student` (`name`, `address`, `createdate`) VALUES ('홍길동', '연습', '21-3-4');
[첨부(Attachments)]
3. 프로젝트 구성
미리 살펴보는 hibernateMaven2 프로젝트의 구성이다.
그림 5) 프로젝트 구성도 - hibernateMaven2
* Servlet 구성
- /SampleServlet
- /StudentServlet
4. POM.xml 수정하기(Maven 적용된 프로젝트)
pom.xml이 왜 없냐고 생각하는 경우가 있을 수 있다.
알기 쉽게 소개하면, maven이 적용되어있는 프로젝트에서 존재하는 기능이라고 보면 된다.
http://mvnrepository.com에 접속해서 몇 가지 구성을 찾아서 입력해줘야 한다.
(중략)
<!-- https://mvnrepository.com/artifact/org.hibernate/hibernate-entitymanager -->
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-entitymanager</artifactId>
<version>5.4.21.Final</version>
</dependency>
<!-- @Inject -->
<dependency>
<groupId>javax.inject</groupId>
<artifactId>javax.inject</artifactId>
<version>1</version>
</dependency>
<!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.21</version>
</dependency>
(중략)
그림 6) pom.xml 수정하기
5. hibernate 환경설정 - 생성과 수정
이 작업은 "JBoss -> hibernate" 라이브러리를 설치하지 않으면, 의미가 없다고 보면 된다.
수동으로 물론 셋팅할 수는 있으나 권장하진 않는다. (시도해봐도 무방, 처음에 찾는데 시간이 오래 걸린다. 이런 문제)
그림 7) 프로젝트 항목 -> 오른쪽 버튼 메뉴 모습
그림 8) Hibernate Configuration File 선택하기
- Hibernate XML Mapping file 기능은 생성이 되지 않는다.
(꼭 반드시 XML Mapping으로 hibernate resources를 잡을 필요는 없으며, Class Mapping도 사용된다.)
셋팅에서 필요한 부분들을 정리해보았다.
* hibernate.connection.driver_class = com.mysql.jdbc.Driver
* hibernate.connection.url = jdbc:mysql://localhost:3306/web?serverTimezone=UTC&characterEncoding=utf8
* hibernate.dialect = org.hibernate.dialect.MySQL8Dialect
* hibernate.show_sql = true
* hibernate.hbm2ddl.auto = update
* hibernate.default_entity_mode = pojo
* hibernate.current_session_context_class = thread
문제1. [MySQL 초기 설치 후 작업했을 때, 타임존 문제]
타임존 미설정시
* ERROR: The server time zone value
해결 방법1: serverTime=UTC를 입력해준다.
해결 방법2: 서버 my.cnf 파일에서 timezone을 지정해준다.
* my.cnf 파일 내에 환경 설정을 변경해주는 방법이 있다.
[mysqld]
default-time-zone='+9:00'
문제2. [UTF-8 환경설정 문제]
해결 방법1: characterEncoding=utf8을 입력해준다.
해결 방법2: 서버 my.cnf 파일에서 timezone을 지정해준다.
* my.cnf 파일 내에 환경 설정을 변경해주는 방법이 있다.
[mysqld]
init_connect = SET collation_connection = utf8_general_ci
init_connect = SET NAMES utf8
character-set-server = utf8
collation-server = utf8_general_ci
그림 9) hibernate.cfg.xml
[첨부(Attachments)]
* 경로는 다음과 같다. 참고로 초기에 폴더가 생성되어 있는 것이 아니라서, 수동으로 폴더를 만들어줘야 한다.
폴더: src/main/resources
그림 10) hibernate 모습
물론 공식 메뉴얼만 가지고 이해가 되지 않으면 추가적인 검색을 시도해봐도 된다.
5. 결과 - 미리 살펴보는 결과
완성된 작품은 이러한 모습을 가지고 있다.
무슨 작품을 만들지 생각해보기 위함이다.
그림 11) 출력 결과 - 웹 브라우저
그림 12) 출력 결과 - 웹 브라우저(2)
그림 13) 출력 결과 - 웹 브라우저(3)
6. 2부에서 만나요
게시글 2부에서 연속 글이 연재된다.
[Spring-Framework] 7. Maven, Hibernate 5.4, Servlet, MySQL 8 연동(CRUD) - (2)
* 참고 자료(References)
1. Hibernate Getting Started Guide, https://docs.jboss.org/hibernate/orm/5.4/quickstart/html_single/, Accessed by 2020-09-21, Last Modified 2020-08-27 10:35.
- 공식적인 Hibernate 메뉴얼이니 이해가 안 되면 읽어보길 바란다.
2. Hibernate 5 Java Configuration Example - DZone Java, https://dzone.com/articles/hibernate-5-java-configuration-example, Accessed by 2020-09-21, Last Modified 2018-12-03
- 추천(70점): 가장 실질적으로 많은 도움을 받았던 글이다. (영어 글)
3. MySQL(MariaDB) 서버 타임존 설정하기, https://offbyone.tistory.com/318, Accessed by 2020-09-21, Last Modified 2018-07-17 23:38.
4. java.sql.SQLException: The server time zone value ‘xx time’ is unrecognized, https://mkyong.com/jdbc/java-sql-sqlexception-the-server-time-zone-value-xx-time-is-unrecognized/, Accessed by 2020-09-21, Last Modified 2019-07-05.
- 비고: (영어 글)이다.
'소프트웨어(SW) > Spring-Framework(단종)' 카테고리의 다른 글
[Spring-Framework] 8. Spring MVC 웹 프로젝트 생성하기, UTF-8 문제(1) (1) | 2020.09.22 |
---|---|
[Spring-Framework] 7. Maven, Hibernate 5.4, Servlet, MySQL 8 연동(CRUD) - (2) (3) | 2020.09.21 |
[Spring-Framework] 5. 순정 Maven MVC 웹 프로젝트 - 서블릿, Oracle DB (2) | 2020.09.20 |
[Spring-Framework] 4. Eclipse와 Maven MVC 웹 프로젝트 - 생성하기 (5) | 2020.09.20 |
[Spring-Framework] 3. Eclipse와 Apache Maven 프로젝트 - 구축하기(1) (5) | 2020.09.19 |