前后端交互协议详解：错误码与响应结构

本文档详细阐述了前后端交互协议，主要涉及文件上传与下载、Ajax请求、错误码系统以及统一的AJAX调用接口函数。此外，还提供了前端和后端交互的示例代码。 在前后端交互协议中，文件上传和下载是常见的操作。这些操作通常需要指定`File_id`来唯一标识文件，`File_name`表示文件的名称，而`Content_type`则指明文件的MIME类型。Ajax请求在交互中扮演重要角色，用于异步地发送和接收数据。请求时，Header包含了必要的头部信息，而提交参数部分可以包括分页对象（`Page`）和请求对象（`Request`）。分页信息包含当前页数（`currentPages`）、总页数（`totalPage`）、每页大小（`pageSize`）以及总记录数（`totalSize`）。 错误码系统是交互中不可或缺的一部分，例如，编号65536表示权限不足，65534表示需要重新认证。当返回的数据中`result`字段为1时，表示存在错误，`errorcode`字段将给出具体的错误代码，便于前端根据错误码进行错误处理。 举例来说，当返回一个带分页列表时，响应数据结构如下： ```json { "result": 0, "errorCode": 1000, "responInfo": { "list": [], "page": { "currentPages": 1, "totalPage": 100, "pageSize": 10, "totalSize": 1000 } } } ``` 对于单条数据，响应数据结构如下： ```json { "result": 0, "errorCode": 1000, "responInfo": { "user": {} } } ``` 在前端开发中，可以使用统一的AJAX调用接口函数`requestAjax`来处理请求。以下是一个获取用户信息的例子： ```javascript function myfn() { var obj = { "request.telephone": 123, "page.pageNum": 1, "page.pageSize": 10 }; getUserInfo(obj, function (data) { if (data.result === 0) { // 处理成功情况，获取user信息 data.response.user; } else { // 错误处理，根据错误码获取错误信息 var errInfo = getErrMsg(data.errorCode); // 进行错误信息处理 } }); } function getUserInfo(obj, callBack) { var options = { "url": "managementNew/bts/getOrgs", "data": obj, "callBack": function (data) { callBack(data); }, "errCallBack": function (e) { console.log("服务器异常，超时，等错误"); } }; requestAjax(options); } ``` 后端接口调用示例中，`getUserInfo`函数接收参数对象并传递给`requestAjax`，同时提供了一个回调函数来处理接收到的数据或错误。 通过这些规范和示例，开发者可以更好地理解和实现前后端之间的有效交互，确保数据的正确传输和错误的妥善处理。