Spring MVC 강의를 듣기위해 프로젝트를 생성하려는데 IntelliJ에는 Spring MVC 프로젝트 만들기가 없는 것이다...!
삽질의 삽질 끝에 Hello World! 페이지를 볼 수 있었다 😂

선행 작업

• Tomcat 설치

---

1. Maven 프로젝트 생성

[New Project] -> [Maven Archetype] 선택 후
1) name 설정 (프로젝트 이름)
2) JDK 버전 설정
3) Archetype을 maven-archetype-webapp로 설정
4) 하단에 Advanced Settings에서 GroupId 설정(com.example.~)

2. pom.xml dependency 설정

1) pom.xml 파일의 <dependencies> </dependencies> 안에 아래 코드를 추가한다
2) reload를 해준다
injelliJ가 우측 상단에 이런 버튼을 띄워준다

<!-- spring  -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <!-- spring mvc -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>

    <dependency>
      <groupId>javax.servlet.jsp.jstl</groupId>
      <artifactId>jstl-api</artifactId>
      <version>1.2</version>
      <type>jar</type>
    </dependency>

    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.2</version>
      <scope>provided</scope>
    </dependency>

    <dependency>
      <groupId>cglib</groupId>
      <artifactId>cglib</artifactId>
      <version>2.2.2</version>
    </dependency>

    <!-- junit test -->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>

    <!-- database -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.4.6</version>
    </dependency>

    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>1.3.2</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

3. Web.xml 수정

Web.xml은 src\main\webapp\WEB-INF 아래에 자동으로 생성됐을 것이다.

만약 Web.xml이 없다면...
1) [File] -> [Project Structue] 창을 열어서 [Project Setting] -> [Modules] 선택 후 web 추가

2) Path를 프로젝트path\src\main\webapp\WEB-INF\web.xml로 설정
3) Web Resource Directory를 프로젝트path\src\main\webapp로 설정

이제 web.xml을 열고 아래 코드를 작성한다.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <display-name>Spring MVC</display-name>

    <!-- Root context -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/root-context.xml</param-value>
    </context-param>

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- servlet context -->
    <servlet>
        <servlet-name>appServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/servlet-context.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>appServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- encoding filter -->
    <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>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>

그려면 빨간줄이 두 개가 뜰 것이다. 해당 파일이 없기 때문에 오류가 난 것이다!

4. root-context.xml, servlet-context.xml 생성

생성 시 일반 xml파일로 생성하면 안되고 Spring Config 파일로 생성해야 한다.
[WEB-INF] 폴더 우클릭 -> [new] -> [XML Configuration File] -> [Spring Config] 선택

두 파일을 생성 한 후 servlet-context.xml 파일 내용만 아래 코드로 변경해준다

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- This tag registers the DefaultAnnotationHandlerMapping and
         AnnotationMethodHandlerAdapter beans that are required for Spring MVC  -->
    <mvc:annotation-driven />
    <!-- This tag allows for mapping the DispatcherServlet to "/" -->
    <mvc:default-servlet-handler />

    <!-- Process annotations on registered beans like @Autowired... -->
    <context:annotation-config/>
    <!-- 컴포넌트 스캔 -->
    <context:component-scan base-package="com.example.mvcproject" />

    <bean id="viewResolver"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/" />
        <property name="suffix" value=".jsp" />
    </bean>

</beans>

그러면 아래 부분에 오류가 발생한다.

<!-- 컴포넌트 스캔 -->
   <context:component-scan base-package="com.example.mvcproject" />

1) base-package를 자신의 groupId/artifactId로 변경한다.(프로젝트 생성시 설정한 이름. 모르면 pom.xml 참고)
2) 프로젝트 main 폴더 아래에 java 디렉토리 추가 후 com.example.mvcproject 패키지 추가

5. Spring module, Application context 추가

1) [File] -> [Project Structue] 창을 열어서 [Project Setting] -> [Modules] 선택 후 Spring 추가

2) add(+) 선택 후 위에서 생성한 xml 파일들을 선택해준다

6. 컨트롤러, 뷰 만들기

설정이 잘 됐는지 확일하기 위해 컨트롤러와 뷰를 만들어준다.

컨트롤러는 위에서 만든 com.example.mvcproject 패키지에 생성한다.

package com.example.mvcproject;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloController {

	@RequestMapping("/hello")
	public String home(){
		return"hello";
	}
}

뷰는 아까 servlet-context.xml에서 설정한대로
WEB-INF 폴더 밑에 views 폴더를 생성하고 hello.jsp 파일을 생성한다

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    HelloWolrd?
</body>
</html>

7. Tomcat 설정

마지막으로 톰캣 설정만 해주면 끝이다

1) run 버튼 옆에 [Current File] -> [Edit Configurations] 클릭

2) [add] -> [Tomcat Server Local] 선택

3) server 선택(configure... -> Tomcat 설치 주소), port 설정

4) [Deployment] 탭으로 가서 [add] -> [Artifact...] 선택 후 war exploded 추가

5) 하단에 Application context 수정
주소를 /로 변경해줘야 루트 주소가 http://localhost:8080/ 로 설정 됨

8. 기타 설정

실행하려는데 java: error: release version 5 not supported 에러가 뜬다면

[Settings] -> [Build, Execution, Deploymen] -> [Compiler] -> [Java Compiler] 에 들어가서 Target version을 확인해보면 된다.

maven 프로젝트는 따로 설정하지 않는 이상 자바 default 버전으로 1.5를 쓰기 때문에 1.5 를 프로젝트 자바 버전으로 변경해준다.

pom.xml에도 properties 코드를 추가해준다

<properties>
    <java.version>11</java.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>11</maven.compiler.source>
    <maven.compiler.target>11</maven.compiler.target>
  </properties>

끝!