- EMPNO VARCHAR(4) NOT NULL PRIMARY KEY : 직원번호(EMPNO) 는 기본키(PRIMARY KEY)로, 중복되거나 비워져서는 안된다(NOT NULL)
- SAL DOUBLE, ORDERNUM INTEGER: INTEGER 는 정수, DOUBLE은 실수(소수점 가능) SAL은 급여 컬럼으로 소수점이 가능하나, ORDERNUM 은 정렬 순서로 정수만 나올 수 있음.
CREATE SEQUENCE AUTO_INCREMENT
AS INTEGER
START WITH 1
INCREMENT BY 1;
AUTO_INCREMENT라는 이름의 시퀀스를 생성.
정수(INTEGER) 타입이고, 1부터 시작해서 1씩 증가한다.
이 시퀀스는 주로 자동으로 증가하는 숫자를 생성할 때 사용한다.
ex) 테이블에 새로운 행을 삽입할 때 고유한 ID 값을 자동으로 생성하고 싶을 때
이 이후 Insert 할 때
INSERT INTO EMP (회원번호, 이름)
VALUES (NEXT VALUE FOR AUTO_INCREMENT, '홍길동');
이렇게 하면 회원번호에 자동으로 1,2,3... 이렇게 들어간다.
시퀀스는 전체 테이블에 동작하는건 아니고,
원하는 테이블/컬럼에서 NEXT VALUE FOR 시퀀스명을 직접 사용해야만 동작한다.
-> 확인해보니 MOVIEINFO 테이블에 쓰려고 만든 것. 일반 EMP와 DEPT 테이블에서는 필요가 없다.
SET DATABASE DEFAULT INITIAL SCHEMA PUBLIC
데이터베이스를 처음 열었을 때 사용할 기본 스키마를 PUBLIC으로 설정.
"앞으로 이 DB를 열면 자동으로 PUBLIC 스키마를 기본으로 사용하게 해!"
여러개 스키마를 쓸 수 있게 하는데 DB 열면 그냥 기본이 PUBLIC으로 하자.
스키마를 PUBLIC 한개만 만들어서 없어도 상관없긴하다.
하지만 스크립트를 이식할 때 다른 환경에서는 스키마가 여러개일 수 있으니 기본값을 정해놓은 것이다.
ex) 다른 스키마가 생길 수 있는 환경, 도구 연동, 이식성 대비
또한 HSQLDB에서 초기 접속 시점에 기본 스키마를 명확히 해주면, 접속한 유저나 설정에 따라 초기 스키마가 null, unknown일 경우 오류가 발생하지 않도록 해준다.
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.SQL_IDENTIFIER TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.YES_OR_NO TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.TIME_STAMP TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.CARDINAL_NUMBER TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.CHARACTER_DATA TO PUBLIC
INFORMATION_SCHEMA라는 특수한 스키마에 있는 도메인들(domain)에 대한 권한을 부여.
"DB 내부 구조(테이블명, 날짜, 숫자, 텍스트 등)에 관련된 기본 데이터 타입들에 대해,
모든 사용자(PUBLIC)가 사용할 수 있도록 허용해!"
이것도 꼭 필요한 구문은 아님.
HSQLDB나 다른 RDB에서 내부적으로 자동으로 생성되는 초기 스크립트에 포함되어있는 경우로 그냥 자동 생성된거다.
DB 새로 만들 때
어떤 툴(DBeaver, HSQL Database Manager 등)을 통해 내보내기(export) 했을 때
시스템 테이블을 백업/초기화할 때
이런 경우 혹시 필요한 경우를 대비해 PUBLIC(모든 사용자)이 기본적인 메타 도메인 타입에 접근할 수 있도록 미리 권한을 주는 것이다.
식별자(SQL_IDENTIFIER), yes, no 같은 제한된 타입(YES_OR_NO), 타임스탬프(TIME_STAMP), 숫자(CARDINAL_NUMBER), 문자열(CHARACTER_DATA) 타입의 도메인을 모든 사용자가 사용할 수 있게 하용한다.
✅ 도메인(domain)이란?
도메인(Domain)은 데이터베이스 설계에서 데이터의 범위와 형식을 제한하는 방법으로, SQL에서는 컬럼에 대해 허용할 수 있는 값의 타입과 규칙을 정의하는 객체.
간단히 말하면, 특정 데이터 타입에 대해 제약 조건을 설정하는 것이다.
예를 들어, 날짜, 전화번호, 금액 등의 규격을 정의하고, 이를 여러 테이블에서 재사용할 수 있게 해준다.
도메인을 사용하면 중복 코드를 줄이고, 데이터의 일관성 및 무결성을 유지하는 데 유리하다.
일반적으로 SQL 데이터 타입(예: VARCHAR, INTEGER, DATE 등)과 유사하지만, 그것들을 특정 규칙과 함께 제한할 수 있다.
예를 들어, 날짜 데이터에서 생일은 미래일 수 없으니 과거 날짜만 가능하도록 하고 싶다면?
CREATE DOMAIN PastDate AS DATE
CHECK (VALUE <= CURRENT_DATE);
CREATE DOMAIN PhoneNumber AS VARCHAR(15)
CHECK (VALUE LIKE '(___)____-____' OR VALUE LIKE '(XXX)XXX-XXXX');
-을 포함한 11자리 숫자만 허용하는 도메인 생성.
INFORMATION_SCHEMA는 내가 생성한 스키마가 아니라 SQL 표준에 정의된 데이터 베이스의 메타데이터를 관리하는 스키마로, 그냥 기본 설정파일 같은거라고 보면 된다.
얘네의 기본 설정값을 최초에 정의한 스키마 PUBLIC에게 사용권한을 주는 명령어가 바로
GRANT USAGE ON DOMAIN 이다.
-- EMP 테이블에 한 행을 삽입
INSERT INTO EMP
VALUES
(
'3092', -- EMPNO: 직원 번호 (직원의 고유 번호, '3092'번 직원)
'JOHN', -- ENAME: 직원 이름 ('JOHN')
'CLERK', -- JOB: 직무 ('CLERK', 사무직)
'OD', -- JOBSTATUS: 직무 상태 ('OD', 직무 상태 코드, 예: "On Duty"일 수 있음)
'7782', -- MGR: 상사 직원 번호 (상사의 직원 번호, 이 직원의 상사는 '7782'번 직원)
'20160601', -- HIREDATE: 고용 날짜 ('20160601', 직원이 고용된 날짜, 'YYYYMMDD' 형식)
4300.0E0, -- SAL: 급여 (4300.0, 급여 금액, 'E0'는 지수 표기법으로 4300.0을 의미)
100.0E0, -- COMM: 커미션 (100.0, 커미션 금액, 'E0'는 지수 표기법으로 100.0을 의미)
'10', -- DEPTNO: 부서 번호 (부서 번호 '10'번 부서에 속한 직원)
3, -- LV: 직원 레벨 (3, 직원의 직급, 예를 들어, 3은 특정 직급을 나타냄)
14 -- ORDERNUM: 직원 순번 (부서 내에서 이 직원의 순번, 예를 들어, 14번째 직원)
);
EMP 테이블에 각각 해당하는 데이터를 넣는다.
-- DEPT 테이블에 한 행을 삽입
INSERT INTO DEPT
VALUES
(
'10', -- DEPTNO: 부서 번호 ('10', 부서 번호 10번)
'ACCOUNTING', -- DNAME: 부서 이름 ('ACCOUNTING', 회계 부서)
'NEWYORK' -- LOC: 부서 위치 ('NEWYORK', 부서의 위치)
);
DEPT 테이블에 각각 해당하는 데이터를 넣는다.
결론적으로 EMP/DEPT 테이블 기본 설정 끝!
SET SCHEMA PUBLIC
SET DATABASE SQL SYNTAX ORA TRUE
--테이블 생성
CREATE MEMORY TABLE PUBLIC.EMP(EMPNO VARCHAR(4) NOT NULL PRIMARY KEY,ENAME VARCHAR(30),JOB VARCHAR(9),JOBSTATUS VARCHAR(9),MGR VARCHAR(4),HIREDATE VARCHAR(8),SAL DOUBLE,COMM DOUBLE,DEPTNO VARCHAR(2), LV INTEGER, ORDERNUM INTEGER)
CREATE MEMORY TABLE PUBLIC.DEPT(DEPTNO VARCHAR(2) NOT NULL PRIMARY KEY,DNAME VARCHAR(14),LOC VARCHAR(13))
SET DATABASE DEFAULT INITIAL SCHEMA PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.SQL_IDENTIFIER TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.YES_OR_NO TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.TIME_STAMP TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.CARDINAL_NUMBER TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.CHARACTER_DATA TO PUBLIC
--데이터 삽입
INSERT INTO EMP VALUES('3092','JOHN','CLERK','OD','7782','20160601',4300.0E0,100.0E0,'10', 3, 14)
INSERT INTO EMP VALUES('7499','ALLEN','SALESMAN','OD','7698','20130619',1600.0E0,300.0E0,'30', 3, 11)
INSERT INTO EMP VALUES('7521','WARD','SALESMAN','LV','7698','19810222',1250.0E0,500.0E0,'30', 3, 7)
INSERT INTO EMP VALUES('7566','JONES','MANAGER','OD','7839','19810402',2975.0E0,0.0E0,'20', 2, 2)
INSERT INTO EMP VALUES('7654','MARTIN','SALESMAN','OD','7698','19810928',1250.0E0,1400.0E0,'10', 3, 9)
INSERT INTO EMP VALUES('7698','BLAKE','MANAGER','LV','7839','19810501',2850.0E0,0.0E0,'30', 2, 6)
INSERT INTO EMP VALUES('7782','CLARK','MANAGER','OD','7839','19810609',2450.0E0,0.0E0,'10', 2, 12)
INSERT INTO EMP VALUES('7788','SCOTT','ANALYST','OD','7566','19870713',99999.0E0,0.0E0,'10', 3, 4)
INSERT INTO EMP VALUES('7839','KING','PRESIDENT','OD','','19811117',5000.0E0,0.0E0,'10', 1, 1)
INSERT INTO EMP VALUES('7844','TURNER','SALESMAN','OD','7698','19810908',1500.0E0,0.0E0,'30', 3, 8)
INSERT INTO EMP VALUES('7876','ADAMS','CLERK','RS','7788','19870713',1100.0E0,0.0E0,'20', 4, 5)
INSERT INTO EMP VALUES('7900','JAMES','CLERK','SB','7698','19811203',950.0E0,0.0E0,'30', 3, 10)
INSERT INTO EMP VALUES('7902','FORD','ANALYST','SB','7566','19811203',3000.0E0,100.0E0,'20', 3, 3)
INSERT INTO EMP VALUES('7934','MILLER','CLERK','LV','7782','19820123',1300.0E0,200.0E0,'10', 3, 13)
INSERT INTO DEPT VALUES('10','ACCOUNTING','NEWYORK')
INSERT INTO DEPT VALUES('20','RESEARCH','DALLAS')
INSERT INTO DEPT VALUES('30','SALES','CHICAGO')
INSERT INTO DEPT VALUES('40','OPERATIONS','BOSTON')
INSERT INTO DEPT VALUES('50','R&D','NEWYORK')
INSERT INTO DEPT VALUES('60','TECH SUPPORT','DALLAS')
INSERT INTO DEPT VALUES('70','MARKETING','CHICAGO')
INSERT INTO DEPT VALUES('80','DESIGN','BOSTON')
INSERT INTO DEPT VALUES('90','FACTORY1','NEWYORK')
INSERT INTO DEPT VALUES('91','FACTORY2','CHICAGO')
어차피 실행하고 있는 ibsheetTpdb.sql은 한개이고, context-mapper.xml 에서 ibsheetTemplate/*.xml 과 같이 아스타로 모든 파일을 다 열어놨기 때문에 시행은 다 된다.
기존에는 mapper 구조로 되어있긴 한데, 잘되는거 그냥 유지시켜보자.....(나중에 mapper로 다시 해보지 뭐)
xml 부터 변환
1. empMapper.xml -> IbsheetMapper.xml
namespace를 변경해줘야한다.
<!-- 기존 -->
<mapper namespace="egovframework.mapper.let.ibsheetTemplate.empMapper">
<!-- 변경 -->
<mapper namespace="egovframework.mapper.let.ibsheetTemplate.IbsheetMapper">
내용은 기존 내용 가져다 쓰기
<select id="selectEmpList" resultType="egovMap">
SELECT
EMPNO -- 사번
, ENAME -- 이름
, JOB -- 직무
, JOBSTATUS -- 직무 상태
, MGR -- 상사 번호
, HIREDATE -- 입사일
, SAL -- 급여
-- 월별 급여 시뮬레이션
, (SAL) AS JAN
, (SAL * 1.05) AS FEB
, (SAL * 0.95) AS MAR
, (SAL * 1.7) AS APR
, (SAL * 0.75) AS MAY
, COMM -- 커미션
, DEPTNO -- 부서번호
-- 급여 기준으로 텍스트 색상을 다르게 지정
, CASE
WHEN SAL > 4500 THEN '#FF0000'
ELSE '#0000FF'
END AS salTextColor
-- MGR이 없으면 편집 불가(0), 있으면 편집 가능(1)
, CASE
WHEN MGR IS NULL THEN '0'
ELSE '1'
END AS _edit
FROM EMP
WHERE 1 = 1
</select>
SAL 컬럼은 1월엔 급여 그대로, 2월엔 5% 인상, 3월엔 5% 감소 등 월별 급여를 시뮬레이션해서 보여주는 계산 컬럼이다.
색상을 지정하여 가져오면 TextColor 값을 핸들링할 수 있기 때문에 CASE 문에서 색상 부여,
추가로 MGR 여부에 따라 편집 여부도 부여한다.
정상동작 하는지 확인할 것.
2. empVO -> IbsheetVO
기존에는 VO가 없지만 인정성을 위해 부여.
3. EmpDAO-> IbsheetDAO
DAO 이름 수정하고 @Repository 이름 수정.
@Repository("ibsheetDAO")
public class IbsheetDAO extends EgovAbstractMapper {
public List<?> selectEmpList(Map<String, String> map){
return selectList("egovframework.mapper.let.ibsheetTemplate.IbsheetMapper.selectEmpList");
}
}
Color 값 등 어떤 타입이 올지 몰라서 제네릭 와일드카드로 열어두자.
리턴 타입: List<?>
이건 제네릭 와일드카드이며, 어떤 타입이든 허용한다는 의미
타입 안정성이 떨어짐. 사용 시 다운캐스팅이 필요할 수 있음
파라미터: Map<String, String> map
조건을 넣을 수 있음. 예: 이름, 부서번호 등
기존의 List<Map<String, Object>> 는 결과가 Map 형태로 확정되어 있어 사용 시 바로 .get("컬럼명") 가능함.
+ 타입 안정성이 높고 직관적으로 데이터를 다루기 쉬움
우선 그대로 만들어보고 추후에 리턴타입을 변경하자.
4. EmpSearvice -> IbsheetService
package egovframework.let.ibsheetTemplate.service;
import java.util.List;
import java.util.Map;
public interface IbsheetService {
public List<?> selectEmpList(Map<String, String> map) throws Exception;
}
[저장] 이라는 것 자체가 추가/수정/삭제를 상태값에 따라 반영하는 것을 한번에 하는 동작이다.
따라서 각각의 동작을 수행할 수 있는 SQL 문을 추가하자.
<!-- EMP 데이터 저장(추가/수정/삭제) -->
<insert id="insertEmpList" parameterType="map">
<![CDATA[
/** insertEmpList */
INSERT INTO EMP (
EMPNO
, ENAME
, JOB
, MGR
, HIREDATE
, SAL
, COMM
, DEPTNO
)
VALUES (
#{empno}
, #{ename}
, #{job}
, #{mgr}
, #{hiredate}
, #{sal}
, #{comm}
, #{deptno}
)
]]>
</insert>
<update id="updateEmpList" parameterType="map">
<![CDATA[
/** updateEmpList */
UPDATE EMP
SET
DEPTNO = #{deptno}
, COMM = #{comm}
, HIREDATE = #{hiredate}
, MGR = #{mgr}
, SAL = #{sal}
, JOB = #{job}
, ENAME = #{ename}
WHERE 1=1
AND EMPNO = #{empno}
]]>
</update>
<delete id="deleteEmpList" parameterType="map">
<![CDATA[
/** deleteEmpList */
DELETE
FROM EMP
WHERE 1=1
AND EMPNO = #{empno}
]]>
</delete>
2. IbsheetDAO
vo는 그대로니까 건들일 필요 없고, DAO 가서 Mapper를 연결해주자.
저장은 한번에 처리하지만 insert/update/delete는 각각 수행하므로 아래와 같이 따로따로 연결.
public void insertEmp(Map<String, Object> mp){
insert("egovframework.mapper.let.ibsheetTemplate.IbsheetMapper.insertEmpList", mp);
}
public void updateEmp(Map<String, Object> mp){
update("egovframework.mapper.let.ibsheetTemplate.IbsheetMapper.updateEmpList", mp);
}
public void deleteEmp(Map<String, Object> mp){
delete("egovframework.mapper.let.ibsheetTemplate.IbsheetMapper.deleteEmpList", mp);
}
3. IbsheetService
Service 가서 인터페이스 설정.
public void saveEmpList(List<?> li) throws Exception;
4. IbsheetServiceImpl
ServiceImpl 가서 인터페이스 설정.
@SuppressWarnings({ "unchecked", "static-access" })
public void saveEmpList(List<?> li) throws Exception {
for(int i=0;i<li.size();i++){
Map<String,Object> record = (Map<String,Object>)li.get(i);
IBSheetUtil iu = new IBSheetUtil();
iu.mapPrint(record);
//IBSheet 상태 컬럼의 값에 따른 작업 설정
switch((record.get("sStatus")+"").charAt(0)){
case 'I':
ibsheetDAO.insertEmp(record);
break;
case 'U':
ibsheetDAO.updateEmp(record);
break;
case 'D':
ibsheetDAO.deleteEmp(record);
break;
}
}
}
상태값에 따라 추가/수정/삭제 되도록 설정해주기.
5. IbsheetTemplateController
데이터 받으면 json 형태로 변환한 뒤 해당 리스트를 saveEmpList()로 보낸다.
추가로 IO에서 결과값 코드와 Message를 보내면 화면단에 뿌릴 수 있음.
@SuppressWarnings("rawtypes")
@RequestMapping(value = "/empSave.do")
public ModelAndView saveEmp(HttpServletRequest request, HttpServletResponse response) throws Exception {
IBSheetUtil ibUtil = new IBSheetUtil();
List<Map> list = ibUtil.getSheetData8(request.getParameter("Data"));
JSONObject result = new JSONObject();
JSONObject IO = new JSONObject();
try{
ibsheetService.saveEmpList(list);
IO.put("Result", 0);
IO.put("Message", "성공적으로 저장되었습니다.");
result.put("IO", IO);
}catch(Exception ex){
IO.put("Result", -10);
IO.put("Message", "저장 중 오류가 발생했습니다.");
result.put("IO", IO);
}
//JSON
ibUtil.setEtc("mySheet","age", "51");
ModelAndView model = new ModelAndView("jsonView",result);
System.out.println("model : "+ model);
//JSON 반환
return model;
}
근데 어라...왜 안되지.... 콘솔에 오류도 없고 하길래 왜 안되나 봤더니...
조회데이터랑 다르게 저장데이터는 " 와 같이 HTML 엔티티가 포함되어있다.
아무래도 클라이언트에서 json으로 데이터 받을 때 HTML 인코딩 상태로 넘어온 것 같다.
이거 디코딩 해주자.
<!-- pom.xml에 추가 -->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.12.0</version> <!-- 버전은 프로젝트에 맞게 조정 -->
</dependency>
SET SCHEMA PUBLIC
SET DATABASE SQL SYNTAX ORA TRUE
--테이블 생성
CREATE MEMORY TABLE PUBLIC.EMP(EMPNO VARCHAR(4) NOT NULL PRIMARY KEY,ENAME VARCHAR(30),JOB VARCHAR(9),JOBSTATUS VARCHAR(9),MGR VARCHAR(4),HIREDATE VARCHAR(8),SAL DOUBLE,COMM DOUBLE,DEPTNO VARCHAR(2), LV INTEGER, ORDERNUM INTEGER)
CREATE MEMORY TABLE PUBLIC.DEPT(DEPTNO VARCHAR(2) NOT NULL PRIMARY KEY,DNAME VARCHAR(14),LOC VARCHAR(13))
SET DATABASE DEFAULT INITIAL SCHEMA PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.SQL_IDENTIFIER TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.YES_OR_NO TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.TIME_STAMP TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.CARDINAL_NUMBER TO PUBLIC
GRANT USAGE ON DOMAIN INFORMATION_SCHEMA.CHARACTER_DATA TO PUBLIC
--데이터 삽입
INSERT INTO EMP VALUES('3092','JOHN','CLERK','OD','7782','20160601',4300.0E0,100.0E0,'10', 3, 14)
INSERT INTO EMP VALUES('7499','ALLEN','SALESMAN','OD','7698','20130619',1600.0E0,300.0E0,'30', 3, 11)
INSERT INTO EMP VALUES('7521','WARD','SALESMAN','LV','7698','19810222',1250.0E0,500.0E0,'30', 3, 7)
INSERT INTO EMP VALUES('7566','JONES','MANAGER','OD','7839','19810402',2975.0E0,0.0E0,'20', 2, 2)
INSERT INTO EMP VALUES('7654','MARTIN','SALESMAN','OD','7698','19810928',1250.0E0,1400.0E0,'10', 3, 9)
INSERT INTO EMP VALUES('7698','BLAKE','MANAGER','LV','7839','19810501',2850.0E0,0.0E0,'30', 2, 6)
INSERT INTO EMP VALUES('7782','CLARK','MANAGER','OD','7839','19810609',2450.0E0,0.0E0,'10', 2, 12)
INSERT INTO EMP VALUES('7788','SCOTT','ANALYST','OD','7566','19870713',99999.0E0,0.0E0,'10', 3, 4)
INSERT INTO EMP VALUES('7839','KING','PRESIDENT','OD','','19811117',5000.0E0,0.0E0,'10', 1, 1)
INSERT INTO EMP VALUES('7844','TURNER','SALESMAN','OD','7698','19810908',1500.0E0,0.0E0,'30', 3, 8)
INSERT INTO EMP VALUES('7876','ADAMS','CLERK','RS','7788','19870713',1100.0E0,0.0E0,'20', 4, 5)
INSERT INTO EMP VALUES('7900','JAMES','CLERK','SB','7698','19811203',950.0E0,0.0E0,'30', 3, 10)
INSERT INTO EMP VALUES('7902','FORD','ANALYST','SB','7566','19811203',3000.0E0,100.0E0,'20', 3, 3)
INSERT INTO EMP VALUES('7934','MILLER','CLERK','LV','7782','19820123',1300.0E0,200.0E0,'10', 3, 13)
INSERT INTO DEPT VALUES('10','ACCOUNTING','NEWYORK')
INSERT INTO DEPT VALUES('20','RESEARCH','DALLAS')
INSERT INTO DEPT VALUES('30','SALES','CHICAGO')
INSERT INTO DEPT VALUES('40','OPERATIONS','BOSTON')
INSERT INTO DEPT VALUES('50','R&D','NEWYORK')
INSERT INTO DEPT VALUES('60','TECH SUPPORT','DALLAS')
INSERT INTO DEPT VALUES('70','MARKETING','CHICAGO')
INSERT INTO DEPT VALUES('80','DESIGN','BOSTON')
INSERT INTO DEPT VALUES('90','FACTORY1','NEWYORK')
INSERT INTO DEPT VALUES('91','FACTORY2','CHICAGO')
2. MyBatis 매퍼 파일 작성
EMP 테이블 전체 데이터를 조회하는 MyBatis 매퍼(xml) 파일을 만드는 작업.
resources > egovframework > mapper > let > ibsheetTemplate 경로에 empMapper.xml 파일 생성
empMapper.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="egovframework.mapper.let.ibsheetTemplate.empMapper">
<!-- EMP 전체 조회 -->
<select id="selectEmpList" resultType="egovMap">
<![CDATA[
SELECT * FROM EMP
]]>
</select>
</mapper>
데이터는 간단하게 전체를 조회해본다.
namespace는 이 매퍼 파일을 참조할 때 사용할 이름이다.
selectEmpList는 DAO에서 호출할 메서드명이다.
resultType="egovMap"은 eGovFrame에서 자주 사용하는 결과 타입으로, key-value로 데이터를 받을 수 있다.
<![CDATA[ ]]>안에 SQL을 넣는 이유는, XML 특수 문자와 충돌하지 않게 하기 위함이다.
mapper-config.xml 파일에 Type Aliases 설정이 기본적으로 되어있다.
3. Service 인터페이스와 VO 생성
Service 인터페이스와 VO 객체를 만드는 작업.
java > egovframework > let > ibsheetTemplate > service 경로에 EmpService.java 파일 생성 java > egovframework > let > ibsheetTemplate > service 경로에 EmpVO.java 파일 생성
package egovframework.let.ibsheetTemplate.service;
import java.io.Serializable;
public class EmpVO implements Serializable {
private static final long serialVersionUID = 1L;
private String empno;
private String ename;
private String job;
private String jobstatus;
private String mgr;
private String hiredate;
private Double sal;
private Double comm;
private String deptno;
private Integer lv;
private Integer ordernum;
// getter/setter
public String getEmpno() { return empno; }
public void setEmpno(String empno) { this.empno = empno; }
public String getEname() { return ename; }
public void setEname(String ename) { this.ename = ename; }
public String getJob() { return job; }
public void setJob(String job) { this.job = job; }
public String getJobstatus() { return jobstatus; }
public void setJobstatus(String jobstatus) { this.jobstatus = jobstatus; }
public String getMgr() { return mgr; }
public void setMgr(String mgr) { this.mgr = mgr; }
public String getHiredate() { return hiredate; }
public void setHiredate(String hiredate) { this.hiredate = hiredate; }
public Double getSal() { return sal; }
public void setSal(Double sal) { this.sal = sal; }
public Double getComm() { return comm; }
public void setComm(Double comm) { this.comm = comm; }
public String getDeptno() { return deptno; }
public void setDeptno(String deptno) { this.deptno = deptno; }
public Integer getLv() { return lv; }
public void setLv(Integer lv) { this.lv = lv; }
public Integer getOrdernum() { return ordernum; }
public void setOrdernum(Integer ordernum) { this.ordernum = ordernum; }
}
EmpService는 컨트롤러와 DAO를 연결해주는 중간 역할이다.
EmpVO는 EMP 테이블의 데이터를 객체로 담는 용도이지만, 여기서는 egovMap을 사용해도 되기 때문에 선택 사항이다. (추후 확장성을 위해 만들어둠)
4. DAO 인터페이스 생성
DAO 인터페이스를 만드는 작업.
java > egovframework > let > ibsheetTemplate > service > impl경로에 EmpDAO.java 파일 생성
package egovframework.let.ibsheetTemplate.service.impl;
import java.util.List;
import java.util.Map;
import org.springframework.stereotype.Repository;
import org.egovframe.rte.psl.dataaccess.EgovAbstractMapper;
@Repository("empDAO")
public class EmpDAO extends EgovAbstractMapper {
public List<Map<String, Object>> selectEmpList() {
return selectList("egovframework.mapper.let.ibsheetTemplate.empMapper.selectEmpList");
}
}
EgovAbstractMapper는 MyBatis의 SqlSession을 상속해서 selectList, selectOne 등을 바로 사용할 수 있도록 도와준다.
EgovAbstractMapper는 egovframework.rte.psl.dataaccess 모듈에 포함되어 있으므로, Maven 또는 Gradle에 아래 의존성을 추가해야함.
egov 4점대부터는 egovframework-> org.egovframe이렇게 바뀌었으니 잘 보기!
<dependency>
<groupId>org.egovframe.rte</groupId>
<artifactId>org.egovframe.rte.psl.dataaccess</artifactId>
<version>4.2.0</version> <!-- 사용 중인 버전 확인 후 적절히 설정 -->
</dependency>
selectList("네임스페이스.아이디") 형식으로 매퍼의 SQL을 호출한다.
empMapper.xml에서 namespace="egovframework.mapper.let.ibsheetTemplate.empMapper"로 지정했기 때문에 해당 네임스페이스를 그대로 사용한다.
이 두개가 같아야하고 아래 select문 id까지 맞게 찾아가는 거임
5. Service 구현 클래스 생성
DAO를 실제로 호출할 Service 구현체를 만드는 작업.
java > egovframework > let > ibsheetTemplate > service > impl경로에 EmpServiceImpl.java 파일 생성
DB 연결 설정 (DataSource), MyBatis Mapper 파일 위치 지정, SQL 스크립트 초기 실행
<jdbc:embedded-database> 부분에 아래 내용 추가.
HSQLDB 같은 내장 DB를 사용할 경우 초기화 SQL을 실행하는 부분이다.
<!-- hsql -->
<jdbc:embedded-database id="dataSource-hsql" type="HSQL">
<jdbc:script location= "classpath:/db/shtdb.sql"/>
<jdbc:script location="classpath:/db/ibsheetTpdb.sql"/> <!-- 추가된 SQL 파일 -->
</jdbc:embedded-database>
이 설정은 HSQLDB가 초기 실행 시 ibsheetTpdb.sql 파일을 읽어서 EMP 테이블 등 필요한 테이블을 생성한다.
메모리 모드일 경우 매번 새로 실행되므로 필수!
2) context-mapper.xml
MyBatis 관련 설정, Mapper XML 파일 등록, SQL 실행 환경 구성
<property name="mapperLocations"> 아래 mapper 경로 추가.
<!-- Mybatis setup for Mybatis Database Layer -->
<bean id="sqlSession" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"/>
<property name="configLocation" value="classpath:/egovframework/mapper/config/mapper-config.xml" />
<property name="mapperLocations">
<list>
<value>classpath:/egovframework/mapper/let/**/*_${Globals.DbType}.xml</value>
<value>classpath:/egovframework/mapper/let/ibsheetTemplate/*.xml</value> <!-- xml 파일 경로 추가 -->
</list>
</property>
</bean>
직접 XML 파일 경로를 명시해서 매퍼 파일을 등록한다.
3) egov-com-servlet.xml
Spring MVC 설정, 뷰(View) 관련 설정, 컨트롤러 컴포넌트 스캔 등
Spring MVC에서 JSON 데이터를 반환할 수 있도록 구성한다.
Resolved [org.springframework.http.converter.HttpMessageNotWritableException: No converter for [class java.util.ArrayList] with preset Content-Type 'null']
현재 이런 오류가 나는데,
컨트롤러에서 List<Map<String, Object>> 형태의 데이터를 반환하고 있으며,
@ResponseBody와 produces = "application/json" 도 사용하고 있으므로, 정상적으로 JSON 형태로 응답이 나가야 함.
이 에러는 Spring MVC에서 JSON 변환에 필요한 HttpMessageConverter를 찾을 수 없어서 발생하는 문제이다.
즉, ArrayList<Map<String, Object>>를 JSON으로 변환할 수 있는 변환기가 누락되어 있다는 뜻.
pom.xml 에서 jackson-databind 이 있는지 확인하거나,
spring 설정파일인 dispacher-servlet.xml(여기서는 egov-com-servlet.xml) 에서 mvc:annotation-driven 태그가 있는지 확인.
수동설정과 자동설정이 함께 있음
GPT에게 물어보니 아래와 같이 대답했다.
당신의 dispatcher-servlet.xml에 다음 두 가지 설정이 동시에 존재합니다:
⚠️ 이 수동 설정 때문에 annotation-driven이 자동으로 등록하는 MappingJackson2HttpMessageConverter가 무시되고 있습니다.
Jackson 변환기를 수동 설정에 추가하거나, 아래처럼 주석처리하는 방법이 있다.
난 메시지 컨버터를 추가해줬다.
<!-- 화면처리용 JSP 파일명의 prefix, suffix 처리에 대한 mvc 설정 -->
<bean class="org.springframework.web.servlet.view.UrlBasedViewResolver" p:order="1"
p:viewClass="org.springframework.web.servlet.view.JstlView"
p:prefix="/WEB-INF/jsp/" p:suffix=".jsp"/>
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
<property name="webBindingInitializer">
<bean class="egovframework.com.cmm.web.EgovBindingInitializer"/>
</property>
<property name="messageConverters">
<list>
<!-- JSON 변환을 위한 메시지 컨버터 추가 -->
<bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
</list>
</property>
</bean>
+++ ModelAndView를 쓰는 경우 아래처럼 사용
<!-- json 관련 설정 @@@ -->
<!-- View 이름이 Bean 이름과 같을 때 그 Bean을 뷰로 사용함 -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.BeanNameViewResolver" p:order="0">
</bean>
<!-- 실제 JSON 출력을 담당하는 View 객체 -->
<bean id="jsonView" class="org.springframework.web.servlet.view.json.MappingJackson2JsonView" p:contentType="application/json;charset=UTF-8">
</bean>
<!-- json 관련 설정 끝-->
viewResolver : 컨트롤러에서 반환하는 뷰 이름을 실제 JSP 경로로 매핑 jsonView: @ResponseBody 없이도 JSON 응답을 보낼 수 있게 하는 뷰 설정
위 Controller랑은 관련이 없긴한데.... 아래와 같이 ModelAndView를 쓰는 경우에는 아래처럼 jsonView를 지정해야한다.
egovFrame 4.2 에서 기본 템플릿인 simple homepage에 기존 샘플을 붙이기로 했다.
여기서 제공하는 구조를 갖다 쓰기 위함....
기존에 쓰던 샘플도 HSQL 을 사용해서 DB연결을 했고 샘플 전용 SQL 파일을 넣어 테이블을 생성해서 활용했다.
이번에도 해당 테이블을 활용해보도록 하자.
1. 구조파악
resources 아래 프로젝트 구조
1️⃣ shtdb.sql (DB 스크립트 파일)
HSQLDB를 사용할 때, 초기 테이블 생성 및 샘플 데이터 삽입을 위한 SQL 스크립트 파일.
HSQLDB는 Java 기반의 오픈 소스 관계형 데이터베이스(RDBMS)로, 로컬에서 개발할 때 자바 내장 DB를 사용해서 간단한 SQL문 실행과 테스트를 진행할 수 있다.
특징으로는 서버를 껐다가 켜면 데이터가 초기화된다.
shtdb.sql 같은 SQL 파일이 HSQLDB에서 데이터를 초기화하기 위해 사용되는 것.
따라서 내부에 보면
CREATE TABLE ... (테이블 생성)
INSERT INTO ... (초기 데이터 삽입)
ALTER TABLE ... (제약 조건 추가)
이런 내용들이 들어가 있음.
2️⃣ globals.properties (전역 설정 파일 - DB 연결 등)
eGovFrame에서 사용하는 전역 설정값을 저장하는 파일이다.
DB 연결 정보, 파일 경로, 공통 변수 등을 정의한다.
#-----------------------------------------------------------------------
#
# globals.properties : 시스템
#
#-----------------------------------------------------------------------
# 1. key = value 구조입니다.
# 2. key값은 공백문자를 포함불가, value값은 공백문자를 가능
# 3. key값으로 한글을 사용불가, value값은 한글사용이 가능
# 4. 줄을 바꿀 필요가 있으면 '\'를 라인의 끝에 추가(만약 '\'문자를 사용해야 하는 경우는 '\\'를 사용)
# 5. Windows에서의 디렉토리 표시 : '\\' or '/' ('\' 사용하면 안됨)
# 6. Unix에서의 디렉토리 표시 : '/'
# 7. 주석문 처리는 #사용
# 8. value값 뒤에 스페이스가 존재하는 경우 서블릿에서 참조할때는 에러발생할 수 있으므로 trim()하거나 마지막 공백없이 properties 값을 설정할것
#-----------------------------------------------------------------------
# 운영서버 타입(WINDOWS, UNIX)
Globals.OsType = WINDOWS
# G4C 연결용 IP (localhost)
Globals.LocalIp = 127.0.0.1
# DB서버 타입(mysql,oracle,altibase,tibero) - datasource 및 sqlMap 파일 지정에 사용됨
Globals.DbType = hsql
Globals.UserName=sa
Globals.Password=
# mysql
#Globals.DriverClassName=net.sf.log4jdbc.DriverSpy
#Globals.Url=jdbc:log4jdbc:mysql://127.0.0.1:3306/sht
#oracle
#Globals.DriverClassName=oracle.jdbc.driver.OracleDriver
#Globals.Url=jdbc:oracle:thin:@127.0.0.1:1521:egovfrm
#Altibase
#Globals.DriverClassName=Altibase.jdbc.driver.AltibaseDriver
#Globals.Url=jdbc:Altibase://127.0.0.1:1721/egovfrm?encoding=UTF-8
#Tibero
#Globals.DriverClassName=com.tmax.tibero.jdbc.TbDriver
#Globals.Url=jdbc:tibero:thin:@127.0.0.1:1821:egovfrm
#cubrid
#Globals.DriverClassName=cubrid.jdbc.driver.CUBRIDDriver
#Globals.Url=jdbc:cubrid:127.0.0.1:33000:sht:::?charset=utf-8
#Hsql - local hssql 사용시에 적용
Globals.DriverClassName=net.sf.log4jdbc.DriverSpy
Globals.Url=jdbc:log4jdbc:hsqldb:hsql://127.0.0.1/sampledb
# MainPage Setting
Globals.MainPage = /cmm/main/mainPage.do
# 파일 확장자 화이트리스트(허용목록) : 파일 확장자를 (.)과 함께 연이어서 사용하며 (.)로 시작한다.
Globals.fileUpload.Extensions.Images = .gif.jpg.jpeg.png
Globals.fileUpload.Extensions = .gif.jpg.jpeg.png.xls.xlsx
# File ID 암호화 키
# 주의 : 반드시 기본값 "egovframe"을 다른것으로 변경하여 사용하시기 바랍니다.
Globals.File.algorithmKey = egovframe
설명이 잘 나와있음.
기본값으로 내장 DB인 hsql로 설정되어 있고, 만약 다른 DB정보를 연결하기 원한다면 아래 #으로 주석처리 되어있는 것들에 주석을 풀어서 DB 연결을 해주면 된다.
MainPage Setting : 애플리케이션이 실행될 때 기본으로 열리는 페이지가 /cmm/main/mainPage.do 로 되어있음
Globals.fileUpload.Extensions.Images → 이미지 업로드 허용 확장자: .gif, .jpg, .jpeg, .png
Globals.fileUpload.Extensions → 일반 파일 업로드 허용 확장자: .gif, .jpg, .jpeg, .png, .xls, .xlsx
서버에서 특정 확장자의 파일만 업로드할 수 있도록 화이트리스트(허용 목록) 설정
Globals.File.algorithmKey = egovframe : 파일 ID를 암호화할 때 사용하는 기본 키 값(보안상 변경 필요)
3️⃣ mapper-config.xml (MyBatis 설정 파일)
MyBatis의 매퍼(Mapper) 설정 파일.
SQL 쿼리를 XML 기반으로 정의하고, Java 객체와 매핑하는 역할을 한다.
<?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>
<!--Mybatis 설정 -->
<settings>
<!-- 전통적인 데이터베이스 컬럼명 형태인 A_COLUMN을 CamelCase형태의 자바 프로퍼티명 형태인 aColumn으로 자동으로 매핑하도록 함 -->
<setting name="mapUnderscoreToCamelCase" value="true"></setting>
<!-- 파라미터에 Null 값이 있을 경우 에러 처리 -->
<setting name="jdbcTypeForNull" value="VARCHAR"></setting>
</settings>
<!-- Type Aliases 설정-->
<typeAliases>
<typeAlias alias="egovMap" type="org.egovframe.rte.psl.dataaccess.util.EgovMap" />
<typeAlias alias="FileVO" type="egovframework.com.cmm.service.FileVO" />
<typeAlias alias="ComDefaultCodeVO" type="egovframework.com.cmm.ComDefaultCodeVO" />
<typeAlias alias="comDefaultVO" type="egovframework.com.cmm.ComDefaultVO" />
</typeAliases>
<mappers>
<!-- 이런식으로 넣는거임 -->
<!-- <mapper resource="egovframework/mapper/sample/Sample_SQL.xml"/> -->
</mappers>
</configuration>
마이바티스 관련해서 두가지 큰 설정이 있는데, Type Alias와 mapper 설정이다.
[Type Aliases(타입 별칭) 설정]
MyBatis에서 객체 타입을 짧게 사용할 수 있도록 별칭(Alias)을 정의함.
예를 들어, <resultType>에서 org.egovframe.rte.psl.dataaccess.util.EgovMap을 쓰는 대신 egovMap으로 사용할 수 있음.
<select id="getFileList" resultType="FileVO">
SELECT * FROM FILE_TABLE;
</select>
🔹 mapper란?
"Java 코드에서 DB 쿼리를 실행할 수 있게 도와주는 도우미"
MyBatis에서 SQL 쿼리를 XML 파일이나 인터페이스에 정의하고, 이를 Java 객체와 연결하여 SQL 실행을 자동화해주는 역할을 하는 것.
터미널로 hsqlbb.jar 있는 경로 들어가서 위 명령어를 실행하면 sampledb.script, sampledb.properties 같은 파일이 생성됨.
이후 jdbc:hsqldb:hsql://localhost/sampledb로 접속하면 정상 동작.
pom.xml에 이렇게 들어있는데, Maven이 자동으로 target/lib 또는 .m2/repository에 저장한다.
<dependency>
<groupId>org.hsqldb</groupId> <!-- HSQLDB 라이브러리 그룹 ID -->
<artifactId>hsqldb</artifactId> <!-- 라이브러리 이름 -->
<version>2.7.2</version> <!-- 사용하는 HSQLDB 버전 (최신 버전) -->
<classifier>jdk8</classifier> <!-- JDK 8 전용 버전 사용 -->
</dependency>
어쨌든 이렇게 하면 db 관련 설정파일이 생성된다.
db.properties (데이터베이스 설정 파일)
db.script (HSQLDB용 SQL 초기화 스크립트)
하지만 난 기존꺼 그냥 붙여넣었고.... 그냥 임베디드 모드(메모리모드)를 사용할 예정이다.
