gym/R.java

// 声明该类所在的包为 com.utils
package com.utils;

// 导入 HashMap 类，用于存储键值对
import java.util.HashMap;
// 导入 Map 接口，用于定义键值对存储的通用规范
import java.util.Map;

// 定义一个名为 R 的类，继承自 HashMap，用于返回数据
public class R extends HashMap<String, Object> {
	// 定义序列化版本号，用于序列化和反序列化时的版本验证
	private static final long serialVersionUID = 1L;

	// 无参构造函数，初始化时设置默认状态码为 0
	public R() {
		// 向 Map 中放入键为 "code"，值为 0 的键值对
		put("code", 0);
	}

	// 静态方法，返回一个表示错误的 R 对象，默认错误码为 500，错误信息为 "未知异常，请联系管理员"
	public static R error() {
		// 调用另一个 error 方法，传入错误码 500 和错误信息
		return error(500, "未知异常，请联系管理员");
	}

	// 静态方法，返回一个表示错误的 R 对象，错误码为 500，自定义错误信息
	public static R error(String msg) {
		// 调用另一个 error 方法，传入错误码 500 和自定义错误信息
		return error(500, msg);
	}

	// 静态方法，返回一个表示错误的 R 对象，自定义错误码和错误信息
	public static R error(int code, String msg) {
		// 创建一个新的 R 对象
		R r = new R();
		// 向 R 对象中放入错误码
		r.put("code", code);
		// 向 R 对象中放入错误信息
		r.put("msg", msg);
		// 返回该 R 对象
		return r;
	}

	// 静态方法，返回一个表示成功的 R 对象，包含自定义成功信息
	public static R ok(String msg) {
		// 创建一个新的 R 对象
		R r = new R();
		// 向 R 对象中放入成功信息
		r.put("msg", msg);
		// 返回该 R 对象
		return r;
	}

	// 静态方法，返回一个表示成功的 R 对象，将传入的 Map 中的键值对添加到 R 对象中
	public static R ok(Map<String, Object> map) {
		// 创建一个新的 R 对象
		R r = new R();
		// 将传入的 Map 中的所有键值对添加到 R 对象中
		r.putAll(map);
		// 返回该 R 对象
		return r;
	}

	// 静态方法，返回一个表示成功的 R 对象
	public static R ok() {
		// 创建并返回一个新的 R 对象
		return new R();
	}

	// 重写 put 方法，将键值对放入 R 对象中，并返回当前 R 对象，方便链式调用
	public R put(String key, Object value) {
		// 调用父类的 put 方法，将键值对放入 Map 中
		super.put(key, value);
		// 返回当前 R 对象
		return this;
	}
}