膳逸：用户每日打卡模块开发文档

最新推荐文章于 2024-08-26 16:32:13 发布
最新推荐文章于 2024-08-26 16:32:13 发布
阅读量818 收藏 17
点赞数 17
分类专栏： 膳逸 文章标签： 数据库 java maven
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Ban_Xiang/article/details/139907912
版权

后端开发文档

文章目录

1. 用户每日打卡

设计思路

用户每日打卡功能允许用户记录每日的心情、活动等信息。每条打卡记录包含用户ID、文本内容、时间、图片和分析字段。通过数据库插入操作，将用户的打卡信息存储到数据库中。

实现过程

  1. 数据模型定义：

        @NotNull(message = "userId不能为空")
    private Integer userId;

    @NotNull(message = "text不能为空")
    @Size(max = 255, message = "text最大长度为255")
    private String text;

    @NotNull(message = "time不能为空")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private DateTime time;

    @NotNull(message = "images不能为空")
    private String images;

    private String analysis;

  2. 数据库插入操作：

    <!-- 用户每日打卡 -->
    <insert id="checkIn" parameterType="Map">
        insert into check_in(user_id, text, time, images, analysis)
        values (#{userId}, #{text}, #{time}, #{images}, #{analysis})
    </insert>

这样实现的好处

  • 数据完整性：通过注解确保所有必填字段不为空，保证数据的完整性。
  • 灵活性：支持用户输入文本、图片和时间，满足多样化的打卡需求。
  • 扩展性：可以轻松添加新的字段或功能，如分析字段。

POST 用户每日打卡

POST /user/checkIn

用户每日打卡

Body 请求参数

{
  "userId": 5,
  "text": "今天打卡测试",
  "time": "2024-05-24 08:16:46",
  "images": "https://lhplanet-1316168555.cos.ap-beijing.myqcloud.com/shanyi/development-documentation/development-documentation-v3.0.assets/202405241119574.png",
  "analysis": ""
}

请求参数

名称位置类型必选说明
tokenheaderstring否none
bodybodyobject否none
» userIdbodyinteger是none
» textbodystring是none
» timebodystring是none
» imagesbodystring是none

返回示例

成功

{
  "msg": "success",
  "code": 200
}

返回结果

状态码状态码含义说明数据模型
200OK成功Inline

返回数据结构

状态码 200

名称类型必选约束中文名说明
» codeintegertruenonenone
» msgstringtruenonenone

2. 分页查询用户每日打卡

设计思路

分页查询功能允许用户按页查看打卡记录，并支持按用户ID、昵称、姓名、时间范围和排序方式进行筛选。

实现过程

  1. 数据模型定义：

        @NotNull(message = "page不能为空")
    @Min(value = 1, message = "page最小值为1")
    private Integer page;

    @NotNull(message = "length不能为空")
    @Range(min = 1, max = 50, message = "length每页长度不正确，最小1，最大50")
    private Integer length;

    private Integer userId;
    private String nickName;
    private String name;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private DateTime startTime;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private DateTime endTime;

    @NotNull(message = "排序不能为空")
    private String order;

  2. 分页查询接口：

        @PostMapping("/searchCheckInByPage")
    @SaCheckLogin
    public R searchCheckInByPage(@RequestBody @Valid searchCheckInByPageForm form) throws ParseException {
        Map param = BeanUtil.beanToMap(form);
        int page = form.getPage();
        int length = form.getLength();
        int start = (page - 1) * length;
        param.put("start", start);
        PageUtils pageUtils = userService.searchCheckInByPage(param);
        return R.ok().put("result", pageUtils);
    }

  3. 服务层实现：

        @Override
    public PageUtils searchCheckInByPage(Map param) {
        ArrayList<HashMap> list = null;
        long count = userDao.countUserCheckIn(param);
        if (count > 0) {
            list = userDao.searchCheckInByPage(param);
        } else {
            list = new ArrayList<>();
        }
        int page = MapUtil.getInt(param, "page");
        int length = MapUtil.getInt(param, "length");
        PageUtils pageUtils = new PageUtils(list, count, page, length);
        return pageUtils;
    }

  4. 数据库查询操作：

    <!-- 查询用户打卡总数 -->
    <select id="countUserCheckIn" parameterType="Map" resultType="long">
        SELECT COUNT(*)
        FROM check_in ci
        JOIN (
            SELECT u.id AS user_id
            FROM user u
            JOIN user_info ui ON u.id = ui.user_id
            WHERE 1 = 1
            <if test="userId != null and userId != ''">
                AND u.id = #{userId}
            </if>
            <if test="nickName != null and nickName != ''">
                AND u.nick_name LIKE CONCAT('%', #{nickName}, '%')
            </if>
            <if test="name != null and name != ''">
                AND ui.name LIKE CONCAT('%', #{name}, '%')
            </if>
        ) sub ON ci.user_id = sub.user_id
        WHERE 1 = 1
        <if test="startTime != null">
            AND ci.time &gt;= #{startTime}
        </if>
        <if test="endTime != null">
            AND ci.time &lt;= #{endTime}
        </if>
    </select>

    <!-- 分页查询用户打卡记录 -->
    <select id="searchCheckInByPage" parameterType="Map" resultType="HashMap">
        SELECT u.nick_name AS nickName,
               ui.name,
               ci.id,
               ci.user_id,
               ci.time,
               ci.text,
               ci.images,
               ci.analysis
        FROM check_in ci
        JOIN user u ON ci.user_id = u.id
        JOIN user_info ui ON u.id = ui.user_id
        WHERE 1 = 1
        <if test="userId != null and userId != ''">
            AND u.id = #{userId}
        </if>
        <if test="nickName != null and nickName != ''">
            AND u.nick_name LIKE CONCAT('%', #{nickName}, '%')
        </if>
        <if test="name != null and name != ''">
            AND ui.name LIKE CONCAT('%', #{name}, '%')
        </if>
        <if test="startTime != null">
            AND ci.time &gt;= #{startTime}
        </if>
        <if test="endTime != null">
            AND ci.time &lt;= #{endTime}
        </if>
        <if test="order == 'desc' ">
            ORDER BY ci.time desc
        </if>
        <if test="order == 'asc' ">
            ORDER BY ci.time asc
        </if>
        LIMIT #{length} OFFSET #{start}
    </select>

这样实现的好处

  • 高效查询：通过分页查询减少一次性查询的数据量，提高查询效率。
  • 灵活筛选：支持多种筛选条件，满足用户的个性化需求。
  • 排序功能：支持按时间升序或降序排序，方便用户查看。

POST 查询用户的打卡信息

POST /user/searchCheckInByPage

查询某一个关注的用户的打卡信息，可以按时间排序也可以默认由近到远，需要被关注的那个用户的id

Body 请求参数

{
  "page": 1,
  "length": 10,
  "userId": 5,
  "startTime": "",
  "endTime": "",
  "order": "desc"
}

请求参数

名称位置类型必选说明
tokenheaderstring否none
bodybodyobject否none
» pagebodyinteger是none
» lengthbodyinteger是最小1，最大50
» userIdbodyinteger是要查询的那个用户的id
» startTimebodystring否none
» endTimebodystring否none
» orderbodystring是按照打卡时间排序，desc或者asc

返回示例

成功

{
  "msg": "success",
  "result": {
    "totalCount": 2,
    "pageSize": 10,
    "totalPage": 1,
    "pageIndex": 1,
    "list": [
      {
        "images": "https://thirdwx.qlogo.cn/mmopen/vi_32/6ibtnStKibXDUTibnu052w40ps0DKqcUZBYaAiberiasgSsTGXwCLAicmXng2gE48ZnibYrmnPIiaVlNWjpCYiby85ibgM8Q/132",
        "user_id": 5,
        "nickName": "绊象",
        "name": "陈泽胜",
        "time": "2024-07-11T18:40:02",
        "text": "今天打卡",
        "analysis": "暂无"
      },
      {
        "images": "https://thirdwx.qlogo.cn/mmopen/vi_32/6ibtnStKibXDUTibnu052w40ps0DKqcUZBYaAiberiasgSsTGXwCLAicmXng2gE48ZnibYrmnPIiaVlNWjpCYiby85ibgM8Q/132",
        "user_id": 5,
        "nickName": "绊象",
        "name": "陈泽胜",
        "time": "2024-05-21T10:00:00",
        "text": "今天打卡",
        "analysis": "暂无"
      }
    ]
  },
  "code": 200
}

返回结果

状态码状态码含义说明数据模型
200OK成功Inline

返回数据结构

状态码 200

名称类型必选约束中文名说明
» msgstringtruenonenone
» resultobjecttruenonenone
»» totalCountintegertruenonenone
»» pageSizeintegertruenonenone
»» totalPageintegertruenonenone
»» pageIndexintegertruenonenone
»» list[object]truenonenone
»»» imagesstringtruenonenone
»»» user_idintegertruenonenone
»»» nickNamestringtruenonenone
»»» namestringtruenonenone
»»» timestringtruenonenone
»»» textstringtruenonenone
»»» analysisstringtruenonenone
» codeintegertruenonenone

3. 用户修改每日打卡信息

设计思路

用户可以修改已存在的打卡记录，包括文本内容、时间和图片。通过数据库更新操作，将修改后的信息保存到数据库中。

实现过程

  1. 数据模型定义：

        @NotNull(message = "checkInId不能为空")
    private Integer checkInId;

    @NotNull(message = "text不能为空")
    @Size(max = 255, message = "text最大长度为255")
    private String text;

    @NotNull(message = "time不能为空")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private DateTime time;

    @NotNull(message = "images不能为空")
    private String images;

  2. 数据库更新操作：

    <!-- 修改用户每日打卡信息 -->
    <update id="updateCheckIn" parameterType="Map">
        UPDATE check_in
        SET text = #{text},
            time = #{time},
            images = #{images}
        WHERE id = #{checkInId};
    </update>

这样实现的好处

  • 数据更新：允许用户修改已存在的打卡记录，保持数据的动态更新。
  • 灵活性：支持修改文本、时间和图片，满足用户的多样化需求。

POST 用户修改每日打卡信息

POST /user/updateCheckIn

Body 请求参数

{
  "checkInId": 1,
  "text": "修改打卡信息",
  "time": "2024-06-21 10:00:00",
  "images": "http://dummyimage.com/300x300"
}

请求参数

名称位置类型必选说明
tokenheaderstring否none
bodybodyobject否none
» checkInIdbodyinteger是none
» textbodystring是none
» timebodystring是none
» imagesbodystring是none

返回示例

200 Response

{
  "code": "string",
  "msg": "string"
}

返回结果

状态码状态码含义说明数据模型
200OK成功Inline

返回数据结构

状态码 200

名称类型必选约束中文名说明
» codestringtruenonenone
» msgstringtruenonenone

4. 用户删除每日打卡信息

设计思路

用户可以删除已存在的打卡记录，通过数据库删除操作，将指定的打卡记录从数据库中移除。

实现过程

  1. 数据模型定义：

        @NotNull(message = "checkInId不能为空")
    private Integer checkInId;

  2. 数据库删除操作：

    <!-- 删除用户打卡信息 -->
    <delete id="deleteCheckIn" parameterType="Map">
        delete from check_in where id = #{checkInId}
    </delete>

POST 用户删除每日打卡信息

POST /user/deleteCheckIn

Body 请求参数

{
  "checkInId": 2
}

请求参数

名称位置类型必选说明
tokenheaderstring否none
bodybodyobject否none
» checkInIdbodyinteger是none

返回示例

200 Response

{
  "code": "string",
  "msg": "string"
}

返回结果

状态码状态码含义说明数据模型
200OK成功Inline

返回数据结构

状态码 200

名称类型必选约束中文名说明
» codestringtruenonenone
» msgstringtruenonenone

五.查询用户总共打卡多少天

设计思路

该功能用于查询用户总共打卡的天数。通过统计用户在数据库中打卡记录的不同日期，计算出用户总共打卡了多少天。

实现过程

数据模型定义

@NotNull(message = "userId不能为空")
private Integer userId;

数据库查询操作

<select id="countMyCheckIn" parameterType="Map" resultType="java.lang.Long">
    select count(distinct date(time)) from check_in
    where user_id = #{userId}
</select>

这样实现的好处

  • 准确统计：通过统计不同日期的打卡记录，准确计算用户总共打卡的天数。
  • 高效查询：使用 distinct 和 count 组合，确保查询效率和准确性。
  • 简单易用：只需提供用户ID即可获取打卡天数，接口设计简洁明了。

POST 查询总共打卡多少天

POST /user/countMyCheckIn

查询自己总共打卡多少天

Body 请求参数

{
  "userId": 5
}

请求参数

名称位置类型必选说明
tokenheaderstring否none
bodybodyobject否none
» userIdbodyinteger是none

返回示例

成功

{
  "msg": "success",
  "result": 2,
  "code": 200
}

返回结果

状态码状态码含义说明数据模型
200OK成功Inline

返回数据结构

状态码 200

名称类型必选约束中文名说明
» codeintegertruenonenone
» msgstringtruenonenone
» resultintegertruenonenone
Ban_Xiang
关注
  • 17
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
微信小程序｜基于小程序实现定位打卡功能
商务合作 / 项目定制 / 学习交流。个人vx：lovely_wml
10-12 9538
此文主要在小程序内实现打卡功能，可根据用户位置与公司设定的打卡范围实时判断打卡是否合法，并在后台对打卡记录进行管理。
leetcode卡-leetcode:leetcode每日打卡尽量
07-06
"LeetCode卡"的概念就是鼓励用户每日在LeetCode上进行练习和打卡，以保持持续的学习状态。 LeetCode的每日打卡不仅是一种自我提升的方式，也是对编程技巧的一种系统性训练。每天解决一道或几道LeetCode的题目，可以...
膳逸：用户活动打卡功能开发文档
Prored的博客
06-24 1509
膳逸：用户活动打卡功能开发文档
膳逸：用户活动打卡相关开发文档
Ban_Xiang的博客
06-24 1932
膳逸：用户活动打卡相关开发文档
膳逸用户端：用户每日打卡模块（每日打卡、查询修改删除每日打卡信息、查询总共打卡天数）
2201_75305720的博客
05-30 864
膳逸用户端：用户每日打卡模块（每日打卡、查询修改删除每日打卡信息、查询总共打卡天数）
膳逸用户端：活动打卡模块内容修改更新（参与活动、活动打卡、查询、修改、删除活动打卡信息）
Prored的博客
06-23 1557
膳逸用户端：活动打卡模块内容修改更新（参与活动、活动打卡、查询、修改、删除活动打卡信息）
微信小程序：自动生成打卡海报
蓝色是天的博客
06-26 2068
在本文中，我们介绍了一款背单词小程序的开发计划，重点是自动生成打卡海报功能。通过这一功能，用户可以将学习成果以精美的海报形式展示，并分享至朋友圈，增强学习的成就感和社交互动。我们还讨论了在海报中嵌入小程序二维码的策略，以便更好地推广小程序。通过持续丰富海报内容、提供个性化选择，我们旨在提升用户参与度和推广效果，为用户带来更好的学习体验。未来，我们将继续优化海报功能，不断创新，实现小程序的进一步发展和成功。
洛谷P1664 每日打卡心情好
水蛙菌
02-16 8064
题目链接 题目背景 在洛谷中，打卡不只是一个简单的鼠标点击动作，通过每天在洛谷打卡，可以清晰地记录下自己在洛谷学习的足迹。通过每天打卡，来不断地暗示自己：我又在洛谷学习了一天，进而帮助自己培养恒心、耐心、细心。此外，通过打卡，还可以获取经验值奖励，经验值的多少在一定程度上反映了你在洛谷的资历和成就。通过打卡累积活跃值，渐渐升级，会让你感觉“离神犇越来越近了”。 题目描述 洛谷的打卡系统与其他网站的打卡系统一样，连续”打卡天数越多，每次打卡获得的奖励也就越多，同时连续天数加上一天。然而，于其他网站只要一天不打
每日打卡熬夜挑战比赛/文字搭建教程
linxiaoming6的博客
12-07 2548
简介： 教程说明： 测试环境：宝塔面板 + Nginx1.18 + PHP7.0 + mysql5.6 数据库配置文件 Application/Common/Conf/config.php 后台/admin 用户：admin 密码：admin 配置文件 Public/ptpaysdk/core/ptpay_config.php 开户网址 https://www.pet0.cn/ 伪静态设置为 ThinkPHP 网盘下载地址： http://kekewl.org/ziyGm0cw1DA0 图片：
考勤打卡模块设计与实现
分享Java，vue学学习笔记
04-27 1530
又到了做毕业设计的阶段了! 最近帮朋友做了一个打卡的功能模块，要求定位获取当前位置与固定地点判断在可打卡范围进行打卡，也没有接触过地图类的开发，刚开始用高德地图弄了一天也没有弄上，查了很多的大佬文章也没有弄好，不知道其中哪个环节出错了，但是发现高德在去年12月就改版了需要https 才可以进行精准定位，后来我又用百度地图可算是行了。这不来分享一下我做的时候学习到一些新知识点分享给大家。 打卡功能首先判断用户当天是否签到记录，并且在0点进行新的一天 判断当天是否有签到记录 我所用到的函数（DATE_FO
Android开发日志打卡APP（一）
热门推荐
ws15168689087的博客
07-15 2万+
Android开发日志打卡APP（详细） 文章目录Android开发日志打卡APP（详细）简介界面展示内容总结1.控件2.布局3.技术开发过程准备工作启动页面 简介 ​ 初学Kotlin和安卓开发，期末大作业是要开发一款APP。因为是一个人一组，所以选择了较为简单的日志打卡，因为知识的局限性，做的App在功能上较为简单，并且代码和项目结构有些凌乱。从开始做到结束做了近半个月，中途遇到过大大小小的困难，最后因为快到验收时间，没有完全做完。 界面展示 ​ App设置了3大界面：首页、统计界面、设置界面 [外链图
LeetCodeEveryDay:每日LeetCode打卡
03-07
《LeetCodeEveryDay:每日LeetCode打卡》是针对程序员提升编程技能的一项挑战活动。通过每日解决LeetCode上的问题，你可以深化对数据结构、算法以及Java编程语言的理解。LeetCode是一个在线平台，它提供了各种编程...
zzulidakadocs：轻工大健康打卡脚本文档
02-14
欢迎使用轻大健康打卡脚本：id = helloworld 手机访问请点击左下角按钮展开侧边栏 如何使用 请点击侧边预算项目获取帮助 脚本简介 通过定时发送数据包到学校服务器实现打卡 关于作者 ：国教20级 ：数信20级 获取...
竞品分析：插旗打卡 VS 小打卡.pdf
07-22
竞品分析：插旗打卡 VS 小打卡.pdf
leetcode卡-leetcode:每日打卡题
07-06
leetcode卡 leetcode 每日打卡题
修复数据库中的 “Access Denied: SUPER Privilege Required” 错误
最新发布
xiaochong0302的博客
08-26 224
当您使用数据库时，您可能会看到错误消息：“Access denied; you need (at least one of) the SUPER privilege(s) for this operation”。当您的数据库用户没有足够的权限来执行某些操作时，就会发生这种情况。
汉服文化平台网站
heye0910032的博客
08-26 233
本文主要探讨了使用Java语言开发汉服文化平台网站的全过程。系统采用B/S架构，严格遵循软件开发流程，从分析、设计到实现，确保了项目的系统性和科学性。系统主要面向管理员和用户两大类使用者，提供了包括首页、个人中心、汉服知识管理、服装展示管理、用户相册管理、论坛交流、系统管理、订单管理等功能。本系统的应用，旨在实现汉服文化信息管理的信息化，提高管理效率，方便用户访问和交流。通过本毕业设计，我深入学习并实践了Java语言和SSM框架在Web开发中的应用。
Android架构组件：MVVM模式的实战应用
m0_66995023的博客
08-22 396
在 Android 开发中，MVVM（Model-View-ViewModel）模式是一种非常流行的架构模式，它可以帮助开发者更好地组织代码，使得应用程序更加模块化、易于维护。用途：在 ViewModel 中使用，当数据发生变化时通知 View 更新。职责：作为 Model 和 View 之间的桥梁，处理 UI 相关的逻辑。实例：持有数据和 UI 相关的状态，处理用户输入，更新 UI 等。用途：实现 View 和 ViewModel 之间的双向绑定。特点：简化 UI 更新逻辑，减少手动更新 UI 的代码。
谷粒商城实战笔记-236~238-商城业务-购物车-环境搭建
epitomizelu的专栏
08-22 911
这一节的内容主要分析购物的业务逻辑和设计存储购物车的选型及数据结构。①把整个购物车封装为一个对象CartVo。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值