模块 jmc.utils
程序包 com.jmc.net

类 R<T>

java.lang.Object
com.jmc.net.R<T>
类型参数:
T - 返回数据类型
public class R<T> extends Object
统一返回数据实体类型
从以下版本开始:
1.6
API Note:

 // 返回请求成功并携带数据666
 // 前端收到json：{ "code": 200, "message": null, "data": 666 }
 R<Integer> succeed = R.ok().data(666);
 // 上述情况的简写
 R<Integer> succeed2 = R.ok(666);

 // 返回请求失败并携带信息"Error"
 // 前端收到json：{ "code": 500, "message": "Error", "data": null }
 R<Void> error = R.error().message("Error").build();
 // 上述情况简写
 R<Void> error2 = R.error("Error");

 // 使用RStream进行灵活方法调用和返回数据（多用于MVC Controller)
 return R.stream()
         // 检查方法（可写多个），如果传入布尔为false就将错误信息"学生姓名重复"返回，数据为空（检查学生姓名是否重复）
         // 相当于布尔是false时返回R.error("学生姓名重复")
         .check(existName(student.getName()), "学生姓名重复”)
         // 执行方法（可写多个），该方法可抛出异常，无返回值。当抛出异常时将异常信息返回，数据为空（执行插入学生对象操作）
         // 相当于抛出异常时返回R.error(e.getMessage())
         .exec(() -> insert(s))
         // 返回结果数据
         // 相当于上述check、exec操作均成功时返回R.ok(getResult(s))
         .build(() -> getResult(s));

  • 嵌套类概要

    嵌套类
    修饰符和类型
    类
    说明
    static class 
    R.RBuilder
    数据类的构造器
    static class 
    R.RStream
    R的流式高级构建对象

  • 方法概要

    修饰符和类型
    方法
    说明
    static R.RBuilder
    error()
    返回状态为错误的数据类构造器
    static <T> R<T>
    error(String errorMsg)
    返回包含错误信息，状态为错误的数据类
    boolean
    failed()
    判断某次请求是否失败
    static R.RBuilder
    forbidden()
    返回状态为禁止访问的数据类构造器
    T
    getData()
    检查请求是否成功并获取返回数据
    如果请求失败就抛出异常信息
    static R.RBuilder
    notFound()
    返回状态为页面不存在的数据类构造器
    static R.RBuilder
    ok()
    返回状态为成功的数据类构造器
    static <T> R<T>
    ok(T data)
    返回包含数据，状态为成功的数据类
    static R.RStream
    stream()
    获取R的流式高级构建对象

    从类继承的方法 java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • 方法详细资料

    • ok

      public static R.RBuilder ok()
      返回状态为成功的数据类构造器
      返回:
      数据类构造器

    • ok

      public static <T> R<T> ok(T data)
      返回包含数据，状态为成功的数据类
      类型参数:
      T - 返回数据类型
      参数:
      data - 返回数据
      返回:
      数据类
      从以下版本开始:
      2.3

    • error

      public static R.RBuilder error()
      返回状态为错误的数据类构造器
      返回:
      数据类构造器

    • error

      public static <T> R<T> error(String errorMsg)
      返回包含错误信息，状态为错误的数据类
      类型参数:
      T - 返回数据类型
      参数:
      errorMsg - 错误信息
      返回:
      数据类
      从以下版本开始:
      2.3

    • forbidden

      public static R.RBuilder forbidden()
      返回状态为禁止访问的数据类构造器
      返回:
      数据类构造器

    • notFound

      public static R.RBuilder notFound()
      返回状态为页面不存在的数据类构造器
      返回:
      数据类构造器

    • failed

      public boolean failed()
      判断某次请求是否失败
      返回:
      请求是否失败
      从以下版本开始:
      2.3
      另请参阅:

    • getData

      public T getData()
      检查请求是否成功并获取返回数据
      如果请求失败就抛出异常信息
      返回:
      返回数据
      从以下版本开始:
      2.5
      API Note:
      
 R<String> r = ...;

 // 先检查请求是否失败
 if (r.failed()) {
     // 处理失败情况
     ...
 }
 // 获取返回数据
 var data = r.getData();

 // 或者不检查直接调用，当前端传来的R请求失败时处理异常（这里直接打印）
 data = Tries.tryReturnsT(r::getData, System.err::println);

    • stream

      public static R.RStream stream()
      获取R的流式高级构建对象
      返回:
      R构建流
      从以下版本开始:
      2.5