[📘스프링5] 9. 스프링 MVC 시작하기 & 10. 스프링 MVC 프레임워크 동작 방식

Chapter 9. 스프링 MVC 시작하기

이 장은 스프링에서 스프링 MVC로 넘어가는 장이다. 지금까지는 스프링의 기초와 스프링 프로젝트에 DB 연동하기 등의 내용을 배웠다면 이제는 스프링이 지원하는 웹 MVC 프레임워크를 사용해 웹 프로그램을 작성하게 된다. build.gradle에 의존설정을 해주고 서버도 설치하고 설정 파일 작성하고 web.xml파일 작성하고 컨트롤러 파일이랑 화면에 보일 jsp 파일까지 작성해준다. 그다음 웹 브라우저에 적절한 주소를 입력하면 jsp파일에 작성한 대로 화면이 나온다.

그.러.나. 책에서 하라는 대로 하고 서버를 동작시키고 해당 URL로 들어가 보면 404 NOT FOUND가 뜬다. 왤까..?

일단 책에서 사용한 것은 eclipse고 나는 VSCode였다. IDE부터 다른 게 시작이었고, java 버전도 다르게 쓰고 있고, gradle 버전, tomcat 버전, ....... 그냥 똑같이 하는 게 거의 없을 정도로 환경이 달랐다. 이 말은 어떤 것이 문제인지 파악하기 힘들다는 얘기였다. 변수가 너무 많았다. 울면서 오류 코드를 분석했다.

책에서는 프로젝트를 서버에 올리고 실행한 후 웹 브라우저 주소창에 localhost:8080/프로젝트 폴더명/hello?name=이름 이런 URL로 접속하면

이런 화면이 뜰 거라고 했는데.... 분명 그랬는데........... 역시나 안 떴다. 이제 한 번에 되면 이상할 지경이다. 화면에 뭐라고 떴는지 보자.

리소스를 찾을 수 없다고 뜬다. 화가 났다. 왜 하라는 대로 했는데 안 될까...

요청된 리소스[/app/hello]은(는) 가용하지 않습니다.

이 메시지를 또 구글링 해봤다. 이 오류는 서버 설정에서 CLASSPATH를 잘못 잡아줬을 때 나온다고 한다. 이걸 해결한 사람들은 전부다 eclipse를 쓰고 있었다. 나같이 VSCode를 사용하는 사람은 없었다.. VSCode로 Spring Boot 말고 Spring MVC로 프로젝트를 한 사람은 없는 걸까....? 더 이상 VSCode로 해결할 방법이 없어 보였다.. 그래서 그냥 eclipse로 갈아타기로 했다. 서버 설정 오류인데 구글링해도 나오지 않는 VSCode에서 서버 설정하기를 내가 해결할 수 있을 것 같지 않았다. (있다면 알려주세요.. 저는 못 찾았어요....)

근데 eclipse로 해봤는데도 404가 떴다...ㅋ 브라우저에 나오는 내용은 똑같았는데 서버 실행 시 콘솔 창에 오류가 떴다.

심각: 필터 [encodingFilter]를 시작하는 중 오류 발생
java.lang.ClassCastException: class org.springframework.web.filter.CharacterEncodingFilter cannot be cast to class jakarta.servlet.Filter

여기서 encodingFilter는 내가 web.xml에서 설정한 필터 이름이다. org.springframework.web.filter.CharacterEncodingFilter가 jakarta.servlet.Filter로 cast 될 수 없단다. 또 구글링을 해봤다.

java.lang.ClassCaseException는 해당 class를 찾을 수 없기 때문에 나오는 오류라고 한다. 어떤 블로그(밑에 출처 있음)에서는 이를 해결할 방법으로

1. 프로젝트 properties에 Deployment Assembly에 Java Build Path를 추가하는 방법
   (gradle로 프로젝트에 추가한 Project and External Dependencies를 tomcat 서버 구동 시 WEB-INF/lib로 대응시키는 역할을 하는 듯하다)
2. web.xml 파일에서 오류가 나는 필터가 참조하는 클래스 주소를 org.apache.catalina.filters.SetCharacterEncodingFilter로 바꾸는 방법

