개발 환경 설정 및 오류 대처

JDK 1.8 이상 설치

환경 변수에서 JAVA_HOME 설정 

변수값 : JDK가 설치된 경로

 

ex) 변수 이름 : JAVA_HOME
     변수 값    : C:\Program Files\Java\jdk1.8.0_171

 

Path에는 JDK bin 디렉토리를 %JAVA_HOME%\bin 으로 지정

 

설정이 완료된 후는 명령 프롬프트를 이용해서 javac 라는 명령어로 재대로 설정 되었는지 확인한다.

 

STS(Spring Tool Suite) 설정

 

https://spring.io/tools3 에서 다운로드 하자

 

Tomcat 설정

 

http://tomcat.apache.org/를 를 통해서 Tomcat 9.0 버전을 이용합니다.

 

다운로드 전에는 항상 https://tomcat.apache.org/whichversion.html 문서를 통해서 자신의 환경에 맞는 버전을 이용합니다.

 

스프링 프로젝트 생성

 

STS에서 스프링 프로젝트를 생성하는 방식은

1)처음부터 스프링 프로젝트를 지정하고 생성하는 방식

2)Maven이나 Gradle 프로젝트를 생성한 후 프레임워크를 추가하는 방식

3)직접 프레임워크 라이브러리를 추가하는 방식이 있습니다.

 

프로젝트를 최초로 생성하면 필요한 코드와 라이브러리를 다운로드하게 됩니다.

다운로드 하는 라이브러리들은 사용자 폴더 내 '.m2' 라는 이름의 폴더를 용합니다. '.m2' 폴더에 생성된 repository 폴더 안에는 프로젝트 생성 시 다운로드된 파일들이 추가됩니다.

 

프로젝트 가 온전히 생성되지 않는 경우가 있는데 이러한 경우 대부분은 Maven등에서 스프링 관련 jar 파일들을 다운로드하는 중에 문제가 발생하는 경우입니다.이때는 이클립스를 종료하고 사용자 폴더내에 있는 '.m2'밑에 'repository' 폴더의 내용물을 삭제해야 합니다.이 후 이클립스를 재시작하면 자동으로 생성된 프로젝트를 점검하면서 관련 라이브러리들을 재 다운로드 합니다.

 

Spring Regacy Project 메뉴로 생성하면 편리하지만 버전이 3.X 버전이고, JDK 환경이 1.6으로 작성되어 있는 것을 확인 할 수 있다. 스프링 5버전을 이용할 계획이기 때문에 pom.xml 파일을 통해서 수정했습니다.

 

알맞는 스프링 메이븐은 maven repository 에서 검색을 통해 찾습니다. 

맞는 버전을 확인후에 dependency 에서 제대로 변경 되었는지 확인합니다.

 

pom.xml의 <plugin>태그 중 maven-compiler-plugin의 내용을 1.6에서 1.8 로 변경합니다.

폴더>maven>프로젝트 업데이트를 한 후에 컴파일과 실행 환경이 바뀌었는지 확인합니다.

 

이제 정상적으로 실행이 되는지 확인하기 위해 run on server 를 이용하여 톰캣을 실행시킵니다.

이때 저는 에러가 발생되었는데 종료 port를 -1 이 아닌 0을 주어서 해결했습니다.

아래는  Tomcat 의 에러 발생시 대처 요령입니다.

 

1. web.xml 에러

servlet등록이 잘못되어 있을 때를 말한다. servlet-name, servlet-classm url-pattern을 오타없이 정확히 기입했는지 확인하자.

2. 서블릿 어노테이션

생성한 servlet의 어노테이션에 오타가 있을 경우 서버가 시작되지 않는다. 때문에 어노테이션 부분을 잘못 썼는지 다시 한번 확인해 보자.

3. 포트번호(8080) 충돌

기본설정 포트번호인 8080에 다른 서버가 잡혀 있어서 톰캣서버가 이 포트번호에 접속하려는 경우 충돌이 발생하면 역시 에러가 난다. 톰캣의 conf폴더의 server.xml파일에서 포트번호를 다른 번호로 변경해주자(보통 8090이나 80를 사용한다).

4. 프로젝트 클린 안해서

프로젝트를 주기적으로 클린해주지 않으면 가끔씩 서버가 꼬이는 경우가 있다. 때문에 프로젝트 클린 또한 한 번 실시해주도록 한다.

5. 프로젝트에 서버 업로드 안해서

웹프로젝트에 서버가 업로드 되지 않아서 발생할 경우도 있다(이 때는 프로젝트 파일들의 http관련 클래스에 빨간줄이 그어져 있을 것이다). 해당 프로젝트를 우클릭 한 후 properties => java build path=> libraries => add library => server runtime => tomcat7을 등록한다.

출처: https://tenlie10.tistory.com/31 [유니티 게임 개발자]