Spring MVC入门
Spring MVC 简介
背景分析
在大型软件系统设计时，业务一般会相对复杂，假如所有业务实现的代码都纠缠在一起，会出现逻辑不清晰、可读性差，维护困难，改动一处就牵一发而动全身等问题。为了更好解决这个问题就有了我们现在常说的分层架构设计。
MVC 是什么
MVC是一种软件架构设计思想,基于MVC架构将我们的应用软件进行分层设计和实现,例如可以分为视图层(View),控制层(Controller),模型层(Model),通过这样的分层设计让我们程序具备更好的灵活性和可可扩展性.因为这样可以将一个复杂应用程序进行简化,实现各司其职,各尽所能.比较适合一个大型应用的开发.
Spring MVC 概述
Spring MVC是MVC设计思想在Spring框架中的一种实现，基于这样的思想spring框架设计了一些相关对象，用于更好的基于MVC架构处理请求和响应，其简易架构如图所示：
其中：
1)DispatcherServlet是客户端所有请求处理的入口,负责请求转发。
2)RequestMapping负责存储请求url到后端handler对象之间的映射。
3)Handler 用于处理DispatcherServlet对象转发过来的请求数据。
4)ViewResolver负责处理所有Handler对象响应结果中的view。
Spring MVC 快速入门
准备工作
第一步：创建项目module，基本信息如图所示：
第二步：添加项目依赖(可以在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>第二步：启动服务器并直接进行访问测试,如图所示
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;@Controllerpublic 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/第三步：启动服务进行访问测试，如图所示：
第四步：访问过程中的BUG分析
第五步:thymeleaf页面缓存设置
假如我们希望在修改了页面内容以后，不重新启动服务，直接刷新即可看页面改动，可以执行如下操作：
修改配置文件内容，添加如下语句：
spring.thymeleaf.cache=false修改idea默认配置，允许自动编译，如图所示：
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;@Controllerpublic 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>第三步:启动项目进行访问测试,并检测输出结果,例如:
第四步:运行过程中的结果分析
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;@RestControllerpublic 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); } }第三步:启动服务器分别进行访问测试,代码如下:
第四步:启动或访问过程中的问题分析
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;@RestControllerpublic class ParamObjectController {}直接量方式
在ParamObjectController中添加方法,基于直接量方式接受客户端请求参数,例如:
@GetMapping("/doParam01")public String doMethodParam(String name){ return "request params " name;}访问时,可以这样传参,例如:
http://localhost/doParam01?name=beijingPOJO对象方式
定义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=beijingMap对象方式
有时候我们不想使用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