后台开发人员C,在通达信交易下单接口,接口返回时,习惯在通达信交易下单接口,接口失败时返回码为code=0000。
在项目开发中,初期搭建框架时,定好通用的通达信交易下单接口,接口数据返回格式,定义好全局的状态码,是非常有必要的。一个项目,甚至整个公司,遵循同一套通达信交易下单接口,接口返回格式规范,这样可以极大的提高进度,降低沟通成本。
可以看到,上面的三个开发人员,都没有大问题,没有谁对谁错,只要给前端通达信交易下单接口,接口文档,前端都是可以接上通达信交易下单接口,接口的。在项目功能越来越多,通达信交易下单接口,接口数量持续增长时,对开发人员而言,就是一种灾难,同一个前端,如果对接A和C,那她接通达信交易下单接口,接口时会很崩溃。因为返回的code,同样是0000,但是一个代表成功,一个代表失败,这时前端就会去找两个人沟通,看可不可以统一一下,但是两个人一看,最近写了几十个通达信交易下单接口,接口了,还和别人对接过,牵一发动全身,没法做改动了。看,这就是灾难。
下面的两个类,一个是数据返回格式,是自定义的,很简单,但是可通用,这里分享一下,返回给前端时,根据情况,直接调用此类中的方法做返回值;另一个是状态码,这个可以根据项目实际情况,自己做修改。
返回示例:
ResponseWrapper{success=true, code='0000', msg='查询成功', 通达信交易下单通达信交易下单接口,接口,data=数据}
ResponseWrapper{success=true, code='0001', msg='查询成功无记录', 通达信交易下单通达信交易下单接口,接口,data=null}
ResponseWrapper{success=false, code='0002', msg='查询失败', 通达信交易下单通达信交易下单接口,接口,data=null}
ResponseWrapper{success=false, code='1004', msg='参数为空或格式错误', 通达信交易下单通达信交易下单接口,接口,data=null}
ResponseWrapper{success=true, code='0000', msg='自定义msg', 通达信交易下单通达信交易下单接口,接口,data=这是自定义的数据}
后台开发人员A,在通达信交易下单接口,接口返回时,习惯返回一个返回码code=0000,然后返回数据;
后台开发人员B,在通达信交易下单接口,接口返回时,习惯直接返回一个boolean类型的success=true,然后返回数据;
通达信交易下单接口,接口数据返回格式:
package response;
import domain.ReturnCode;
/**
* Created by lightClouds917
* Date 2017/11/10
* Description:通达信交易下单接口,接口统一返回格式
*/
public class ResponseWrapper {
/**是否成功*/
private boolean success;
/**返回码*/
private String code;
/**返回信息*/
private String msg;
/**返回数据*/
private Object 通达信交易下单通达信交易下单接口,接口,data;
/**
* 自定义返回结果
* 建议使用统一的返回结果,特殊情况可以使用此方法
* @param success
* @param code
* @param msg
* @param 通达信交易下单通达信交易下单接口,接口,data
* @return
*/
public static ResponseWrapper markCustom(boolean success,String code,String msg,String 通达信交易下单通达信交易下单接口,接口,data){
ResponseWrapper responseWrapper = new ResponseWrapper();
responseWrapper.setSuccess(success);
responseWrapper.setCode(code);
responseWrapper.setMsg(msg);
responseWrapper.setData(通达信交易下单通达信交易下单接口,接口,data);
return responseWrapper;
}
/**
* 参数为空或者参数格式错误
* @return
*/
public static ResponseWrapper markParamError(){
ResponseWrapper responseWrapper = new ResponseWrapper();
responseWrapper.setSuccess(false);
responseWrapper.setCode(ReturnCode.PARAMS_ERROR.getCode());
responseWrapper.setMsg(ReturnCode.PARAMS_ERROR.getMsg());
return responseWrapper;
}
/**
* 查询失败
* @return
*/
public static ResponseWrapper markError(){
ResponseWrapper responseWrapper = new ResponseWrapper();
responseWrapper.setSuccess(false);
responseWrapper.setCode(ReturnCode.FEAILED.getCode());
responseWrapper.setMsg(ReturnCode.FEAILED.getMsg());
responseWrapper.setData(null);
return responseWrapper;
}
/**
* 查询成功但无数据
* @return
*/
public static ResponseWrapper markSuccessButNoData(){
ResponseWrapper responseWrapper = new ResponseWrapper();
responseWrapper.setSuccess(true);
responseWrapper.setCode(ReturnCode.NODATA.getCode());
responseWrapper.setMsg(ReturnCode.NODATA.getMsg());
responseWrapper.setData(null);
return responseWrapper;
}
/**
* 查询成功且有数据
* @param 通达信交易下单通达信交易下单接口,接口,data
* @return
*/
public static ResponseWrapper markSuccess(Object 通达信交易下单通达信交易下单接口,接口,data){
ResponseWrapper responseWrapper = new ResponseWrapper();
responseWrapper.setSuccess(true);
responseWrapper.setCode(ReturnCode.SUCCESS.getCode());
responseWrapper.setMsg(ReturnCode.SUCCESS.getMsg());
responseWrapper.setData(通达信交易下单通达信交易下单接口,接口,data);
return responseWrapper;
}
public boolean isSuccess() {
return success;
}
public void setSuccess(boolean success) {
this.success = success;
}
public Object getData() {
return 通达信交易下单通达信交易下单接口,接口,data;
}
public void setData(Object 通达信交易下单通达信交易下单接口,接口,data) {
this.通达信交易下单通达信交易下单接口,接口,data = 通达信交易下单通达信交易下单接口,接口,data;
}
public String getMsg() {
return msg;
}
public void setMsg(String msg) {
this.msg = msg;
}
public String getCode() {
return code;
}
public void setCode(String code) {
this.code = code;
}
@Override
public String toString() {
return 'ResponseWrapper{' +
'success=' + success +
', code='' + code + ''' +
', msg='' + msg + ''' +
', 通达信交易下单通达信交易下单接口,接口,data=' + 通达信交易下单通达信交易下单接口,接口,data +
'}';
}
}
文章为作者独立观点,不代表股票交易接口观点