运单服务组件与接口

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

@@ -0,0 +1,32 @@
+package com.example.api.service;
+
+import com.example.api.model.entity.Sale; // 导入Sale实体类，这个类包含了销售记录的属性
+
+import java.util.List; // 导入List接口，用于定义返回销售记录列表的方法
+
+/**
+ * 销售服务接口，定义了与销售记录相关的业务操作。
+ */
+public interface SaleService {
+
+    /**
+     * 保存销售记录的方法。
+     * @param sale 需要保存的销售记录对象
+     * @return 保存后的销售记录对象
+     */
+    Sale save(Sale sale);
+
+    /**
+     * 查询所有销售记录的方法。
+     * @return 所有销售记录的列表
+     */
+    List<Sale> findAll();
+
+    /**
+     * 根据公司名称搜索销售记录的方法。
+     * @param name 公司名称的关键字
+     * @return 包含指定公司名称关键字的销售记录列表
+     */
+    List<Sale> searchByCompany(String name);
+
+}

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

@@ -0,0 +1,43 @@
+package com.example.api.service.impl;
+
+import com.example.api.model.entity.Sale; // 导入Sale实体类
+import com.example.api.repository.SaleRepository; // 导入SaleRepository接口
+import com.example.api.service.SaleService; // 导入SaleService接口
+import com.example.api.utils.DataTimeUtil; // 导入用于处理日期时间的工具类
+import org.springframework.stereotype.Service; // 导入Spring的@Service注解，用于声明这是一个服务组件
+
+import javax.annotation.Resource; // 导入@Resource注解，用于注入Spring管理的Bean
+import java.util.List; // 导入List接口，用于返回列表类型的数据
+
+// 使用@Service注解声明这是一个服务组件
+@Service
+public class SaleServiceImpl implements SaleService {
+
+    // 使用@Resource注解注入SaleRepository
+    @Resource
+    private SaleRepository saleRepository;
+
+    // 实现SaleService接口的save方法，用于保存Sale对象
+    @Override
+    public Sale save(Sale sale) {
+        // 使用DataTimeUtil工具类获取当前时间字符串，并设置到Sale对象的createAt字段
+        sale.setCreateAt(DataTimeUtil.getNowTimeString());
+        // 调用saleRepository的save方法保存Sale对象，并返回保存后的对象
+        return saleRepository.save(sale);
+    }
+
+    // 实现SaleService接口的findAll方法，用于查询所有Sale对象
+    @Override
+    public List<Sale> findAll() {
+        // 直接调用saleRepository的findAll方法查询所有Sale对象，并返回查询结果
+        return saleRepository.findAll();
+    }
+
+    // 实现SaleService接口的searchByCompany方法，用于根据公司名称搜索Sale对象
+    @Override
+    public List<Sale> searchByCompany(String name) {
+        // 调用saleRepository的findAllByCompanyLike方法根据公司名称模糊搜索Sale对象，并返回搜索结果
+        return saleRepository.findAllByCompanyLike(name);
+    }
+
+}