xit-app-starter란?
xit-app-starter는 xit-base-starter를 기반으로 응용시스템을 구축하는 프로젝트의 템플릿이다.
xit-app-starter는 응용시스템의 공통구조와 일반기능을 지원하기위해 해당기능의
- 의존모듈
- 기본설정
- 데이터베이스 스크립트
- 초기 소스
- 페이지 기본 레이아웃
- 시스템 관리 페이지
등을 제공한다.
xit-app-starter가 지원하는 일반기능은 다음과 같다.
- 공통모듈
- 공통코드 관리
- 파일 관리
- 사용자 관리
- 기관/부서 관리
- 보안 관리
- 메뉴 관리
- 시스템로그 관리
- 엑셀/한컴한글 생성/다운로드
- 암복호화
설치
다운로드
xit-app-starter의 배포파일(xit-app-starter-23.04.01.zip)을 다운로드하여 원하는 경로로 옮긴다.
압축풀기
배포파일의 압축을 풀면 아래와 같은 레이아웃의 디렉토리가 생성된다.
 |
|
Customization
xit-app-starter가 정의한 초기이름을 응용시스템의 프로젝트에서 정한대로 수정한다.
이 작업은 프로젝트를 개발환경에 로드하기 전이나 후에 해도 무방하다.
이름
프로젝트 디렉토리
초기 베이스 디렉토리 'xit-app-starter'를 프로젝트에서 정한 이름으로 변경한다.
pom.xml
프로젝트 디렉토리/pom.xml을 열어
- <artifactId ../>
- <version ../>
- <name ../>
- <description ../>
을 프로젝트에서 정한대로 수정한다.
application.yml
src/main/resources/application.yml을 열어
- 애플리케이션 이름(spring.application.name)
을 수정한다.
자바 소스
- 필요할 경우 응용시스템 자바소스의 초기 패키지(cokr.xit.app) 아래의 클래스들의 이름을 수정한다.
- 초기 패키지(cokr.xit.app)를 프로젝트에서 정한 이름으로 변경한다. 이 때 새 패키지 이름은 'cokr.xit'로 시작해야 한다.
head.jsp
웹페이지로 사용자가 보는 응용시스템의 이름을 수정한다.
이를 위해 src/main/webapp/WEB-INF/jsp/include/head.jsp를 열고 다음 부분을 찾아 수정한다.
<c:set var="appName" scope="request">App Starter</c:set>
데이터베이스 생성
xit-app-starter가 지원하는 기능이 사용할 데이터베이스를 생성하기 위해 src/sql/xit-base-mariadb.sql을 열어 실행한다.
이 스크립트를 실행하면 다음과 같은 시스템 관리자 계정이 생성된다.
- 사용자 아이디: admin
- 비밀번호: 1
설정
src/main/resources/application.yml을 열어
- 웹서버 포트(server.port)
- 서블릿 컨텍스트(server.servlet.context-path)
- 데이터베이스 접속(spring.sql.init.platform, spring.datasource)
- ssl 사용여부(server.ssl.enabled)
등을 수정한다.
ssl을 위한 인증서, 키 파일들은 src/main/resources/ssl 디렉토리에 위치한다.
- 이 디렉토리의 파일들은 자체발급한 파일들이다.
- 운영 시에는 공인기관이 발급한 파일들을 사용하도록 한다.
응용시스템 시작
- 응용시스템의 웹서버를 시작한다.
- 웹브라우저를 열고, application.yml에 설정한 대로
http(s)://localhost:포트/컨텍스트를 연다
crudgen
crudgen을 사용하면 CRUD 구현을 쉽게 할 수 있다.