SpringBoot * JSP 연동하기 ㅠㅠ ( feat. ✅ solved few errors )

Spring boot는 JSP 연동하는 걸 싫어한다.

아니 싫어하는 거 같다! ㅂㄷㅂㄷ 🤯

 

공식 문서에도 JSP 사용하는 것을 권장하지 않으며 다른 템플릿 엔진을 쓰라고 나와 있다.

FreeMarker, Groovy, Thymeleaf, Mustache를 추천하고 있다.

JSP는 JAR 패키징을 할 수 없고(war로 패키징 해야 함) 의존성 문제도 발생 할 수 있기 때문이라고 한다.

 

기존에 Spring Framwork에서는 웹 애플리케션을 구성 할 때 View 영역에 JSP를 사용했다.

하지만 Spring boot를 사용하는 지금.. JSP를.. 😥🤣😂 대부분의 Spring boot 예제들도 위의 추천 템플릿을 사용한다.

 

이건 어쩔 수 없이 JSP를 써야 했던 나에게 바치는 포스팅이다..

 

 

시자ㅏㅏㅏㅏ악...

1. Dependencies 추가

스프링 부트는 내장 톰켓을 가지고 있지만 이 내장 톰켓 안에 JSP를 구동시키는 친구는 포함하지 않는다.

(추천 안 하니까 당연한 걸지도 모르겠다.)

사용하고 싶은 우리가 직접 의존성을 추가해줘야한다.

 

다음 두개의 의존성을 dependencies 안에 추가해주자

implementation 'javax.servlet:jstl'
implementation 'org.apache.tomcat.embed:tomcat-embed-jasper'

Could not find javax.servlet.jsp.jstl:jstl:1.2.

 

MVN REPOSITORY에서 jstl를 검색하면 다음과 같은 의존성 정보가 나온다.

implementation group: 'javax.servlet.jsp.jstl', name: 'jstl', version: '1.2'

이걸 추가하면 에러가 생기는데 group의 주소(?)가 잘못되어서 그런 것 같다.

 

✅ solved

implementation group: 'javax.servlet', name: 'jstl', version: '1.2' 으로 수정해서 사용하면 해결된다.

 

쓰니는 에러를 해결하고 난 뒤 version 정보를 없에고 group과  name을 합쳐서 정리해줬다!

딱히 지정할 버전이 없다면 위 코드블럭 처럼 작성하는게 깔끔해보인다!

 

24.03.21 추가

3.0 미만인 경우에서 사용되는 의존성 주입이니, 만약 spring boot 3.0 버전 이상이라면 위의 코드 대신에 아래 의존성을 추가하자!

implementation 'jakarta.servlet.jsp.jstl:jakarta.servlet.jsp.jstl-api'
implementation 'org.glassfish.web:jakarta.servlet.jsp.jstl'
implementation 'org.apache.tomcat.embed:tomcat-embed-jasper'

2. application.yml 파일에 내용 추가

prefix로 webapp 하단의 위치를 지정해주고 suffix로 파일 확장자를 적어준다.

static-path-pattern 로 참고할 정적 resource 위치를 잡아준다. ( css, js, img 파일 분리를 위한 작업 )

무슨 말인가 싶다면 아래 3번의 폴더 구조와 비교하며 보길바란다.

spring:
  mvc:
    view:
      prefix: /WEB-INF/views/
      suffix: .jsp
    static-path-pattern: /resources/**

3. 폴더 경로 설정 및 해당 경로에 .jsp 파일 추가

application.yml에 설정한 경로대로 폴더를 생성하고 .jsp 파일을 넣어준다.

 

 

내용이 많아 필요한 부분이외에는 모자이크를 했다.

 

보다싶이 src/main/webapp/WEB-INF/views/.jsp 가 위치하고 있다.

prefix 이름에 따라 달라지겠지만 어쨋든 prefix로 설정한 path는 src/main/webapp 안에 들어가 있어야 한다는 걸 주의하자.

 

css 와 img, js 디렉토리는 resources/static 아래에 있다.

사용할 때는 경로를 다음과 같이 지정해주면 된다.

 

<%-- CSS --%>
<link rel="stylesheet" type="text/css" href="/resources/css/파일명.css">
 
<%-- img --%>
<img src="/resources/img/파일명.jpg" alt="">
 
<%-- javascript --%>
<script src="/resources/js/파일명.js" type="text/javascript"></script>

 

application.yml 파일의 내용은 다른 설정 부분이 있어 sping와 mvc 사이에 거리가 좀 있는데 신경쓰지말고 위 2번처럼 코딩하면 된다.

 

여기까지 했다면 설정 끝 🤩!

사용은 그냥 view 페이지 부르듯이 하면 되는데.. 흐아.. 혹시나 싶어 부분 코드를 첨부한다.

// 클래스명.java

@Controller
public class 클래스명 {

    @GetMapping("/URL주소")
    public String 함수이름(){
        return "JSP파일이름";
    }

}

 

 

더 적어보기..

분명 설정을 다 했는데 아래와 같은 에러를 냈었다.

해결하고 난 뒤라 인터넷에 있는 에러를 가져왔다.

 

~~ ResourceHttpRequestHandler : Path with "WEB-INF" or "META-INF": 라는 에러가 뜨면서 접속한 브라우저 페이지에는 Whitelabel Error Page가 떴다.

 

✅ solved

따로 수정한 것 없었고 그냥 개발 툴을 껏다가 다시 켜서 실행하니까 고쳐졌다.

 

 

Tip.

포스팅 윗쪽을 읽었다면 JSP를 배포하려면 .war로 만들어야한다는 걸 알게된다.

그럼 .jar 파일로 생성 할 경우 이 문제가 해결이 안되나? 라고 물으면 해결이되긴했다.

그런데 프로젝트를 닫았다가 다시 열었을 때 또 인식을 못했다. 

 

그리고..만약 나중에 배포를 하려고 하면...

ㅎ-ㅎ 그냥 war 패키징으로 만들자.

 

 

---

Thanks for 🙈

• [Spring boot] Spring Boot와 jsp 연동 하는 방법
• Spring Boot에서 JSP 사용하기
• Spring boot jsp 못 읽는 경우
• [스프링 부트 오류] spring boot Path with "WEB-INF" or "META-INF"
• [Spring-Boot] js,css파일 jsp파일 외부로 빼기