基于 SpringBoot + Redis 的「钓鱼佬」网页游戏实战：Redisson 数据模型与全玩法实现

文档教程后端【免费下载链接】CodeGuide:books: 本代码库是作者小傅哥多年从事一线互联网 Java 开发的学习历程技术汇总旨在为大家提供一个清晰详细的学习教程侧重点更倾向编写Java核心内容。如果本仓库能为您提供帮助请给予支持(关注、点赞、分享)项目地址https://gitcode.com/gh_mirrors/code/CodeGuide点击查看免费下载「钓鱼佬」是仓库 docs/md/project/xfg-fish-pond/xfg-fish-pond.md 中讲解的一个轻量级网页游戏项目以 SpringBoot Redis 为技术底座提供 Java、Python 双版本实现通过登录、画鱼、鱼塘、钓鱼、投票、签到积分等玩法把 Redisson 对 Redis 各类数据结构Map、Set、String的常用操作串联成一套完整的实战案例。读完本文你将掌握该项目的整体玩法与启动方式理解用户会话、积分、鱼类、钓鱼记录、投票统计、健康检查等六大模块的 Redis 存储设计并结合仓库内大营销、AI MCP Gateway 等项目的源码看懂 Redisson 客户端配置、IRedisService 封装与分布式场景的进阶用法。一、项目背景与定位在互联网应用场景中京东、淘宝、拼多多等平台时常会看到游戏化玩法如集卡、浇水、养动物通过这些场景增强用户粘性、提高转化率。这些游戏化场景背后是一套套营销玩法最终把券、积分、物品发放给用户。「钓鱼佬」网页游戏正是对这一类轻量游戏化营销场景的复刻项目以娱乐化的方式让学习者掌握 Redis 技术同时可以与社群内的大营销积分、兑换、返利、抽奖等业务项目做微服务对接形成流程闭环。从仓库 docs/README.md 的项目定位看本仓库是作者多年一线互联网 Java 开发的学习历程技术汇总而「钓鱼佬」属于其中的轻量实战项目类型其特点可以概括为技术栈轻量基于 SpringBoot Redis 实现后端仅有一层架构页面和后端代码都比较简单适合作为 Redis 学习与二次开发的起点。双版本实现项目提供 JavaSpringBoot 服务端 前端代码与 Python 两个版本数据统一使用 Redis 存储。可对接可扩展项目可以与大营销积分、兑换、返利、抽奖对接可以把 AI 场景接入还可以接入小型支付完成买卖鱼的交易甚至扩展在线售卖等玩法。二、运行效果与核心玩法项目整体是一个网页游戏应用围绕鱼构建了完整的用户行为链路。1. 登录用户登录后服务端会把用户信息写入 Redis并维护在线用户列表。登录页是整个玩法的入口所有后续操作画鱼、钓鱼、投票、签到都建立在已登录用户身份之上。2. 画鱼登录用户可以在画布上绘制自己的鱼包含名称、emoji 等属性绘制完成后将鱼投放进鱼塘。投放后这条鱼会出现在所有登录用户可见的公共鱼塘中其他用户可以看到、投票甚至钓走。3. 鱼塘鱼塘页面可以看到所有登录用户投放进来的鱼还可以钓鱼。钓鱼有一定概率把别人的鱼钓到自己的鱼篓里。钓鱼需要消耗积分积分通过每日签到获取。此外页面中还内置了一些问题话术和救赎时间上班摸鱼等于救赎自己等趣味设计增加娱乐性。4. 居民在鱼塘居民页面下可以看到各个伙伴画的鱼并可以对每条鱼点一个喜欢或不喜欢形成投票数据。三、工程结构与项目启动1. 工程代码项目代码由以下部分组成前端代码负责登录、画鱼、鱼塘、居民等页面展示与交互SpringBoot 服务端代码xfg-fish-pond-app提供全部业务接口Python 版本代码同一套玩法的另一种实现。服务端通过redisService统一操作 Redis从调用形式看这是对 Redisson 客户端的轻量封装——这与仓库 docs/md/road-map/redis.md 中使用 Redisson 框架处理 Redis 调用的思路一致。2. 环境与启动配置启动前需要在xfg-fish-pond-app模块下的resources/application-dev.yml中配置 Redis 连接信息核心配置项如下spring: redis: host: localhost # Redis 地址 port: 6379 # Redis 端口 password: 123456 # Redis 密码按实际环境填写 # 连接池、超时等参数可按需补充配置完成后启动项目点击打开页面即可访问。仓库 docs/md/road-map/redis.md 中给出了一套更完整的 Redisson 自定义连接配置参考包含pool-size连接池大小、min-idle-size最小空闲连接数、idle-timeout、connect-timeout连接超时、retry-attempts重试次数、retry-interval重试间隔、ping-interval、keep-alive等参数可作为本项目连接参数调优的参考。3. Docker 部署如果要部署到云服务器可以通过 Docker 构建镜像完成部署这与仓库内其他项目的云部署方式一致可参考 Docker 部署 等相关文档。四、Redis 技术实战六大 Controller 逐一拆解本套项目的数据存储全部基于 Redis 实现是学习 Redis 应用技术的最佳素材。以下六大模块的代码全部来自原文档建议对照源码逐行阅读。1. 用户会话管理UserController登录时存储用户信息RMapString, String userMap redisService.getMap(userKey); userMap.put(userId, userId); userMap.put(username, username); userMap.put(loginTime, LocalDateTime.now().toString()); userMap.expire(86400, TimeUnit.SECONDS); // 24小时过期这里使用 Redis 的 Hash 结构Redisson 的RMap保存单个用户的多字段信息并通过expire设置 24 小时过期实现会话的自动失效。相比字符串拼接序列化Hash 结构便于对单个字段做读写和局部更新。用户列表管理redisService.addSetMember(USER_LIST_KEY, userId); // 添加到在线用户列表 redisService.removeSetMember(USER_LIST_KEY, userId); // 从在线用户列表移除在线用户列表使用 Redis 的 Set 结构对应 Redisson 的RSetSet 天然去重addSetMember/removeSetMember对应 SADD/SREM可以低成本维护一个当前在线用户的集合供鱼塘、居民等页面展示使用。2. 积分系统PointsController积分存储和操作// 获取用户积分 int points Integer.parseInt(pointsMap.getOrDefault(points, 0)); // 更新积分 pointsMap.put(points, String.valueOf(newPoints)); pointsMap.put(lastUpdated, LocalDateTime.now().toString());用户积分同样以 Hash 结构存储points字段记录积分余额lastUpdated记录最近更新时间。读取时用getOrDefault避免首次访问空指针。签到记录String today LocalDate.now().format(DateTimeFormatter.ofPattern(yyyy-MM-dd)); RMapString, String signMap redisService.getMap(signKey); signMap.put(today, LocalDateTime.now().toString());签到以日期为 key 写入 Hash天然保证一天只能签一次重复写同一天的 key 只是覆盖时间戳可用作签到去重校验的依据钓鱼所需的积分就来自每日签到。积分变动记录String recordValue points | type | reason | LocalDateTime.now().toString(); recordsMap.put(recordId, recordValue);积分流水采用管道符拼接的紧凑格式积分|类型|原因|时间每条流水以recordId为 key 存入 Hash。这种以字符串拼接换空间、以 Hash 分片存明细的做法是轻量项目记录审计日志的常见手法。3. 鱼类管理FishController添加鱼到池塘RMapString, String fishMap redisService.getMap(fishKey); fishMap.put(name, fishName); fishMap.put(emoji, emoji); fishMap.put(userId, userId); fishMap.put(createTime, LocalDateTime.now().toString()); // 添加到鱼类列表 redisService.addSetMember(FISH_LIST_KEY, fishId);每条鱼以fishId对应的 Hash 保存属性名称、emoji、所属用户、创建时间同时把fishId加入全局 SetFISH_LIST_KEY用于鱼塘页面的全量遍历。Hash Set 的组合解决了单条鱼的属性读写与所有鱼的列表枚举两个诉求。4. 钓鱼系统FishingController钓鱼记录String recordValue success | fishEmoji | fishName | fishRarity | LocalDateTime.now().toString() | transferred | originalOwner | fishId; recordsMap.put(recordId, recordValue);钓鱼结果被记录为一条完整流水是否成功success、鱼的 emoji 与名称、稀有度fishRarity、时间、是否转移transferred、原主人originalOwner、鱼 ID。transferred与originalOwner字段支撑了把别人的鱼钓到自己鱼篓这一核心玩法鱼的所有权发生了转移原主人信息被保留在记录中。鱼篓管理String fishValue emoji | name | rarity | LocalDateTime.now().toString() | originalFishId | image; basketMap.put(fishId, fishValue);钓到的鱼写入个人鱼篓basketMap保留鱼的完整展示信息并记录originalFishId追溯来源。至此鱼的流转路径完整覆盖画鱼FishController 入库→ 鱼塘展示FISH_LIST_KEY→ 钓鱼转移FishingController 记录 鱼篓落库。5. 投票系统VoteController用户投票记录RMapString, String userVotesMap redisService.getMap(userVotesKey); userVotesMap.put(fishId, voteType); // like 或 dislike以用户为维度记录其对各条鱼的投票key 为 fishId值为 like/dislike后续可通过检查该 Map 判断用户是否已对某条鱼投票实现一人一票。投票统计fishVotesMap.put(likes, String.valueOf(currentLikes)); fishVotesMap.put(dislikes, String.valueOf(currentDislikes)); fishVotesMap.put(score, String.valueOf(currentLikes - currentDislikes));以鱼为维度聚合投票统计likes、dislikes分别累计score作为净得分喜欢数 - 不喜欢数用于居民页面的排序与展示。这里体现了 Redis Hash 做计数器聚合的典型用法——先读旧值、再写新值轻量且直观。6. 系统监控SystemControllerRedis 健康检查// 设置测试值 redisService.setValue(health_check, ok); // 读取测试值 String value redisService.getValue(health_check); // 删除测试值 redisService.remove(health_check); // 获取用户总数 MapString, String userList redisService.getMapAll(user_list);健康检查使用 Redis String 结构完成写入 → 读取 → 删除的探活闭环验证 Redis 服务的连通性与读写能力同时通过getMapAll读取用户列表获取在线用户总数把监控与业务数据结合在了一起。五、源码级延伸Redisson 在仓库中的设计范式「钓鱼佬」项目把 Redis 玩法的覆盖面做得非常全Map、Set、String 一应俱全但它只是仓库 Redis 技术体系中的一环。结合仓库内其他项目的源码可以更完整地理解这套 Redisson 使用范式。1. Redisson 客户端配置与统一服务封装在仓库的 Redis 学习路线文档 中Redisson 客户端通过RedisClientConfigProperties配置类 RedisClientConfig启动类创建配置项覆盖 host、port、password、连接池、超时、重试、心跳等而 AI MCP Gateway 分布式 Redis 设计 一节进一步说明工程在 app 模块 config 包下新增RedisClientConfig和RedisClientConfigProperties创建 Redisson 客户端 Bean并在 infrastructure 层提供IRedisService接口与RedissonService实现类覆盖键值操作、队列、集合、Map、锁、信号量、布隆过滤器、发布订阅等几乎全部 Redis 数据结构操作。「钓鱼佬」代码中的redisService.getMap、addSetMember、setValue等调用正是这类统一服务封装的使用方式——它让业务代码不直接依赖 Redisson API便于统一扩展与替换。2. 从 Map/Set/String 到锁、发布订阅的进阶HashRMap在本项目用于用户信息、积分、鱼属性、投票统计等多字段对象是轻量实体的首选结构SetRSet在本项目用于在线用户列表、鱼类列表承担去重与全量枚举String在本项目用于健康检查在 大营销不超卖库存规则实现 中则用于decr原子扣减库存——文档明确说明decr 是原子操作效率非常高且不要用一条 key 加锁和等待释放的方式来处理要尽可能考虑分摊竞争达到无锁化锁与发布/订阅仓库 Redis 学习路线文档 展示了独占锁RLock lock redissonService.getLock(create_order_lock_ sku)、分段锁/无锁化按sku_decrCount拆分锁 key以及自定义RedisTopic注解动态注入RTopicBean 的发布/订阅高级玩法。3. 与营销系统对接的扩展思路原文档明确说明本项目可以与大营销的积分、兑换、返利、抽奖做微服务对接也可以接入 AI 场景或小型支付实现买卖鱼交易。这种对接思路与仓库中 大营销平台系统 的玩法一致营销平台把券、积分、物品发放给用户而「钓鱼佬」的签到积分、鱼篓资产可以作为营销活动的用户侧载体——例如用积分兑换抽奖机会、用鱼作为可交易资产等把娱乐玩法与营销转化串成闭环。六、扩展玩法与二次开发原文档提供了清晰的扩展方向在线售卖已有伙伴建议让鱼支持在线售卖可在此基础上扩展交易模块可结合小型支付组件实现买卖双方的积分/资金流转AI 辅助开发页面和后端代码都比较简单、后端仅有一层架构可以自己实现扩展也可以使用 trae.ai、Cursor 等 AI 工具辅助开发玩法叠加增加鱼的稀有度概率、钓鱼成功率、签到奖励梯度、排行榜等都能在现有 Hash/Set/String 结构上低成本演进。总而言之这套「钓鱼佬」项目以游戏化场景为载体把 Redisson 操作 Redis 的核心数据结构Map、Set、String融入真实的用户行为链路中配合仓库内 Redis 学习路线文档中的连接池配置、分布式锁、发布/订阅等进阶内容构成了一个从入门到进阶、从单体玩法到分布式对接的完整 Redis 实战学习路径。赞分享文档教程后端【免费下载链接】CodeGuide:books: 本代码库是作者小傅哥多年从事一线互联网 Java 开发的学习历程技术汇总旨在为大家提供一个清晰详细的学习教程侧重点更倾向编写Java核心内容。如果本仓库能为您提供帮助请给予支持(关注、点赞、分享)项目地址https://gitcode.com/gh_mirrors/code/CodeGuide点击查看免费下载相关推荐Wifiphisher 完整实战指南基于 Rogue Access Point 框架的 Wi-Fi 安全测试与网页钓鱼攻击Wifiphisher 完整实战指南基于 Rogue Access Point 框架的 Wi Fi 安全测试与网页钓鱼攻击 Wifiphisher 是一款开源网络安全渗透测试Zphisher Origin模板游戏账户钓鱼Zphisher Origin模板游戏账户钓鱼 概述 Zphisher是一个功能强大的自动化钓鱼工具提供了30多个精心设计的钓鱼模板其中Origin模板专渗透测试网络安全CLIWeKnora Docker部署完整指南3条命令搭起私有RAG知识库WeKnora Docker部署完整指南3条命令搭起私有RAG知识库 想把一堆文档变成可问答的私有 RAG 知识库却不想手工搭建 Postgres、Redi人工智能大模型RAGAI Agent后端前端MCP 服务知识库dsh-plugin工具调用上一篇LibreHardwareMonitor 硬件监控实战指南10分钟跑起来温度电压风扇全掌握下一篇聚惠星商城 dts-shop完整微信小程序商城搭建与部署指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考