SpringMVC

发布于:2025-05-27 ⋅ 阅读:(20) ⋅ 点赞:(0)

第一章 初识SpringMVC

1.1 SpringMVC概述

  • SpringMVC是Spring子框架
  • SpringMVC是Spring 为【展现层|表示层|表述层|控制层】提供的基于 MVC 设计理念的优秀的 Web 框架,是目前最主流的MVC 框架。
  • SpringMVC是非侵入式:可以使用注解让普通java对象,作为请求处理器【Controller】
  • SpringMVC是用来代替Servlet

Servlet作用

1. 处理请求
  - 将数据共享到域中
2. 做出响应
  - 跳转页面【视图】

1.2 SpringMVC处理请求原理简图

  • 请求
  • DispatcherServlet【前端控制器】
    • 将请求交给Controller|Handler
  • Controller|Handler【请求处理器】
    • 处理请求
    • 返回数据模型
  • ModelAndView
    • Model:数据模型
    • View:视图对象或视图名
  • DispatcherServlet渲染视图
    • 将数据共享到域中
    • 跳转页面【视图】
  • 响应

第二章 SpringMVC搭建框架

2.1 搭建SpringMVC框架

  • 创建工程【web工程】
  • 导入jar包
<!--spring-webmvc-->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.3.1</version>
</dependency>

<!-- 导入thymeleaf与spring5的整合包 -->
<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring5</artifactId>
    <version>3.0.12.RELEASE</version>
</dependency>

<!--servlet-api-->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>
  • 编写配置文件
    • web.xml注册DispatcherServlet
      • url配置:/
      • <load-on-startup>:设置DispatcherServlet优先级【启动服务器时,创建当前Servlet对象】
      • init-param:contextConfigLocation,设置springmvc.xml配置文件路径【管理容器对象】
    • springmvc.xml
      • 开启组件扫描
      • 配置视图解析器【解析视图(设置视图前缀&后缀)】
  • 编写请求处理器【Controller|Handler】
  • 准备页面进行,测试

第三章 @RequestMapping详解

@RequestMapping注解作用:为指定的类或方法设置相应URL

3.1 @RequestMapping注解位置

  • 书写在类上面
    • 作用:为当前类设置映射URL
    • 注意:不能单独使用,需要与方法上的@RequestMapping配合使用
  • 书写在方法上面
    • 作用:为当前方法设置映射URL
    • 注意:可以单独使用

3.2 @RequestMapping注解属性

  • value属性
    • 类型:String[]
    • 作用:设置URL信息
  • path属性
    • 类型:String[]
    • 作用:与value属性作用一致
  • method属性
    • 类型:RequestMethod[]
public enum RequestMethod {
   GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE
}
  • 作用:为当前URL【类或方法】设置请求方式【POST、DELETE、PUT、GET】

        注意:

  • 默认情况:所有请求方式均支持
  • 如请求方式不支持,会报如下错误
  • 405【Request method 'GET' not supported】
  • params
    • 类型:String[]
    • 作用:为当前URL设置请求参数
    • 注意:如设置指定请求参数,但URL中未携带指定参数,会报如下错误
      • 400【Parameter conditions "lastName" not met for actual request parameters:】
  • headers
    • 类型:String[]
    • 作用:为当前URL设置请求头信息
    • 注意:如设置指定请求头,但URL中未携带请求头,会报如下错误
      • 404:请求资源未找到
  • 示例代码
@RequestMapping(value = {"/saveEmp","/insertEmp"},
                method = RequestMethod.GET,
                params = "lastName=lisi",
                headers = "User-Agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.84 Safari/537.36")
public String saveEmp(){
    System.out.println("添加员工信息!!!!");

    return SUCCESS;
}
@RequestMapping(method = RequestMethod.POST)
public @interface PostMapping {}
@RequestMapping(method = RequestMethod.GET)
public @interface GetMapping {}
@RequestMapping(method = RequestMethod.PUT)
public @interface PutMapping {}
@RequestMapping(method = RequestMethod.DELETE)
public @interface DeleteMapping {}

3.3 @RequestMapping支持Ant 风格的路径(了解)


  • a) ?:匹配一个字符
    b) *:匹配任意字符
    c) **:匹配多层路径
常用通配符
  • 示例代码
