1. 개발 환경 설정 가이드
본 문서에서는 개발자 개발 환경 설정 방법에 대하여 기술합니다.
아래에서 로컬 개발환경 기본구조를 설명하고, 로컬개발환경 세팅 방법을 설명합니다.
1.1. 로컬 개발환경
1.1.1. IDE Tool
IntelliJ IDEA - 2023.2(232.8660.185) : 최신 버전 이용
Visual Studio Code - 1.81 : 최신 버전 이용
Eclipse - 2023‑06 : 최신 버전 이용
1.1.2. JDK 버전
openjdk-17.0.8.7.1 (LTS) : 17버전 기준으로 최신 버전 이용
1.1.3. 형상관리
GitLab : 배포서버에 설치된 GitLab에서 생성되는 Git Repository를 사용
1.1.4. WAS
Tomcat – 10.1.11 : Java Servlet Container
1.1.5. DBMS
Postgresql – 15.3
1.2. 주요 Framework / Library
1.2.1 Spring Framework
spring-boot – 3.1.2
spring-core – 6.0.11
spring-data-jpa – 3.1.2
tomcat-embed-core – 10.1.11 (exclusion)
1.2.2 Spring Cloud Aws – 3.0.1
1.2.3 logback – 1.4.8
1.2.4 mybatis – 3.5.13
1.2.5 HikariCP – 5.0.1
1.2.6 postgresql – 42.6.0
1.2.7 querydsl – 5.0.0
1.2.8 ehcache – 3.10.8
1.2.9 jjwt – 0.11.5
1.2.10 poi – 5.2.3
1.2.11 jackson
jackson-core – 2.15.2
jackson-databind – 2.15.2
1.2.12 Apache Utils
commons-lang3 – 3.13.0
commons-text – 1.10.0
commons-io - 2.13.0
commons-codec – 1.16.0
commons-beanutils – 1.9.4
1.2.13 Lombok – 1.18.28
1.2.14 Springdoc(swagger 3.0) – 2.2.0
1.3. 로컬개발환경 세팅
1.3.1. 개발환경 다운로드
개발 Tool의 경우 3가지중에 본인이 사용하는 프로그램을 다운로드
IntelliJ IDEA : https://www.eclipse.org/downloads/
Visual Studio Code : https://code.visualstudio.com/
Eclipse : https://www.eclipse.org/downloads/
1.3.2. Tool 설치 파일
git (git version control) : https://git-scm.com/ (git에서 소스코드를 받기 위해서 설치)
SourceTree (git ui client) : https://www.sourcetreeapp.com/ (SourceTree를 사용하지 않고 개발 Tool에서 기본 제공하는 Git Client 사용도 가능)
DBeaver (db client) : https://dbeaver.io/download/ (DBMS를 활용하기 위한 UI Client
Open Jdk 17 : https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/downloads-list.html (Amazon외에 다른 곳에서 제공하는 Open jdk를 설치하여도 됨)
1.3.3. Project 목록
x2bee-common : Spring 공통 기능 제공 프로젝트
(해당 프로젝트의 경우 각각의 Spring 프로젝트가 pom.xml에서 dependency를 추가하여 참조해서 사용하고 있음)x2bee-gw : Spring cloud gateway 프로젝트
x2bee-bo : 관리자 사이트 Spring Thymeleaf Front End 프로젝트
x2bee-api-bo : 관리자 Api Spring 프로젝트
x2bee-api-common : 공통 Api 및 외부 인터페이스 Api Spring 프로젝트
x2bee-api-display : 전시 Api Spring 프로젝트
x2bee-api-event : 이벤트 Api Spring 프로젝트
x2bee-api-goods : 상품 Api Spring 프로젝트
x2bee-api-order : 주문 Api Spring 프로젝트
x2bee-api-member : 회원 Api Spring 프로젝트
x2bee-batch-gddp : 전시, 상품 Spring Batch 프로젝트
x2bee-batch-mbod: 회원, 주문 Spring Batch 프로젝트
1.4. IntelliJ IDEA 설정 및 APP 기동
IntelliJ를 설치 후 실행합니다.
Git – Clone를 실행하여 Git Repository에서 소스코드를 로컬 디렉토리에 복제합니다.
전체 프로젝트 또는 개별 프로젝트별로 Reload project를 선택하여 maven에서 dependency를 재설정 및 다운로드 합니다.
만약에 충돌등이 일어나서 dependency 설정이 제대로 되지 않는다면 메뉴에서 clean을 선택하여 초기화 시킨 후 다시 Reload 합니다.
기동시킬 프로젝트의 기동파일을 Run 또는 Debug를 선택하면 해당 프로젝트가 기동됩니다.
1.5. Visual Studio Code 설정 및 APP 기동
VS Code를 설치 후 실행합니다.
Source Control 탭에서 Clone Repository를 실행하여 Git Repository에서 소스코드를 로컬 디렉토리에 복제합니다.
Extensions 탭에서 java를 검색하여서 Extension Pack for Java, Spring Boot Extension Pack를 설치합니다.
기동시킬 프로젝트의 기동파일을 Run 또는 Debug를 선택하면 해당 프로젝트가 기동됩니다.
1.6. Eclipse 설정 및 APP 기동
Eclipse를 설치 후 실행합니다.
Open Perspective창에서 Clone a Git repository를 실행하여 Git Repository에서 소스코드를 로컬 디렉토리에 복제합니다.
https://projectlombok.org/download 해당 사이트에서 lombok.jar를 파일을 Eclipse 설치 경로에 다운로드 받습니다.
그후 설치된 폴더의 eclipse.ini를 열어서
-javaagent:C:\설치경로\jee-2023-06\eclipse\lombok.jar 해당 설정을 추가합니다.
기동시킬 프로젝트의 기동파일을 Run 또는 Debug를 선택하면 해당 프로젝트가 기동됩니다.