SpringMVC入门

目录

 1. SpringMVC的工作原理 

 2. SpringMVC核心开发步骤 

 3. SpringMVC的组件 

 4. 在项目中添加SpringMVC相关依赖

 5. 在WEB-INF下添加spring-mvc.xml

 6. 修改web.xml

 7. 案例(第一个springMVC程序：HelloWorld)

 8. 页面跳转

 9. 常用注解 

10.请求处理方法的参数及返回值 

11. spring常用注解 

12. struts2和springMVC的区别: 

---

•  什么是SpringMVC?

   Spring Web MVC是一种基于Java的实现了MVC设计模式的、请求驱动类型的、
   轻量级Web框架。

 1. SpringMVC的工作原理 

  1. SpringMVC处理请求的流程
  1.1 首先用户发送请求-->DispatherServlet
  1.2 DispatcherServlet-->HandlerMapping         Controller
  1.3 DispatcherServlet-->HandlerAdapter    
  1.4 HandlerAdapter-->处理器功能处理方法的调用  参数赋值
  1.5 ModelAndView的逻辑视图名-->ViewRecolver
  1.6 View-->渲染
  1.7 返回控制权给DispatcherServlet，由DispatcherServlet返回呼应给用户，流程结束

2. SpringMVC核心开发步骤 

  2.1 DispatcherServlet在web.xml中的部署描述，从而拦截请求到springMVC
  2.2 HandlerMapping的配置，从而将请求映射到处理器
  2.3 HandlerAdapter的配置，从而支持多种类型的处理器
  2.4 处理器(页面控制器)的配置，从而进行功能处理
  2.5 ViewResolver的配置，从而将逻辑视图名解析为具体的视图技术 

3. SpringMVC的组件 

  3.1 前端控制器(DispatcherServlet)
  3.2 请求到处理器映射(HandlerMapping)
  3.3 处理器适配器(HandlerAdapter)
  3.4 视图解析器(ViewResolver)
  3.5 处理器或页面控制器(Controller)
  3.6 验证器(Validator)
  3.6 命令对象(Command 请求参数绑定到的对象就叫命令对象)
  3.7 表单对象(Form Object提供给表单展示和提交到的对象就叫表单对象) 

4. 在项目中添加SpringMVC相关依赖

<!-- ********************** spring-web依赖 ********************** -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>

<!-- ********************** spring-webmvc依赖 ********************** -->
   <dependency>
     <groupId>org.springframework</groupId>
     <artifactId>spring-webmvc</artifactId>
     <version>${spring.version}
     </version>
   </dependency>

 <!-- ********************** JSTL依赖 ********************** -->
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>
    <dependency>
      <groupId>taglibs</groupId>
      <artifactId>standard</artifactId>
      <version>1.1.2</version>
    </dependency>

    <!-- ********************** Json相关依赖 ********************** -->
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-databind</artifactId>
      <version>${jackson.version}</version>
      <exclusions>
        <exclusion>
          <artifactId>jackson-annotations</artifactId>
          <groupId>com.fasterxml.jackson.core</groupId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-core</artifactId>
      <version>${jackson.version}</version>
    </dependency>
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-annotations</artifactId>
      <version>${jackson.version}</version>
    </dependency>

 5. 在WEB-INF下添加spring-mvc.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:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!--1) use-dafault-filters="false"的情况下，根据表达式包含(include-filter)或排除(exclude-filter)指定包-->
    <context:component-scan base-package="com.jmh.mybatis" use-default-filters="false">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
        <!--<context:exclude-filter type="regex" expression=".+\.controller2\..*"/>-->
    </context:component-scan>

    <!--2) 此标签默认注册DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter -->
	<!--两个bean，这两个bean是spring MVC为@Controllers分发请求所必须的。并提供了数据绑定支持，-->
    <!--@NumberFormatannotation支持，@DateTimeFormat支持，@Valid支持，读写XML的支持（JAXB），读写JSON的支持（Jackson）-->
    <mvc:annotation-driven></mvc:annotation-driven>

    <!--3) ViewResolver -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- viewClass需要在pom中引入两个包：standard.jar and jstl.jar -->
        <property name="viewClass"
                  value="org.springframework.web.servlet.view.JstlView"></property>
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!--4) 单独处理图片、样式、js等资源 -->
    <mvc:resources location="/static/css/" mapping="/static/css/**"/>
    <mvc:resources location="/static/images/" mapping="/static/images/**"/>
    <mvc:resources location="/static/js/" mapping="/static/js/**"/>
</beans>

 需要改里面的为1的所要扫描的包名路径即可（意思就是只扫描指定的包下的指定的模块）

