商品类服务接口/实现类

IDEA/src/main/java/com/example/api/service/CommodityService.java

@@ -0,0 +1,51 @@
+package com.example.api.service;
+
+import com.example.api.model.entity.Commodity; // 导入Commodity实体类，代表商品信息
+
+import java.util.List; // 导入List类，用于处理列表数据
+
+/**
+ * 商品服务接口，定义商品相关的业务操作。
+ */
+public interface CommodityService {
+
+    /**
+     * 保存商品信息。
+     * @param commodity 商品实体对象，包含商品的各个属性
+     * @return 保存后的商品实体对象，包含由数据库生成的ID等信息
+     */
+    Commodity save(Commodity commodity);
+
+    /**
+     * 更新商品信息。
+     * @param commodity 要更新的商品实体对象
+     */
+    void update(Commodity commodity);
+
+    /**
+     * 根据ID删除商品信息。
+     * @param id 要删除的商品ID
+     */
+    void delete(String id);
+
+    /**
+     * 根据ID查询商品信息。
+     * @param id 要查询的商品ID
+     * @return 查询到的商品实体对象，如果没有找到则返回null
+     */
+    Commodity findById(String id);
+
+    /**
+     * 查询所有商品信息。
+     * @return 商品实体对象列表，包含所有商品的详细信息
+     */
+    List<Commodity> findAll();
+
+    /**
+     * 根据商品名称模糊查询商品信息。
+     * @param name 商品名称关键词
+     * @return 与商品名称匹配的商品实体对象列表
+     */
+    List<Commodity> findAllByLikeName(String name);
+
+}

IDEA/src/main/java/com/example/api/service/impl/CommodityServiceImpl.java

@@ -0,0 +1,80 @@
+package com.example.api.service.impl;
+
+import com.example.api.model.entity.Commodity; // 导入Commodity实体类
+import com.example.api.repository.CommodityRepository; // 导入CommodityRepository接口
+import com.example.api.service.CommodityService; // 导入CommodityService接口
+import com.example.api.utils.DataTimeUtil; // 导入日期时间工具类
+import org.springframework.stereotype.Service; // 导入Service注解
+
+import javax.annotation.Resource; // 导入Resource注解，用于注入Spring管理的Bean
+import java.util.List; // 导入List类，用于处理列表数据
+
+/**
+ * 商品服务实现类，提供商品相关的业务逻辑。
+ */
+@Service
+public class CommodityServiceImpl implements CommodityService {
+
+    @Resource
+    private CommodityRepository commodityRepository; // 注入Commodity仓库
+
+    /**
+     * 保存商品信息。
+     * @param commodity 商品实体对象
+     * @return 保存后的商品实体对象
+     */
+    @Override
+    public Commodity save(Commodity commodity) {
+        commodity.setCreateAt(DataTimeUtil.getNowTimeString()); // 设置创建时间
+        return commodityRepository.save(commodity); // 保存商品信息
+    }
+
+    /**
+     * 更新商品信息。
+     * @param commodity 商品实体对象
+     */
+    @Override
+    public void update(Commodity commodity) {
+        commodity.setUpdateAt(DataTimeUtil.getNowTimeString()); // 设置更新时间
+        commodityRepository.save(commodity); // 更新商品信息
+    }
+
+    /**
+     * 根据ID删除商品信息。
+     * @param id 商品ID
+     */
+    @Override
+    public void delete(String id) {
+        commodityRepository.deleteById(id); // 根据ID删除商品信息
+    }
+
+    /**
+     * 根据ID查询商品信息。
+     * @param id 商品ID
+     * @return 查询到的商品实体对象，如果没有找到则返回null
+     */
+    @Override
+    public Commodity findById(String id) {
+        return commodityRepository.findById(id).orElse(null); // 根据ID查询商品信息
+    }
+
+    /**
+     * 查询所有商品信息。
+     * @return 商品实体对象列表
+     */
+    @Override
+    public List<Commodity> findAll() {
+        return commodityRepository.findAll(); // 查询所有商品信息
+    }
+
+    /**
+     * 根据商品名称模糊查询商品信息。
+     * @param name 商品名称关键词
+     * @return 匹配的商品实体对象列表
+     */
+    @Override
+    public List<Commodity> findAllByLikeName(String name) {
+        return commodityRepository.findByNameLike("%" + name + "%"); // 模糊查询商品信息
+    }
+
+}