[Spring] 스프링 MVC 1편 백엔드 웹 개발 핵심 (2)

 

https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-mvc-1/dashboard

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의

 

스프링 MVC 1편 백엔드 웹 개발 핵심 강의 정리

 

 

1. 스프링 프로젝트 생성

 

스프링 부트 스타터 사이트로 생성

(Pro Edu 버전을 사용하고 있어 인텔리제이에서 바로 생성)

 

Packaging: War - Jar를 통해서 많이 사용하나 강의에선 JSP 를 사용하기 위해서 WAR로 진행함.

Dependencies: Spring Web, Lombok

 

 

Postman을 설치 - 로그인 필요 * 회원가입 또는 구글 계정으로 로그인 가능함.

https://www.postman.com/downloads 

 

서블릿

 

[참고] 서블릿

: 서블릿은 톰캣과 같은 WAS(웹 어플리케이션 서버)를 직접 설치하고 그 위에 서블릿 코드를 클래스 파일로 빌드해서 올린 다음, 톰캣 서버를 실행하면 되지만 과정이 매우 번거롭다. 스프링 부트는 톰캣 서버를 내장하고 있어 별도의 서버 셋팅이나 설치 과정없이 편리하게 서블릿 코드를 실행할 수 있다.

 

@ServletComponentScan

: 스프링 부트는 서블릿을 직접 등록해서 사용할 수 있도록 해당 어노테이션을 지원함.

: Servlet 3.0 스팩의 일부인 @WebServlet, @WebFilter, @WebListener 등의 어노테이션을 스캔하는 데 사용'

 

@ServletComponentScan //서블릿 자동 등록
@SpringBootApplication
public class ServletApplication {

    public static void main(String[] args) {
        SpringApplication.run(ServletApplication.class, args);
    }

}

 

import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

public class ServletInitializer extends SpringBootServletInitializer {

	@Override
	protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
		return application.sources(ServletApplication.class);
	}

}

@WebServlet annotaion

@WebServlet(name = "requestHeaderServlet", urlPatterns = "/request-header")

RequestHeaderServlet 을 통해서, HttpServletRequest 에 어떤 데이터들이 있는 지 출력

* 

@WebServlet(name = "requestHeaderServlet", urlPatterns = "/request-header")
public class RequestHeaderServlet extends HttpServlet {
    @Override
    public void service(HttpServletRequest reqeust, HttpServletResponse response) throws ServletException, IOException {
        printStartline(reqeust);
        printHeaders(reqeust);
        printHeaderUtils(reqeust);
        printEtc(reqeust);
    }

    private void printStartline(HttpServletRequest request) {
        System.out.println("--- REQUEST-LINE - start ---");

        System.out.println("request.getMethod() = " + request.getMethod()); //GET
        System.out.println("request.getProtocal() = " + request.getProtocol()); //HTTP/1.1
        System.out.println("request.getScheme() = " + request.getScheme()); //http
        // http://localhost:8080/request-header
        System.out.println("request.getRequestURL() = " + request.getRequestURL());
        // /request-test
        System.out.println("request.getRequestURI() = " + request.getRequestURI());
        //username=hi
        System.out.println("request.getQueryString() = " + request.getQueryString());
        System.out.println("request.isSecure() = " + request.isSecure()); //https 사용 유무
        System.out.println("--- REQUEST-LINE - end ---");
        System.out.println();
    }

    public void printHeaders(HttpServletRequest request){
        System.out.println("--- REQUEST-LINE - start ---");

        //1
        Enumeration<String> headerNames = request.getHeaderNames();

        while(headerNames.hasMoreElements()){
            String headerName = headerNames.nextElement();
            System.out.println(headerName + " : " + headerName);
        }


        //2
        request.getHeaderNames().asIterator()
                .forEachRemaining(headerName -> System.out.println(headerName + " : " + headerName));

        System.out.println("--- REQUEST-LINE - end ---");
        System.out.println();

    }
    private void printHeaderUtils(HttpServletRequest request) {
        System.out.println("--- Header 편의 조회 start ---");
        System.out.println("[Host 편의 조회]");
        System.out.println("request.getServerName() = " + request.getServerName()); //Host 헤더
        System.out.println("request.getServerPort() = " + request.getServerPort()); //Host 헤더
        System.out.println();

        System.out.println("[Accept-Language 편의 조회]");
        // Accpet Locale 정보
        request.getLocales().asIterator()
                .forEachRemaining(locale -> System.out.println("locale = " + locale));
        // 가장 우선순위 높은 Locale
        System.out.println("request.getLocale() = " + request.getLocale());
        System.out.println();

        System.out.println("[cookie 편의 조회]");
        if (request.getCookies() != null) {
            for (Cookie cookie : request.getCookies()) {
                System.out.println(cookie.getName() + ": " + cookie.getValue());
            }
        }
        System.out.println();

        System.out.println("[Content 편의 조회]");
        System.out.println("request.getContentType() = " + request.getContentType());
        System.out.println("request.getContentLength() = " + request.getContentLength());
        System.out.println("request.getCharacterEncoding() = " + request.getCharacterEncoding());

        System.out.println("--- Header 편의 조회 end ---");
        System.out.println();
    }