@RequestMapping("/testAnt/**")
public String testAnt(){
    System.out.println("==>testAnt!!!");
    return SUCCESS;
}

第四章 @PathVariable 注解 

4.1 @PathVariable注解位置

@Target(ElementType.PARAMETER)
  • 书写在参数前面

4.2 @PathVariable注解作用

  • 获取URL中占位符参数
  • 占位符语法:{}
  • 示例代码
<a th:href="@{/EmpController/testPathVariable/1001}">测试PathVariable注解</a><br>

4.3 @PathVariable注解属性

  • value属性
    • 类型:String
    • 作用:设置占位符中的参数名
  • name属性
    • 类型:String
    • 作用:与name属性的作用一致
  • required属性
    • 类型:boolean
    • 作用:设置当前参数是否必须入参【默认值:true】
      • true:表示当前参数必须入参,如未入参会报如下错误
        • Missing URI template variable 'empId' for method parameter of type Integer
      • false:表示当前参数不必须入参,如未入参,会装配null值

第五章 REST【RESTful】风格CRUD

5.1 REST的CRUD与传统风格CRUD对比

  • 传统风格CRUD
    • 功能 URL 请求方式
      • 增                             /insertEmp       POST
      • 删                             /deleteEmp?empId=1001                       GET
      • 改                             /updateEmp                                            POST
      • 查                             /selectEmp?empId=1001                       GET
  • REST风格CRUD
    • 功能 URL 请求方式
      • 增                             /emp       POST
      • 删                             /emp/1001                                              DELETE
      • 改                             /emp                                                       PUT
      • 查                             /emp/1001                                              GET

5.2 REST风格CRUD优势

  • 提高网站排名
    • 排名方式
      • 竞价排名
      • 技术排名
  • 便于第三方平台对接

5.3 实现PUT&DELETE提交方式步骤

  • 注册过滤器HiddenHttpMethodFilter
  • 设置表单的提交方式为POST
  • 设置参数:_method=PUT或_method=DELETE

5.4 源码解析HiddenHttpMethodFilter

public static final String DEFAULT_METHOD_PARAM = "_method";

private String methodParam = DEFAULT_METHOD_PARAM;

@Override
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
      throws ServletException, IOException {

   HttpServletRequest requestToUse = request;

   if ("POST".equals(request.getMethod()) && request.getAttribute(WebUtils.ERROR_EXCEPTION_ATTRIBUTE) == null) {
      String paramValue = request.getParameter(this.methodParam);
      if (StringUtils.hasLength(paramValue)) {
         String method = paramValue.toUpperCase(Locale.ENGLISH);
         if (ALLOWED_METHODS.contains(method)) {
            requestToUse = new HttpMethodRequestWrapper(request, method);
         }
      }
   }

   filterChain.doFilter(requestToUse, response);
}
/**
	 * Simple {@link HttpServletRequest} wrapper that returns the supplied method for
	 * {@link HttpServletRequest#getMethod()}.
	 */
	private static class HttpMethodRequestWrapper extends HttpServletRequestWrapper {

		private final String method;

		public HttpMethodRequestWrapper(HttpServletRequest request, String method) {
			super(request);
			this.method = method;
		}

		@Override
		public String getMethod() {
			return this.method;
		}
	}

第六章 SpringMVC处理请求数据

使用Servlet处理请求数据

  1. 请求参数
  • String param = request.getParameter();
  1. 请求头
  • request.getHeader();
  1. Cookie
  • request.getCookies();

6.1 处理请求参数

  • 默认情况:可以将请求参数名,与入参参数名一致的参数,自动入参【自动类型转换】
  • SpringMVC支持POJO入参
    • 要求:请求参数名与POJO的属性名保持一致
    • 示例代码
<form th:action="@{/saveEmp}" method="POST">
    id:<input type="text" name="id"><br>
    LastName:<input type="text" name="lastName"><br>
    Email:<input type="text" name="email"><br>
    Salary:<input type="text" name="salary"><br>
    <input type="submit" value="添加员工信息">
