day01-SpringMVC基本介绍

SpringMVC介绍

1.离线文档

解压 spring-5.3.8-dist.zip文件。

位置：spring-framework-5.3.8/docs/reference/html/web.html#spring-web

2.SpringMVC基本介绍

2.1SpringMVC特点&概述

SpringMVC 从易用性，效率上都比曾经流行的 Struts2 更好
SpringMVC 是 WEB 层框架：SpringMVC接管了 web层组件，比如控制器，视图，视图解析，返回给用户的数据格式，同时支持 MVC 的开发模式/开发架构
SpringMVC 通过注解，让 POJO 成为控制器，不需要继承类或者实现接口
SpringMVC 采用低耦合的组件设计方式，具有更好的拓展和灵活性
支持 REST 格式的 URL 请求
SpringMVC 是基于 Spring 的，它的核心包为 spring-webmvc-xxx.jar 和 spring-web-xxx.jar

2.2Spring SpringMVC SpringBoot的关系

SpringMVC 只是 Spring 处理 WEB 层的一个模块/组件，SpringMVC 的基石是 Servlet
SpringBoot 是为了简化开发者的使用而推出的一个框架（约定优于配置，简化了Spring的配置流程），它包含很多组件/框架，Spring 就是最核心的内容之一，也包含了 SpringMVC
三者之间的关系是：Spring Boot > Spring > SpringMVC

3.SpringMVC的快速入门

3.1需求说明

需求说明：使用SpringMVC，完成一个最基本的测试案例——登录案例

3.2SpringMVC登录流程分析

3.3代码实现

创建Java项目，添加 web支持并配置 tomcat
导入SpringMVC 开发需要的jar包
src目录下创建spring的容器文件applicationContext-mvc.xml（名称随意）

在WEB-INF/web.xml文件中配置前端控制器（中央控制器）

<!--配置前端控制器/中央控制器/分发控制器，负责处理所有的应用请求-->
<servlet>
    <servlet-name>springDispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
   <!--配置属性 contextConfigLocation,指定 DispatcherServlet 去操作的 spring容器配置文件-->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext-mvc.xml</param-value>
    </init-param>
    <!--在web项目启动时，就自动的加载 DispatcherServlet实例，1表示加载的顺序号-->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>springDispatcherServlet</servlet-name>
    <!--1.配置的url-pattern为 /，表示用户的请求都经过 DispatcherServlet
        2.这样配置也支持 rest 风格的url请求-->
    <url-pattern>/</url-pattern>
</servlet-mapping>

web目录下创建login.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>登录</title>
</head>
<body>
<h3>登录页面</h3>
<%--
    action="login": 这样写实际上是相对路径，而相对路径是以当前的浏览器地址栏而言。
    因此实际上这里表示的 url 是 http://localhost:8080/web工程路径/login
--%>
<form action="login">
    u:<input name="username" type="text"/> <br/>
    p:<input name="password" type="password"/> <br/>
    <input type="submit" value="登录"/>
</form>
</body>
</html>

关于web工程路径，详见 Javaweb--day18-web工程路径

创建 src/com/li/web/UserServlet.java

package com.li.web;

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

/**
 * @author 李
 * @version 1.0
 * 1.如果我们使用了SpringMVC，在一个类上标识 @Controller
 * 2.表示将该类视为一个控制器，注入到容器
 * 3.比原生的 servlet方便很多
 */
@Controller
public class UserServlet {
    /**
     * 编写login方法，响应用户请求
     * 1.login()方法用于响应用户的登录请求
     * 2.@RequestMapping(value = "/login")
     *    类似于我们原生的Servlet配置的url-pattern，不同的是这里是给方法配置url映射
     * 3.当用户在浏览器地址栏输入 http://localhost:8080/web工程路径/login
     *    就能够访问当到 login()方法
     * 4.return "login_ok"; 表示返回结果给视图解析器（InternalResourceViewResolver），
     *    视图解析器会根据配置，来决定提交到哪一个页面，如：
     * <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
     *    <property name="prefix" value="/WEB-INF/pages/"/>
     *    <property name="suffix" value=".jsp"/>
     * </bean>
     * 根据上面的配置，return "login_ok"; 就是转发到 /WEB-INF/pages/login_ok.jsp
     *
     * @return
     */
    @RequestMapping(value = "/login")
    public String login() {
        System.out.println("login ok...");
        return "login_ok";
    }
}

创建web/WEB-INF/pages/login_ok.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>登录成功</title>
</head>
<body>
<h1>恭喜，登录成功！</h1>
</body>
</html>

配置容器文件applicationContext-mvc.xml

<!--指定扫描的包-->
<context:component-scan base-package="com.li.web"/>

<!--配置视图解析器-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <!--配置属性 suffix(后缀) 和 prefix(前缀)-->
    <property name="prefix" value="/WEB-INF/pages/"/>
    <property name="suffix" value=".jsp"/>
</bean>

整体的文件位置如下：
启动tomcat，访问 http://localhost:8080/springmvc/login.jsp，访问成功：
点击登录，成功访问到login_ok.jsp

3.4注意事项和细节说明

这里的UserServlet 需要注解成一个@Controller，我们称之为一个Handler处理器
在UserServlet 指定 url 时，value 可以省略（注意是省略“value”字符，不是省略值）
关于SpringMVC 的 DispatcherServlet 的配置文件，如果不在web.xml中指定spring配置文件，则默认在/WEB-INF/目录下找名为 springDispatcherServlet-servlet.xml 的spring配置文件。

因此，我们将之前的spring容器文件移动到/web-INF/目录下，并注释掉web.xml配置的<init-param>，然后将容器文件重命名为 springDispatcherServlet-servlet.xml，重启tomcat，依然可以成功运行。