본문 바로가기
프로그래밍/스프링프레임워크

전자정부 표준프레임워크 및 all in one 샘플 프로젝트 설치

by pentode 2018. 4. 4.

“전자정부 표준프레임워크”는 공공사업에 적용되는 개발프레임워크로써 현재 최신버전은 3.6.0 입니다. 3.6.0 버전의 개발환경은 JDK1.7 이상을 필요로합니다. IDE는 eclipse Mars 4.5로 되어 있으며 Spring Framework를 기반으로 하여 다양한 공통 컴포넌트가 제공되어 집니다.

 

이 글에서는 전자정보 표준프레임워크 3.6.0 개발환경을 설치하고, 같이 제공되는 all in one 프로젝트를 설치하여 실행해 보겠습니다.

 

 

- JDK의 설치는 "윈도우에 JDK 8 설치하기" 를 참고 하세요.

- 데이터베이스의 설치는 "Oracle 11g Express Edition 과 SQL Developer 설치하기" 를 참고하세요.

- 다음 사이트에서 Tomcat 8.0 을 64-bit Windows zip 형태로 다운로드 받아서 풀어 둡니다. 이 글에서는 C:\util\tomcat\apache-tomcat-8.0.43 로 풀어 두었습니다. (http://tomcat.apache.org/download-80.cgi)

 

 

1. 전자정부 표준프레임워크 개발환경을 다운로받기 위해서는 표준프레임워크 포털에 가입하여야 합니다.

 

표준프레임워크 포탈

 

 

2. IDE 다운로드

메뉴에서 다운로드 ->  개발환경 -> 3.x 다운로드 -> 개발자용 개발환경 32bit/64bit(Implementation Tool) Full Version 3.6.0 에서 자신에 맞는 파일을 받으면 됩니다. 나는 64bit 이므로 eGovFrameDev-3.6.0-64bit.exe 파일을 받았습니다. 용량은 641MB 입니다.

 

 

3. 공통 컴포넌트 다운로드

메뉴에서 다운로드 -> 공통컴포넌트 -> 다운로드 -> 공통컴포넌트 3.6.0 all-in-one 배포파일 에서 egovframework-all-in-one_v3.6.0.zip 파일을 다운받습니다.

 

 

 

4. eGovFrameDev-3.6.0-64bit.exe 파일을 더블클릭하여 실행합니다. 압축을 풀 디렉토리를 물어보는 창이 뜹니다. 여기서는 C:\util\ 폴더로 지정했습니다. 압축이 풀리면 설치된 것입니다. 경로는 C:\util\eGovFrameDev-3.6.0-64bit\eclipse 가 될 것입니다.

 

설치위치 지정

 

 

5. 개발환경을 실행합니다.

C:\util\eGovFrameDev-3.6.0-64bit\eclipse\eclipse.exe를 실행합니다. Splash Screen 이미지 입니다.

 

스플래쉬 스크린

 

 

6. 워크스페이스의 위치를 지정합니다. 여기서는 C:\workspace\egovframework로 하였습니다.  Use this as the default and do not ask again 을 체크해두면 다음 실행시부터는 묻지 않습니다.

 

workspace 위치 지정

 

 

7. 이제 all in one 프로젝트를 설치해 보겠습니다. egovframework-all-in-one_v3.6.0.zip 을 워크스페이스내에 압축을 풉니다. 폴더는 C:\workspace\egovframework\egovframework-all-in-one_v3.6.0가 됩니다. 압축을 풀면 안에 데이터베이스 생성과 초기 데이터 입력을 위한 파일이 있는 script 폴더, src 폴더 그리고 pom.xml 파일이 있습니다.

 

 

8. 먼저 데이터베이스를 준비합니다.

- SYSTEM 계정으로 로그인 하여 계정을 생성합니다.

 

GRANT connect, resource TO EGOVUSER IDENTIFIED BY EGOVUSER;

 

sql developer 로 계정 생성

 

 

- 뷰를 생성할 수 있는 권한을 부여합니다.

 

GRANT create view TO EGOVUSER;

 

 

9. 테이블을 생성합니다.

- EGOVUSER 계정으로 로그인합니다.

- 프로젝트 파일 압축 푼곳 아래의 script\ddl\oracle 폴더내의 com_DDL_oracle_v3.6.sql 파일을 실행합니다. 파일내용을 sqldeveloper의 쿼리창에 복사해넣고, 두 번째 버튼인 스크립트 실행(F5) 를 누릅니다. 또는 단축키 F5 를 눌러 실행시킵니다.

 

테이블 생성

 

 

- 동일한 방법으로 script\dml\oracle 폴더 내의 com_DML_oracle_v3.6.sql 를 실행 시킵니다.

- 이번에는 데이터 입력작업 이므로 입력이 끝나고, commit 버튼을 눌러 데이터베이스에 영구적으로 반영합니다.

 

 

10. 프로젝트를 생성합니다.

- 실행해둔 전자정부 프레임웍 개발환경(이클립스)의 메뉴에서 File -> Import 를 선택합니다.

- Import 창에서 Maven -> Existing Maven Projects 를 선택하고 Next 를 누릅니다.

- Root Directory에 우측의 Browse... 버튼을 눌러 압축을 풀어둔 프로젝트 폴더를 선택합니다.

- Finish 버튼을 눌러 완료 합니다.

- Java EE 퍼스펙티브로 되어 있다면, eGovFrame 퍼스펙티브로 변경합니다.

 

프로젝트 생성

 

 

11. 프로젝트의 JRE System Library 를 JDK 8 로 변경합니다.

- 생성된 프로젝트는 JRE System Library 가 [JavaSE-1.7] 로 되어 있습니다. 이렇게 두고 그냥 실행하면 다음과 같은 에러 메세지를 보이면서 웹 애플리케이션이 실행되지 않습니다.

 

정보: No Spring WebApplicationInitializer types detected on classpath

 

- 생성된 프로젝트에서 마우스 오른쪽 키를 눌러 Build Path -> Configure Build Path... 를 선택합니다.

- Libraries 탭에서 JavaSE-1.7 JRE System Library를 제거합니다.

- 우측의 Add Library... -> JRE System Library 를 선택하여 JDK 8 을 추가합니다.

 

시스템 라이브러리 JDK 8 추가

 

 

12. 기본 설정을 변경합니다.

- src/main/resources/egovframework/egovProps/globals.properties 파일에서 다음을 변경합니다.

 

# 운영서버 타입(WINDOWS, UNIX)
Globals.OsType = WINDOWS

# DB서버 타입(mysql, oracle) - datasource 및 sqlMap 파일 지정에 사용됨
Globals.DbType = oracle

#oracle
Globals.oracle.DriverClassName=oracle.jdbc.driver.OracleDriver
Globals.oracle.Url=jdbc:oracle:thin:@127.0.0.1:1521:XE
Globals.oracle.UserName = EGOVUSER
Globals.oracle.Password = EGOVUSER

 

- Oracle용 JDBC 드라이버를 설치합니다.(라이센스 문제로 기본 Maven repository 에 없다고 합니다.) 아래와 같이 리파지토리와 디펜던시를 추가합니다. 각각 <repositories><dependencies> 태그에 포함시키면 됩니다.

 

<repository>
	<id>oracle</id>
	<url>http://maven.jahia.org/maven2</url>
</repository>

<dependency>
	<groupId>com.oracle</groupId>
	<artifactId>ojdbc6</artifactId>
	<version>12.1.0.2</version>
</dependency>

 

- 부서일정관리 sqlmap 파일 오류를 수정합니다.(부서일정관리 조회시 오류가 나는 것 수정입니다.)

 

src/main/resources/egovframework/slqmap/com/cop/smt/sdm/EgovDeptSchdulManage_SQL_oracle.xml 파일의 184번째 줄

 

<if test='searchMode == "DAILY""'>  를 <if test='searchMode == "DAILY"'> 로 수정합니다. DAILY 뒤에 큰 따옴표가 하나 더 들어가 있었습니다.

 

- pom.xml 파일을 수정한 후에 프로젝트에 마우스 오른쪽 키를 클릭하여 Maven -> Update Project... 를 실행해 줍니다. 반드시 필요한것은 아니지만 가끔 업데이트가 잘 안될때가 있습니다.

 

 

13. 올인원 프로젝트를 실행해 봅니다.

- 프로젝트명에 마우스 오른쪽 키를 누르고, Run as... -> Run on server 를  선택합니다.

- Manually define a new server 에 체크를 하고, server typeApache -> Tomcat v8.0 Server를 선택합니다.

 

프로젝트 실행

 

 

Next를 누릅니다.

 

- Tomcat installation directory 를 선택합니다. 앞에서 풀어둔 C:\util\tomcat\apache-tomcat-8.0.43 폴더 입니다.

 

Tomcat Server설정

 

 

Finish를 누릅니다.

 

- 설정을 제대로 했는데도 실행이 안된다면 Servers 창에서 Tomcat v8.0 Server at localhost 에 마우스 오른쪽키를 누르고, Clean... 을 실행하고 다시 서버를 시작해 봅니다.

 

 

14. 올인원 애플리케이션이 실행되었습니다. 업무를 선택하고 webmaster / rhdxhd12 로 로그인 해볼 수 있습니다.

 

 

실행화면

 

 

로그인된 화면 입니다.

 

로그인후 화면

 

 

이것으로 전자정부 표준프레임워크 개발환경 설치 및 공통 컴포넌트를 모두 포함하고 있는 올인원 프로젝트를 생성하고 실행해 보았습니다.

 

 

반응형