Spring Tool Suite 4에서 Spring Legacy Project 생성 및 Tomcat 연결 방법

2024년 10월 20일 기준 설치 방법

목차

• 01. STS4에서 Legacy Project 생성
  - STS4에서 Spring Legacy Project를 생성하기 위한 플러그인 설치 방법
  - "Spring Tools 3 Add-On for Spring Tools 4" 설치 및 설정 과정

• 02. Spring MVC Project와 Tomcat 연결
  - STS4에서 톰캣 서버를 추가하고 레거시 프로젝트와 연결하는 방법
  - 프로젝트 유형 선택과 Tomcat 서버 설정

• 03. Tomcat Server 연결 localhost 테스트 확인
  - Tomcat 서버 실행 및 localhost를 통한 서버 연결 테스트 방법
  - 프로젝트명 제거 후 localhost로의 연결 설정 확인

01. STS4에서 Legacy Project 생성

💡 스프링 레거시 프로젝트는 주로 XML 설정을 사용했던 Spring의 초기 형태입니다. STS3는 이러한 레거시 프로젝트를 더 잘 지원하도록 설계된 반면, 최신 버전인 STS4는 Spring Boot 프로젝트에 최적화되어 있습니다.
하지만 STS4에서도 레거시 프로젝트를 다루기 위해 "Spring Tools 3 Add-On for Spring Tools 4" 플러그인을 설치할 수 있습니다.

- STS4에서 Spring Legacy Project를 생성하기 위한 플러그인 설치 방법

1. 이클립스를 실행하여 상단 메뉴 Help의 Eclipse MarketPlace를 클릭합니다.

   

2. 검색창에 "Spring Tools 3 Add-On for Spring Tools 4"를 입력하여
   플러그인을 찾아 Install 버튼을 클릭하여 설치를 진행합니다.

   

   

3. 설치 완료 후, 재시작 여부를 묻는 창에서 'Restart Now'를 클릭하여 Spring Tools Suite 4를 재시작합니다.

   

4. STS4에서 플러그인 설치 후
   File -> New -> Other… → Spring Legacy Project
   메뉴를 통해 새로운 레거시 프로젝트를 생성합니다.

   

5. 프로젝트 유형은 'Spring MVC Project'를 선택합니다.

   

6. 프로젝트 이름을 지정하고 선택하면 패키지가 생성됩니다.
   Project Name : ‘crudtest’ 생성

- Spring MVC Project와 Tomcat 연결

1. STS4에서 톰캣 서버를 추가하기 위해,
   하단에 Servers 뷰에서 New Server를 선택합니다.

   

   💡 Servers 탭이 안보인다면?
   제일 상단의 WINDOW → Show view → other 에 ‘Servers’ 를 입력해서 탭을 열어줍니다.

   

2. Apache -> Tomcat v9.0 Server를 선택한 후, 설치된 Tomcat 디렉토리를 지정하여 톰캣 서버를 추가합니다.

   

3. Next 클릭 -> Browse… 버튼 클릭해서 설치한 톰캣 경로를 지정해줍니다.

- 프로젝트와 톰캣 연결

1. 생성한 Spring Legacy Project를 톰캣 서버에 추가합니다.

   

2. Servers 뷰에서 톰캣 서버를 마우스 오른쪽 클릭하고 Add를 선택하여 프로젝트를 서버에 추가합니다.

3. 좌측 패키지 패널에서 생성된 항목을 확인합니다.
   → Spring Legacy Project : ‘crudtest’
   → Tomcat : Servers

03. Tomcat Server 연결 localhost 테스트 확인

- Tomcat 서버 실행 및 localhost를 통한 서버 연결 테스트 방법

1. Servers 뷰에서 톰캣 서버를 마우스 오른쪽 클릭하고 start 실행합니다.

2. 위와 같이 서버가 가동되면 웹 브라우저의 주소창에 아래와 같이 입력합니다.
   정상적으로 진행되었을 경우 기본 설정된 home.jsp 파일의 내용이 보입니다..
   - localhost:8080/[프로젝트명]
   - Ex) localhost:8080/crudtest
   
   💡 home.jsp 경로 : src/main/webapp/WEB-INF/views/home.jsp

- 프로젝트명 제거 후 localhost로의 연결 설정 확인

1. 연결이 확인되었으면, 서버 연결을 해제한 후 server.xml 파일에서
   path경로를 찾아 프로젝트명 제거 후, 서버를 재실행합니다.
   이후 localhost:8080/[프로젝트명] 경로 접속 시 404 에러가 발생하는지 확인합니다.

2. localhost:8080 로 주소를 수정하고 정상 접속이 확인되면 설정이 완료된 것입니다.

마무리
이번 포스팅에서는 STS4에서 Spring Legacy Project를 생성하고 Tomcat과 연결하는 방법에 대해 다뤘습니다. 저는 주로 IntelliJ와 스프링 부트를 사용하여 작업했기 때문에 Tomcat을 별도로 설치해본 경험이 없었습니다. 이번 기회를 통해 STS4 툴을 사용하며 Tomcat 설정 과정을 이해할 수 있어서 유익했던 시간이였습니다.

다음 글에서는 Spring Legacy Project CRUD 게시판 만들기를 진행하고 추후 포스팅을 진행해보겠습니다.

안녕하세요! 제 글을 읽어주셔서 감사합니다.
현재 글들은 작성된 날짜를 기준으로 포스팅되어 정보가 시간이 지나며 달라질 수 있습니다. 잘못된 정보나 수정이 필요한 부분이 있다면 언제든 알려주세요.
반영하여 더 나은 내용으로 공유하겠습니다. 감사합니다! :)

✉ dzdzz93@naver.com

📂 https://github.com/devloghub