SpringMVC 笔记——注解方式声明控制器及资源访问

超、凢脫俗 2022-06-12 03:28 172阅读 0赞

一、新建动态Web 工程

工程名: TestSpringMVC

1、配置web.xml

<!DOCTYPE web-app PUBLIC
     "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
     "http://java.sun.com/dtd/web-app_2_3.dtd" >
    <web-app>
      	<display-name>Test Web Application</display-name>
      	<description>A simple SpringMVC project.</description>
            
            <context-param>  
                <param-name>log4jConfigLocation</param-name>  
                <param-value>classpath:log4j.properties</param-value>  
            </context-param>  
            <context-param>  
                <param-name>log4jRefreshInterval</param-name>  
                <param-value>60000</param-value>  
            </context-param>  
      	
      	<context-param>
      		<param-name>contextConfigLocation</param-name>
      		<param-value>/WEB-INF/spring-context.xml</param-value>
      	</context-param>
      	
      	<filter>
    		<filter-name>encodingFilter</filter-name>
    		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    		<init-param>
    			<param-name>encoding</param-name>
    	       	<param-value>UTF-8</param-value>
    		</init-param>
      	</filter>
            <filter-mapping>   
    
                <filter-name>encodingFilter</filter-name>
    
                <url-pattern>/*</url-pattern>
    
            </filter-mapping>
    
           <listener>
    		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
      	</listener>
      	<listener>  
                <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>  
            </listener>
      	
      	<servlet>
    		<servlet-name>dispatcher</servlet-name>
    		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    		<load-on-startup>1</load-on-startup>
      	</servlet>
      	<servlet-mapping>
    		<servlet-name>dispatcher</servlet-name>
    		<url-pattern>/</url-pattern>
      	</servlet-mapping>
    	<welcome-file-list>
    	    <welcome-file>index.html</welcome-file>
    	</welcome-file-list>
    </web-app>

2、配置DispatcherServlet 对应的映射文件

此处使用默认的名字，即dispatcher-servlet.xml，放于WEB-INF下。

**说明：**  
DispatcherServlet 的配置文件的beans 声明部分都是相同的，只是版本号的区别，所以对于不同版本，只需修改上面的版本号（保留2位，上面为4.0）

Spring 中定义组件的注解：

@Component：最普通组件，比之下三种，没太多语义

@Repository: 持久层组件，即DAO 组件

@Service：业务层组件

@Controller：控制层组件

3、以注解方式定义 Controller 及页面访问

此处以注解方式定义控制器。新建 com.milan.web 包，里面定义Controller 组件TestController。

TestController.java：

package com.milan.web.controller;
    
    import javax.servlet.http.HttpServletResponse;
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    @Controller
    @RequestMapping("/request")
    public class TestController {
    	
    	@RequestMapping("/testController")
    	public String testMethod(){
    		System.out.println("hello world");
    		return "success";
    	}
    }

说明：根据web.xml 中对DispatcherServlet 的映射路径"/"，及dispatcher-servlet.xml 中视图解析器的路径配置（prefix="/views/"，suffix=".jsp"），结合@RequestMapping注解值

*  则下面的请求路径将返回webapp/views目录下success.jsp（需先定义目录结构与文件）

localhost:8080/TestSpringMVC/request/testController

而实际上，此路径会提示：**HTTP ERROR 500 错误**

控制台输出错误信息为：

hello world

\[ERROR\] /test\_c3p0/request/testController

java.lang.NoSuchMethodError: javax.servlet.ServletContext.getEffectiveMajorVersion()I

打印了字符串，可见已经进入了 testMethod 方法，但却没返回与显示success.jsp页面。

*  修改访问路径，直接访问success.jsp

localhost:8080/TestSpringMVC/views/success.jsp

控制台提示错误信息为：

\[ERROR\] /test\_c3p0/views/success.jsp  
java.lang.NoSuchMethodError: javax.servlet.ServletContext.getEffectiveMajorVersion()I

可见并没有被DispatcherServlet 拦截处理。

*  修改web.xml中dispatcher映射路径为/\* （注意原来为/）

请求路径：

localhost:8080/TestSpringMVC/request/testController

控制台提示错误信息：

hello world  
WARN 2017-07-14 14:44:28 \[PageNotFound:947\] - No mapping found for HTTP request with URI \[/test\_c3p0/views/success.jsp\] in DispatcherServlet with name 'dispatcherServlet'

请求路径：

localhost:8080/TestSpringMVC/views/success.jsp

错误信息：

WARN 2017-07-14 14:46:46 \[PageNotFound:947\] - No mapping found for HTTP request with URI \[/test\_c3p0/views/success.jsp\] in DispatcherServlet with name 'dispatcherServlet'

解决此访问问题，只需在web.xml 中增加下面配置（web.xml中映射路径仍还原为/，且不需要声明名为default的servlet），就可以正确访问，但效果不同

<servlet-mapping>
    		<servlet-name>default</servlet-name>
    		<url-pattern>*.jsp</url-pattern>
    </servlet-mapping>

通过以下路径返回页面，控制台会打印helloworld，但页面出现乱码：

localhost:8080/TestSpringMVC/request/testController

而此路径控制台不会打印Helloworld ，但页面没有乱码：

localhost:8080/TestSpringMVC/views/success.jsp

参考：[http://www.cnblogs.com/bigdataZJ/p/springmvc1.html][http_www.cnblogs.com_bigdataZJ_p_springmvc1.html]

二、SpringMVC 资源访问问题

1、DispatcherServlet 的路径映射"/" 与"/\*"的区别？

/ 只拦截不带后缀名的请求，/\* 会处理所有请求。

但是，当dispatcherServlet 中增加了处理.jsp 的default的映射时，映射为/ 的dispatcherServlet 能返回页面（上面实验中乱码的页面），而没有增加此default 映射时，无法进入Controller。简言之，直接访问静态资源能返回的，Controller方式访问也能返回，但却没有经过Controller的方法。对此有点不解，先放着。

2、最好将全部资源访问交由SpringMVC 处理

DispacherServlet对应的配置文件中：

**使用<mvc:default-servlet-handler />**:

将会在Spring MVC上下文中定义一个org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，它会像一个检查员，对进入DispatcherServlet的URL进行筛查，如果发现是静态资源的请求，就将该请求转由Web应用服务器默认的Servlet处理，如果不是静态资源的请求，才由DispatcherServlet继续处理。

此servlet 默认名字为default，也可修改：

<mvc:default-servlet-handler default-servlet-name="名字" />

**使用<mvc:resources />：**

使用mvc:default-servlet-handler 将静态资源的处理经由Spring MVC框架交回Web应用服务器处理。而mvc:resources 更进一步，由Spring MVC框架自己处理静态资源，并添加一些有用的附加值功能。

首先，mvc:resources 允许静态资源放在任何地方，如WEB-INF目录下、类路径下等，你甚至可以将JavaScript等静态文件打到JAR包中。通过location属性指定静态资源的位置，由于location属性是Resources类型，因此可以使用诸如”classpath:”等的资源前缀指定资源位置。传统Web容器的静态资源只能放在Web容器的根路径下mvc:resources 完全打破了这个限制。

其次，mvc:resources 依据当前著名的Page Speed、YSlow等浏览器优化原则对静态资源提供优化。你可以通过cacheSeconds属性指定静态资源在浏览器端的缓存时间，一般可将该时间设置为一年，以充分利用浏览器端的缓存。在输出静态资源时，会根据配置设置好响应报文头的Expires 和 Cache-Control值。

在接收到静态资源的获取请求时，会检查请求头的Last-Modified值，如果静态资源没有发生变化，则直接返回303相应状态码，提示客户端使用浏览器缓存的数据，而非将静态资源的内容输出到客户端，以充分节省带宽，提高程序性能。

配置示例：

<mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>

以上配置将Web根路径”/”及类路径下 /META-INF/publicResources/ 的目录映射为/resources路径。假设Web根路径下拥有images、js这两个资源目录,在images下面有bg.gif图片，在js下面有test.js文件，则可以通过 /resources/images/bg.gif 和 /resources/js/test.js 访问这二个静态资源。

假设WebRoot还拥有images/bg1.gif 及 js/test1.js，则也可以在网页中通过 /resources/images/bg1.gif 及 /resources/js/test1.js 进行引用。

参考： [http://www.cnblogs.com/fangqi/archive/2012/10/28/2743108.html 原文值得一看（关于REST 服务）][http_www.cnblogs.com_fangqi_archive_2012_10_28_2743108.html _REST]

[http_www.cnblogs.com_bigdataZJ_p_springmvc1.html]: http://www.cnblogs.com/bigdataZJ/p/springmvc1.html
[http_www.cnblogs.com_fangqi_archive_2012_10_28_2743108.html _REST]: http://www.cnblogs.com/fangqi/archive/2012/10/28/2743108.html