spring mvc 中使用sitemesh 报java.lang.IllegalStateExce

摘要: org.springframework.web.util.NestedServletException: Request processing failed; nested exception is java.lang.IllegalStateException: NO CONTENT
WARN:oejs.ServletHandler:/public/images/vague2.jpg
java.lang.IllegalStateException: NO CONTENT

在闲暇之余想自己搭一套项目自己娱乐一下。

没想到在搭好框架并开始写页面的时候遇到一个纠结的问题，spring mvc 和sitemesh搭配使用的时候竟然一直报java.lang.IllegalStateException: NO CONTENT的错误，瞬间头大了几圈。

在这里贴上主要的报错信息：

-------------------------------------------------
2015-12-10 17:21:09.077:WARN:oejs.ServletHandler:
org.springframework.web.util.NestedServletException: Request processing failed; nested exception is java.lang.IllegalStateException: NO CONTENT
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:982)
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:861)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:735)
at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:846)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:848)
at org.eclipse.jetty.servlet.ServletHolder.handle(ServletHolder.java:684)
at org.eclipse.jetty.servlet.ServletHandler$CachedChain.doFilter(ServletHandler.java:1496)
at org.sitemesh.webapp.contentfilter.ContentBufferingFilter.bufferAndPostProcess(ContentBufferingFilter.java:169)
at org.sitemesh.webapp.contentfilter.ContentBufferingFilter.doFilter(ContentBufferingFilter.java:126)
at org.sitemesh.webapp.SiteMeshFilter.doFilter(SiteMeshFilter.java:120)
at org.sitemesh.config.ConfigurableSiteMeshFilter.doFilter(ConfigurableSiteMeshFilter.java:163)
at org.eclipse.jetty.servlet.ServletHandler$CachedChain.doFilter(ServletHandler.java:1476)
Caused by:
java.lang.IllegalStateException: NO CONTENT
at org.eclipse.jetty.http.HttpGenerator.addContent(HttpGenerator.java:176)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:155)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:107)
at org.sitemesh.webapp.contentfilter.io.RoutableServletOutputStream.write(RoutableServletOutputStream.java:133)
2015-12-10 17:21:09.078:WARN:oejs.ServletHandler:/public/js/jquery-1.11.3.js
java.lang.IllegalStateException: NO CONTENT
at org.eclipse.jetty.http.HttpGenerator.addContent(HttpGenerator.java:176)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:155)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:107)
at org.sitemesh.webapp.contentfilter.io.RoutableServletOutputStream.write(RoutableServletOutputStream.java:133)
at org.springframework.util.StreamUtils.copy(StreamUtils.java:124)
at org.springframework.web.servlet.resource.ResourceHttpRequestHandler.writeContent(ResourceHttpRequestHandler.java:446)
at org.springframework.web.servlet.resource.ResourceHttpRequestHandler.handleRequest(ResourceHttpRequestHandler.java:271)
at org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter.handle(HttpRequestHandlerAdapter.java:51)
2015-12-10 17:21:09.152:WARN:oejs.ServletHandler:
org.springframework.web.util.NestedServletException: Request processing failed; nested exception is java.lang.IllegalStateException: NO CONTENT
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:982)
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:861)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:735)
at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:846)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:848)
at org.eclipse.jetty.servlet.ServletHolder.handle(ServletHolder.java:684)
at org.eclipse.jetty.servlet.ServletHandler$CachedChain.doFilter(ServletHandler.java:1496)
at org.sitemesh.webapp.contentfilter.ContentBufferingFilter.bufferAndPostProcess(ContentBufferingFilter.java:169)
Caused by:
java.lang.IllegalStateException: NO CONTENT
at org.eclipse.jetty.http.HttpGenerator.addContent(HttpGenerator.java:176)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:155)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:107)
at org.sitemesh.webapp.contentfilter.io.RoutableServletOutputStream.write(RoutableServletOutputStream.java:133)
2015-12-10 17:21:09.153:WARN:oejs.ServletHandler:/public/images/vague2.jpg
java.lang.IllegalStateException: NO CONTENT
at org.eclipse.jetty.http.HttpGenerator.addContent(HttpGenerator.java:176)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:155)
at org.eclipse.jetty.server.HttpOutput.write(HttpOutput.java:107)
at org.sitemesh.webapp.contentfilter.io.RoutableServletOutputStream.write(RoutableServletOutputStream.java:133)

这里是sitemesh和spring mvc 之间纠结的访问关系的问题。其中spring mvc中有几种访问静态资源的方法

方案一：Tomcat的defaultServlet来处理静态文件

<servlet-mapping>

<servlet-name>default</servlet-name>

<url-pattern>*.jpg</url-pattern>

</servlet-mapping>

要写在DispatcherServlet的前面， 让 defaultServlet先拦截请求，这样请求就不会进入Spring了

方案二： 在spring3.0.4以后版本提供了mvc:resources

<!-- 对静态资源文件的访问 -->

<mvc:resources mapping="/images/**" location="/images/" />

/images/**映射到ResourceHttpRequestHandler进行处理，location指定静态资源的位置.可以是web application根目录下、jar包里面，这样可以把静态资源压缩到jar包中。cache-period 可以使得静态资源进行web cache

如果出现下面的错误，可能是没有配置<mvc:annotation-driven />的原因。
报错WARNING: No mapping found for HTTP request with URI [/mvc/user/findUser/lisi/770] in DispatcherServlet with name 'springMVC'

使用<mvc:resources/>元素,把mapping的URI注册到SimpleUrlHandlerMapping的urlMap中,
key为mapping的URI pattern值,而value为ResourceHttpRequestHandler,
这样就巧妙的把对静态资源的访问由HandlerMapping转到ResourceHttpRequestHandler处理并返回,所以就支持classpath目录,jar包内静态资源的访问.
另外需要注意的一点是,不要对SimpleUrlHandlerMapping设置defaultHandler.因为对static uri的defaultHandler就是ResourceHttpRequestHandler,
否则无法处理static resources request.
方案三 ，使用<mvc:default-servlet-handler/>

<mvc:default-servlet-handler/>

会把"/**" url,注册到SimpleUrlHandlerMapping的urlMap中,把对静态资源的访问由HandlerMapping转到org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler处理并返回.
DefaultServletHttpRequestHandler使用就是各个Servlet容器自己的默认Servlet.

补充说明：多个HandlerMapping的执行顺序问题：
DefaultAnnotationHandlerMapping的order属性值是：0

< mvc:resources/ >自动注册的 SimpleUrlHandlerMapping的order属性值是： 2147483646

<mvc:default-servlet-handler/>自动注册 的SimpleUrlHandlerMapping 的order属性值是： 2147483647

spring会先执行order值比较小的。当访问一个a.jpg图片文件时，先通过 DefaultAnnotationHandlerMapping 来找处理器，一定是找不到的，因为我们没有叫a.jpg的Action。然后再按order值升序找，由于最后一个 SimpleUrlHandlerMapping 是匹配 "/**"的，所以一定会匹配上，就可以响应图片。

访问一个图片，还要走层层匹配。不知性能如何？
最后再说明一下，方案二、方案三 在访问静态资源时，如果有匹配的(近似)总拦截器，就会走拦截器。如果你在拦截中实现权限检查，要注意过滤这些对静态文件的请求。
如何你的DispatcherServlet拦截 *.do这样的URL后缀，就不存上述问题了。还是有后缀方便。

然而我使用的是方法二，直接报错。最后我使用方法三完美解决问题。
大家可以看下这篇文章：http://hanhongke123.blog.163.com/blog/static/62223494201242451230534/
希望能解决大家的困扰。