어차피 실행하고 있는 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>
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 초기화 스크립트)
하지만 난 기존꺼 그냥 붙여넣었고.... 그냥 임베디드 모드(메모리모드)를 사용할 예정이다.
<!-- json 관련 설정 -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.BeanNameViewResolver" p:order="0">
</bean>
<bean id="jsonView" class="org.springframework.web.servlet.view.json.MappingJackson2JsonView" p:contentType="application/json;charset=UTF-8">
</bean>
<!-- json 관련 설정 끝-->
그 다음 web-inf 아래에 있는 web.xml 비교해서 추가해주기
3.10에 이렇게 쓰여있는거 주석만 넣어주기
<!-- 템플릿 소스에서는 아래의 필터사용 대신 JSP 출력시 <c:out> 태그를 사용하는 것을 기본정책으로 한다 -->
<!-- egovframework.rte.ptl.mvc.filter.HTMLTagFilter egovframework.com.cmm.filter.HTMLTagFilter-->
3.10 에서 4.0으로 올리는 것이 가장 복잡하고, 4.0에서 4.1이나 4.1에서 4.2로 올리는 것은 비슷하다.
사실상 pom.xml 수정만 하는 것 같음.
사실상 크게 바뀐건 두개.
버전 숫자를 변경하는 것과 패키지 명이 egovframework에서 org.egorframe.rte로 변경되었다.
표준프레임워크 4.0.0 버전부터 실행환경의 패키지명을 org.egovframe.rte로 변경하였으므로, 실행환경을 import한 소스에 변경된 패키지명을 사용하시기 바랍니다. 표준프레임워크 개발환경에서 Search 기능에서 기존의 패키지명인 egovframework.rte 로 검색한 후, 변경할 패키지명인 org.egovframe.rte로 일괄로 변경하여 사용할 수 있습니다.
일괄 변경 해보자.
이처럼 실행환경의 패키지명을 전부 search 해서 replace 해주는 작업을 한다.
또한 4.0에서 4.1, 4.2로 마이그레이션 하는 것도 문서를 보고 동일하게 진행한다.
마지막으로 eclipce 버전이 기존것임을 확인해서 4.2 버전으로 아예 실행파일 자체를 대치해주었다.
3.10 의 이클립스에서는 java compiler가 14까지밖에 안나왔음. 근데 이제 4.2로 덮어써서 워크스페이스를 변경하니까 17까지 뜸.
jdk 버전도 올려야하는데 3.10 실행환경으로는 17까지 올릴 수가 없음. eclipse 폴더 자체를 4.2 버전으로 덮어쓰기 하니 버전이 잘 올라갔다.
17로 변경하고 maven clean 하면 다시 1.8 디폴트로 변경되니 17로 맞춘 뒤 install을 해준다.
groupId는 당신의 프로젝트를 모든 프로젝트 사이에서 고유하게 식별하게 해 주는 것이다.따라서, groupId에는 네이밍 스키마를 적용하도록 한다.groupId는 package 명명 규칙을 따르도록 한다.즉, 최소한 당신이 컨트롤하는 도메인 네임이어야 한다.하위 그룹은 얼마든지 추가할 수 있다.예: org.apache.maven, org.apache.commons
