SpringBoot工程下的Spring-MVC应用

头像
亮亮
    阅读 7 分钟

    Spring MVC 简介

    背景分析

    在大型软件系统设计时，业务一般会相对复杂，假如所有业务实现的代码都纠缠在一起，会出现逻辑不清晰、可读性差，维护困难，改动一处就牵一发而动全身等问题。为了更好解决这个问题就有了我们现在常说的分层架构设计。

    MVC 是什么

    MVC是一种软件架构设计思想,基于MVC架构将我们的应用软件进行分层设计和实现,例如可以分为视图层(View),控制层(Controller),模型层(Model),通过这样的分层设计让我们程序具备更好的灵活性和可可扩展性.因为这样可以将一个复杂应用程序进行简化,实现各司其职,各尽所能.比较适合一个大型应用的开发.

    Spring MVC 概述

    Spring MVC是MVC设计思想在Spring框架中的一种实现，基于这样的思想spring框架设计了一些相关对象，用于更好的基于MVC架构处理请求和响应，其简易架构如图所示：

    image.png

    其中：
    1)DispatcherServlet是客户端所有请求处理的入口,负责请求转发。
    2)RequestMapping负责存储请求url到后端handler对象之间的映射。
    3)Handler 用于处理DispatcherServlet对象转发过来的请求数据。
    4)ViewResolver负责处理所有Handler对象响应结果中的view。

    Spring MVC 快速入门

    准备工作

    第一步：创建项目module，基本信息如图所示：

    image.png

    第二步：添加项目依赖(可以在module创建时，也可以创建后)，代码如下：

    Spring Web 依赖(提供了spring mvc支持并且会嵌入一个tomcat)

    <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-web</artifactId>
