前后端数据交互，跳转
- 2019 年 10 月 3 日
- 笔记
概述
作为一枚菜鸟，前后端交互可是大问题，经常数据交互失败，不知道怎么跳转。在这分享一下交互的小心得。
我们不妨先大概了解一下整个访问流程：
用户从输入网址按下回车，交互就已经开始了。
浏览器会将请求按照http协议（或者其他https，ftp等）将请求数据封装包从电脑的端口发出 -> 路由器 -> 运营商（域名解析之类的）-> 目标服务器（可能会有代理，负载均衡等等）
最终从服务器开放的端口，进入到服务器（TCP三次握手和四次挥手，Tomcat之类的，会根据协议的内容进行解析）-> web项目进行具体的逻辑处理 -> 返回数据 -> 浏览器接收数据（根据协议内容进行解析）
整个过程，协议很重要，因为客户端和服务器都是通过协议来解析和发送信息的，最常见的http协议，协议头部的参数常用的哪几个，有什么影响。
Http协议的简介，说的很有意思：https://blog.csdn.net/u010256388/article/details/68491509/
还有缓存问题（cookie、session、localstorage、cashe-controller等），不仅提高效率，而且有时候你更改了代码测试却没变化的重要原因：https://www.jianshu.com/p/9ed3e8759ce3
相应的后台tomcat的缓存处理：http://www.360doc.com/content/17/0721/17/41344223_673116604.shtml（了解即可）
具体到使用分为：前端交互，分为同步和异步。
同步交互
常见的from表单提交（post方式带参数），URL直接访问（get方式，有参数在地址栏可见，特殊符号需要转义，不安全）。
异步交互
关键是XMLHttpRequest对象，平时说的ajax只是一种交互模式，并不是什么新技术，其原理就是对XMLHttpRequest的封装。所以对XMLHttpRequest深入全面的了解可以帮助我们更好的掌握异步交互。
可以看这篇精品文章了解：https://www.jianshu.com/p/b037f71af548，里面涉及到了在传送过程中各个参数的用法，会触发的事件，返回值等等很实用的知识。（虽然能设置同步交互，但不推荐）
其中传输类型 contentType就非常重要，这个值设置决定了后台怎么去解析http协议。
- 上图所示，如果格式前后端发送和接收对不上，那是获取不了数据。如图的最后一步返回，如果想页面跳转，则不需要@ResponseBody，改为返回ModelAndView
- @RequestBody主要用来接收前端传递给后端的json字符串中的数据的(请求体中的数据的)；GET方式无请求体，所以使用@RequestBody接收数据时，前端不能使用GET方式提交数据，而是用POST方式进行提交。
- @RequestParam接收的是key-value里面的参数，所以GET方式的数据和表单提交，可以接收。
- @RequestBody和@RequestParma的使用知识，更轻松的全面掌握：https://blog.csdn.net/justry_deng/article/details/80972817
前端交互类
前端我创建了两个工具类，来负责交互。
异步交互类
我把jQuery的ajax进行了封装，主要是获取和计算信息，代码如下：
1 /* 2 * 以下为程序错误码 3 */ 4 //通用的请求失败，包括未知原因 5 var EXPECTATION_FAILED = 417; 6 var EXPECTATION_QUERY = 404; 7 8 /** 9 * 访问后台的对象，为ajax封装 10 * @constructor 11 */ 12 var Query = function (url, param, callback, contentType) { 13 this.url = url; 14 15 //先确认参数存在，如果不存在则创建空map 16 if (!param) { 17 param = new Map(); 18 } 19 //注意，要根据不同的传输格式来确定传输的值的类型 20 if (contentType == Query.NOMAL_TYPE) { 21 this.param = JSON.parse(this._convertParam(param)); 22 } else { 23 this.param = this._convertParam(param); 24 } 25 26 27 this.callback = callback; 28 this.contentType = contentType; 29 //请求超时，默认5秒 30 this.timeout = 5000; 31 //是否异步请求，默认异步 32 this.async = true; 33 } 34 35 Query.JSON_TYPE = 'application/json'; 36 Query.NOMAL_TYPE = 'application/x-www-form-urlencoded'; 37 38 /** 39 * ajax请求的访问 40 * @param url 要访问的地址 41 * @param paramMap 传给后台的Map参数，key为字符串类型 42 * @param callback 回调函数 43 * @param contentType 传输数据的格式 默认传输application/x-www-form-urlencoded格式 44 */ 45 Query.create = function (url, paramMap, callback) { 46 return new Query(url, paramMap, callback, Query.NOMAL_TYPE); 47 } 48 49 Query.createJsonType = function (url, paramMap, callback) { 50 return new Query(url, paramMap, callback, Query.JSON_TYPE); 51 } 52 53 /** 54 * 将ParamMap转为json格式，目前只支持Map对象，以后会扩展 55 * @param paramMap 56 * @private 57 */ 58 Query.prototype._convertParam = function (param) { 59 60 if (param instanceof Map) { 61 return strMap2Json(param); 62 } 63 } 64 65 /** 66 * 对ajax回调函数的封装 67 * @param callBack 68 * @private 69 */ 70 Query.prototype._callback = function (queryResult) { 71 72 //取消加载框 73 if (this.loadDom) { 74 $(this.loadDom).remove("#loadingDiv"); 75 } 76 77 //Query对象 78 var self = queryResult.queryObj; 79 var data = $.parseJSON(queryResult.responseText); 80 //记录请求是否有错误 81 self.queryException = false; 82 var handleError; 83 84 if (queryResult.status == EXPECTATION_FAILED || queryResult.status == EXPECTATION_QUERY) { 85 var error = queryResult.responseText; 86 self.queryException = true; 87 } 88 89 //调用回调函数，如果返回结果为true，则对于出错不会默认错误处理 90 if (self.callback instanceof Function) { 91 handleError = self.callback(data); 92 } 93 94 //如果出现了异常并且没有被处理，那么将进行默认错误处理 95 if (self.queryException && !handleError) { 96 window.location.href = "/system/error/" + error.code + "/" + error.msg; 97 } 98 99 //如果需要跳转，则进行跳转 100 if (data.redirect_url) { 101 window.location.href = data.redirect_url; 102 } 103 } 104 105 /** 106 * 正式发送ajax 107 * @private 108 */ 109 Query.prototype.sendMessage = function () { 110 var self = this; 111 var xhr = $.ajax( 112 { 113 type: "post", 114 url: this.url, 115 contentType: this.contentType, 116 data: this.param, 117 // ajax发送前调用的方法，初始化等待动画 118 // @param XHR XMLHttpRequest对象 119 beforeSend: function (XHR) { 120 //绑定本次请求的queryObj 121 XHR.queryObj = self; 122 if (self.beforeSendFunc instanceof Function) { 123 self.beforeSendFunc(XHR); 124 } 125 126 if (self.loadDom instanceof HTMLElement) { 127 self.loadDom.innerText = ""; 128 $(self.loadDom).append("<div id='loadingDiv' class='loading'><img src='/image/loading.gif'/></div>"); 129 } else if (self.loadDom instanceof jQuery) { 130 self.loadDom.empty(); 131 self.loadDom.append("<div id='loadingDiv' class='loading'><img src='/image/loading.gif'/></div>"); 132 } 133 }, 134 complete: this._callback, 135 timeout:this.timeout, 136 async:this.async 137 } 138 ); 139 140 } 141 142 /** 143 * 检测是否有错误,返回ture有错误，或者false 144 */ 145 Query.prototype.checkEception = function () { 146 return this.queryException; 147 } 148 149 //------------------------以下为对Query的参数设置--------------------------- 150 /** 151 * 在ajax发送前设置参数，可以有加载的动画，并且请求完成后会自动取消 152 * @param loadDom 需要显示动画的dom节点 153 * @param beforeSendFunc ajax发送前的自定义函数 154 */ 155 Query.prototype.setBeforeSend = function (loadDom, beforeSendFunc) { 156 this.loadDom = loadDom; 157 this.beforeSendFunc = beforeSendFunc; 158 } 159 160 /** 161 * 设置超时时间 162 * @param timeout 163 */ 164 Query.prototype.setTimeOut = function (timeout) { 165 this.timeout = timeout; 166 } 167 168 Query.prototype.setAsync = function (async) { 169 this.async = async; 170 }
封装的好处：
- 可以省略很多重复的代码，如$.ajax传参数那一长串（111-136行）
- 可以规定统一的前端交互流程，并且修改这个流程也方便。
-
- 根据传输类型也对参数进行转换（20-24行），并且_convertParam（）方法能继续扩展参数类型，直到后面可以把绝大多数参数都转换成正确的格式（那发送基本不用考虑参数格式了，只要确定传输的类型就好）
- 统一回调流程（70-103行）可以对异常做统一处理（ajax）像我这样跳转到错误页面，或者有些异步请求返回时需要跳转，也能统一跳转
- 统一请求发送前的处理（119-133行）可以对请求等待统一的设置等待动画，最后再回调流程统一取消动画
同步交互类
from表单创建类，主要是进行有参数传输的页面跳转，因为直接URL跳转参数会暴露不安全
1 /** 2 * 访问后台的类，构造form表单来进行post请求 3 * @param url 4 * @param paramMap 参数map 5 * @constructor 6 */ 7 var QueryForm = function (url,paramMap) { 8 //form表单的JQ对象 9 this.form = $("<form></form>"); 10 this.form.attr("action",url); 11 this.form.attr("method","post"); 12 //遍历Map 13 for(var [key,value] of paramMap){ 14 var inputDom = $("<input/>") ; 15 inputDom.attr("name",key); 16 inputDom.attr("value",value); 17 this.form.append(inputDom); 18 } 19 //必须要放入body里面，不然请求发不出去 20 var bodyDom = $("body"); 21 bodyDom.append(this.form); 22 this.sendMessage(); 23 24 //发送完后销毁 25 this.destroy(); 26 } 27 28 QueryForm.create = function (url, paramMap) { 29 return new QueryForm(url,paramMap); 30 } 31 32 QueryForm.prototype.sendMessage = function () { 33 this.form.submit(); 34 } 35 36 QueryForm.prototype.destroy = function () { 37 this.form.remove(); 38 }
后端交互类
普通的Controller，在@RequestMapping中填写正确的路径，根据前端传输的数据类型来获取参数（见上文），根据逻辑来确定要不要@ResponseBody来返回信息，还是ModelAndView来进行页面跳转
路径
经常404怎么办，那就是路径有问题。得先明白，java虚拟机运行的不是java文件而是编译后的.calss文件，所以最先检查的是target文件夹下是否有你URL写的这个文件，是否路径正确
平时网上看到的classpath，就是指target下的classes文件夹
顺带提一句，如果是eclipse，右键点击新建，你会发现有几个文件夹可以选
folder：就是普通的文件夹，它和我们window下面使用的文件夹没有任何区别
source folder：文件夹是一种特别的文件夹，如果你用面向对象的思想去看待这个source folder，那么他是folder的一个子集，作为子集，肯定是有folder的所有功能，而且还有自己特别的功能，他的特别之处，就是在source folder下面的java文件都会被编译，编译后的文件会被放在我们设置的某个文件夹下面（一般我们设置成WEB-INF/classes），source folder下面的非java文件会被copy一份放在我们的设置的文件夹下面
package：文件夹也是一种特别的文件夹，他的特别之处在于：他必须存在于source folder下面，上下级通过.来区分，他的路径最后组成了每一个类的包路径名
所以当出现404，请先检查路径，如果是springboot项目，则要遵守一些默认路径规则，比如模板必须放在templates，静态文件必须放在static
