统一响应格式

Nop平台的REST服务和RPC服务，统一使用ApiResponse<T>形式返回结果数据，同步模式直接返回ApiResponse，异步模式返回CompletionStage<ApiResponse<T>>。

ApiResponse的基本结构如下：

class ApiResponse<T>{
    Map<String,Object> headers;
    int status;
    String code;
    String msg;
    T data;
}

status相当于是提供一个粗粒度的正确或者失败的信息表示，而且它采用整数类型，便于和命令行程序的exitCode对应。Nop平台的服务实现不仅仅是作为Http服务来使用，它还可以直接发布为命令行服务，此时命令行程序的exitCode就使用这里的status来返回。

code为错误码，它采用字符串格式，便于扩展到各种使用场景。在Nop平台中可以通过错误码映射将系统内置的错误码映射为满足外部规范要求的错误码。

错误码定义

    ErrorCode ERR_AUTH_UNKNOWN_SITE = define("nop.err.auth.unknown-site", "未知的站点：{siteId}", ARG_SITE_ID);

它包含一个异常码的key，一个缺省的异常消息。

        if (siteMap == null)
            throw new NopException(ERR_AUTH_UNKNOWN_SITE).param(ARG_SITE_ID, siteId);

可以通过param函数为异常对象增加任意参数。 NopException具有errorCode, description, params等属性，并具有可选的status属性。

ApiResponse<?> res = ErrorMessageManager.instance().buildErrorResponse(request, error);

ApiResponse的结构类似SmartAdmin中ResponseDTO。response = headers + status + msg + data

在转换为ApiResponse的过程中会执行i18n消息映射，根据异常码的key映射得到国际化消息。

异常码映射 ErrorMessageManager构造ApiResponse的过程中，会将内部异常码映射为外部异常码。比如客户对返回的异常码可能有统一规范要求。例如将 nop.err.auth.unknown-site 映射为 10010等。
参数化消息映射有的时候系统底层可能会抛出一个统一的异常码，但是它的参数不同。如果我们希望根据不同的参数向客户返回不同的错误消息，则可以配置参数化消息映射。例如

"nop.err.my-error?myParam=xx" : "异常消息A"

异常消息定制异常码对应的异常消息可以通过i18n文件进行定制。例如在 /i18n/zh-CN/error.i18n.yaml文件中为每个错误码指定对应的错误消息，它会替代错误码定义时所使用的缺省消息。 I18nMessageManager会自动读取_vfs/i18n/目录下所有的不以下划线为前缀的i18n.yaml文件。Nop平台并没有约定一定要在error.i18n.yaml中定制错误消息，这里的名称是自定义的。