2、SpringMVC入门实例

学习资源:动力节点的2020最新SpringMVC教程【IDEA版】-springmvc从入门到精通



入门实例

需求:用于在页面发起一个请求,请求结果是结果页面显示一个 hello SpringMVC

1、创建 maven web 工程

image-20200903174627443


2、maven依赖

springmvc的依赖包含了spring的依赖

<dependency>
  <groupId>javax.servlet</groupId>
  <artifactId>javax.servlet-api</artifactId>
  <version>4.0.1</version>
</dependency>
<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-webmvc</artifactId>
  <version>5.2.5.RELEASE</version>
</dependency>

3、注册 DispatcherServlet 中央调度器

在 web.xml 中注册 springmvc 框架的核心对象 DispatcherServlet

  • DispatcherServlet 叫做中央调度器, 是一个servlet, 它的父类继承 HttpServlet
  • DispatcherServlet 也叫称为 前端控制器(front controller)
  • DispatcherServlet 负责接收用户提交的请求,然后调用其它的控制器对象,把请求的处理结果显示给用户

3.1、配置<load-on-startup/>

在 <servlet/> 中添加 <load-on-startup/> 的作用是,标记是否在 Web 服务器(这里是Tomcat)启动时会创建这个 Servlet 实例,即是否在 Web 服务器启动时调用执行该 Servlet 的 init() 方法,而不是在真正访问时才创建。

它的值必须是一个整数。

  • 当值大于等于 0 时,表示容器在启动时就加载并初始化这个 servlet,数值越小,该 Servlet 的优先级就越高, 其被创建的也就越早;
  • 当值小于 0 或者没有指定时,则表示该 Servlet 在真正被使用时才会去创建。
  • 当值相同时,容器会自己选择创建顺序

3.2、配置<url-pattern/>

配置 servlet-mapping ,即 请求 $-->$ servlet 的映射关系 ,请求分配给哪个 servlet 处理。

对于 <url-pattern/> ,可以写为 / ,表示所有请求由一个 servlet 处理;但是建议写为 .do、.action、*.mvc 等形式。


3.3、配置文件位置与名称

注册完毕后,可直接在服务器上发布运行。此时,访问浏览器页面,控制台均会抛出 FileNotFoundException 异常。即默认要从项目根下的 WEB-INF 目录下找名称为 Servlet 名称-servlet.xml 的配置文件。这里的 "Servlet 名称"指的是注册中央调度器 <servlet-name/> 标签中指定的 Servlet 的 name 值。本例配置文件名为 springmvc-servlet.xml。

image-20200903213313407

而一般情况下, 配置文件是放在类路径下,即 resources 目录下。所以,在注册中央调度器时,还需要为中央调度器设置查找 SpringMVC 配置文件路径及文件名。

<servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    
    <!--自定义springmvc读取配置文件的位置-->
    <init-param>
        <!--springmvc的配置文件的位置属性-->
        <param-name>contextConfigLocation</param-name>
        <!--指定自定义文件的位置及文件名-->
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    
    <load-on-startup>1</load-on-startup>
</servlet>

<!--
            使用框架的时候, url-pattern可以使用两种值
            1. 使用扩展名方式, 语法 *.xxxx , xxxx是自定义的扩展名。 常用的方式 *.do, *.action, *.mvc等等
               不能使用 *.jsp
               http://localhost:8080/myweb/some.do
               http://localhost:8080/myweb/other.do

            2.使用斜杠 "/"
-->
<servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>*.do</url-pattern>
    <url-pattern>*.action</url-pattern>
</servlet-mapping>

服务器在启动后, DispatcherServlet 就要被创建,然后 DispatcherServlet 要读取 springmvc 配置文件进而创建 springmvc 容器对象,并把容器放到 ServletContext 中(全局作用域)。

springmvc 容器又会读取 springmvc 配置文件创建控制器对象放到容器中。

springmvc 配置文件默认是 /WEB-INF/<DispatcherServlet的名字>-servlet.xml,默认固定路径和命名,但是可自定义修改。


4、创建发起请求的页面

可以直接修改并使用 index.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>首页</title>
</head>
<body>
<p>第一个springmvc项目</p>
<p><a href="some.do">发起some.do的请求</a> </p>
<p><a href="other.do">发起other.do的请求</a> </p>
</body>
</html>

5、创建控制器

在类上与方法上添加相应注解即可。

  1. 在类的上面使用 @Controller 注解,作用是为该类创建一个实例对象,并将其加入到 springmvc 的容器中
  2. 在类的方法上面使用 @RequestMapping 注解,表示当前方法为处理器方法。
    被注解的方法要对 value 属性所指定的 URI 进行处理与响应。被注解的方法的方法名可以随意定义。
    若有多个请求路径均可匹配该处理器方法的执行,则@RequestMapping 的 value 属性中可以写一个 String 数组。
    该注解可以使用在方法上或类上,一般用在方法上。

注解方法的定义要求:

  1. 方法是自定义的,名称自定义
  2. 可以有多个参数(限定类型)
  3. 可以有多种返回值类型(限定类型)

ModelAndView:返回值,表示请求处理后的 数据+视图,底层是是一个 HashMap<String, Object>,

  • Model:数据,表示请求处理完成后回显给用户的数据
  • View:视图,如 jsp 页面

Model 中的数据存储在 request 作用域中, SringMVC 默认采用 转发 的方式跳转到视图,本次请求结束后,模型中的数据被销毁。

@Controller
public class FirstController {

    @RequestMapping({"/some.do"})
    public ModelAndView doSome(){
        // 业务

        ModelAndView mv = new ModelAndView();
        mv.addObject("msg", "hello,springmvc");
        mv.addObject("fun", "用起来真方便");
        
        mv.setViewName("show");

        return mv;
    }
}

6、创建请求返回结果的页面

通常我们将,除了首页之外的其他动态资源都放在 /WEB-INF/ 下(静态资源在 webapp 下),因为这个路径下的资源,客户端是无法访问的,只能由服务端转发访问,这样可以保护资源。

创建 show.jsp 用于显示请求的处理结果

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>show页面</title>
</head>
<body>
<h2>/WEB-INF/view/show.jsp,显示返回数据</h2>
<h3>msg数据:${msg}</h3>
<h3>msg数据:${fun}</h3>
</body>
</html>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>other页面</title>
</head>
<body>
<h2>/WEB-INF/other.jsp,显示返回数据</h2>
<h3>msg数据:${msg}</h3>
<h3>msg数据:${fun}</h3>
</body>
</html>

7、创建 springmvc 的配置文件

springmvc-xml

7.1、声明组件扫描器

扫描指定包下的 @Controller 注解

<context:component-scan base-package="com.chen.controller"/>

7.2、声明视图解析器

用于帮助开发人员设置视图文件的路径,SpringMVC 框架为了避免对于请求资源路径与扩展名上的冗余,在视图解析器
InternalResouceViewResolver 中引入了请求的前辍与后辍。而 ModelAndView 中只需给出要跳转页面的文件名即可,对于具体的文件路径与文件扩展名,视图解析器会自动完成拼接。

<!--  注册视图解析器  -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <!--    前缀:表示试图所在的路径    -->
    <property name="prefix" value="/WEB-INF/view/"/>
    <!--    后缀:表示视图文件的扩展名    -->
    <property name="suffix" value=".jsp"/>
</bean>

8、测试

部署运行 Tomcat

posted @ 2020-09-06 17:27  卡文迪雨  阅读(149)  评论(0编辑  收藏  举报