며칠전 스프링 3.0.4가 나왔다. 3.0.1 이후 마이너 업그레이드는 거의 자잘한 버그 수정이거나 최신 버전 서드-파티 툴 지원(확인)이 전부였는데 3.0.4에는 눈에 띄는 새로운 기능이 추가된 것이 있다. @MVC에서 세 가지를 찾아 볼 수 있다.  @ModelAttributge 모델이 아닌 단순 @RequestParam 등에서도 포매터를 사용하게 된 것과 mvc 스키마에 새롭게 추가된 전용 태그 두개이다.

3.0.4 내용을 모두 확인하고 추가된 기능 등을 토비의 스프링 3에 반영해서 다음 인쇄시 적용해 달라고 할 수도 있겠지만, 버전 업그레이드를 시도하는 것은 생각보다 부담이 큰 작업이다. 3.0.4만 해도 개발 스타일을 바꾸고 싶은 것이 있어서 예제도 손을 좀 봐야 하고. 그래서 일단 블로그에 그런 내용을 정리해보기로 했다.

 

3.0.4의 변경사항 중에서 그 중에서 가장 내 관심을 끈 것은 바로 <mvc:default-servlet-handler/>이다. 이를 이용하면 그동안 안쓰자니 불편하고 쓰자니 지저분해 보였던 UrlRewriteFilter를 제거할 수 있게 됐다. 그런데 UrlRewriteFilter 따위는 왜 쓰게 됐을까?

여러 가지 이유를 댈 수 있겠지만 가장 큰 것은 RESTful 스타일의 URL을 사용하고 싶기 때문이다. RESTful 스타일 URL의 특징의 하나는 확장자를 쓰지 않는 것이다.  기존엔 주로 컨트롤러에 매핑되는 URL을 login.do니 login.action이니 하는 식으로 특정 확장자를 주어서 만들었다. 그래서 스프링의 프론트 컨트롤러인 DispatcherServlet의 서블릿 매핑을 *.do나 *.action 처럼 주면 됐다. URL의 서브 디렉토리는 어떻게 잡아도 상관없어서 이 방식이 가장 편하긴 하다.

그런데 RESTful 스타일에선 이렇게 확장자를 잘 쓰지 않는다. 여러가지 스타일이 있지만 보통 리소스 이름을 경로로 쓰고 그 뒤에 의미있는 추가 경로를 붙이거나 HTTP요청 메소드(GET,POST,PUT 등등)를 바꿔서 활용하는 식이다. 그래서 URI가 보통 /user니 /user/1, /user/1/edit 이런식으로 만들어진다. 따라서 특정 확장자를 사용할 수 없다.

문제는 스프링이 이런 URL을 처리하게 하려면 웹 애플리케이션에 기본으로 등록된 다른 서블릿과 중복이 되지 않게 만들어줘야 한다. 보통 서블릿 컨테이너에는 스태틱 리소스(HTML, 자바 스크립트, CSS, 이미지 등)를 처리하는 디폴트 서블릿과 JSP를 처리하는 JSP 서블릿이 기본으로 등록되어있다. 디폴트 서블릿은 /에 매핑되어 있고 JSP는 확장자를 이용해서 *.jsp로 되어있다. 그리고 여기에 추가로 서블릿을 등록하면 URL 우선순위(매핑 조건이 긴게 우선)에 따라서 그 서블릿의 매핑에 해당하는 것은 등록된 것으로 가고 나머지는 디폴트 서블릿이나 JSP 서블릿이 담당한다. 스프링을 *.do와 같이 사용할 땐 그래서 문제가 없었다. 그런데 경로만 있는 URL로 가니 얘기가 달라졌다.

