Spring

스프링 부트 웹 MVC - 정적 리소스 지원

Spring

Posted by kwon on 2020-04-10

Spring Boot 정적 리소스 지원

정적 리소스 맵핑 “​/​”

  • 기본 리소스 위치
    • classpath:/static
    • classpath:/public
    • classpath:/resources/
    • classpath:/META-INF/resources
  • Last-Modified 헤더를 보고 304 응답을 보냄.
  • 304 상태 코드 : 서버의 변경사항이 없음
  • 파일이 변경되면 Last_Modified가 변경되는데 이것을 감지하면 리소스를 클라이언트에게 새로 보냄.
  • 서버 변경사항이 없을 때 다시 요청을 보내면 304 코드로 응답하며 리소스를 새로 보내지 않는다. 따라서 응답이 훨씬 빨라진다.

spring.mvc.static-path-pattern: 맵핑 설정 변경 가능

  • 기본적으로 resource들은 root부터 매핑이 되어있는데, 이것을 변경하고 싶다면 application.properties에서 다음과 같이 변경하면 된다.
  • 예) “/hello.html” => /static/hello.html
1
spring.mvc.static-path-pattern=/static/**

이렇게 변경한다면 다음과 같이 /static/hello.html 로 요청해야 정상적으로 응답이 된다.

WebMvcConfigurer의 addRersourceHandlers로 커스터마이징

  • com.kwon.demospringmvc/config/WebConfig 파일
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    @Configuration
    public class WebConfig implements WebMvcConfigurer {
        // 기존에 제공하는 리소스 핸들러는 그대로 유지하며
        // 원하는 리소스 핸들러만 추가할 수 있음
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) {
            registry.addResourceHandler("/m/**")
                    .addResourceLocations("classpath:/m/") // 반드시 '/'로 끝나야 함
                    .setCachePeriod(20); // 없어도 됨.(캐시 지속시간 설정 (초))
        }
    }
  • 위와 같이 작성하면 기존에 제공하는 리소스 핸들러는 그대로 유지하며 원하는 리소스 핸들러만 추가할 수 있음
  • addResourceHandlers는 리소스 등록 및 핸들러를 관리하는 객체인 ResourceHandlerRegistry를 통해 리소스 위치와 이 리소스와 매칭될 url을 등록
  • setCachePeriod : 캐시의 지속시간 설정(초)
  • resource/m/hello2.html
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
    Hello2~ Static Resource
    </body>
    </html>
    이제 /m/hello2.html로 요청을 보내면 정상적인 응답을 받을 수 있다.

스프링 부트 웹 jar

스프링 부트는 웹 jar에 대한 기본 매핑도 제공한다.
mvnrepository 에서 원하는 웹 jar을 검색하여 의존성을 추가하면 된다.

  • jquery의존성 추가
    1
    2
    3
    4
    5
    6
    <!-- https://mvnrepository.com/artifact/org.webjars.bower/jquery -->
    <dependency>
        <groupId>org.webjars.bower</groupId>
        <artifactId>jquery</artifactId>
        <version>3.4.1</version>
    </dependency>
  • 다음과 같이 jquery를 테스트해 보자.
  • static/hello.html
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
    Hello Static Resource
    <script src="/webjars/jquery/3.4.1/dist/jquery.min.js"></script>
    <!--/webjars/jquery/dist/jquery.min.js -->
    <script>
        $(function(){
           alert("ready!");
        });

    </script>
    </body>
    </html>
  • 이때 /webjars/jquery/3.4.1/dist/jquery.min.js 와 같이 버전을 명시하였는데, 만약 jquery버전을 변경할 때마다 소스 코드를 찾아서 변경해야 한다면 번거로우니 생략할 수 있다.
    • /webjars/jquery/dist/jquery.min.js
  • 버전을 생략하려면 다음과 같은 webjars-locator-core라는 의존성을 추가해주어야 한다.
    1
    2
    3
    4
    5
    6
    <!-- https://mvnrepository.com/artifact/org.webjars/webjars-locator-core -->
    <dependency>
        <groupId>org.webjars</groupId>
        <artifactId>webjars-locator-core</artifactId>
        <version>0.44</version>
    </dependency>

이제 http://localhost:8080/hello.html 로 요청하니 정상적으로 작동하는 것을 볼 수 있다.

참조
https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81%EB%B6%80%ED%8A%B8/dashboard

FEATURED TAGS
Spring
FRIENDS