두 가지를 제시했다. 첫 번째 방법을 시도했을 때는 별 변화가 없었고, 두 번째 방법을 시도했더니 오류 내용이 바뀌었다.

java.lang.ClassCastException: class org.springframework.web.servlet.DispatcherServlet cannot be cast to class jakarta.servlet.Servlet

이번엔 dispatcher라는 이름으로 설정한 서블릿이 cast 될 수 없다는 말인 것 같다. 여기서 dispatcher는 내가 web.xml에서 설정한 서블릿 이름이다. 이번에도 구글링을 해봤다. jakarta.servlet.Servlet 이놈이 뭔가 수상했다. 찾아보니 지금 내가 쓰고 있는 tomcat 버전이 10이었고 9와 10은 큰 차이가 있으며 9까지는 API 구현체가 JavaEE(javax.)이고 10부터는 JakartaEE(jakarta.)란다. 즉, 내가 지금 사용하고 있는 API 방식은 JavaEE인데 서버는 jakartaEE 방식을 사용하기 때문에 구동이 안 됐던 것이었다. Homebrew로 tomcat을 설치할 때 버전별로 큰 차이가 없는 줄 알고 가장 최신의 tomcat 버전을 설치한 탓이었다. 그래서 tomcat9를 다시 깔고 tomcat9에 프로젝트를 올리니까 잘 구동됐다. 위의 필터도 사실은 tomcat의 문제였던 것 같다. 결국... 또 버전 문제였다. 버전별 사양이나 주의점을 잘 알고 사용해야 한다는 교훈을 또 얻었다.

Chapter10. 스프링 MVC 프레임워크 동작 방식

이 장은 9장에서 작성한 코드로 스프링 MVC 프레임워크가 동작하는 방식을 설명한 장이다. 새로 작성하는 코드는 없었고, 어떻게 동작하는지 이해하면서 읽고 지나갔다.

Chapter9, 10을 마치며..

이번 장은 해결될 것 같지 않았던 오류를 해결할 수 있는 값진 시간이었다. 해결하지 못할 줄 알고 그냥 Spring Boot로 넘어갈까 수천 번 고민했고, 실제로 어제까지만 해도 그냥 Spring Boot로 넘어가야겠다고 생각하고 프로젝트까지 만들었다. 그런데 그래도 끝까지 안 해보면 속이 시원하지 않을 것 같아 마지막으로 해보자 하고 도전했다. VSCode로 해결한 게 아니라 찝찝함이 조금 남긴 했지만 그래도 이게 어디냐 싶다. 어차피 책에서도 eclipse로 했으니 VSCode는 못 하는 게 당연한가 싶기도 하고, VSCode로 서버 연동하는 건 한계가 있는 건가 싶기도 하고... 어쨌든간 예제 코드대로 진행했다는 것에 의의를 두고 이번 장은 마치도록 하겠다. (근데 왜 VSCode로는 해결이 안되는걸까.. 아직도 궁금하다. Deployment Assembly에 Java Build Path를 추가할 수 없어서 그런걸까..? 혹시나 해서 tomcat9에 프로젝트를 올려봤는데 역시나 안된다.. 왤까.. 너무 알고싶다...)

P.S. VSCode의 코드 자동완성 기능은 놓칠 수 없기 때문에 앞으로 소스 코드 작성은 VSCode로, 서버에 올려서 구동하는 것은 eclipse를 사용할 예정이다. 예전에는 eclipse도 잘만 썼는데 VSCode를 경험하고 나니 너무 불편하다.. 옛날에는 어떻게 썼었을까...?

[출처]

java.lang.ClassCastException: class org.springframework.web.filter.CharacterEncodingFilter 해결방법- https://jeaha.dev/73
cannot be cast to jakarta.servlet.Servlet 해결방법 - https://velog.io/@softpeter/cannot-be-cast-to-jakarta.servlet.Servlet-%ED%95%B4%EA%B2%B0%EB%B0%A9%EB%B2%95
tomcat 9/10 버전별 차이 - https://blog.itcode.dev/posts/2022/02/12/tomcat-9-and-10