📌 STS3 기반 Spring Legacy 프로젝트 설치 및 설정 가이드

📅 날짜

2025-04-21

---

🧭 목차

1. STS3 다운로드
2. STS.ini 설정
3. 스프링 템플릿 오류 해결
4. Spring Legacy 템플릿 오류 해결
5. UTF-8 인코딩 설정
6. 프로젝트 생성 후 톰캣 연결
7. pom.xml 설정
8. web.xml 인코딩 필터 설정
9. 실행 확인 방법
10. 참고 자료

---

📝 학습 내용

✅ 1. STS3 다운로드

• GitHub 배포 페이지:
  🔗 https://github.com/spring-attic/toolsuite-distribution/wiki/Spring-Tool-Suite-3
• Full distribution on Eclipse 4.21 버전 다운로드
• 압축 경로는 한글 경로, 너무 긴 경로 피하기 → C:\sts-3.9.18.RELEASE 권장

---

✅ 2. STS.ini 설정

-startup
plugins/org.eclipse.equinox.launcher_1.6.300.v20210813-1054.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.300.v20210828-0802
-product
org.springsource.sts.ide
--launcher.defaultAction
openFile
-vm
C:\jdk-11.0.2\bin\javaw.exe

-vmargs
-javaagent:lombok.jar
-Dosgi.requiredJavaVersion=11
-Dosgi.dataAreaRequiresExplicitInit=true
-Xms256m
-Xmx2048m
--add-modules=ALL-SYSTEM
-Dosgi.module.lock.timeout=10

💡 설명:
javaagent:lombok.jar는 Lombok 속도 개선 및 정상 작동을 위한 필수 설정
해당 파일은 STS 설치 경로 (C:\sts-3.9.18.RELEASE)에 위치해야 함

---

✅ 3. 스프링 템플릿 오류 해결

• 경로:

  [워크스페이스]/.metadata/.plugins/org.springsource.ide.eclipse.commons.content.core

• 비어 있다면 아래 링크에서 https-content.xml 다운로드 후 복사
  🔗 https://nirsa.tistory.com/405

---

✅ 4. Spring Legacy 템플릿 오류 해결

• 추가로 받은 압축 파일 해제 → template.xml, template.zip, wizard.json 구성

• 복사 경로:

  C:\Users\Administrator\Desktop\SPRING\SPRINGMY\.metadata\.sts\content\org.springframework.templates.mvc-3.2.2

---

✅ 5. UTF-8 인코딩 설정

1. Window → Preferences 진입
2. General → Workspace → Text file encoding: UTF-8
3. Web → CSS / HTML / JSP / JSON: 각각 UTF-8로 변경

---

✅ 6. 프로젝트 생성 후 톰캣 연결

1. Servers 탭에서 New → Tomcat 9.0 선택
2. 톰캣 설치 경로 지정: C:\apache-tomcat-9.0.xx
3. 포트 번호 변경
   • HTTP: 8090
   • HTTPS: 8091

📌 포트 설정 경로:
Servers 탭에서 톰캣 더블 클릭 → Overview 화면 → Ports 섹션

4. 프로젝트 추가: Add and Remove... → 프로젝트 이동 → Finish
5. 서버 우클릭 → Start

---

✅ 7. pom.xml 설정

<properties>
  <java-version>11</java-version>
  <org.springframework-version>5.0.7.RELEASE</org.springframework-version>
  <org.aspectj-version>1.6.10</org.aspectj-version>
  <org.slf4j-version>1.6.6</org.slf4j-version>
</properties>

<!-- Lombok -->
<dependency>
  <groupId>org.projectlombok</groupId>
  <artifactId>lombok</artifactId>
  <version>1.18.38</version>
  <scope>provided</scope>
</dependency>

<!-- 주의: 충돌 방지를 위해 아래 runtime scope 주석 처리 -->
<!-- <scope>runtime</scope> -->

💡 Lombok 주의사항

• 반드시 STS/Eclipse에 Lombok 플러그인 설치 필요
• provided 설정은 컴파일 시만 사용
• 충돌 방지를 위해 SLF4J 관련 scope 설정은 조심

---

✅ 8. web.xml 인코딩 필터 설정

<!-- 한글 변환 필터 시작 -->
<filter>
  <filter-name>encodingFilter</filter-name>
  <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
  <init-param>
    <param-name>forceEncoding</param-name>
    <param-value>true</param-value>
  </init-param>
</filter>

<filter-mapping>
  <filter-name>encodingFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>
<!-- 한글 변환 필터 끝 -->

💡 <filter>는 반드시 <servlet> 태그보다 위쪽에 위치해야 함

---

✅ 9. 실행 확인 방법

1. STS에서 프로젝트를 Run on Server
2. 브라우저에서 http://localhost:8090/프로젝트명 접속
3. 한글이 정상 출력되는지 확인
4. 콘솔 오류 로그 없이 톰캣 서버가 실행되면 성공!

---

🔥 정리

• STS3은 Spring Legacy 개발에 적합한 안정적인 개발 환경
• 필수 설정: 인코딩, 템플릿 복사, lombok 설정, pom.xml
• javaagent:lombok.jar, UTF-8 필터 등은 초기 세팅에서 반드시 필요
• 프로젝트 실행까지 전체 흐름을 체계적으로 설정할 수 있음

---

🔗 참고 자료

• STS3 다운로드
• Lombok 다운로드
• Maven Repository - Lombok
• Spring 템플릿 오류 해결 링크

---