layout: post title: 자바 웹API 서버 구성하기 (上) categories: [dev] author: 문재범 email: [email protected] date: 2022-02-04 tag:
<!-- @format -->
진학어플라이 개발부 서비스파트에서 경찰청 원서접수서비스를 개발하는 도중 한국사능력검정시험 대상자정보 유통 서비스를 연동해야하는 일이 생겼습니다. 해당 서비스를 이용하려면 자바기반의 표준API를 사용해야 합니다.
정부기관의 모듈은 대부분 자바기반입니다. 그러나 진학사 서비스파트는 ASP.NET을 사용합니다. 자바 기반의 모듈을 ASP.NET으로 변환하는 것은 어렵기에 자바 기반의 웹API 서버를 구성해서 기존시스템에서 호출하도록 구성해야합니다.
서비스 파트에서 자바 기반의 웹API 서버를 구현하기에 여의치 않은 상황이라, 전략프로젝트팀 소속인 제가 개발을 맡게되었습니다.
전략프로젝트팀에서는 현재 서버 개발을 TypeScript로 하기 때문에 자바를 사용하지는 않지만 그래도 자바 기반의 개발환경이 아닌 곳에서 자바 웹API 서버를 구성하시는분들에게 도움을 드리기 위해 제가 구성한 방법을 설명해드리고자 합니다. (최소한의 설정)
먼저 프로젝트 구성에 필요한 프로그램은 JDK8, tomcat8.5, Docker, eclipse 2020-06 입니다. 모두 설치가 되어야 합니다.
간단하게 설명을 드리자면 jdk는 자바 개발 키트입니다. 자바 개발을 하기 위해서 필수적입니다.
tomcat8.5는 자바 서블릿 구현체를 실행시켜주는 WAS입니다. 서블릿 컨테이너에서 사용자가 구현한 자바 서블릿 구현체를 알맞는 request에 맞게 실행시켜서 결과를 response 해주는 역할을 합니다.
이클립스는 자바를 개발할 수 있는 무료 IDE입니다. 다른 IDE도 많지만 이클립스는 무료이기 때문에 이클립스를 사용하도록 하겠습니다. 2020-06까지 JDK8을 지원하고 그 이후부터는 지원하지 않기때문에 2020-06 버젼을 사용했습니다.
마지막으로 도커 이미지로 빌드해서 도커 환경에서 독립적으로 구동이 가능하도록 할 것이기 때문에 도커가 필요합니다.
우선 이클립스를 실행하고 인코딩 설정을 변경합니다. 기본적으로 EUC-KR 설정되어 이는 독자적인 한글 인코딩 방식이므로, 범용성을 위해서 UTF-8로 변경하는게 좋습니다.
Window → Preferences → 검색 <Enc>