목차

개발자 개발환경 설치가이드

개요

본 가이드는 전자정부 표준프레임워크에서 제공하는 개발자 개발환경의 사용 방법을 제공한다.

Step 1. 개발환경 설치

개발자 개발환경 다운로드

- 인터넷 웹브라우저를 통해 eGovFrame 홈페이지(https://www.egovframe.go.kr/)에 접속하여 사이트 상위메뉴를 통해 “다운로드>개발환경”으로 이동한다.
- 환경에 따라 다운받을 개발환경을 선택한다.
- 첨부된 파일을 다운로드받아 압축을 해제한다.

개발자 개발환경 실행

  1. eclipse를 실행한다.


    ✔ Fail to create Java Virtual Machine 오류가 발생할 경우 eclipse가 설치된 디렉토리의 eclipse.ini 파일에 JVM 경로를 지정해 주도록 한다.
    개발자 개발환경을 사용하기 위해서는 해당 이클립스의 자바 버전을 설치되어야 한다.
    또한, -Dfile.encoding=UTF-8 설정을 통하여 파일 인코딩을 UTF-8로 적용이 가능하다.
    이클립스 버전별 지원 자바 버전은 환경 설정에서 확인 가능하다.


  2. eclipse를 실행 후 Workspace Launcher 팝업이 나타나면 전자정부 개발환경에서 제공하는 workspace를 선택한다.

✔ 전자정부 표준프레임워크에서는 eclipse에 eGovFrame 관련 설정정보를 세팅하여 배포한다.
따라서 C:\eGovFrameDev-3.x.x-xxbit\workspace와 같이 eGovFrame 개발환경에서 기본적으로 제공해주는 workspace를 선택하는 것을 권장한다.

퍼스펙티브(Perspective) 전환

  1. eclipse가 정상적으로 실행되면 우측 상단의 Perspective가 eGovFrame으로 되어있는지 확인한다.

✔ 만약 Perspective가 eGovFrame이 아닐 경우 다음의 절차를 따른다.

Step 2. 프로젝트 생성 및 실행

프로젝트 생성

  1. 메뉴 표시줄에서 File > New > eGovFrame Web Project를 선택한다.
    또는, Ctrl+N 단축키를 이용하여 새로작성 마법사를 실행한 후 eGovFrame > eGovFrame Web Project을 선택하고 Next를 클릭한다.


  2. 프로젝트 명과 Maven 설정에 필요한 값들을 입력하고 Next를 클릭한다.


  3. 예제 소스 파일 생성 여부를 체크하고 Finish를 클릭한다.


서버 설치

  1. eclipse 하단의 Servers 탭을 클릭하고, 마우스 우클릭하여 “New > Server”를 선택한다.


  2. Apache > Tomcat v8.0 Server를 선택 후 Next를 클릭하고 Download and Install 버튼을 클릭하여 서버 설치를 완료한다.

✔ 개발환경 3.7 이상의 경우 Tomcat 8.0 이상을 권장한다.


프로젝트 실행

  1. 실행할 프로젝트를 마우스 우클릭하고 “Run As > Run on Server”를 선택한다.


  2. Choose an existing server를 선택하고 서버 설치에서 설치한 서버를 선택 후 Next 버튼을 클릭하고 실행할 프로젝트를 Add한다.

  3. 다음과 같은 화면이 실행되는지 확인한다.

✔ 프로젝트 생성 후 “Could not open JDBC Connection for transaction” 메시지가 나타날 경우 HSQLDB 설정 가이드를 참고하여 HSQLDB를 연결한다.

기타 설정

DB 정보 변경

  1. DB 정보를 변경할 프로젝트의 sql-map-config.xml 파일을 다음과 같이 수정한다.

  2. context-datasource.xml 파일을 다음과 같이 수정하고 사용할 DB 정보를 입력한다.

  3. pom.xml 파일에 다음과 같은 dependency를 추가한다.

  4. 프로젝트 마우스 우클릭 후 “Run As > Maven install”을 선택한다.

Data Source Explorer 연결

Data Source Explorer연결 가이드를 참고한다.

다국어 지원 방안

✔ 개발자 개발환경의 영문 버전을 사용할 경우 eclipse 설치 디렉토리에 있는 eclipse.ini 파일을 다음과 같이 수정한다.
-Duser.language=en
-Duser.country=US

✔ 개발자 개발환경의 국문 버전을 사용할 경우 eclipse 설치 디렉토리에 있는 eclipse.ini 파일을 동일한 방법으로 수정한다.
-Duser.language=ko
-Duser.country=KR

성능 향상 방안

✔ 다음과 같은 설졍을 통해 구현도구(eclipse)의 성능 및 속도를 높일 수 있다. 아래 설정은 필수 적용사항이 아니므로, 필요한 경우 참고자료로 활용한다.

1. eclipse theme 기능 변경

  1. Window » Preferences » General » Appearance » Theme를 Classic으로 변경.
  2. Use mixed fonts and colors for labels 체크를 해지
  3. Apply 후 eclipse 재실행.

2. eclipse.ini 파일 수정

필요에 따라 아래의 설정정보를 수정할 수 있다.
메모리 설정의 경우, 각 컴퓨터의 메모리 용량에 따라 설정하여야한다. (1~2G : 256m, 2~3G, 512m, 4G~ : 1024m 권장)

  1. Xverify:none
    클래스 검사 생략. eclipse 실행 시간 단축
  2. Xms256m
    eclipse 실행시 잡는 최소 메모리
  3. Xmx1024m
    eclipse 실행시 잡는 최대 메모리