类 R


  • public class R
    extends Object
    便捷返回 Result,构建 RESTful 风格API结果
    从以下版本开始:
    2017年7月31日
    作者:
    ylyue
    • 构造器详细资料

      • R

        public R()
    • 方法详细资料

      • success

        public static Result<?> success()
        成功后调用,返回的data为null
        返回:
        HTTP请求,最外层响应对象
      • success

        public static <T> Result<T> success​(T data)
        成功后调用,返回的data为一个对象
        类型参数:
        T - 泛型
        参数:
        data - 数据
        返回:
        HTTP请求,最外层响应对象
      • success

        public static <T> Result<T> success​(Long count,
                                            T data)
        成功后调用,分页查询
        类型参数:
        T - 泛型
        参数:
        count - 总数
        data - 数据
        返回:
        HTTP请求,最外层响应对象
      • success

        public static <T> Result<T> success​(Integer code,
                                            Long count,
                                            T data)
        成功后调用,分页查询
        类型参数:
        T - 泛型
        参数:
        code - 自定义code(默认200)
        count - 总数
        data - 数据
        返回:
        HTTP请求,最外层响应对象
      • loggedIn

        public static Result<?> loggedIn()
        会话未注销,无需登录-210
        返回:
        HTTP请求,最外层响应对象
      • resourceAlreadyInvalid

        public static Result<?> resourceAlreadyInvalid()
        资源已失效-300
        返回:
        HTTP请求,最外层响应对象
      • movedPermanently

        public static Result<?> movedPermanently()
        Moved Permanently-301
        返回:
        HTTP请求,最外层响应对象
      • fileEmpty

        public static Result<?> fileEmpty()
        文件上传请求错误,获得文件信息为空,同时文件必须有明确的匹配类型(如文本类型:.txt)-310
        返回:
        HTTP请求,最外层响应对象
      • unauthorized

        public static Result<?> unauthorized()
        未登录或登录已失效-401
        返回:
        HTTP请求,最外层响应对象
      • attack

        public static Result<?> attack()
        非法访问-402
        返回:
        HTTP请求,最外层响应对象
      • attack

        public static <T> Result<T> attack​(T data)
        非法访问-402
        类型参数:
        T - 泛型
        参数:
        data - 异常数据
        返回:
        HTTP请求,最外层响应对象
      • forbidden

        public static Result<?> forbidden()
        无权限-403
        返回:
        HTTP请求,最外层响应对象
      • notFound

        public static Result<?> notFound()
        Not Found-404
        返回:
        HTTP请求,最外层响应对象
      • methodNotAllowed

        public static <T> Result<T> methodNotAllowed​(T data)
        方法不允许(Method Not Allowed)-405

        客户端使用服务端不支持的 Http Request Method 进行接口调用

        参数:
        data - Result#setData(Object) 更详细的异常提示信息
        返回:
        HTTP请求,最外层响应对象
      • gone

        public static Result<?> gone()
        API接口版本弃用-410
        返回:
        HTTP请求,最外层响应对象
      • tooManyRequests

        public static Result<?> tooManyRequests()
        频繁请求限流-429
        返回:
        HTTP请求,最外层响应对象
      • paramVoid

        public static Result<?> paramVoid()
        参数为空-432
        返回:
        HTTP请求,最外层响应对象
      • paramCheckNotPass

        public static Result<?> paramCheckNotPass()
        参数校验未通过,请参照API核对后重试-433
        返回:
        HTTP请求,最外层响应对象
      • paramCheckNotPass

        public static <T> Result<T> paramCheckNotPass​(T data)
        参数校验未通过,请参照API核对后重试-433
        参数:
        data - Result#setData(Object) 提示信息
        返回:
        HTTP请求,最外层响应对象
      • paramValueInvalid

        public static Result<?> paramValueInvalid()
        参数校验未通过,无效的value-434
        返回:
        HTTP请求,最外层响应对象
      • paramValueInvalid

        public static <T> Result<T> paramValueInvalid​(T data)
        参数校验未通过,无效的value-434
        参数:
        data - Result#setData(Object) 提示信息
        返回:
        HTTP请求,最外层响应对象
      • paramDecryptError

        public static Result<?> paramDecryptError()
        参数解密错误-435
        返回:
        HTTP请求,最外层响应对象
      • internalServerError

        public static Result<?> internalServerError()
        服务器内部错误-500
        返回:
        HTTP请求,最外层响应对象
      • internalServerError

        public static <T> Result<T> internalServerError​(T data)
        服务器内部错误-500
        类型参数:
        T - 泛型
        参数:
        data - 异常数据
        返回:
        HTTP请求,最外层响应对象
      • requestError

        public static Result<?> requestError()
        请求错误-501
        返回:
        HTTP请求,最外层响应对象
      • requestError

        public static <T> Result<T> requestError​(T data)
        请求错误-501
        类型参数:
        T - 泛型
        参数:
        data - 异常数据
        返回:
        HTTP请求,最外层响应对象
      • serviceUnavailable

        public static Result<?> serviceUnavailable()
        服务不可用-503

        服务目前无法使用(由于超载或停机维护)

        返回:
        HTTP请求,最外层响应对象
      • serviceUnavailable

        public static Result<?> serviceUnavailable​(LocalDateTime restoreTime)
        服务不可用(停机维护)-503
        参数:
        restoreTime - 预计恢复时间(如:2020-12-31 08:00:00)
        返回:
        HTTP请求,最外层响应对象
      • serviceUnavailable

        public static <T> Result<T> serviceUnavailable​(T data)
        服务不可用-503

        服务目前无法使用(由于超载或停机维护)

        类型参数:
        T - 泛型
        参数:
        data - 服务不可用的具体原因,参考:ResultPrompt.serviceUnavailable(int)
        返回:
        HTTP请求,最外层响应对象
      • dataStructure

        public static Result<?> dataStructure()
        数据结构异常-505
        返回:
        HTTP请求,最外层响应对象
      • dataStructure

        public static Result<?> dataStructure​(int expected,
                                              int actual)
        数据结构异常-505

        不正确的结果大小

        参数:
        expected - 预期值
        actual - 实际值
        返回:
        HTTP请求,最外层响应对象
      • dbError

        public static Result<?> dbError()
        数据结构异常,请检查相应数据结构一致性-506
        返回:
        HTTP请求,最外层响应对象
      • dbError

        public static <T> Result<T> dbError​(T data)
        数据结构异常,请检查相应数据结构一致性-506
        参数:
        data - Result#setData(Object) 提示信息
        返回:
        HTTP请求,最外层响应对象
      • clientFallback

        public static Result<?> clientFallback()
        哎哟喂!网络开小差了,请稍后重试...-507
        返回:
        HTTP请求,最外层响应对象
      • clientFallback

        public static <T> Result<T> clientFallback​(T data)
        哎哟喂!网络开小差了,请稍后重试...-507
        参数:
        data - Result#setData(Object) 更详细的异常提示信息
        返回:
        HTTP请求,最外层响应对象
      • clientFallbackError

        public static Result<?> clientFallbackError()
        哎哟喂!服务都被您挤爆了...-508
        返回:
        HTTP请求,最外层响应对象
      • clientFallbackError

        public static <T> Result<T> clientFallbackError​(T data)
        哎哟喂!服务都被您挤爆了...-508
        参数:
        data - Result#setData(Object) 更详细的异常提示信息
        返回:
        HTTP请求,最外层响应对象
      • typeConvertError

        public static <T> Result<T> typeConvertError​(T data)
        类型转换错误-509
        参数:
        data - Result#setData(Object) 提示信息
        返回:
        HTTP请求,最外层响应对象
      • errorPromptFormat

        public static Result<?> errorPromptFormat​(String msg,
                                                  Object... values)
        错误提示-600

        适用于用户操作提示、业务消息提示、友好的错误提示等场景。

        可优先使用 ResultPrompt 预定义的提示信息,如:ResultPrompt.USERNAME_OR_PASSWORD_ERROR

        msg支持文本模板格式化,{} 表示占位符

        例:("this is {} for {}", "a", "b") = this is a for b
        参数:
        msg - 文本模板,被替换的部分用 {} 表示
        values - 文本模板中占位符被替换的值
        返回:
        HTTP请求,最外层响应对象