Java设计通用的返回数据格式过程讲解
作者:shenzhenNBA 发布时间:2023-11-09 00:16:40
标签:Java,返回,数据,格式
相信在做B/S模式的项目时,我们请求server端时通常遇到返回数据的处理,对返回数据的格式处理方式多样,随着JSON的流行,现在很多的项目server端返回client端的数据多数以JSON格式返回,同时结合其它需要,通常加一下状态码和信息之类,给前端处理带来很大的方便,那我们今天就来看看一种通用返回结果的设计和应用;
一,通用返回结果的信息类
这个主要是做返回结果信息的载体类,含有关键的结果代码,结果信息,结果数据,基本满足前端的需要关键信息,其中数据以泛型使其可以保存任意数据类型,通用代码如下:
public class ResultInfo<T> {
//通用返回信息对象类
private int code; //返回状态码
private String msg;//返回信息
private T data; //返回数据
public ResultInfo<T> setCode(int code){
this.code = code;
return this;
}
public int getCode(){
return this.code;
}
public ResultInfo<T> setMsg(String msg){
this.msg = msg;
return this;
}
public String getMsg(){
return this.msg;
}
public ResultInfo<T> setData(T data){
this.data = data;
return this;
}
public T getData(){
return this.data;
}
//more functon here...
}
二,通用返回结果信息的方法类
提供各种通用的返回方法,以便在Controller层直接使用,通常设计如下:
public class Result {
//通用返回结果的方法类
private static final int okCode = 0;
private static final int failCode = 1;
private static final String okMsg = "操作成功";
private static final String failMsg = "操作失败";
//以上这些通常可以定义为一种枚举类,然后使用
//成功返回方法
public static <T> ResultInfo<T> Ok(){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(okCode).setMsg(okMsg);
return r;
}
public static <T> ResultInfo<T> Ok(String msg){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(okCode).setMsg(msg);
return r;
}
public static <T> ResultInfo<T> Ok(T data){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(okCode).setMsg(okMsg).setData(data);
return r;
}
public static <T> ResultInfo<T> Ok(String msg, T data){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(okCode).setMsg(msg).setData(data);
return r;
}
//失败返回方法
public static <T> ResultInfo<T> Fail(){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(failCode).setMsg(failMsg);
return r;
}
public static <T> ResultInfo<T> Fail(String msg){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(failCode).setMsg(msg);
return r;
}
public static <T> ResultInfo<T> Fail(T data){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(failCode).setMsg(failMsg).setData(data);
return r;
}
public static <T> ResultInfo<T> Fail(String msg, T data){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(failCode).setMsg(msg).setData(data);
return r;
}
//通用返回方法
public static <T> ResultInfo<T> result(int code, String msg){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(code).setMsg(msg);
return r;
}
public static <T> ResultInfo<T> result(int code, String msg, T data){
ResultInfo<T> r = new ResultInfo<T>();
r.setCode(code).setMsg(msg).setData(data);
return r;
}
}
三,在Controller层中的使用
package com.xxx.yyy.zzz.controller;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import com.xxx.yyy.zzz.util.ResultInfo;
import com.xxx.yyy.zzz.util.Result;
import com.xxx.yyy.zzz.model.User;
import com.xxx.yyy.zzz.service.UserService;
import org.springframework.stereotype.Controller;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.ResquestBody;
// more import ...
/**
* 用户对外API
* @author shenzhenNBA
* @since 2020.03.05
* 通用返回结果的应用
*/
@RequestMapping("/user")
@Controller
public class UserController {
private static Log Logger = LogFactory.getLog(UserController.class);
@Autowired
UserService userService; //需另外定义,此处省略
/**
* 保存用户,
* 返回格式: {"code":xx,"msg":"yyy","data":null}
*/
@PostMapping(value="/save")
@ResponseBody
public ResultInfo<String> saveUser(@RequestBody User param){
try{
int num = userService.saveUser(param);
if (0 == num) {
return Ok("保存成功"); //通用方法Ok()使用
} else if (1 == num) {
return Fail("失败,参数异常"); //通用方法Fail()使用
} else if (2 == num) {
return Fail("失败,保持操作失败");
} else {
return Fail("失败,未知异常");
}
} catch (Exception e) {
Logger.error("controller UserController.saveUser() error, param: {}, info: {}", param, e)
return Fail("保存失败,过程出现异常");
}
}
/**
* 根据记录ID获取用户记录信息,
* 返回格式: {"code":xx,"msg":"yyy","data":User对象JSON格式字符串}
*/
@PostMapping(value="/getById")
@ResponseBody
public ResultInfo<User> getById(@RequestBody UserParam param){
try{
User user = userService.getById(param);
return Ok("查询成功", user); //通用方法Ok()使用
} catch (Exception e) {
Logger.error("controller UserController.getById() error, param: {}, info: {}", param, e)
return Fail("查询失败,过程出现异常",null); //通用方法Fail()使用
}
}
}
后记,项目主要框架代码,不全,但可以很清楚看清设计和使用了
来源:https://blog.csdn.net/shenzhenNBA/article/details/105336814
![](https://www.aspxhome.com/images/zang.png)
![](https://www.aspxhome.com/images/jiucuo.png)
猜你喜欢
- 一、实验目的1. 掌握输入输出流的总体结构;2. 掌握流的概念;3. 掌握FileInputStream类、FileOutputStream
- throw抛出异常的方式比较直接:if(age < 0){throw new MyException("年龄不能为负数!&q
- Mybatis与JPA的优缺点JPA java持久层API可理解为一种规范,Hibernate就是其具体一个实现。它的实现应用是Spring
- SharedPreferences是Android中最容易理解的数据存储技术,实际上SharedPreferences处理的就是一个key-
- 年纪大了,以前做过的东西过阵子还是会忘,今天使用jenkins持续集成工具时用到了eclipse上传新maven工程至svn,上传完毕后改了
- springboot读取文件,打成jar包后访问不到最新开发出现一种情况,springboot打成jar包后读取不到文件,原因是打包之后,文
- 本文实例讲述了Android TextView中文字通过SpannableString设置属性的方法。分享给大家供大家参考,具体如下:在An
- 一、Jvm加载对象在说Java * 之前,还是要说一下Jvm加载对象的过程,这个依旧是理解 * 的基础性原理:Java类即源代码程序.j
- 本文实例为大家分享了android自定义环形对比图的具体代码,供大家参考,具体内容如下1.首先在res/values里创建一个attr.xm
- 通过http://localhost:7002/card/services/HelloWorld?wsdl访问到xml如下,说明接口写对了。
- 通常情况下我们想实现文字的走马灯效果需要在xml文件中这样设置<TextView android:layout_widt
- 如果想实现一个在桌面显示的悬浮窗,用Dialog、PopupWindow、Toast等已经不能实现了,他们基本都是在Activity之上显示
- 代码背景一个班级,有两类学生,A类:不学习,玩,但是玩的东西不一样,有的是做游戏,有的是看电视B类:放哨的学生,专门看老师的动向,如果老师进
- 概念理解Properties 继承于 Hashtable。表示一个持久的属性集,属性列表以key-value的形式存在,key和value都
- startActivityForResult与startActivity的不同之处在于:1、startActivity( )仅仅是跳转到目标
- java 实现MD5加密算法的简单实例实现代码:import java.security.NoSuchAlgorithmException;
- 方法参数public String listFireEvent(@Valid FireSearch fireSearch, Ht
- 一,FileWritter写入文件FileWritter, 字符流写入字符到文件。默认情况下,它会使用新的内容取代所有现有的内容,然而,当指
- 一、获取android工程里面的各种资源的id; 1.1 string型 比如下面: << string name=”OK”&g
- Android 显示GIF图片实例详解gif图动画在Android中还是比较常用的,比如像新浪微博中,有很多gif图片,而且展示非常好,所以