</form>
  • @RequestParam注解
    • 作用:如请求参数与入参参数名不一致时,可以使用@RequestParam注解设置入参参数名
      • 属性
      • value
        • 类型:String
        • 作用:设置需要入参的参数名
      • name
        • 类型:String
        • 作用:与value属性作用一致
      • required
        • 类型:Boolean
        • 作用:设置当前参数,是否必须入参
          • true【默认值】:表示当前参数必须入参,如未入参会报如下错误
          • 400【Required String parameter 'sName' is not present】
          • false:表示当前参数不必须入参,如未入参,装配null值
        • defaultValue
      • 类型:String
        • 作用:当装配数值为null时,指定当前defaultValue默认值
  • 示例代码
/**
 * 获取请求参数
 * @return
 */
@RequestMapping("/requestParam1")
public String requestParam1(@RequestParam(value = "sName",required = false,
                                        defaultValue = "zhangsan")
                                        String stuName,
                            Integer stuAge){
    System.out.println("stuName = " + stuName);
    System.out.println("stuAge = " + stuAge);
    return SUCCESS;
}

6.2 处理请头

  • 语法:@RequestHeader注解
  • 属性
    • value
      • 类型:String
      • 作用:设置需要获取请求头名称
    • name
      • 类型:String
      • 作用:与value属性作用一致
    • required
      • 类型:boolean
      • 作用:【默认值true】
        • true:设置当前请求头是否为必须入参,如未入参会报如下错误
        • 400【Required String parameter 'sName' is not present】
      • false:表示当前参数不必须入参,如未入参,装配null值
    • defaultValue
      • 类型:String
      • 作用:当装配数值为null时,指定当前defaultValue默认值
  • 示例代码
<a th:href="@{/testGetHeader}">测试获取请求头</a>

6.3 处理Cookie信息

  • 语法:@CookieValue 获取Cookie数值
  • 属性
    • value
      • 类型:String
      • 作用:设置需要获取Cookie名称
    • name
      • 类型:String
      • 作用:与value属性作用一致
    • required
      • 类型:boolean
      • 作用:【默认值true】
        • true:设置当前Cookie是否为必须入参,如未入参会报如下错误
        • 400【Required String parameter 'sName' is not present】
      • false:表示当前Cookie不必须入参,如未入参,装配null值
    • defaultValue
      • 类型:String
      • 作用:当装配数值为null时,指定当前defaultValue默认值
  • 示例代码
<a th:href="@{/setCookie}">设置Cookie信息</a><br>
<a th:href="@{/getCookie}">获取Cookie信息</a><br>

6.4 使用原生Servlet-API

  • 将原生Servlet相关对象,入参即可
@RequestMapping("/useRequestObject")
public String useRequestObject(HttpServletRequest request){}

第七章 SpringMVC处理响应数据

7.1 使用ModelAndView

  • 使用ModelAndView对象作为方法返回值类型,处理响应数据
  • ModelAndView是模型数据视图对象的集成对象,源码如下
public class ModelAndView {

   /** View instance or view name String. */
   //view代表view对象或viewName【建议使用viewName】
   @Nullable
   private Object view;

   /** Model Map. */
   //ModelMap集成LinkedHashMap,存储数据
   @Nullable
   private ModelMap model;
    
    /**
    	设置视图名称
	 */
	public void setViewName(@Nullable String viewName) {
		this.view = viewName;
	}

	/**
	 * 获取视图名称
	 */
	@Nullable
	public String getViewName() {
		return (this.view instanceof String ? (String) this.view : null);
	}

    /**
	 获取数据,返回Map【无序,model可以为null】
	 */
	@Nullable
	protected Map<String, Object> getModelInternal() {
		return this.model;
	}

	/**
	 * 获取数据,返回 ModelMap【有序】
	 */
	public ModelMap getModelMap() {
		if (this.model == null) {
			this.model = new ModelMap();
		}
		return this.model;
	}

	/**
	 * 获取数据,返回Map【无序】
	 */
	public Map<String, Object> getModel() {
		return getModelMap();
	}
    
    /**
    	设置数据
    */
    public ModelAndView addObject(String attributeName, @Nullable Object attributeValue) {
		getModelMap().addAttribute(attributeName, attributeValue);
		return this;
	}
    
    
}
  • 示例代码
@GetMapping("/testMvResponsedata")
public ModelAndView testMvResponsedata(){
    ModelAndView mv = new ModelAndView();
    //设置逻辑视图名
    mv.setViewName("response_success");
    //设置数据【将数据共享到域中(request\session\servletContext)】
    mv.addObject("stuName","zhouxu");
    return mv;
}

