handlerList.md 18 KB
AppGame模块Handler列表
本文档记录了AppGame模块中所有Handler的详细信息，包括功能描述、请求/响应类型、实现状态等。
目录
- 1. Public Handler - 公共接口Handler
- 1.1 TokenHandler - 获取访问令牌
- 1.2 LoginHandler - 用户登录
- 1.3 Login4uHandler - 4U登录
- 1.4 Login4ursHandler - URS登录
- 1.5 RegisterHandler - 用户注册
- 1.6 PlayerDataHandler - 获取玩家公共数据
- 1.7 SendSmsHandler - 发送短信验证码
- 1.8 CheckCodeHandler - 验证短信验证码
- 1.9 DeviceInfoHandler - 上报设备信息
- 2. User Handler - 用户相关Handler
- 2.1 DataHandler - 获取用户完整数据
- 2.2 EditinfoHandler - 编辑用户信息
- 2.3 EditPasswordHandler - 修改用户密码
- 2.4 GameSkinHandler - 游戏皮肤管理
- 2.5 LogoutHandler - 用户登出
- 2.6 QueryDataHandler - 查询用户数据
- 2.7 LogDataHandler - 获取用户日志数据
- 2.8 ClearLogHandler - 清理用户日志
- 3. Farm Handler - 农场相关Handler
- 3.1 Land相关
- 3.1.1 SowHandler - 种植种子
- 3.1.2 HarvestHandler - 收获作物
- 3.1.3 UpHandler - 升级土地
- 3.1.4 FertilizerHandler - 使用化肥
- 3.1.5 PesticideHandler - 使用农药
- 3.1.6 WateringHandler - 浇水
- 3.1.7 WeedicideHandler - 使用除草剂
- 3.1.8 RemoveCropHandler - 移除作物
- 3.2 House相关
- 3.2.1 UpHandler - 升级房屋
- 3.2.2 RankHandler - 房屋等级排行榜
- 3.2.3 RankfundHandler - 房屋资金排行榜
- 3.3 God相关
- 3.3.1 OpenHandler - 激活神像
- 4. Pet Handler - 宠物相关Handler
- 4.1 DataHandler - 获取宠物数据
- 4.2 GetHandler - 获取宠物
- 4.3 EatHandler - 宠物进食
- 4.4 TrainHandler - 宠物训练
- 4.5 TrainSaveHandler - 保存宠物训练结果
- 4.6 LifeSkillUseHandler - 使用宠物生活技能
- 4.7 VegetealHandler - 宠物摘菜功能
- 4.8 RankHandler - 宠物排行榜
- 5. Item Handler - 物品相关Handler
- 5.1 CraftHandler - 物品合成
- 5.2 DismantleHandler - 物品分解
- 5.3 OpenboxHandler - 开启宝箱
- 5.4 QueryHandler - 查询物品信息
- 6. Friend Handler - 好友相关Handler
- 6.1 ApplyHandler - 申请添加好友
- 6.2 ApplyAgreeHandler - 同意好友申请
- 6.3 ApplyRefuseHandler - 拒绝好友申请
- 6.4 ApplyListHandler - 获取好友申请列表
- 6.5 ApplyL2Handler - L2好友申请
- 6.6 ApplyMyHandler - 我的好友申请
- 6.7 ListHandler - 获取好友列表
- 6.8 DeleteHandler - 删除好友
- 7. Shop Handler - 商店相关Handler
- 7.1 BuyHandler - 购买商品
- 7.2 QueryHandler - 查询商品信息
- 8. Matchexchange Handler - 撮合交易Handler
- 8.1 OpenHandler - 开启交易所
- 8.2 AddHandler - 添加交易订单
- 8.3 CancelHandler - 取消交易订单
- 8.4 ListHandler - 获取交易订单列表
- 8.5 MyHandler - 获取我的交易订单
- 9. Promotion Handler - 推广相关Handler
- 9.1 InfoHandler - 获取推广信息
- 9.2 ListHandler - 获取推广列表
- 10. Test Handler - 测试相关Handler
- 10.1 ActivityTimeTestHandler - 活动时间测试
1. Public Handler
公共接口Handler，处理不需要特殊权限的请求。
1.1 TokenHandler ✅
文件: app/Module/AppGame/Handler/Public/TokenHandler.php
功能: 获取访问令牌
请求: RequestPublicToken
响应: ResponsePublicToken
需要登录: ❌
实现状态: ✅ 已完成
1.2 LoginHandler ✅
文件: app/Module/AppGame/Handler/Public/LoginHandler.php
功能: 用户登录
请求: RequestPublicLogin
响应: ResponsePublicLogin
需要登录: ❌
实现状态: ✅ 已完成
1.3 Login4uHandler ✅
文件: app/Module/AppGame/Handler/Public/Login4uHandler.php
功能: 4U系统登录
需要登录: ❌
实现状态: ✅ 已完成
1.4 Login4ursHandler ✅
文件: app/Module/AppGame/Handler/Public/Login4ursHandler.php
功能: URS系统登录
需要登录: ❌
实现状态: ✅ 已完成
1.5 RegisterHandler ✅
文件: app/Module/AppGame/Handler/Public/RegisterHandler.php
功能: 用户注册
请求: RequestPublicRegister
响应: ResponsePublicRegister
需要登录: ❌
实现状态: ✅ 已完成
1.6 PlayerDataHandler ✅
文件: app/Module/AppGame/Handler/Public/PlayerDataHandler.php
功能: 获取玩家公共数据（其他玩家可见的信息）
请求: RequestPublicPlayerData
user_id(int64) - 目标用户ID
响应: ResponsePublicPlayerData
user_info(PublicUserInfo) - 用户基本信息gods_info(PublicGod[]) - 神像数据land_info(PublicLand[]) - 土地数据
需要登录: ✅
实现状态: ✅ 已完成
最后更新: 2025-07-08
说明:
- 返回指定用户的公共可见信息
- 包括用户基本信息（昵称、头像、皮肤）
- 包括神像激活状态（4种神像）
- 包括土地信息和作物状态
- 支持查看其他玩家的农场信息
1.7 SendSmsHandler ✅
文件: app/Module/AppGame/Handler/Public/SendSmsHandler.php
功能: 发送短信验证码
需要登录: ❌
实现状态: ✅ 已完成
1.8 CheckCodeHandler ✅
文件: app/Module/AppGame/Handler/Public/CheckCodeHandler.php
功能: 验证短信验证码
需要登录: ❌
实现状态: ✅ 已完成
1.9 DeviceInfoHandler ✅
文件: app/Module/AppGame/Handler/Public/DeviceInfoHandler.php
功能: 上报设备信息
需要登录: ❌
实现状态: ✅ 已完成
2. User Handler
用户相关Handler，处理用户账户、信息管理等功能。
2.1 DataHandler ✅
文件: app/Module/AppGame/Handler/User/DataHandler.php
功能: 获取当前用户完整数据
请求: RequestUserData
响应: ResponseUserData
- 包含用户完整信息、物品、货币、房屋、土地、神像、宠物等数据
需要登录: ✅
实现状态: ✅ 已完成
说明:
- 获取当前登录用户的完整游戏数据
- 包含所有模块的相关信息
- 用于游戏主界面数据加载
2.2 EditinfoHandler ✅
文件: app/Module/AppGame/Handler/User/EditinfoHandler.php
功能: 编辑用户信息
需要登录: ✅
实现状态: ✅ 已完成
2.3 EditPasswordHandler ✅
文件: app/Module/AppGame/Handler/User/EditPasswordHandler.php
功能: 修改用户密码
需要登录: ✅
实现状态: ✅ 已完成
2.4 GameSkinHandler ✅
文件: app/Module/AppGame/Handler/User/GameSkinHandler.php
功能: 游戏皮肤管理
需要登录: ✅
实现状态: ✅ 已完成
2.5 LogoutHandler ✅
文件: app/Module/AppGame/Handler/User/LogoutHandler.php
功能: 用户登出
需要登录: ✅
实现状态: ✅ 已完成
2.6 QueryDataHandler ✅
文件: app/Module/AppGame/Handler/User/QueryDataHandler.php
功能: 查询用户数据
需要登录: ✅
实现状态: ✅ 已完成
2.7 LogDataHandler ✅
文件: app/Module/AppGame/Handler/User/LogDataHandler.php
功能: 获取用户日志数据
需要登录: ✅
实现状态: ✅ 已完成
2.8 ClearLogHandler ✅
文件: app/Module/AppGame/Handler/User/ClearLogHandler.php
功能: 清理用户日志
需要登录: ✅
实现状态: ✅ 已完成
3. Farm Handler
农场相关Handler，处理种植、收获、土地管理等功能。
3.1 Land相关
3.1.1 SowHandler ✅
文件: app/Module/AppGame/Handler/Land/SowHandler.php
功能: 种植种子
需要登录: ✅
实现状态: ✅ 已完成
3.1.2 HarvestHandler ✅
文件: app/Module/AppGame/Handler/Land/HarvestHandler.php
功能: 收获作物
需要登录: ✅
实现状态: ✅ 已完成
3.1.3 UpHandler ✅
文件: app/Module/AppGame/Handler/Land/UpHandler.php
功能: 升级土地
需要登录: ✅
实现状态: ✅ 已完成
3.1.4 FertilizerHandler ✅
文件: app/Module/AppGame/Handler/Land/FertilizerHandler.php
功能: 使用化肥
需要登录: ✅
实现状态: ✅ 已完成
3.1.5 PesticideHandler ✅
文件: app/Module/AppGame/Handler/Land/PesticideHandler.php
功能: 使用农药（除虫）
需要登录: ✅
实现状态: ✅ 已完成
3.1.6 WateringHandler ✅
文件: app/Module/AppGame/Handler/Land/WateringHandler.php
功能: 浇水
需要登录: ✅
实现状态: ✅ 已完成
3.1.7 WeedicideHandler ✅
文件: app/Module/AppGame/Handler/Land/WeedicideHandler.php
功能: 使用除草剂
需要登录: ✅
实现状态: ✅ 已完成
3.1.8 RemoveCropHandler ✅
文件: app/Module/AppGame/Handler/Land/RemoveCropHandler.php
功能: 移除作物
需要登录: ✅
实现状态: ✅ 已完成
3.2 House相关
3.2.1 UpHandler ✅
文件: app/Module/AppGame/Handler/House/UpHandler.php
功能: 升级房屋
需要登录: ✅
实现状态: ✅ 已完成
3.2.2 RankHandler ✅
文件: app/Module/AppGame/Handler/House/RankHandler.php
功能: 房屋等级排行榜
需要登录: ✅
实现状态: ✅ 已完成
3.2.3 RankfundHandler ✅
文件: app/Module/AppGame/Handler/House/RankfundHandler.php
功能: 房屋资金排行榜
需要登录: ✅
实现状态: ✅ 已完成
3.3 God相关
3.3.1 OpenHandler ✅
文件: app/Module/AppGame/Handler/God/OpenHandler.php
功能: 激活神像
需要登录: ✅
实现状态: ✅ 已完成
4. Pet Handler
宠物相关Handler，处理宠物管理、技能使用等功能。
4.1 DataHandler ✅
文件: app/Module/AppGame/Handler/Pet/DataHandler.php
功能: 获取宠物数据
需要登录: ✅
实现状态: ✅ 已完成
4.2 GetHandler ✅
文件: app/Module/AppGame/Handler/Pet/GetHandler.php
功能: 获取宠物
需要登录: ✅
实现状态: ✅ 已完成
4.3 EatHandler ✅
文件: app/Module/AppGame/Handler/Pet/EatHandler.php
功能: 宠物进食
需要登录: ✅
实现状态: ✅ 已完成
4.4 TrainHandler ✅
文件: app/Module/AppGame/Handler/Pet/TrainHandler.php
功能: 宠物训练
需要登录: ✅
实现状态: ✅ 已完成
4.5 TrainSaveHandler ✅
文件: app/Module/AppGame/Handler/Pet/TrainSaveHandler.php
功能: 保存宠物训练结果
需要登录: ✅
实现状态: ✅ 已完成
4.6 LifeSkillUseHandler ✅
文件: app/Module/AppGame/Handler/Pet/LifeSkillUseHandler.php
功能: 使用宠物生活技能
需要登录: ✅
实现状态: ✅ 已完成
4.7 VegetealHandler ✅
文件: app/Module/AppGame/Handler/Pet/VegetealHandler.php
功能: 宠物摘菜功能
需要登录: ✅
实现状态: ✅ 已完成
4.8 RankHandler ✅
文件: app/Module/AppGame/Handler/Pet/RankHandler.php
功能: 宠物排行榜
需要登录: ✅
实现状态: ✅ 已完成
5. Item Handler
物品相关Handler，处理物品使用、合成、分解等功能。
5.1 CraftHandler ✅
文件: app/Module/AppGame/Handler/Item/CraftHandler.php
功能: 物品合成
需要登录: ✅
实现状态: ✅ 已完成
5.2 DismantleHandler ✅
文件: app/Module/AppGame/Handler/Item/DismantleHandler.php
功能: 物品分解
需要登录: ✅
实现状态: ✅ 已完成
5.3 OpenboxHandler ✅
文件: app/Module/AppGame/Handler/Item/OpenboxHandler.php
功能: 开启宝箱
需要登录: ✅
实现状态: ✅ 已完成
5.4 QueryHandler ✅
文件: app/Module/AppGame/Handler/Item/QueryHandler.php
功能: 查询物品信息
需要登录: ✅
实现状态: ✅ 已完成
6. Friend Handler
好友相关Handler，处理好友申请、管理等功能。
6.1 ApplyHandler ✅
文件: app/Module/AppGame/Handler/Friend/ApplyHandler.php
功能: 申请添加好友
需要登录: ✅
实现状态: ✅ 已完成
6.2 ApplyAgreeHandler ✅
文件: app/Module/AppGame/Handler/Friend/ApplyAgreeHandler.php
功能: 同意好友申请
需要登录: ✅
实现状态: ✅ 已完成
6.3 ApplyRefuseHandler ✅
文件: app/Module/AppGame/Handler/Friend/ApplyRefuseHandler.php
功能: 拒绝好友申请
需要登录: ✅
实现状态: ✅ 已完成
6.4 ApplyListHandler ✅
文件: app/Module/AppGame/Handler/Friend/ApplyListHandler.php
功能: 获取好友申请列表
需要登录: ✅
实现状态: ✅ 已完成
6.5 ApplyL2Handler ✅
文件: app/Module/AppGame/Handler/Friend/ApplyL2Handler.php
功能: L2好友申请
需要登录: ✅
实现状态: ✅ 已完成
6.6 ApplyMyHandler ✅
文件: app/Module/AppGame/Handler/Friend/ApplyMyHandler.php
功能: 我的好友申请
需要登录: ✅
实现状态: ✅ 已完成
6.7 ListHandler ✅
文件: app/Module/AppGame/Handler/Friend/ListHandler.php
功能: 获取好友列表
需要登录: ✅
实现状态: ✅ 已完成
6.8 DeleteHandler ✅
文件: app/Module/AppGame/Handler/Friend/DeleteHandler.php
功能: 删除好友
需要登录: ✅
实现状态: ✅ 已完成
7. Shop Handler
商店相关Handler，处理商品购买、促销等功能。
7.1 BuyHandler ✅
文件: app/Module/AppGame/Handler/Shop/BuyHandler.php
功能: 购买商品
需要登录: ✅
实现状态: ✅ 已完成
7.2 QueryHandler ✅
文件: app/Module/AppGame/Handler/Shop/QueryHandler.php
功能: 查询商品信息
需要登录: ✅
实现状态: ✅ 已完成
8. Matchexchange Handler
撮合交易相关Handler，处理交易所功能。
8.1 OpenHandler ✅
文件: app/Module/AppGame/Handler/Matchexchange/OpenHandler.php
功能: 开启交易所
需要登录: ✅
实现状态: ✅ 已完成
8.2 AddHandler ✅
文件: app/Module/AppGame/Handler/Matchexchange/AddHandler.php
功能: 添加交易订单
需要登录: ✅
实现状态: ✅ 已完成
8.3 CancelHandler ✅
文件: app/Module/AppGame/Handler/Matchexchange/CancelHandler.php
功能: 取消交易订单
需要登录: ✅
实现状态: ✅ 已完成
8.4 ListHandler ✅
文件: app/Module/AppGame/Handler/Matchexchange/ListHandler.php
功能: 获取交易订单列表
需要登录: ✅
实现状态: ✅ 已完成
8.5 MyHandler ✅
文件: app/Module/AppGame/Handler/Matchexchange/MyHandler.php
功能: 获取我的交易订单
需要登录: ✅
实现状态: ✅ 已完成
9. Promotion Handler
推广相关Handler，处理推广系统功能。
9.1 InfoHandler ✅
文件: app/Module/AppGame/Handler/Promotion/InfoHandler.php
功能: 获取推广信息
需要登录: ✅
实现状态: ✅ 已完成
9.2 ListHandler ✅
文件: app/Module/AppGame/Handler/Promotion/ListHandler.php
功能: 获取推广列表
需要登录: ✅
实现状态: ✅ 已完成
10. Test Handler
测试相关Handler，处理测试功能。
10.1 ActivityTimeTestHandler ✅
文件: app/Module/AppGame/Handler/Test/ActivityTimeTestHandler.php
功能: 活动时间测试
需要登录: ✅
实现状态: ✅ 已完成
说明: 用于测试活动时间相关功能
状态说明
- ✅ 已完成: Handler已实现并测试通过
- 🚧 开发中: Handler正在开发中
- 📋 计划中: Handler已规划但未开始开发
- ❌ 已废弃: Handler已不再使用
维护说明
- 新增Handler时请及时更新此文档
- Handler状态变更时请更新对应状态标识
- 重要变更请在说明中注明更新时间
- 建议按模块分类组织Handler信息