전자정부 표준프레임워크 설치 및 설정 방법

전자정부 표준프레임워크 설치 및 설정 방법

정부 프로젝트 개발자라면 반드시 알아야 할 기본 세팅 가이드

---

1. 전자정부 표준프레임워크란?

전자정부 표준프레임워크(eGovFrame)는 대한민국 행정안전부가 주도하여 만든 공공 SW 개발 표준 플랫폼입니다.

Spring Framework 기반이며, MVC 구조와 공통 컴포넌트를 제공합니다.

---

2. 설치 전 준비 사항

전자정부 프레임워크는 Java 기반이므로 기본적인 개발 환경을 갖춰야 합니다.

필수 설치 항목

도구	권장 버전
Java JDK	JDK 8 (또는 프로젝트에 따라 11)
Apache Maven	3.x
Apache Tomcat	8.x 또는 9.x
Eclipse	Eclipse IDE for Java EE Developers (STS 사용 가능)
eGovFrame Dev IDE	전용 통합 개발 툴

---

3. eGovFrame 설치 방법

방법 1: 전용 IDE 사용 (가장 쉬운 방법)

1. 전자정부프레임워크 공식사이트 접속

2. 상단 메뉴 → 다운로드 → 개발환경 선택

3. eGovFrame Dev IDE (Eclipse 기반) 다운로드 및 설치

   • Windows용 / macOS는 Eclipse 수동 설정 필요

4. 압축 해제 후 eGovFrameDev.exe 실행

5. 기본 워크스페이스 경로 설정 (예: C:/egovframe/workspace)

6. 시작

방법 2: 수동 환경 설정

Eclipse 수동 설정 시 다음 작업 필요

1. Eclipse 설치

2. Java JDK 설치 후 환경변수 설정 (JAVA_HOME, PATH)

3. Maven 설치 후 환경변수 설정 (MAVEN_HOME)

4. Tomcat 설치 및 연동

5. 전자정부 표준프레임워크 소스 프로젝트 다운로드

---

4. 샘플 프로젝트 다운로드 및 실행

1. eGovFrame GitHub 또는 공식 사이트에서 샘플 다운로드

   • egovframe-template-simple-web 또는 egovframe-template-all-in-one

2. Eclipse → Import → Existing Maven Projects 선택

3. 프로젝트 import 후 pom.xml 빌드

4. src/main/resources/egovProps/globals.properties에서 DB 설정 변경 가능

5. Tomcat 연동 후 실행

---

5. 주요 폴더 구조 설명

src/
 ├─ main/
 │   ├─ java/               → 컨트롤러, 서비스, DAO 등 Java 코드
 │   ├─ resources/          → 설정파일 (log4j, properties 등)
 │   └─ webapp/
 │        ├─ WEB-INF/       → web.xml, Spring 설정 등
 │        └─ jsp/           → 화면 구성 (JSP 파일)

---

6. 초기 설정파일 체크 포인트

파일	설명
pom.xml	Maven 라이브러리 관리, JDK 버전 설정
web.xml	서블릿 설정, Spring Context 로딩
dispatcher-servlet.xml	Spring MVC 설정
datasource-context.xml	DB 연결 설정
egovProps/globals.properties	전역 설정 (경로, DB 등)

---

7. 실행 및 검증

1. 프로젝트 Clean → Build

2. Tomcat 서버 추가 → 프로젝트 연동

3. 브라우저에서 http://localhost:8080/프로젝트명/index.jsp 접속

4. 기본 로그인 화면 또는 메인 화면 출력 확인

---

8. 자주 발생하는 오류 및 해결

오류 메시지	해결 방법
JAVA_HOME not set	환경변수 설정 확인
Maven build fail	pom.xml 종속성 누락 또는 인터넷 연결 확인
Tomcat 404 오류	WAR 배포 설정 확인, context root 확인
DB 연결 실패	globals.properties DB 접속 정보 확인

---

9. 마무리

전자정부 표준프레임워크는 다소 초기 설정이 복잡하지만, 한 번 잘 구축해두면 공공 SW 개발에서 재사용성과 안정성이 매우 높습니다. 특히 eGovFrame Dev IDE를 사용하면 대부분의 세팅이 자동화되어 있어 개발이 수월해집니다.

---

참고 링크

• 전자정부 표준프레임워크 공식 사이트

• eGovFrame GitHub 소스코드