前后端数据交互，跳转

Posted 2022-08-31 top-housekeeper

概述

作为一枚菜鸟，前后端交互可是大问题，经常数据交互失败，不知道怎么跳转。在这分享一下交互的小心得。

我们不妨先大概了解一下整个访问流程：

用户从输入网址按下回车，交互就已经开始了。

浏览器会将请求按照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行）
• 可以规定统一的前端交互流程，并且修改这个流程也方便。

1. 1. 根据传输类型也对参数进行转换（20-24行），并且_convertParam（）方法能继续扩展参数类型，直到后面可以把绝大多数参数都转换成正确的格式（那发送基本不用考虑参数格式了，只要确定传输的类型就好）　　　　          
   2. 统一回调流程（70-103行）可以对异常做统一处理（ajax）像我这样跳转到错误页面，或者有些异步请求返回时需要跳转，也能统一跳转
   3. 统一请求发送前的处理（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