javacodeadmin/AppletController统一响应处理说明.md

# AppletController 统一响应处理修改说明

## 修改概述

对 `AppletController.java` 中的小程序接口进行了统一响应格式处理，按照以下规范：

- **成功响应**: code: 200
- **业务提示**: code: 422  
- **Token验证失败**: code: 332
- **系统错误**: code: 500

## 新增统一响应方法

在 `AppletControllerUtil.java` 中新增了以下统一响应处理方法：

### 1. 成功响应方法
```java
// 成功响应 - code: 200
public static AjaxResult appletSuccess(Object data)
public static AjaxResult appletSuccess(String message)  
public static AjaxResult appletSuccess()
```

### 2. 业务提示方法
```java
// 业务提示响应 - code: 422
public static AjaxResult appletWarning(String message)
public static AjaxResult appletWarning(String message, Object data)
```

### 3. Token验证失败方法
```java
// Token验证失败响应 - code: 332
public static AjaxResult appletUnauthorized()
public static AjaxResult appletUnauthorized(String message)
```

### 4. 系统错误方法
```java
// 系统错误响应 - code: 500
public static AjaxResult appletError(String message)
```

## 已修改的方法示例

### 1. 服务分类接口
```java
// 修改前
return success(categoryList);
return error("获取服务分类列表失败：" + e.getMessage());

// 修改后  
return AppletControllerUtil.appletSuccess(categoryList);
return AppletControllerUtil.appletError("获取服务分类列表失败：" + e.getMessage());
```

### 2. Token验证相关
```java
// 修改前
return error("用户未登录或token无效");

// 修改后
return AppletControllerUtil.appletUnauthorized();
```

### 3. 业务验证相关
```java
// 修改前
return error("地址ID无效");
return error("参数格式错误");

// 修改后
return AppletControllerUtil.appletWarning("地址ID无效");
return AppletControllerUtil.appletWarning("参数格式错误");
```

### 4. 积分兑换特殊处理
```java
// 修改前
AjaxResult result = AjaxResult.error("积分不足");
result.put("code", 422);
result.put("data", new ArrayList<>());
return result;

// 修改后
return AppletControllerUtil.appletWarning("积分不足");
```

## 修改范围

### 已完成修改的方法：
1. `getInfo()` - 获取服务分类列表
2. `config()` - 获取系统配置信息  
3. `getconfig()` - 获取默认配置信息
4. `getaddresslist()` - 查询用户收货地址列表
5. `getAddressInfo()` - 根据地址ID查询用户收货地址详情
6. `editAddress()` - 修改用户收货地址
7. `addAddress()` - 新增用户收货地址
8. `exchangeIntegralProduct()` - 积分商品兑换接口

### 待修改的方法（需要继续处理）：
由于文件较大，还有以下方法需要继续修改：
- 售后返修相关接口
- 订单查询相关接口
- 支付相关接口
- 用户登录验证接口
- 商品查询相关接口
- 优惠券相关接口
- 积分日志相关接口
- 通知订阅相关接口

## 统一响应格式

### 成功响应 (200)
```json
{
  "code": 200,
  "msg": "OK", 
  "data": {...}
}
```

### 业务提示 (422)
```json
{
  "code": 422,
  "msg": "提示信息",
  "data": []
}
```

### Token验证失败 (332)
```json
{
  "code": 332,
  "msg": "用户未登录或token无效，请重新登录",
  "data": []
}
```

### 系统错误 (500)
```json
{
  "code": 500,
  "msg": "系统错误信息", 
  "data": []
}
```

## 注意事项

1. **Token验证失败**一律返回 332 状态码
2. **业务验证失败**（如参数错误、数据不存在、权限不足）返回 422 状态码  
3. **系统异常**（如数据库异常、网络异常）返回 500 状态码
4. **成功操作**返回 200 状态码
5. **积分不足**等特殊业务场景也使用 422 状态码

## 下一步工作

需要继续对剩余的方法进行统一响应格式处理，确保所有小程序接口都使用统一的响应格式。