• 同时也要修改spring-mybatis.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:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
       xmlns:aop="http://www.springframework.org/schema/aop"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd">

    <!--1. 注解式开发 -->
    <!--1) 注解驱动 -->
<!--    <context:annotation-config/>
    &lt;!&ndash;2) 用注解方式注入bean，并指定查找范围：com.zking.oa及子子孙孙包&ndash;&gt;
    <context:component-scan base-package="com.jmh.mybatis"/>-->
    <context:component-scan base-package="com.jmh.mybatis" use-default-filters="true">
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
        <!--<context:exclude-filter type="regex" expression=".+\.controller2\..*"/>-->
    </context:component-scan>

    <!-- 已在spring.xml中配置，只能引入一次 -->
    <!--2. 引入外置jdbc配置文件 -->
    <!--<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">-->
    <!--<property name="location" value="classpath:jdbc.properties"/>-->
    <!--</bean>-->

    <!--3. dbcp2数据库连接池配置-->
    <bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource"
          destroy-method="close">
        <property name="driverClassName" value="${jdbc.driver}"/>
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
        <!--初始连接数-->
        <property name="initialSize" value="10"/>
        <!--最大活动连接数-->
        <property name="maxTotal" value="100"/>
        <!--最大空闲连接数-->
        <property name="maxIdle" value="50"/>
        <!--最小空闲连接数-->
        <property name="minIdle" value="10"/>
        <!--设置为-1时，如果没有可用连接，连接池会一直无限期等待，直到获取到连接为止。-->
        <!--如果设置为N（毫秒），则连接池会等待N毫秒，等待不到，则抛出异常-->
        <property name="maxWaitMillis" value="-1"/>
    </bean>


    <!--4. spring和MyBatis整合 -->
    <!--1) 创建sqlSessionFactory-->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 指定数据源 -->
        <property name="dataSource" ref="dataSource"/>
        <!-- 指定mybatis核心配置文件 -->
        <property name="configLocation" value="classpath:mybatis.cfg.xml"/>
        <!-- 自动扫描XxxMapping.xml文件，**任意路径 -->
        <property name="mapperLocations" value="classpath:com/jmh/mybatis/**/mapper/*.xml"/>
        <!-- 指定别名 -->
        <property name="typeAliasesPackage" value="com.jmh.mybatis.model"/>
    </bean>
    <!--2) 自动扫描com/zking/oa/**/mapper下的所有XxxMapper接口(其实就是DAO接口)，并实现这些接口，-->
    <!--   即可直接在程序中使用dao接口，不用再获取sqlsession对象-->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <!--basePackage 属性是映射器接口文件的包路径。-->
        <!--你可以使用分号或逗号 作为分隔符设置多于一个的包路径-->
        <property name="basePackage" value="com/jmh/mybatis/**/mapper"/>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    </bean>



    <!--2) 事务管理器 -->
    <bean id="transactionManager"
          class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <!--5. 注解式事务配置开始 -->
    <tx:annotation-driven transaction-manager="transactionManager"/>

    <!--1) 开启自动代理 -->
    <aop:aspectj-autoproxy/>
</beans>

 6. 修改web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <display-name>Archetype Created Web Application</display-name>
    <!-- Spring和web项目集成start -->
    <!-- spring上下文配置文件 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring.xml</param-value>修改成你自己的spring.xml
    </context-param>
    <!-- 读取Spring上下文的监听器 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- Spring和web项目集成end -->

    <!-- 防止Spring内存溢出监听器 -->
    <listener>
        <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
    </listener>

    <!-- 中文乱码处理 -->
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>com.jmh.mybatis.utils.EncodingFiter</filter-class>
        <!--web.xml 3.0的新特性，是否支持异步-->
        <async-supported>true</async-supported>
        <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>

    <!-- Spring MVC servlet -->
    <servlet>
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--此参数可以不配置，默认值为：/WEB-INF/springmvc-servlet.xml-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring-mvc.xml</param-value>在WEB-INF下添加的spring-mvc.xml
        </init-param>
        <load-on-startup>1</load-on-startup>
        <!--web.xml 3.0的新特性，是否支持异步-->
        <async-supported>true</async-supported>
    </servlet>
    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

•  中文乱码过滤器

package com.jmh.mybatis.utils;

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Map;

/**
 * 中文乱码处理
 * 
 */
public class EncodingFiter implements Filter {

	private String encoding = "UTF-8";// 默认字符集

	public EncodingFiter() {
		super();
	}

	public void destroy() {
	}