7.2 使用Model、ModelMap、Map

  • 使用Model、ModelMap、Map作为方法入参,处理响应数据
  • 示例代码
/**
     * 使用Map、Model、ModelMap处理响应数据
     * @return
     */
    @GetMapping("/testMapResponsedata")
    public String testMapResponsedata(Map<String,Object> map
                                         /* Model model
                                        ModelMap modelMap*/){
        map.put("stuName","zhangsan");
//        model.addAttribute("stuName","lisi");
//        modelMap.addAttribute("stuName","wangwu");

        return "response_success";
    }

7.3 SpringMVC中域对象

  • SpringMVC封装数据,默认使用request域对象
  • session域的使用
    • 方式一
/**
 * 测试响应数据【其他域对象】
 * @return
 */
@GetMapping("/testScopeResponsedata")
public String testScopeResponsedata(HttpSession session){
    session.setAttribute("stuName","xinlai");
    return "response_success";
}
    • 方式二
@Controller
@SessionAttributes(value = "stuName") //将request域中数据,同步到session域中
public class TestResponseData {
    /**
     * 使用ModelAndView处理响应数据
     * @return
     */
    @GetMapping("/testMvResponsedata")
    public ModelAndView testMvResponsedata(){
        ModelAndView mv = new ModelAndView();
        //设置逻辑视图名
        mv.setViewName("response_success");
        //设置数据【将数据共享到域中(request\session\servletContext)】
        mv.addObject("stuName","zhouxu");
        return mv;
    }
}

第八章 SpringMVC处理请求响应乱码

8.1 源码解析CharacterEncodingFilter

public class CharacterEncodingFilter extends OncePerRequestFilter {

   //需要设置字符集
   @Nullable
   private String encoding;
   //true:处理请乱码
   private boolean forceRequestEncoding = false;
   //true:处理响应乱码
   private boolean forceResponseEncoding = false;
    
    public String getEncoding() {
		return this.encoding;
	}
    
    public boolean isForceRequestEncoding() {
		return this.forceRequestEncoding;
	}
    
    public void setForceResponseEncoding(boolean forceResponseEncoding) {
		this.forceResponseEncoding = forceResponseEncoding;
	}
    
    public void setForceEncoding(boolean forceEncoding) {
		this.forceRequestEncoding = forceEncoding;
		this.forceResponseEncoding = forceEncoding;
	}
    
 	@Override
	protected void doFilterInternal(
			HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
			throws ServletException, IOException {

		String encoding = getEncoding();
		if (encoding != null) {
			if (isForceRequestEncoding() || request.getCharacterEncoding() == null) {
				request.setCharacterEncoding(encoding);
			}
			if (isForceResponseEncoding()) {
				response.setCharacterEncoding(encoding);
			}
		}
        
		filterChain.doFilter(request, response);
	
    }
    
    
}

8.2 处理请求与响应乱码

  • SpringMVC底层默认处理响应乱码
  • SpringMVC处理请求乱码步骤
  1. 注册CharacterEncodingFilter
  • 注册CharacterEncodingFilter必须是第一Filter位置
  1. 为CharacterEncodingFilter中属性encoding赋值
  2. 为CharacterEncodingFilter中属性forceRequestEncoding赋值
  • 示例代码
<!--    必须是第一过滤器位置-->
<filter>
    <filter-name>CharacterEncodingFilter</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>
    <init-param>
        <param-name>forceRequestEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

第九章 源码解析SpringMVC工作原理

9.1 Controller中方法的返回值问题

  • 无论方法返回是ModelAndView还是String,最终SpringMVC底层,均会封装为ModelAndView对象
//DispatcherServlet的1061行代码
ModelAndView mv = null;
mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
  • SpringMVC解析mv【ModelAndView】
//DispatcherServlet的1078行代码
processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
  • ThymeleafView对象中344行代码【SpringMVC底层处理响应乱码】
//computedContentType="text/html;charset=UTF-8"
response.setContentType(computedContentType);
  • WebEngineContext对象中783行代码【SpringMVC底层将数据默认共享到request域】
this.request.setAttribute(name, value);

9.2 视图及视图解析器源码

  • 视图解析器将View从ModelAndView中解析出来
    • ThymeleafViewResolver的837行代码
//底层使用反射的方式,newInstance()创建视图对象
final AbstractThymeleafView viewInstance = BeanUtils.instantiateClass(getViewClass());

第十章 SpringMVC视图及视图解析器

10.1 视图解析器对象【ViewResolver】

