SpringMVC基础教程

1. 最简单的配置

首先是要有相应的配置文件：

文件内容：

  <context:component-scan base-package="com.imethsoft.server.*" />
  <!-- 开启注解 -->
  <mvc:annotation-driven />

  <!-- 静态资源(js/image)的访问 -->
  <mvc:resources mapping="/images/**" location="/images/" cache-period="31556926" />
  <mvc:resources mapping="/js/**" location="/js/" cache-period="31556926" />
  <mvc:resources mapping="/css/**" location="/css/" cache-period="31556926" />

  <!-- 定义视图解析器 -->
  <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/"></property>
    <property name="suffix" value=".jsp"></property>
  </bean>

在web.xml配置如下即可：第一种方式：文件放在WEB-INF下面，取名为springMVC-servlet.xml

 <!-- 配置SpringMVC -->
  <servlet>
    <servlet-name>springMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>

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

第二种方式：文件位置随意放、或者名字不为springMVC-servlet.xml

在web.xml配置如下即可：

 <!-- 配置SpringMVC -->
 <servlet>
   <servlet-name>springMVC</servlet-name>
   <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
   <init-param>
         <!-- 加载SpringMVC的xml到 spring的上下文容器中 -->
         <param-name>contextConfigLocation</param-name>
         <param-value>classpath:applicationContext-servlet.xml</param-value>
         </init-param>
   <load-on-startup>1</load-on-startup>
  </servlet>

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

二者方式的区别只是在于springmvc有自带的加载路径和文件名，当然一般我们会采取第二种，方便我们自己的命名以及文件放置。

 

2.配置springMVC-servlet.xml使得我们可以根据URL的结尾进行返回对应的返回值，例如list.json，list.xml

 

 <!-- 根据客户端的不同的请求决定不同的view进行响应, 如 /blog/1.json /blog/1.xml -->
  <bean class="org.springframework.web.servlet.view.ContentNegotiatingViewResolver">
      <property name="order" value="1" />
      <!-- 在没有扩展名时即: "/blog/1" 时的默认展现形式 -->
   <property name="defaultContentType" value="text/html" />
   <!-- 是否启用扩展名支持，默认就是true -->
   <property name="favorPathExtension" value="true"></property>

   <!-- 设置为true以忽略对Accept Header的支持 -->
   <property name="ignoreAcceptHeader" value="true" />
   <!-- 用于开启 /blog/123?format=json 的支持，一旦开启就要加format参数 -->
   <property name="favorParameter" value="false" />

   <!-- 扩展名至mimeType的映射,即 /blog.json => application/json -->
   <property name="mediaTypes">
    <map>
     <entry key="xml" value="application/xml" />
     <entry key="json" value="application/json" />
    </map>
   </property>

   <property name="defaultViews">
    <list>
     <!-- for application/json -->
     <bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView" />

     <!-- for application/xml -->
     <bean class="org.springframework.web.servlet.view.xml.MarshallingView">
      <property name="marshaller">
       <bean class="org.springframework.oxm.xstream.XStreamMarshaller" />
      </property>
     </bean>
    </list>
   </property>
  </bean>

值得要注意的是，你的springmvc中必须要配置

 <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
   <property name="order" value="2" />
   <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
   <property name="prefix" value="/"></property>
   <property name="suffix" value=".jsp"></property>
  </bean>

这样配置了以后，能保证的有一点，当用户输入的结尾不存在的时候会默认使用text/html来进行处理，也就是网页处理，因为会自动跳到viewResolver中

 

在代码块中建议如下处理：

  @RequestMapping(value="/getById",method=RequestMethod.GET)
  public ModelAndView getById(Model model, HttpServletRequest request){

   User user = new User();
   user.setUsername("aaa");
   user.setPassword("bbb");

   Map<String, Object> map = new HashMap<String, Object>();
   map.put("row", user);
   return new ModelAndView("getById", map);
  }

解释：这样的目的在于，如果请求的是单纯的action会跳转到getById.jsp中，如果是其他的结尾会自动转为相应的数据格式

 

3.统一异常处理

 <bean id="exceptionResolver" class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
      <property name="defaultErrorView" value="error500"></property>
      <property name="defaultStatusCode" value="500"></property>
      <property name="statusCodes">
          <props>
              <prop key="error500">500</prop> <!-- error.jsp -->
              <prop key="error404">404</prop> <!-- error1.jsp -->
          </props>
      </property>
      <property name="exceptionMappings">
          <props>
              <!-- 这里你可以根据需要定义N多个错误异常转发 -->
              <!-- 数据库错误(dbError.jsp) -->
              <prop key="java.sql.SQLException">dbError</prop>
              <!-- 参数绑定错误(如：必须参数没传递)(bizError.jsp) -->
              <prop key="org.springframework.web.bind.ServletRequestBindingException">bizError</prop>
              <!-- 参数错误(bizError.jsp) -->
              <prop key="java.lang.IllegalArgumentException">bizError</prop>
              <!-- 参数类型有误(bizError.jsp) -->
              <prop key="org.springframework.validation.BindException">bizError</prop>
              <!-- 其他错误为'未定义错误'(unknowError.jsp) -->
              <prop key="java.lang.Exception">unknowError</prop>
          </props>
      </property>
  </bean>

 

其次要在web.xml中配置

 <error-page>
   <error-code>500</error-code>
   <location>/error500.jsp</location>
  </error-page>

  <error-page>
   <error-code>404</error-code>
   <location>/error404.jsp</location>
  </error-page>

这样可以保证在springmvc没有拦截到的时候可以跳转到web.xml中进行拦截错误处理

 

4.数据格式化

 <!-- 配置默认的注解映射 -->
  <mvc:annotation-driven>
      <mvc:message-converters>
          <ref bean="stringHttpMessageConverter" />
             <ref bean="fastJsonHttpMessageConverter" />
      </mvc:message-converters>
  </mvc:annotation-driven>

  <bean id="stringHttpMessageConverter" class="org.springframework.http.converter.StringHttpMessageConverter">
         <!-- 避免出现乱码 -->
         <property name="supportedMediaTypes">
             <list>
                 <value>text/plain;charSet=UTF-8</value>
             </list>
         </property>
     </bean>

  <bean id="fastJsonHttpMessageConverter" class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter">
         <property name="supportedMediaTypes">
             <list>
                 <value>application/json;charset=UTF-8</value>
                 <value>text/html;charset=UTF-8</value><!-- 避免IE出现下载JSON文件的情况 -->
             </list>
         </property>
         <property name="features">
             <util:list>
                 <value>WriteMapNullValue</value>
                 <value>QuoteFieldNames</value>
                 <value>WriteDateUseDateFormat</value>
             </util:list>
         </property>
     </bean>