	public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain chain)
			throws IOException, ServletException {
		HttpServletRequest request = (HttpServletRequest) servletRequest;
		HttpServletResponse response = (HttpServletResponse) servletResponse;

		String method = request.getMethod();
		if (method.equalsIgnoreCase("get")) {
			Map<String, String[]> map = (Map<String, String[]>) request.getParameterMap();// 保存所有参数名=参数值(数组)的Map集合
			for (String[] values : map.values()) {
				for (int i = 0; i < values.length; i++) {
					values[i] = new String(values[i].getBytes("ISO-8859-1"), this.encoding);
				}
			}
		} else if (method.equalsIgnoreCase("post")) {
			request.setCharacterEncoding(this.encoding);
		}
		response.setContentType("text/html;charset=" + this.encoding);

		chain.doFilter(servletRequest, servletResponse);
	}

	public void init(FilterConfig filterConfig) throws ServletException {
		String s = filterConfig.getInitParameter("encoding");// 读取web.xml文件中配置的字符集
		if (null != s && !s.trim().equals("")) {
			this.encoding = s.trim();
		}
	}

}

7. 案例(第一个springMVC程序：HelloWorld)

• HelloController

package com.jmh.mybatis.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/hello")
public class HelloController {

    @RequestMapping("/toHello")
    public String toHello(){
        return "hello";//逻辑视图名
    }
}

 @Controller：用于标识处理器类

 @RequestMapping：请求到处理器功能方法的映射规则，可定义到类和方法
 常用参数：value、method
 可将@RequestMapping标签定义到类名处窄化路径(加在类上面就是给访问路径多加了指定   的目录)

• 需在WEB-INF目录下jsp目录下创建一个hello的页面 

<%--
  Created by IntelliJ IDEA.
  User: 蒋明辉
  Date: 2022/8/15
  Time: 9:36
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>hello</title>
</head>
<body>
<h1>HelloWorld</h1>
</body>
</html>

 效果图: 

• 案例二(返回Json数据) 

package com.jmh.mybatis.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/hello")
public class HelloController {

    @RequestMapping("/toHello")
    @ResponseBody
    public String toHello(){
        return "hello";//穿到前端的Json数据
    }
}

@ResponseBody：处理器功能处理方法的返回值作为响应体（通过HttpMessageConverter进行类型转换）； 

• 访问其它的静态资源(被springmvc拦截了) 
• 加在上诉的WEB-INF下面的spring-mvc.xml文件中

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

 8.  页面跳转

8.1 转发："forward:path"
8.2 重定向："redirect:path"
注1：这两种跳转方式将会绕开视图解析器的前缀和后缀
注2：还有就是如果是在同一controller中则不用使用"/"从根目录开始,而如果是在不同的        controller则一定要从根目录开始。 

9. 常用注解 

9.1 @Controller：用于标识处理器类
      @RestController注解相当于@ResponseBody ＋ @Controller合在一起的作用

 9.2 @RequestMapping：请求到处理器功能方法的映射规则，可定义到类和方法
      常用参数：value、method
      可将@RequestMapping标签定义到类名处窄化路径

 9.3 @RequestParam：请求参数到处理器功能处理方法的方法参数上的绑定
      常用参数：value、required、defaultValue
      注：required设置成false的参数类型必须是引用类型，因为基本数据类型是不能为null的

 9.4 @ModelAttribute：请求参数到命令对象的绑定
      常用参数：value
 9.4.1 可用@ModelAttribute标注方法参数，方法参数会被添加到Model对象中(作用：向视图层传数据)
 9.4.2 可用@ModelAttribute标注一个非请求处理方法，此方法会在每次调用请求处理方法前被调用(作用：数据初始化)
 9.4.3 可用@ModelAttribute标注方法，方法返回值会被添加到Model对象中(作用：向视图层传数据)
          但此方法视图的逻辑图就会根据请求路径解析，例如：a/test42 --> /WEB-INF/a/test42.jsp
          太麻烦几乎不用，不用直接保存到Model或ModelAndView中

 9.5 @SessionAttributes：指定ModelMap中的哪些属性需要转存到session
      常用参数：value、types
      注1：必须放到class类名处

 9.6 @InitBinder(自学)：用于将请求参数转换到命令对象属性的对应类型
      例如：日期格式到后台的数据转换
            birthday=2000年10月10日   --> java.util.Date birthday;

 9.7 @RequestBody(重要~~~~~)：用于目前比较流行的ajax开发的数据绑定(即提交数据的类型为json格式)
      注1：使用@RequestBody注解的时候，前台的Content-Type必须要改为application/json，
           如果没有更改，前台会报错415（Unsupported Media Type）。
           后台日志就会报错Content type ‘application/x-www-form-urlencoded;charset=UTF-8’ not supported。
           这些错误Eclipse下Tomcat是不会显示错误信息的，只有使用了日志才会显示
      $.ajax({
                url : "jsontest",
                type : "POST",
                async : true,
                contentType : "application/json",
                data : JSON.stringify(json),
                dataType : 'json',
                success : function(data) {
                    if (data.userstatus === "success") {
                        $("#errorMsg").remove();
                    } else {
                        if ($("#errorMsg").length <= 0) {
                            $("form[name=loginForm]").append(errorMsg);
                        }
                    }
                }
            });
      
  9.8 @ResponseBody：处理器功能处理方法的返回值作为响应体（通过HttpMessageConverter进行类型转换）；
      
      注1：@RestController
      @RestController=@Controller+@ResponseBody

  9.9 其它
      @CookieValue cookie数据到处理器功能处理方法的方法参数上的绑定
      @RequestHeader：请求头（header）数据到处理器功能处理方法的方法参数上的绑定
      @RequestBody：请求的body体的绑定（通过HttpMessageConverter进行类型转换）；
      @ResponseStatus：定义处理器功能处理方法/异常处理器返回的状态码和原因；
      @ExceptionHandler：注解式声明异常处理器；
      @PathVariable：请求URI中的模板变量部分到处理器功能处理方法的方法参数上的绑定，
      @PostConstruct或@PreDestroy：初始化方法/销毁方法

