springmvc 自定义配置文件路径 springmvc的配置文件怎么写

转载

definitely 2024-02-18 19:35:21

文章标签 springmvc 自定义配置文件路径 spring mvc spring xml mvc 文章分类 架构后端开发

SpringMVC的配置文件有两个，分别是部署描述符文件（web.xml）和Spring MVC配置文件（springmvc.xml）。配置的内容主要有以下几点：

配置前端控制器DispatcherServlet；
配置处理器适配器；
配置处理器映射器；
配置视图解析器；
配置控制器（Handler）。
具体的配置在下面的SpringMVC应用中具体讲解。

一、环境的搭建

单纯的SpringMVC应用，需要用到的jar包并不多，如下图所示：

springmvc 自定义配置文件路径 springmvc的配置文件怎么写_spring

二、配置前端控制器DispatcherServlet

SpringMVC的前端控制器是一个servlet：org.springframework.web.servlet.DispatcherServlet，Struts2的前端控制器是一个Filter。配置servlet需要配置<servlet>和<servlet-mapping>，如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
  <display-name>Study_SpringMVC</display-name>
  <welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>default.html</welcome-file>
    <welcome-file>default.htm</welcome-file>
    <welcome-file>default.jsp</welcome-file>
  </welcome-file-list>

  <!-- 配置前端控制器DispatcherServlet -->
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
  </servlet>

  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>  
</web-app>

需要注意的是，在<init-param>指定了SpringMVC的配置文件的位置，如果没有指定配置文件位置的话，需要将配置文件命名为[servlet-name]-servlet.xml，并将其放在web.xml相同的路径下。

三、配置处理器适配器

SpringMVC中，常用的处理器适配器有两种，SimpleControllerHandlerAdapter和HttpRequestHandlerAdapter。
（1）SimpleControllerHandlerAdapter是默认的处理器适配器，如果不在配置文件中配置，SpringMVC将使用这个适配器。所以，当我把处理器适配器的配置注释掉后，SpringMVC应用依然可用；
（2）HttpRequestHandlerAdapter需要handler实现HttpRequestHandler接口。如果要使用HttpRequestHandlerAdapter，必须显式地配置。如：<bean class="org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter"></bean>

这里使用的是SimpleControllerHandlerAdapter，配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:aop="http://www.springframework.org/schema/aop" 
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/mvc 
        http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd 
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/aop
        http://www.springframework.org/schema/aop/spring-aop-4.2.xsd
        http://www.springframework.org/schema/tx
        http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- 配置处理器适配器：HandlerAdapter。所有处理器适配器都实现了HandlerAdapter接口-->
    <!-- SimpleControllerHandlerAdapter适配器能执行实现了Controller接口的Handler。所以，现在配置了这个适配器的话，所有的处理器Handler必须要实现Controller接口才行。-->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />
</beans>

四、配置处理器映射器

常用的处理器映射器也有两种，分别是BeanNameUrlHandlerMapping和SimpleUrlHandlerMapping。
（1）BeanNameUrlHandlerMapping，通过控制器（handler）的<bean>的name属性来匹配相应的控制器。配置如下：

<!-- 配置处理器映射器 -->
<!-- 将bean的name作为url进行查找，需要在配置Handler时指定bean name -->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping" />

（2）SimpleUrlHandlerMapping是BeanNameUrlHandlerMapping的增强版本，它可以将url和控制器（handler）bean的id进行统一映射配置。如：

<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">  
    <property name="mappings">  
        <props>  
            <!-- itemsController1为控制器的id属性，/queryItems1.action是URL -->  
            <prop key="/queryItems1.action">itemController1<prop/>  
            <prop key="/queryItems2.action">itemController1<prop/>  
        </props>  
    </property>  
</bean>

五、配置视图解析器

视图解析器可以指定前缀和后缀属性，这样一来，在handler中的view路径名可以缩短。配置如下所示：

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

这样一来，视图路径设置为return new ModelAndView("productForm");时，视图解析器将自动增加前缀和后缀，最终的视图的路径为/WEB-INF/jsp/productForm.jsp。

六、编写控制器类

这个应用中，共编写了两个控制器类，如下：
InputProductController：

package controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

public class InputProductController implements Controller {
    private final Log logger = LogFactory.getLog(InputProductController.class);
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        // TODO Auto-generated method stub
        logger.info("调用了InputProductController");
        return new ModelAndView("productForm");
    }

}

SaveProductController：

package controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import model.Product;

public class SaveProductController implements Controller {
    private final Log logger = LogFactory.getLog(SaveProductController.class);
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        // TODO Auto-generated method stub
        logger.info("调用SaveProductController");
        request.setCharacterEncoding("UTF-8");
        Product product = new Product();
        product.setName(request.getParameter("name"));
        product.setDescription(request.getParameter("description"));
        product.setPrice(request.getParameter("price"));

        return new ModelAndView("productDetails", "product", product);
    }
}

七、配置控制器（Handler）

这里直接将整个springmvc.xml文件的内容贴上来，因为处理器适配器、处理器映射器和控制器都需要配套。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:aop="http://www.springframework.org/schema/aop" 
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/mvc 
        http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd 
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/aop
        http://www.springframework.org/schema/aop/spring-aop-4.2.xsd
        http://www.springframework.org/schema/tx
        http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- 配置处理器适配器：HandlerAdapter。所有处理器适配器都实现了HandlerAdapter接口-->
    <!-- SimpleControllerHandlerAdapter适配器能执行实现了Controller接口的Handler。所以，现在配置了这个适配器的话，所有的处理器Handler必须要实现Controller接口才行。-->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />

    <!-- 配置处理器映射器 -->
    <!-- 将bean的name作为url进行查找，需要在配置Handler时指定beanname（就是url）-->
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping" />

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

    <!-- 配置Handler -->
    <bean name="/inputProduct" class="controller.InputProductController"></bean>
    <bean name="/saveProduct" class="controller.SaveProductController"></bean>
</beans>

至此，需要配置的东西已经全部配置完毕。为了测试，还需要新建一个Product类和两个jsp页面，这里就不贴代码了，直接上一个项目的总体架构图：

springmvc 自定义配置文件路径 springmvc的配置文件怎么写_spring_02