提交

yami-shop-service/src/main/java/com/yami/shop/service/NoticeService.java

@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2018-2999 广州市蓝海创新科技有限公司 All rights reserved.
+ *
+ * https://www.mall4j.com/
+ *
+ * 未经允许，不可做商业用途！
+ *
+ * 版权所有，侵权必究！
+ */
+
+// 定义包名，表示这个接口属于com.yami.shop.service包
+        package com.yami.shop.service;
+
+// 导入MyBatis Plus框架中的分页插件的Page类
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+// 导入MyBatis Plus框架中的IService接口，提供基础的CRUD操作
+import com.baomidou.mybatisplus.extension.service.IService;
+// 导入项目中定义的NoticeDto数据传输对象
+import com.yami.shop.bean.app.dto.NoticeDto;
+// 导入项目中定义的Notice实体类
+import com.yami.shop.bean.model.Notice;
+// 导入Java.util.List接口，用于返回列表类型的数据
+import java.util.List;
+
+/**
+ * NoticeService接口的文档注释
+ * 这个接口是用于定义与Notice实体类相关的业务操作，主要用于公告管理
+ *
+ * @author hzm 表示这个接口是由hzm创建的
+ * @date 2019-04-18 21:21:40 表示这个接口是在2019年4月18日创建的
+ */
+public interface NoticeService extends IService<Notice> {
+
+    /**
+     * 获取公告列表的方法
+     * 这个方法返回一个List<Notice>类型的数据，包含了所有的公告实体
+     *
+     * @return 包含所有公告的列表
+     */
+    List<Notice> listNotice();
+
+    /**
+     * 删除公告缓存的方法
+     * 这个方法用于清除与公告相关的缓存，以确保数据的一致性
+     */
+    void removeNoticeList();
+
+    /**
+     * 分页获取公布的公告的方法
+     * 这个方法接受一个Page<NoticeDto>类型的参数，返回一个分页的NoticeDto列表
+     *
+     * @param page 分页参数
+     * @return 分页的公告DTO列表
+     */
+    Page<NoticeDto> pageNotice(Page<NoticeDto> page);
+
+    /**
+     * 根据公告id获取公告的方法
+     * 这个方法接受一个Long类型的公告ID，返回对应的Notice实体
+     *
+     * @param noticeId 公告ID
+     * @return 对应的公告实体
+     */
+    Notice getNoticeById(Long noticeId);
+
+    /**
+     * 根据公告id删除公告的方法
+     * 这个方法接受一个Long类型的公告ID，用于删除对应的公告实体
+     *
+     * @param noticeId 公告ID
+     */
+    void removeNoticeById(Long noticeId);
+}