From 17ddddc66a6e67cb560b14c3a9a057740a807c1e Mon Sep 17 00:00:00 2001
From: puxcofief <1827156039@qq.com>
Date: Mon, 16 Dec 2024 15:15:03 +0800
Subject: [PATCH] Update TrainService.java

---
 .../src/com/cn/service/TrainService.java      | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/ticketing-master/src/com/cn/service/TrainService.java b/ticketing-master/src/com/cn/service/TrainService.java
index 246ec02..0fcfdec 100644
--- a/ticketing-master/src/com/cn/service/TrainService.java
+++ b/ticketing-master/src/com/cn/service/TrainService.java
@@ -12,6 +12,9 @@ public interface TrainService {
 
     /**
      * 添加一个新的车次。
+     * 该方法将车次对象的信息添加到数据库中。
+     * 如果添加成功，返回1；如果添加失败，抛出SQLException异常。
+     *
      * @param train 车次对象，包含车次的详细信息。
      * @return 返回1表示添加成功。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
@@ -20,6 +23,9 @@ public interface TrainService {
 
     /**
      * 根据车次ID删除一个车次。
+     * 该方法根据传入的车次ID从数据库中删除对应的车次信息。
+     * 如果删除成功，返回1；如果删除失败，抛出SQLException异常。
+     *
      * @param trainId 要删除的车次的ID。
      * @return 返回1表示删除成功。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
@@ -28,6 +34,9 @@ public interface TrainService {
 
     /**
      * 更新一个车次的信息。
+     * 该方法根据传入的车次对象更新数据库中的车次信息。
+     * 如果更新成功，返回1；如果更新失败，抛出SQLException异常。
+     *
      * @param train 包含更新信息的车次对象。
      * @return 返回1表示更新成功。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
@@ -36,6 +45,9 @@ public interface TrainService {
 
     /**
      * 获取所有车次的信息。
+     * 该方法从数据库中查询所有车次的信息，并返回一个包含所有车次信息的列表。
+     * 如果查询失败，抛出SQLException异常。
+     *
      * @return 返回一个包含所有车次信息的List，其中每个元素都是Train对象。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
      */
@@ -43,6 +55,9 @@ public interface TrainService {
 
     /**
      * 根据车次ID查询一个车次的详细信息。
+     * 该方法根据传入的车次ID从数据库中查询对应的车次详细信息。
+     * 如果查询失败，抛出SQLException异常。
+     *
      * @param trainId 要查询的车次的ID。
      * @return 返回一个Train对象，包含车次的详细信息。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
@@ -51,6 +66,9 @@ public interface TrainService {
 
     /**
      * 根据车次号查询车次信息。
+     * 该方法根据传入的车次号从数据库中查询对应的车次信息。
+     * 如果查询失败，抛出SQLException异常。
+     *
      * @param trainNumber 车次号。
      * @return 返回一个包含匹配车次号的所有车次信息的List，其中每个元素都是Train对象。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
@@ -59,6 +77,9 @@ public interface TrainService {
 
     /**
      * 根据起始站、终点站、开车时间查询车次信息。
+     * 该方法根据传入的起始站、终点站和开车时间从数据库中查询对应的车次信息。
+     * 如果查询失败，抛出SQLException异常。
+     *
      * @param startStation 起始站名称。
      * @param endStation 终点站名称。
      * @param startTime 开车时间，传入时不包含时分秒。
@@ -69,6 +90,9 @@ public interface TrainService {
 
     /**
      * 获取所有非重复的起始站。
+     * 该方法从数据库中查询所有非重复的起始站，并返回一个包含所有非重复起始站的列表。
+     * 如果查询失败，抛出SQLException异常。
+     *
      * @return 返回一个包含所有非重复起始站的List，其中每个元素都是Train对象。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
      */
@@ -76,6 +100,9 @@ public interface TrainService {
 
     /**
      * 获取所有非重复的终点站。
+     * 该方法从数据库中查询所有非重复的终点站，并返回一个包含所有非重复终点站的列表。
+     * 如果查询失败，抛出SQLException异常。
+     *
      * @return 返回一个包含所有非重复终点站的List，其中每个元素都是Train对象。
      * @throws SQLException 如果数据库操作失败，则抛出SQLException异常。
      */