Yo

运行环境需求

运行环境需求

IDEA 开发环境需求

由于项目依赖org.projectlombok:lombok:1.18.2，而Lombok在1.18.4版本做了重设计，不兼容之前版本，因此IDEA的Lombok插件必须是版本lombok-plugin-0.23，这里比较坑，如果升级到版本1.18.4以后，插件还是得升级，而且很多API都要改。

插件下载地址：https://pan.caimi-inc.com/d/b038610394/

下载对应版本插件，比如IDEA 2018.2.x下载lombok-plugin-0.23-2018.2.zip，卸载IDEA已安装Lombok插件，选择磁盘安装，如下图：

启动SpringBoot项目

建议先执行mvn编译命令，比如编译模块CMS

mvn clean compile -am -pl cms -T 2C

Tigon

Controller

如果加注了@ResponseBody或者@RestController，不做变动，依循Spring MVC方式JSON序列化返回数据，否则返回Wacai接口规范数据格式，如下例：

@ResponseBody

@ResponseBody
@RequestMapping("/resp-body")
public String respBody() {
    return "Response Body";
}

响应输出

Response Body

Wacai JSON API

@RequestMapping("/resp-body")
public String respBody() {
    return "Response Body";
}

响应输出

{
    "code": 0,
    "success": true,
    "data": "Response Body"
}

简单来说就是，不加@ResponseBody注解，默认会以WacaiAPI规范响应数据结果。

参见以下样例：

I.

@RequestMapping("/count")
public int count() {
    return 1024;
}

响应输出

{
    "code": 0,
    "success": true,
    "data": 1024
}

II.

@RequestMapping("/user-info")
public Map<String, Object> userInfo() {
    final Map<String, Object> user = new HashMap<>(4);
    user.put("name", "Uncle Donghuang");
    user.put("gender", "MALE");
    user.put("mobile", "17161787481");
    user.put("active", true);
    return user;
}

响应输出

{
    "code": 0,
    "success": true,
    "data": {
        "name": "Uncle Donghuang",
        "gender": "MALE",
        "mobile": "17161787481",
        "active": true,
    }
}

III.

@RequestMapping("/error-caused")
public Map<String, Object> errorCaused() {
    throw new RuntimeException("Oops, some error caused");
}

响应输出

{
    "code": 5000,
    "success": false,
    "message": "Oops, some error caused"
}