  • 概述:ViewResolver接口的实现类或子接口,称之为视图解析器
  • 作用:将ModelAndView中的View对象解析出来

10.2 视图对象【View】

  • 概述:View接口的实现类或子接口,称之为视图对象
  • 作用:视图渲染
    1. 将数据共享域中
    2. 跳转路径【转发或重定向】

第十一章 视图控制器&重定向&加载静态资源

11.1 视图控制器

  • 语法:view-controller
  • 步骤
    1. 添加<mvc:view-controller>标签:为指定URL映射html页面
    2. 添加<mvc:annotation-driven>
      • 有20+种功能
      • 配置了<mvc:view-controller>标签之后会导致其他请求路径都失效,添加<mvc:annotation-driven>解决

11.2 重定向

  • 语法:return "redirect:/xxx.html";

11.3 加载静态资源

  • DefaultServlet加载静态资源到服务器
    • 静态资源:html、css、js等资源
    • tomcat->conf->web.xml关键代码如下:
<servlet>
        <servlet-name>default</servlet-name>
        <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
        <init-param>
            <param-name>debug</param-name>
            <param-value>0</param-value>
        </init-param>
        <init-param>
            <param-name>listings</param-name>
            <param-value>false</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
<servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
  • 发现问题
    • DispatcherServlet与DefaultServlet的URL配置均为:/,导致DispatcherServlet中的配置将DefaultServlet配置的/覆盖了【DefaultServlet失效,无法加载静态资源
  • 解决方案
<!--    解决静态资源加载问题-->
<mvc:default-servlet-handler></mvc:default-servlet-handler>
<!-- 添加上述标签,会导致Controller无法正常使用,需要添加mvc:annotation-driven解决 -->
<mvc:annotation-driven></mvc:annotation-driven>

11.4 源码解析重定向原理

  • 创建RedirectView对象【ThymeleafViewResolver的775行代码】
// Process redirects (HTTP redirects)
if (viewName.startsWith(REDIRECT_URL_PREFIX)) {
    vrlogger.trace("[THYMELEAF] View \"{}\" is a redirect, and will not be handled directly by ThymeleafViewResolver.", viewName);
    final String redirectUrl = viewName.substring(REDIRECT_URL_PREFIX.length(), viewName.length());
    final RedirectView view = new RedirectView(redirectUrl, isRedirectContextRelative(), isRedirectHttp10Compatible());
    return (View) getApplicationContext().getAutowireCapableBeanFactory().initializeBean(view, REDIRECT_URL_PREFIX);
}
  • RedirectView视图渲染
    • RedirectView对象URL处理【330行代码】

    • 执行重定向【RedirectView的627行代码】

第十二章 REST风格CRUD练习

12.1 搭建环境

● 导入相关jar包
● 编写配置文件
        ○web.xml
■CharacterEncodingFilter
■HiddenHttpMethodFilter
■DispatcherServlet
        ○springmvc.xml
■开启组件扫描
■装配视图解析器
■装配视图控制器
■解决静态资源加载问题
■装配annotation-driver
        ● dao&pojo

12.2 实现功能思路

● 实现添加功能思路
        a跳转添加页面【查询所有部门信息】
        b实现添加功能
● 实现删除功能思路
        a 方式一:直接使用表单实现DELETE提交方式
        b 方式二:使用超链接【a】实现DELETE提交方式
■ 使用Vue实现单击超链接,后提交对应表单
■ 取消超链接默认行为
■ 示例代码

HTML运行代码复制代码

<div align="center" id="app">
<a href="#" @click="deleteEmp">删除</a>
<form id="delForm" th:action="@{/emps/}+${emp.id}" method="post">
<input type="hidden" name="_method" value="DELETE">
</form>
</div>
<script type="text/javascript" src="static/js/vue_v2.6.14.js"></script>
<script type="text/javascript">
new Vue({
    el:"#app",
    data:{},
    methods:{
        deleteEmp(){
            alert("hehe");
            //获取响应表单
            var formEle = document.getElementById("delForm");
            formEle.submit();
            //取消超链接默认行为
            event.preventDefault();
        }
    }
});
</script>

网站公告

今日签到

点亮在社区的每一天
去签到