10. 请求处理方法的参数及返回值 

10.1请求处理方法的参数
      HttpServletRequest/ServletRequest
      HttpServletResponse/HttpServletResponse
      HttpSession
      Model/ModelAndView/ModelMap/Map

      WebRequest/NativeWebRequest
      Locale
      InputStream/Reader
      OutputStream/Writer
      Principal
      HttpEntiry<?>
      RedirectAttributes
      Errors
      BindingResult
      SessionStatus
      UriComponentsBuilder
      带@PathVariable,@MatrixVariable注释的对象
      @RequestParam,@RequestHeader,@RequestBody,@RequestPart

      特别重要的是：org.springframework.ui.Model类型，每次调用请求处理方法时，SpringMVC都创建Model对象并将
      其注入到各种对象

  10.2返回值的类型
      ModelAndView
      String(代表一个逻辑视图名)

      void
      Map
      View
      Callable
      DeferredResult
      其它任意类型，spring将其视作输出给View的对象模型

11. spring常用注解 

@Service用于标注业务层组件
@Controller用于标注控制层组件（如struts中的action）
@Repository用于标注数据访问组件，即DAO组件
@Component泛指组件，当组件不好归类的时候，我们可以使用这个注解进行标注。

@Aspect//切面
@Pointcut//定义需要切面的地方，表达式参数（https://blog.csdn.net/elim168/article/details/78150438）
@annotation//当执行的方法上拥有指定的注解时生效。

@After
@Before
@Around

附录二：Ant 风格路径表达式 

• ANT通配符有三种： 

?      匹配任何单字符
*      匹配0或者任意数量的字符
**     匹配0或者更多的目录 

12. struts2和springMVC的区别: 

1、springmvc入口是一个servlet前端控制器( DispatcherServlet ),struts2入口是一个filter过滤器(StrutsPrepareAndExecuteFilter).

2、struts2通过在action类中定义成员变量接收参数,(属性驱动和模型驱动),它只能使用多例模式管理action.

springmvc通过在controller方法中定义形参接收参数,springmvc可以使用单例模式管理controller.

3、springmvc是基于方法开发的，注解开发中使用requestMapping将url和方法进行 映射,如果根据url找到controller类的方法生成一个handler处理器对象(只包括一个method).

struts2是基于类开发的，每个请求过来创建一个action实例,实例对象中有若干个方法.

开发中建议使用springmvc,springmvc方法更类似service业务方法.

4、struts2采用值栈存储请求和相应的数据，通过OGNL存取数据；springmvc通过参数绑定期将request请求内容解析,并给方法形参赋值.

5、struts2和springmvc的速度是相当的,由于struts2的漏洞较多,更多企业使用springmvc

6、SpringMVC验证支持JSR303，处理起来相对更加灵活方便，而Struts2验证比较繁琐，感觉太烦乱。

7、设计思想上，Struts2更加符合OOP的编程思想， SpringMVC就比较谨慎，在servlet上扩展。

8、拦截器实现机制上，Struts2有以自己的interceptor机制，SpringMVC用的是独立的AOP方式，这样导致Struts2的配置文件量还是比SpringMVC大。

---