    private void printEtc(HttpServletRequest request) {
        System.out.println("--- 기타 조회 start ---");

        System.out.println("[Remote 정보]");
        System.out.println("request.getRemoteHost() = " + request.getRemoteHost()); //
        System.out.println("request.getRemoteAddr() = " + request.getRemoteAddr()); //
        System.out.println("request.getRemotePort() = " + request.getRemotePort()); //
        System.out.println();

        System.out.println("[Local 정보]");
        System.out.println("request.getLocalName() = " + request.getLocalName()); //
        System.out.println("request.getLocalAddr() = " + request.getLocalAddr()); //
        System.out.println("request.getLocalPort() = " + request.getLocalPort()); //

        System.out.println("--- 기타 조회 end ---");
        System.out.println();
    }
}

 

 

HTTP 요청데이터 GET 쿼리 스트링

package hello.servlet.basic.request;

import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import java.io.IOException;


@WebServlet(name="requestParamServlet", urlPatterns = "/request-param")
public class RequestParamServlet extends HttpServlet{
    @Override
    public void service(ServletRequest request, ServletResponse response) throws ServletException, IOException {
        //System.out.println("RequestParamServlet.service");
        System.out.println("[전체 파라미터 조회] - Start");
            request.getParameterNames().asIterator()
                            .forEachRemaining((paramName -> System.out.println(paramName+ ": "+ request.getParameter(paramName))));
        System.out.println("[전체 파라미터 조회] - Start");
        System.out.println();

        System.out.println("[단일 파라미터 조회] - Start");

        String userName = request.getParameter("username");
        String age = request.getParameter("age");

        System.out.println("userName = " + userName);
        System.out.println("age = " + age);

        System.out.println("[단일 파라미터 조회] - end");
        System.out.println();

        // 파라미터 이름이 하나인데 값이 중복이면???
        // request.getParameter 의 경우는 하나의 파라미터인 경우에만 사용해야 함.
        // request.getParameterValues를 사용함.
        System.out.println("[같은 복수 파라미터 조회] - Start");

        String [] userNames = request.getParameterValues("username");

        for(String name : userNames){
            System.out.println("username = " + name);
        }

        System.out.println();

        response.getWriter().write("ok");
    }
}

 

 

 

HTTP 요청데이터 - HTML FORM

 

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/request-param" method="post">
    username: <input type="text" name="username" />
    age:      <input type="text" name="age" />
    <button type="submit">전송</button>
</form>
</body>
</html>

 

application/x-www-form-urlencodded 형식은 GET 의 쿼리 파라미터와 동일

쿼리 파라미터의 조회 메서드를 그대로 사용 할 수 있다.

서버 입장에서는 둘의 형식이 동일하므로, request.getParamter() 로 구분없이 조회 가능함.

 

 

HTTP 요청데이터 - API 메시지 바디 - 단순 텍스트

 

Http message body 직접 데이터를 담아서 요청함.

HTTP API 에서 주로 사용 (JSON, XML, TEXT)

 

package hello.servlet.basic.request;

import org.springframework.util.StreamUtils;

import javax.servlet.ServletException;
import javax.servlet.ServletInputStream;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

@WebServlet(name = "RequestBodyStringServlet", urlPatterns = "/request-body-string")
public class RequestBodyStringServlet extends HttpServlet {

    @Override
    public void service(ServletRequest req, ServletResponse res) throws ServletException, IOException {
        ServletInputStream inputStream = req.getInputStream();
        // Byte 전환 , Charset 지정 필수
        String messageStream = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

        System.out.println("messageStream = " + messageStream);
        System.out.println();

        res.getWriter().write("ok");
    }
}

 

HTTP 요청데이터 - API 메시지 바디 - JSON

 

주로 사용하는 JSON 형식으로 데이터 전달

 

 

데이터 전달하기 위한 Data

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class HelloData {

    private String username;
    private int age;
}

* Lombok 관련 확인 (File > setting으로 들어가서 annation processors)

Enable annotation processing 체크여부 확인

Json 데이터를 ObjectMapper 를 통해서 HelloData에다 저장

import com.fasterxml.jackson.databind.ObjectMapper;
import hello.servlet.basic.HelloData;
import org.springframework.util.StreamUtils;

import javax.servlet.ServletException;
import javax.servlet.ServletInputStream;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

@WebServlet(name = "RequestBodyJsonServlet", urlPatterns = "/request-body-json")
class RequestBodyJsonServlet extends HttpServlet {
   
    private ObjectMapper objectMapper = new ObjectMapper();
   
    @Override
    public void service(ServletRequest req, ServletResponse res) throws ServletException, IOException {
        ServletInputStream inputStream = req.getInputStream();
        String messageBody  = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

        System.out.println("messageBody = " + messageBody);
        
        HelloData helloData = objectMapper.readValue(messageBody, HelloData.class);

        System.out.println("helloData.getUsername() = " + helloData.getUsername());
        System.out.println("helloData.getAge() = " + helloData.getAge());
    }
}