디폴트 서블릿을 안쓸 수는 없다. 따라서 스프링 서블릿(DispatcherServlet)을 /에 매핑할 수는 없다. 그러면 DispatcherServlet가 모든 스태틱 리소스까지 처리해줘야 한다. 그래서 보통 /app와 같은 서브폴더를 만들고 그 아래로 오는 요청을 스프링의 DispatcherServlet이 담당하게 만든다. DispatcherServlet의 매핑을 /app/나 /app/* 등으로 하고, URL은 /app/user, /app/user/1, /app/user/1/edit 이렇게 썼다.

그런데 app가 계속 붙으니 안이쁘다. 폼나게 RESTful하게 보이려면 도메인 이름 뒤에 바로 리소스 이름이 나오는게 좋다. 그냥 http://toby.epril.com/article/1 이런 식으로.

그래서 스프링 사용자들이 슬슬 사용하기 시작한게 UrlRewriteFilter다. 이 필터는 서버로 온 URL을 애플리케이션으로 넘길 때 강제로 변경해주는 역할을 한다.  UrlRewriteFilter은 서블릿의 매핑보다 세밀한 제어가 가능하기 때문에 원하는 방식으로 URL을 작성할 수가 있다. 일단 모든 스태틱 리소스는 /resource 등에 위치시킨다. 그리고 스프링 DispatcherServlet은 그냥 /app와 같은 서브 폴더에 매핑시킨다. 그런다음 UrlRewriteFilter를 적용한다.

스태틱 리소스인 /resource는 그냥 /resource로 그대로 가도록 한다. 대신 그 외의 /로 시작하는 경로는 앞에 /app를 붙이도록 만들어주는 것이다. 그러면 /resource로 시작하지 않는 모든 URL은 /app가 앞에 붙어서 넘어가므로 /app로 매핑을 해둔 DispatcherServlet처리하고 나머지는 그대로 URL이 유지되므로 디폴트 서블릿이 처리할 수 있는 것이다.

이렇게 해서 깔끔한 URL을 만들어 사용할 수 있긴한데, 제법 복잡한 UrlRewiteFilter를 공부해서 사용해야 한다는 번거로움이 있다. 그래서 책에도 UrlRewriteFilter를 사용하는 방법을 넣을까 하다가 독자들 머리만 더 아플까 해서 그냥 뺐다. 예제도 덜 이쁘지만 /app로 시작하는 URL을 그냥 사용하도록 했고. RESTful URL을 사용하는 ROO에서 사용한 UrlRewriteFilter를 보면 꽤나 복잡하다.

그런데 이런 불만이 나만 있던 것은 아니었나보다. UrlRewriteFilter를 쓰지 않고 스프링 DispatcherServlet을 /에 매핑해서 쓰면 안될까? 스프링에 안되는 게 어딨겠나. 결국 스프링 개발자들은 3.0.4에서 <mvc:default-servlet-handler/>를 추가해서 이 문제를 깔끔하게 해결해버렸다.

 

사용방법은 간단하다.

일단 DispatcherServlet을 그냥 /에 매핑한다. jsp와 같은 특정 확장자를 가진 URL말고는 모두 DispatcherServlet이 다 받는다. 일단 스프링의 기본 등록된 핸들러 매핑 전략을 이용해서 컨트롤러를 매핑해본다. @Controller가 담당하는 URL이라면 그리로 넘어갈거고. 그런데 그러다보면 /js/jquery.js 처럼 컨트롤러에 매핑안되는 URL이 나올 것이다. 이런 나머지 모든 URL은 <mvc:default-servlet-handler/>이 내부적으로 등록해주는 DefaultServletHttpRequestHandler이 담당한다. 이 핸들러(컨트롤러)는 /**로 매핑되어있다. 대신 핸들러 매핑 우선순위가 가장 낮다. 따라서 애노테이션 매핑 등등을 거쳐서 다 실패한 URL만 넘어온다. 그리고 DefaultServletHttpRequestHandler는 이 요청을 자신이 직접 스태틱 리소스를 읽어서 처리하는 것이 아니라, 원래 서버가 제공하는 디폴트 서블릿으로 넘겨버린다. 그러면 서버의 기본 디폴트 서블릿이 동작해서 스태틱리소스를 처리해버리는 것이다. 일단 스프링이 다 받고 스프링이 처리 못하는 건 다시 서버의 디폴트 서블릿으로 넘긴다는 아이디어이다. 멋지지 않은가?

그런데 사실 아이디어는 간단하지만 구현은 쉽지 않다. 디폴트 서블릿을 찾아서 사용하는 건 일반적인 접근방법이 아니다. 서블릿 스펙 2.0 부터는 하나의 서블릿이 다른 서블릿을 직접 찾아서 실행할 수 있는 방법을 막아버렸다. 그래서 ServletContext의 getServlets() 나 getServletNames()와 같은 메소드는 무조건 null을 리턴하도록 스펙에 명시되어있다. 대신 스프링은 URL 대신 이름을 이용해서 RequestDispatcher를 가져오는 getNamedDispatcher() 메소드를 이용한다. 물론 디폴트 서블릿 이름을 알고 있어야 하는데, 그건 스프링 개발자들이 주요 서버의 디폴트 서블릿 이름을 다 조사해놨다. 톰캣, 제티, JBoss, 글래스 피시는 이름이 default, Resin은 resin-file, WebLogic은 FileServlet, WebSphere는 SimpleFileServlet이다. 이 서버들의 디폴트 서블릿 이름은 자동으로 찾아준다. 그 외의 서버라면 디폴트 서블릿 이름을 직접 주면 된다. 보통 서버의 설정 폴더에 보면 디폴트 web.xml이 다 나와있다. 그걸 열어보면 디폴트 서블릿 이름을 알 수 있다. 톰캣이라면 conf 밑의 web.xml에서 찾을 수 있다.

톰캣 6에 보면 디폴트 서블릿이 다음과 같이 등록되어있다.

<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
     …
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

 

이제 3.0.4를 사용하면 특별한 이유가 아니라면 UrlRewriteFilter를 사용할 필요가 없다. 혹시 스태틱 리소스의 경로를 다이나믹하게(버전 폴더를 바꾼다거나) 바꾸는 필요가 있다면, 그때는 3.0.4에 함께 추가된 <mvc:resource>를 사용하면 된다. 그건 다음 시간에.

참. GAE에서는 이 기능을 사용할 수 없다. 구글이 수정한 GAE의 Jetty 소스를 보면 이 getNamedDispatcher()가 항상 null을 리턴하도록 해놨다. 리소스 접근에 제약을 걸어야 하기 때문에 코드를 통해서 디폴트 서블릿에 접근하는 것을 원천적으로 차단한 것이다.

Related posts:

  1. Spring 3.0 (22) Web.Servlet 모듈의 선택 라이브러리 분석
  2. Spring 3.0 (36) Field Marker와 Field Default
  3. Maven의 default directory layout 변경하기
  4. DispatcherServlet의 디폴트 대체(fallback) 전략
  5. 미국여행을 위한 전자허가는 Spring을 이용해서
  6. 토비의 스프링 3이 나오기까지 (2)
  7. 토비의 스프링 3이 나오기까지 (7)
  8. 토비의 스프링 3이 나오기까지 (11)
  9. [토스3] 테스트를 위한 필드 주입 유틸
  10. Spring 3.0 (21) Web 모듈의 선택 라이브러리 분석
  11. Spring 3.0.2 모듈 의존관계
  12. Spring 3.0.1 mvc:annotation-driven 이 몰래 하는 짓
  13. InsideSpring (3) 스프링 밖에서 WebApplicationContext에 접근하기
  14. 블로그 업데이트, 스킨 교체, SNS(FB,TW,M2,BZ) 공유기능 추가
  15. 토비의 스프링 3이 나오기까지 (3)

Facebook comments:

to “[토스3] 스프링 3.0.4 <mvc:default-servlet-handler/>를 이용해서 UrlRewriteFilter없이 깔끔한 URL을 만들기”

  1. I blog frequently and I truly thank you for your content. This article has truly peaked my interest. I will take a note of your site and keep checking for new information about once per week. I opted in for your RSS feed too.

  2. I just couldn’t depart your website before suggesting that I extremely enjoyed the usual information a person provide in your visitors? Is going to be again ceaselessly to investigate cross-check new posts|

  3. The very next time I read a blog, I hope that it won’t fail me just as much as this particular one. After all, I know it was my choice to read, but I genuinely believed you would probably have something interesting to say. All I hear is a bunch of moaning about something that you can fix if you weren’t too busy seeking attention.

  4. I’m impressed, I must say. Rarely do I come across a blog that’s both equally educative and entertaining, and without a doubt, you have hit the nail on the head. The issue is something which too few people are speaking intelligently about. I am very happy that I came across this in my search for something regarding this.

  5. Great blog you have here.. It’s difficult to find high-quality writing like yours these days. I seriously appreciate individuals like you! Take care!!

  6. Howdy! This post couldn’t be written much better! Reading through this post reminds me of my previous roommate! He continually kept talking about this. I most certainly will forward this post to him. Pretty sure he’ll have a very good read. I appreciate you for sharing!

  7. Spot on with this write-up, I seriously believe that this web site needs much more attention. I’ll probably be returning to read more, thanks for the advice!

  8. Great post! We will be linking to this great post on our site. Keep up the good writing.

  9. Oh my goodness! Incredible article dude! Thank you, However I am encountering problems with your RSS. I don’t know why I can’t join it. Is there anybody having similar RSS problems? Anyone that knows the solution will you kindly respond? Thanks!!

  10. Hi, I do think this is an excellent site. I stumbledupon it ;) I am going to revisit yet again since i have book-marked it. Money and freedom is the greatest way to change, may you be rich and continue to help others.

  11. I couldn’t refrain from commenting. Well written!

  12. Good day! I simply wish to give you a huge thumbs up for your great information you’ve got right here on this post. I will be returning to your web site for more soon.

  13. The very next time I read a blog, I hope that it doesn’t fail me as much as this particular one. After all, Yes, it was my choice to read, however I actually thought you’d have something interesting to say. All I hear is a bunch of complaining about something you can fix if you weren’t too busy searching for attention.

  14. I really like it whenever people get together and share ideas. Great site, stick with it!

  15. Looking forward to reading more. Great article.Thanks Again. Fantastic.

  16. Oh my goodness! Impressive article dude! Thank you so much, However I am going through issues with your RSS. I don’t know the reason why I am unable to join it. Is there anybody having identical RSS issues? Anybody who knows the answer can you kindly respond? Thanks!!

  17. This is the right webpage for everyone who would like to understand this topic. You know a whole lot its almost tough to argue with you (not that I really will need to…HaHa). You definitely put a fresh spin on a topic which has been written about for decades. Great stuff, just wonderful!

  18. You should be a part of a contest for one of the finest websites on the web. I am going to recommend this blog!

  19. Very good information. Lucky me I found your blog by chance (stumbleupon). I have book-marked it for later!

  20. Good web site you have here.. It’s difficult to find high quality writing like yours nowadays. I truly appreciate people like you! Take care!!

  21. very few web-sites that happen to become in depth below, from our point of view are undoubtedly nicely really worth checking out

  22. Hello there! This blog post couldn’t be written any better! Going through this article reminds me of my previous roommate! He constantly kept talking about this. I will forward this article to him. Fairly certain he’ll have a very good read. Many thanks for sharing!

  23. When I originally left a comment I appear to have clicked the -Notify me when new comments are added- checkbox and from now on each time a comment is added I get four emails with the exact same comment. Perhaps there is a means you can remove me from that service? Cheers!

  24. Hi! I simply would like to offer you a big thumbs up for your excellent info you have got here on this post. I will be returning to your site for more soon.

  25. Very good info. Lucky me I recently found your site by accident (stumbleupon). I’ve saved it for later!

  26. I was able to find good information from your blog posts.

  27. Having read this I believed it was extremely informative. I appreciate you spending some time and energy to put this information together. I once again find myself personally spending a lot of time both reading and posting comments. But so what, it was still worthwhile!

  28. Your style is unique compared to other people I’ve read stuff from. Thanks for posting when you’ve got the opportunity, Guess I’ll just book mark this site.

  29. Hello there! I could have sworn I’ve been to this site before but after going through many of the posts I realized it’s new to me. Regardless, I’m certainly pleased I found it and I’ll be book-marking it and checking back often!

  30. As the admin of this site is working, no uncertainty very soon it will be famous, due to its feature contents.|

  31. We’re a group of volunteers and starting a new scheme in our community.
    Your web site provided us with valuable information to work on. You
    have done a formidable job and our entire community will be thankful to you.

  32. Hi, I do think this is a great blog. I stumbledupon it ;) I’m going to return yet again since i have book-marked it. Money and freedom is the greatest way to change, may you be rich and continue to help other people.

  33. This is a really good tip particularly to those new to the blogosphere. Simple but very precise information… Appreciate your sharing this one. A must read article!

  34. I’m excited to find this great site. I want to to thank you for your time for this wonderful read!! I definitely appreciated every bit of it and I have you book marked to see new things on your website.

  35. I was pretty pleased to discover this web site. I want to to thank you for your time just for this wonderful read!! I definitely loved every little bit of it and i also have you saved to fav to check out new information on your blog.

  36. I like it when people get together and share opinions. Great blog, continue the good work!

Leave a Reply

(required)

(required)

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

© 2017 Toby's Epril Suffusion theme by Sayontan Sinha