xl.java

ticketing-master/src/com/cn/service/PrepService.java

@@ -1,47 +1,56 @@
 package com.cn.service;
 
-import java.sql.SQLException;
+import java.sql.SQLException; // 导入SQLException类，用于处理数据库操作时可能遇到的异常
-import java.util.List;
+import java.util.List; // 导入List接口，用于返回列表类型的数据
 
-import com.cn.domain.Prep;
+import com.cn.domain.Prep; // 导入Prep类，该类代表订单的实体
 
+/**
+ * 定义订单服务接口，提供订单相关的业务操作。
+ */
 public interface PrepService {
 
     /**
-	 * 添加订单
+     * 添加一个新的订单。
-	 * @return 返回1为添加成功
+     * @param prep 订单对象，包含订单的详细信息。
+     * @return 返回1表示添加成功。
+     * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
      */
     int add(Prep prep);
 
     /**
-	 * 删除订单
+     * 根据订单ID删除一个订单。
-	 * @return 返回1为删除成功
+     * @param prepId 要删除的订单的ID。
+     * @return 返回1表示删除成功。
+     * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
      */
     int delete(Integer prepId);
 
     /**
-	 * 修改订单
+     * 更新一个订单的信息。
-	 * @return 返回1为修改成功
+     * @param prep 包含更新信息的订单对象。
+     * @return 返回1表示更新成功。
+     * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
      */
     int update(Prep prep);
 
     /**
-	 * 获取所有订单信息
+     * 获取所有订单的信息。
-	 * @return 返回元素为Prep对象的list
+     * @return 返回一个包含所有订单信息的List，其中每个元素都是Prep对象。
      */
     List<Prep> getAll();
 
     /**
-	 * 根据会员信息ID查询这个会员的所有订单
+     * 根据会员信息ID查询该会员的所有订单。
-	 * @param pmemberId 会员信息ID
+     * @param pmemberId 会员信息ID，用于标识特定的会员。
-	 * @return
+     * @return 返回一个包含该会员所有订单的List，其中每个元素都是Prep对象。
      */
     List<Prep> getPrepByPmemberId(Integer pmemberId);
 
     /**
-	 * 根据id查询订单信息
+     * 根据订单ID查询一个订单的详细信息。
-	 * @return Prep的对象
+     * @param prepId 要查询的订单的ID。
+     * @return 返回一个Prep对象，包含订单的详细信息。
      */
     Prep getById(Integer prepId);
-	
 }