며칠전 스프링 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. here are some links to web sites that we link to simply because we feel they may be worth visiting

  2. generic viagra goodrx viagra https://klviagrathk.com/# – viagra without a doctor prescription canada where can i buy viagra over the counter canadian online pharmacy viagra <a href="https://klviagrathk.com/#">buy viagra online cheap</a> generic viagra india viagra amazon

  3. generic name for viagra viagra over the counter https://viagrapdn.com/# – viagra 100mg price generic viagra walmart how to buy viagra <a href="https://viagrapdn.com/#">no prescription viagra</a> viagra pill viagra price

  4. Very neat post.Really looking forward to read more. Cool.

  5. viagra cheap buy viagra https://klviagrathk.com/# – canadian pharmacy generic viagra mexican viagra viagra without a prescription <a href="https://klviagrathk.com/#">100mg viagra</a> is there a generic viagra viagra price comparison

  6. Thank you for your post.Really looking forward to read more. Want more.

  7. Hi! I know this is kind of off-topic however I needed to ask.
    Does running a well-established website like yours require a massive amount
    work? I’m brand new to blogging however I do write in my diary everyday.
    I’d like to start a blog so I can share my personal experience
    and views online. Please let me know if you have
    any recommendations or tips for new aspiring bloggers.
    Appreciate it!

  8. viagra pill is viagra over the counter https://viagrapdn.com/# – cheap viagra online canadian pharmacy cheapest generic viagra viagra <a href="https://viagrapdn.com/#">amazon viagra</a> viagra no prescription viagra prescription

  9. I enjoy reading a post that will make people think. Also, thanks for permitting me to comment!|

  10. I loved your blog.Really looking forward to read more. Really Cool.

  11. Hey this is somewhat of off topic but I was wanting to know if blogs use WYSIWYG editors or if you have to
    manually code with HTML. I’m starting a blog soon but have no coding
    experience so I wanted to get guidance from someone with experience.
    Any help would be greatly appreciated!

  12. viagra cost viagra without a prescription https://klviagrathk.com/# – where can i buy viagra viagra no prescription buy generic viagra online <a href="https://klviagrathk.com/#">viagra online usa</a> best place to buy generic viagra online viagra without a prescription

  13. My brother suggested I might like this blog.

    He used to be entirely right. This publish truly
    made my day. You cann’t consider simply how so much time
    I had spent for this info! Thanks!

  14. Greetings! Very useful advice in this particular article!
    It’s the little changes that produce the most important changes.
    Thanks for sharing!

  15. generic viagra cost generic viagra online https://viagrapdn.com/# – viagra no prescription viagra price comparison generic for viagra <a href="https://viagrapdn.com/#">mexican viagra</a> cheap viagra viagra cost per pill

  16. After exploring a handful of the articles on your web site, I truly like your technique of writing a blog. I bookmarked it to my bookmark site list and will be checking back in the near future. Please check out my web site too and let me know your opinion.

  17. It as wonderful that you are getting thoughts from this post as well as from our discussion made here.

  18. online viagra prescription viagra from canada https://viagrapdn.com/# – cvs viagra buy generic viagra online cheapest generic viagra <a href="https://viagrapdn.com/#">is viagra over the counter</a> cheapest viagra online cheap viagra 100mg

  19. Hi, i think that i saw you visited my blog thus i came to ?return the favor?.I’m trying to find
    things to improve my web site!I suppose its ok to use some of your
    ideas!!

  20. Hmm is anyone else encountering problems with the images on this
    blog loading? I’m trying to figure out if its a problem on my end or if it’s the blog.

    Any feedback would be greatly appreciated.

  21. Wonderful post however I was wondering if you could write
    a litte more on this topic? I’d be very grateful if you could elaborate a little bit further.
    Thanks!

  22. always a significant fan of linking to bloggers that I enjoy but really don’t get lots of link like from

  23. viagra professional mexican viagra https://klviagrathk.com/# – buy viagra online usa viagra online canadian pharmacy buy viagra online <a href="https://klviagrathk.com/#">walmart viagra</a> viagra over the counter usa 2019 generic for viagra

  24. Yay google is my king assisted me to find this great site!. Don at rule out working with your hands. It does not preclude using your head. by Andy Rooney.

  25. Good article. I definitely appreciate this site. Keep writing!

  26. viagra discount where to buy viagra online https://klviagrathk.com/# – viagra doses 200 mg viagra cheap how much viagra should i take the first time? <a href="https://klviagrathk.com/#">is there a generic viagra</a> viagra online canada generic viagra online for sale

  27. My relatives always ssay that I aam killing my time here at web, however I know I am getting know-how daily by reading such fastidious posts.

  28. how much will generic viagra cost viagra discount https://viagrapdn.com/# – viagra 100mg viagra amazon how much viagra should i take the first time? <a href="https://viagrapdn.com/#">viagra pill</a> viagra online canadian pharmacy canadian online pharmacy viagra

  29. Thanks for the blog post.Really thank you! Fantastic.

  30. viagra over the counter usa 2019 viagra price comparison https://klviagrathk.com/# – generic viagra online for sale where can i buy viagra viagra cheap <a href="https://klviagrathk.com/#">viagra cialis</a> cheap viagra 100mg viagra over the counter

  31. cheap anti theft backpack anti theft backpack kqfana20161

  32. 100mg viagra when will viagra be generic https://klviagrathk.com/# – generic viagra viagra without a doctor prescription canada viagra canada <a href="https://klviagrathk.com/#">canada viagra</a> buy generic viagra online viagra prices

Leave a Reply to Gustavo Cancel 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