</dependency>

    Thymeleaf 依赖(提供了以html作为页面模板进行解析和操作的相关对象）

    <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

    第三步：启动项目检测控制台启动状态是否OK

    static 目录分析及应用

    static 目录为springboot工程创建时添加了web依赖以后自动创建的目录，此目录中可以存储html、css、js、image，这些资源可以在启动服务器以后，直接在浏览器进行访问。例如：
    第一步：在static目录下创建一个index.html页面，代码如下：

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
   <h1>The First Html Page</h1>
</body>
</html>

    第二步：启动服务器并直接进行访问测试,如图所示

    image.png

    templates 目录分析及应用

    templates 目录为springboot工程创建时添加了thymeleaf依赖以后自动创建的目录，此目录中要存储一些html模板，这个模板页面不能直接通过浏览器url进行访问，需要基于后端控制器，在方法中定义页面响应，例如：

    第一步：定义TemplateController及方法，代码如下：

    package com.cy.pj.health.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class TemplateController {
      @RequestMapping("doTemplateUI")
      public String doTemplateUI(){
         return "default";
      }
}

    第二步：在templates目录中定义模板页面default.html，代码如下：

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>The Default Template page</h1>
</body>
</html>

    其中,假如default.html要在放在templates子目录中,则还需要在配置文件中配置thymeleaf的前缀,例如:

    spring.thymeleaf.prefix=classpath:/templates/module/

    第三步：启动服务进行访问测试，如图所示：

    image.png

    第四步：访问过程中的BUG分析

    image.png

    image.png

    image.png

    第五步:thymeleaf页面缓存设置
    假如我们希望在修改了页面内容以后，不重新启动服务，直接刷新即可看页面改动，可以执行如下操作：
    修改配置文件内容，添加如下语句：

    spring.thymeleaf.cache=false

    修改idea默认配置，允许自动编译，如图所示：
    image.png

    image.png

    SpringMVC 响应数据处理

    ModelAndView 应用

    我们有一业务,现在需要将响应数据封装到ModelAndView对象,然后响应到客户端,如何实现呢?

    第一步:定义ModelViewController以及方法,代码如下:

    package com.cy.pj.module.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class ModelViewController {
    @RequestMapping("/doModelAndView")
    public String doModelAndView(Model model) {
        model.addAttribute("username", "jason");
        model.addAttribute("state", true);
        return "view";
    }
}

    第二步:在templates相关目录下定义view.html，并在页面中添加呈现数据的代码,例如:

     <div>
    <ul>
        <li>username:[[${username}]]</li>
        <li>state:[[${state}]]</li>
    </ul>
</div>

    第三步:启动项目进行访问测试,并检测输出结果,例如:

    image.png

    第四步:运行过程中的结果分析

    image.png

    JSON数据响应

    我们有一业务不需要页面,只需要将响应数据转换为json,然后响应到客户端,如何实现呢?
    第一步:定义ResponseResult对象用于封装响应数据,例如:

    package com.cy.pj.module.pojo;
public class ResponseResult {
    private Integer code;
    private String message;
    public Integer getCode() {
        return code;
    }
    public void setCode(Integer code) {
        this.code = code;
    }
    public String getMessage() {
        return message;
    }
    public void setMessage(String message) {
        this.message = message;
    }
}

    第二步:定义JsonObjectController以及方法,代码如下:

    package com.cy.pj.module.controller;

@RestController
public class JsonObjectController {

    @RequestMapping("/doConvertResponseToJson")
    public ResponseResult doConvertResponseToJson(){
        ResponseResult rs=new ResponseResult();
        rs.setCode(200);
        rs.setMessage("OK");
        return rs;
    }
    
    @RequestMapping("/doConvertMapToJson")
    public Map<String,Object> doConvertMapToJson(){
        Map<String,Object> map=new HashMap<>();
        map.put("username","刘德华");
        map.put("state",true);
        return map;
    }
    
    @RequestMapping("/doPrintJSON")
    public void doPrint(HttpServletResponse response)throws Exception{
        Map<String,Object> map=new HashMap<>();
        map.put("username","刘德华");
        map.put("state",true);
        //将map中的数据转换为json格式字符串
        ObjectMapper om=new ObjectMapper();
        String jsonStr=om.writeValueAsString(map);
        System.out.println("jsonStr="+jsonStr);
        //将字符串响应到客户端
        //设置响应数据的编码
        response.setCharacterEncoding("utf-8");
        //告诉客户端,要向它响应的数据类型为text/html,编码为utf-8.请以这种编码进行数据呈现
        response.setContentType("text/html;charset=utf-8");
        PrintWriter pw=response.getWriter();
        pw.println(jsonStr);
    }
    
}

    第三步:启动服务器分别进行访问测试,代码如下:

    image.png

    第四步:启动或访问过程中的问题分析

    image.png

    image.png

    SpingMVC 请求参数数据处理

    我们在执行业务的过程中通常会将一些请求参数传递到服务端,服务端如何获取参数并注入给我们的方法参数的呢?

    准备工作

    定义一个controller对象,用户处理客户端请求,例如:

    package com.cy.pj.module.controller;
import com.cy.pj.module.pojo.RequestParameter;
import org.springframework.web.bind.annotation.*;
import java.util.Map;
@RestController
public class ParamObjectController {}

    直接量方式

    在ParamObjectController中添加方法,基于直接量方式接受客户端请求参数,例如:

    @GetMapping("/doParam01")
public String doMethodParam(String name){
 return "request params "+name;
}

    访问时,可以这样传参,例如:

    http://localhost/doParam01?name=beijing

    POJO对象方式

    定义pojo对象,用于接受客户端请求参数,例如:

    package com.cy.pj.module.pojo;
public class RequestParameter {
    private String name;
    //......
 public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    @Override
 public String toString() {
        return "RequestParam{" +
                "name='" + name + ''' +
                '}';
    }
}

    定义Controller方法,方法中使用pojo对象接收方法参数,例如:

    @RequestMapping("/doParam02")
public String doMethodParam(RequestParameter param){//pojo对象接收请求参数,pojo对象中需提供与参数名相匹配的set方法
 return "request params "+param.toString();
}

    启动服务进行访问测试,可以这样传参,例如:

    http://localhost/doParam02?name=beijing

    Map对象方式

    有时候我们不想使用pojo对象接收请求参数,我们可以使用map对象来接收,又该如何实现呢?

    定义Controller方法,基于map对象接收请求参数,例如:

    @GetMapping("/doParam03")
public String doMethodParam(@RequestParam Map<String,Object> param){
 return "request params "+param.toString();
}

    其中,map接收请求参数,必须使用@RequestParam对参数进行描述.

    启动服务进行访问测试,可以这样传参,例如:

    http://localhost/doParam03?name=beijing

    总结(Summary)

    本章节对springboot工程下spring mvc技术的应用做了一个入门实现,并结合实际项目中的业务应用,讲解了MVC中请求数据的获取和响应数据处理的一个基本过程.

    springboot

    javaspringbootspring-mvc
    亮亮
    4 声望1 粉丝

    学而要所获，必然明其理，知其然。

    « 上一篇
    Spring整合Mybatis框架
    下一篇 »
    Spring、Mybatis、SpringBoot、以Spring-MVC设计思想整合实现CRUD操作

    引用和评论

    推荐阅读
    头像
    javaScript的for of和for in 的区别总结

    亮亮阅读 1.2k

    头像
    在Java程序中监听mysql的binlog

    huan1993赞 11阅读 2k

    头像
    Jerry和您聊聊Chrome开发者工具

    注销赞 9阅读 4.5k评论 3

    头像
    Bitmap 和 布隆过滤器傻傻分不清？你这不应该啊

    程序员小富赞 8阅读 1.6k评论 1

    头像
    Just for fun——迅速写完快速排序

    ufdf赞 3阅读 2.6k

    头像
    Spring 实现 3 种异步流式接口，干掉接口超时烦恼

    程序员小富赞 5阅读 1.7k

    头像
    状态码 406， Not Acceptable, (Spring Boot)

    zZ_jie赞 4阅读 734

    0 条评论
    得票最新