STS (Spring Tool Suite 4) 를 이용한 웹 프로젝트나 웹 서비스를 개발할 때, 프로젝트를 생성하기까지의 과정을 설명한다.
먼저, 내 피시에 JDK가 설정되어있는지 확인하고, 설정되어있지 않다면, JDK를 다운로드 받자
https://www.oracle.com/kr/java/
오라클 페이지에서 JDK를 원하는 버전으로 다운로드 받았다면,
환경변수로 등록해주어야한다.
JDK 파일이 존재하는 파일 경로를 바로 지정해줘도 되지만, 나는 JDK파일을 위한 폴더를 생성해서 JDK파일을 보관해둔다.
먼저 압축 해제한 JDK 파일을 c://Program Files/java/ 폴더를 생성하고, java폴더 안에 해당 JDK폴더를 넣어주고,
환경변수를 등록해보자.
1.내 PC에서 오른쪽 마우스 클릭 -> 속성 -> 고급 시스템 설정 -> 환경변수 클릭
2. 시스템 변수 탭 하단의 새로 만들기 클릭 (제일 아래에 있는 버튼)
해당 값들을 입력해주고, 확인을 누른다.
3. Path를 선택하고 편집을 누른다.
4. [새로만들기] 버튼을 클릭하고, [%JAVA_HOME%\bin] 을 입력해준 후, 창을 닫는다.
- 내가 다운받은 jdk 폴더 내부의 bin 폴더를 지정한 경로이다.
5. 마지막으로, JAVA_HOME 변수를 만들 때 처럼, 하단의 새로만들기 버튼을 클릭하고, CLASSPATH 변수를 아래와 같이 등록해준다.
지금까지 완료했다면, jdk가 정상적으로 등록됐을 것이다.
등록된 jdk를 확인해보자.
dos 창을 열어서 [java -version] 명령어를 쳐보자.
아래와 같이, 설치한 jdk 버전 정보가 출력되면 정상적으로 jdk가 등록된 것이다.
이제 Spring tool suite 를 설치해야한다.
Spring Tools 4 is the next generation of Spring tooling
Largely rebuilt from scratch, Spring Tools 4 provides world-class support for developing Spring-based enterprise applications, whether you prefer Eclipse, Visual Studio Code, or Theia IDE.
spring.io
위 경로에 가서 Spring 설치하면 된다.
나는 무난하게 Spring 4. 대 버전의 Sts를 설치했다.
설치를 완료하면, 압축을 풀고,
sts-bundle 폴더 내부의 sts-3.9.7.RELEASE 폴더로 들어가면, STS.exe 처럼 실행파일이 존재하는데, 해당 실행파일을 클릭해서 sts를 실행시키면 된다.
실행시키고 난 뒤, mvc를 이용한 웹 프로젝트를 생성하기 위해선, spring mvc Project를 생성해야한다.
1. 왼쪽 상단의 FILE 항목 -> NEW -> Other로 진입하면 해당 팝업 창이 뜬다.
여기에 드래그 되어있는, Spring Legacy Project를 클릭한다.
2. Spring Legacy Project를 클릭하면, 해당 화면이 뜨는데, 여기서 제일 하단의 Spring MVC Project를 선택한다.
테스트를 위한 프로젝트를 만들고 있기 때문에, Project name을 mvcProject라고 생성했다.
프로젝트 명을 입력하고 Next 를 클릭한다.
3. 다음 화면 페이지다.
여기서는 프로젝트의 기본 패키지 명을 입력하게 되어있는데, 패키지는 프로젝트를 생성한 이후에도,
사용자가 임의로 계속 생성할 수 있으므로, [mvc.test.app]으로 대충 작명하여 입력했다.
여기까지 진행하면 왼쪽 탭 Project Explorer에 프로젝트가 하나 생성되어 있다.
아래에 보면 내가 만든 패키지 안에, HomeController라고 프로젝트 내부에 컨트롤러가 하나 존재해있다.
일단 지나치고, 프로젝트를 정상적으로 실행시키기 위한 톰캣 서버를 설치해야한다.
Apache Tomcat® - Welcome!
The Apache Tomcat® software is an open source implementation of the Jakarta Servlet, Jakarta Server Pages, Jakarta Expression Language, Jakarta WebSocket, Jakarta Annotations and Jakarta Authentication specifications. These specifications are part of the
tomcat.apache.org
해당 페이지에서 Tomcat을 설치하면 된다.
어떤 버전이든 다운을 받은 후, c드라이브 안에 해당 톰캣 폴더를 넣어줬다.
c드라이브에 꼭 존재해야 하는 건 아니다 ~! 본인이 관리하기 편한 곳에 넣어줘도 된다.
그리고 다시, sts로 돌아와서 tomcat을 인스톨해준다.
하단의 Servers 탭에 들어가면, No servers available .... 라는 링크가 보일텐데, 해당 링크를 클릭해주자
(Servers 탭이 안보인다면 제일 상단의 WINDOW -> Show view -> other 에 'Servers'를 입력해서 탭을 열어주자)
해당 링크를 클릭하면, 아래 페이지가 뜨는데 여기서 본인이 설치한 tomcat 버전을 검색해서 클릭해준다.
Next 클릭 후, Browse... 버튼을 클릭해서 설치한 톰캣 경로를 지정해준다.
이 후, Finish를 클릭하면, 우리가 만든 MVC project를 구동시킬 톰캣 서버가 생성된다.
해당 서버가 생성되면 서버에 마우스를 두고 오른쪽 클릭을 한 후, add And Removes... 항목을 선택한다.
여기서, 우리가 생성한 mvcProject를 오른쪽 Configured 탭으로 옮겨 준 후, Finish를 눌러준다.
여기까지, 우리는 생성한 프로젝트를 tomcat 서버에 올려주었다.
톰캣을 실행하기 전, 수정할 사항이 있다.
여기 우리가 톰캣을 생성하면서 생긴 Servers 폴더다.
폴더 내부에 server.xml 파일을 열어 보면, 톰캣에 올라가 있는 MVC 프로젝트를 호출할 때, 호출 URL을 설정하는 부분을 볼 수 있다.
해당 파일은 아래와 같다.
<Context --> 태그를 보면 path 속성이 있는데, 현재 path 경로가 '/app' 이다.
이는 http://localhost8080/app/...~~ 으로 호출 경로를 시작해야 해당 프로젝트를 찾을 수 있다는 말이다.
여기서 path="/" 로 변경하고 저장해주자.
그리고 서버를 시작한 후에,
아래 HomeController에 명시되어있는 '/'를 호출하면 된다.
주소창에 http://localhost:8080/ 이라고 호출을 해보면,
HomeController에 명시되어있는 호출 경로가 실행되면서, Hello World가 찍히게 된다.
여기까지 진행했다면, MVC 프로젝트를 개발할 준비가 완료되었다는 뜻이다