美文网首页
SpringMVC 入坑 (一)

SpringMVC 入坑 (一)

作者: jihe | 来源:发表于2018-01-07 20:10 被阅读0次

    概述

    SpringMVC 是包含在 Spring 框架中基于 Servlet API 构建的 Web 框架。在 MVC 「 Model-View-Control 」软件设计模式中, SpringMVC 框架处在 C 层,主要是将 Web 请求封装为一个数据对象,调用业务逻辑层来处理数据对象,返回处理后的数据结果和对应的视图给用户。SpringMVC 前端核心控制器是 DispatcherServlet, 像其他的 Servlet 一样,需要在 web.xml文件中进行配置,相较于 Struts2, SpringMVC 更好的和 Spring 进行整合。

    小程序

    1. 搭建环境
      Spring 官网 下载相应的架包,使用 SpringMVC 实现一个 HelloWorld! 至少需要的包有:
    • spring-aop-4.2.4.RELEASE.jar 「 和AOP 编程相关的包 」
    • spring-beans-4.2.4.RELEASE.jar 「 和操作 bean 相关的包 」
    • spring-context-4.2.4.RELEASE.jar 「 运行时上下文,包括调度和远程调用抽象 」
      -spring-core-4.2.4.RELEASE.jarSpring 核心包 」
    • spring-web-4.2.4.RELEASE.jarWeb 核心包 」
      -spring-webmvc-4.2.4.RELEASE.jarWeb 层的一个具体实现包,DispatcherServlet 位于此包中 」
    • commons-logging-1.1.1.jarapache 的日志包 」
    • spring-expression-4.2.4.RELEASE.jarSpring 表达式语言 」
    1. 配置web.xml文件
    
        <?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>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>
          
            <!-- 配置DisptcherServlet -->
            <servlet>
                <servlet-name>springMVC</servlet-name>
                <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
                <!-- 配置加载时间,在 tomcat 启动时加载 -->
                <load-on-startup>1</load-on-startup>
            </servlet>
          
            <servlet-mapping>
                <servlet-name>springMVC</servlet-name>
                <url-pattern>*.do</url-pattern>
            </servlet-mapping>
        </web-app>
    
    1. 配置 springMVC-servlet.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:p="http://www.springframework.org/schema/p"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:dubbo="http://code.alibabatech.com/schema/dubbo" xmlns:mvc="http://www.springframework.org/schema/mvc"
        xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
            http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
            http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd
            http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd">
        
        <bean id="simpleUrlHandlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
            <property name="mappings">
                <props>
                    <prop key="/helloWorld.do">helloWorld</prop>
                </props>
            </property>
        </bean>
        
        <bean id="helloWorld" class="com.jihe.controller.HelloWorldController"/>
    </beans>
    
    
    • 注意:「 springMVC 」-servlet.xml文件,其中方括号中的名称在没有指定的情况下对应的是web.xml 文件中的 <servlet-name>springMVC</servlet-name>配置的名称,不然会报错,加载不到文件。
    1. HelloWorldController 编写
        public class HelloWorldController implements Controller {
            @Override
            public ModelAndView handleRequest(HttpServletRequest arg0,
                    HttpServletResponse arg1) throws Exception {
                //ModelAndView对象包含数据和视图,返回 hello.jsp,并在页面可以获取 message 中包含的数据
                ModelAndView mv = new ModelAndView("hello.jsp");
                mv.addObject("message", "HelloWorld!");
                return mv;
            }
          }
    
    1. 编写 hello.jsp,放在webRoot 目录下
    <body>
        你好 SPRINGMVC 
        <br/>
        ${message }
      </body>
    
    1. 在浏览器访问

    地址 http://localhost:8080/springMVC/helloWorld.do 一切正常的话会在页面显示到内容。

    小结

    将以上程序部署在 tomcat 上,当启动tomcat后,项目中 web.xml 文件会被加载,随后配置在 web.xml 中的 DispachterServlet 也会被加载,随后 springMVC-servlet.xml 文件也会被加载。当访问 ../hellWorld.do 时,前端控制 DispachterServlet器配合配置文件,将请求分发给对应的控制器 HelloWorldController 来处理。处理完成之后,将数据封装ModelAndView对象,返回给对应的页面。


    优化

    通过上面的入门小程序也了解了 SpringMVC 的大致访问过程。但是还有很多不太方便的地方, 比如不把 springMVC-servlet 放在 WEB-INF 下程序会报找不到此文将的错误,而且名字前半部分必须和在 web.xml 中配置的一样等等,下面是对上面的一些小改进。

    1. 加载 springMVC-servlet.xml

    web.xml 加载前端控制器时,以初始化参数的形式加载 springMVC-servlet.xml ,这里在 src 同等目录下创建 source folder 类型的 config 目录, 将 springMVC-servlet.xml 改名为 springMVC.xml 放在此目录下。「这里时处于习惯改掉名称,只要在加载时名称一致就可以, source folder 类型的目录下所有的文件编译后会放在类路径 src 下」,改进后代码如下:

    <!--省略相同的头尾-->
    <!-- 配置DisptcherServlet -->
      <servlet>
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 改进1:直接在加载前端控制器的时候加载springMVC.xml -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springMVC.xml</param-value>
        </init-param>
        <!-- 配置加载时间,在 tomcat 启动时加载 -->
        <load-on-startup>1</load-on-startup>
      </servlet>
    
    1. 修改后的 springMVC.xml ,也就是之前的 springMVC-servlet.xml

    首先注释掉之前的所有配置。只留下约束文件信息。

        <!-- 改进1:通过包扫描的方式来找到有@Controller注解的后端控制器,下面包下面的所有类都会扫描 -->
        <context:component-scan base-package="com.jihe.controller"/>
        
        <!-- 注解驱动: 自动加载最新的处理器映射器和处理器适配器,也就是处理@RequestMapping注解中的路径映射 -->
        <mvc:annotation-driven/>
        
        <!-- 配置视图解析器 :在 `ontroller` 中指定页面路径的时候就省略完整路径名称,和页面的后缀名,这里对比下面 `HelloWorldController` 中的内容不难得出结论-->
        <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <!-- 前缀路径:配置之后,在后端控制器中就可以省略不写这个路径,直接写此路径下的页面名称 -->
            <property name="prefix" value="/WEB-INF/jsp/"></property>
            <!-- 后缀名称:配置之后就可以直接写页面前部分名称,后面的 `.jsp` 后缀就省略不写了 -->
            <property name="suffix" value=".jsp"></property>
        </bean>
    
    1. 最后是后端控制器 HelloWorldController 的内容改进

    后端控制器是普通的 java 类,不继承任何类,也不实现任何接口
    首先将之前控制器继承的类和覆盖的方法注释掉。

    package com.jihe.controller;
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.servlet.ModelAndView;
    /**
     * 后端控制器
     */
    @Controller
    public class HelloWorldController {
        //改进1:通过注解@RequestMapping来指定此方法的访问路径,一般采用的时这种方式。
        @RequestMapping("/hello")
        public ModelAndView hello(){
            ModelAndView mv = new ModelAndView();
            mv.addObject("message", "HelloSpring");
            mv.setViewName("hello");
            return mv;
        }
    }
    
    1. 访问

    在浏览器输入 http://localhost:8080/springMVC/hello.do 访问项目。返回之前的页面,说明配置成功,当然,如果觉得 .do 结尾很不舒服,何以在 web.xml 中配置
    <url-pattern>/</url-pattern> 在访问时就可以不写后面的 .do 了。

    小结

    在后面的改进中使用注解的方式是比较多的, 通过 web.xml 中初始化配置加载类路径下的 springMVC 核心配置文件 springMVC.xml ,在 springMVC.xml 中配置了@Controller注解,来自动扫描相应包下面的后端控制器,配置了处理@RequestMaooing注解中路径的注解驱动,以及方便后端控制器返回页面数据时路径写法的视图解析器。最后,改进了控制器,使其变的更加简洁,和方便理解。

    相关文章

      网友评论

          本文标题:SpringMVC 入坑 (一)

          本文链接:https://www.haomeiwen.com/subject/dltynxtx.html