diff --git a/ticketing-master/src/com/cn/test/TrainDaoTest.java b/ticketing-master/src/com/cn/test/TrainDaoTest.java index cecdb83..50f2653 100644 --- a/ticketing-master/src/com/cn/test/TrainDaoTest.java +++ b/ticketing-master/src/com/cn/test/TrainDaoTest.java @@ -1,6 +1,5 @@ package com.cn.test; - import java.sql.SQLException; import java.sql.Timestamp; import java.util.Date; @@ -14,133 +13,242 @@ import com.cn.domain.Train; /** * - * @ClassName: TrainDaoTest - * @Description: TrainDao的测试类 + * @ClassName: TrainDaoTest + * @Description: TrainDao的测试类,主要用于对与列车相关的数据访问层(TrainDao)中的各个方法进行单元测试, + * 验证如添加列车信息、删除列车信息、更新列车信息以及多种条件下查询列车信息等功能是否能正确与数据库交互并执行相应操作, + * 以此确保TrainDao所提供的数据库操作功能符合预期。 * @author: ljy * @date: 2019年9月16日 下午10:53:22 */ public class TrainDaoTest { - - private TrainDao trainDao = new TrainDaoImpl(); - - @Test - public void testAdd() { - Train train = new Train(); - train.setTrainNumber("K322"); - train.setStartStation("北京"); - train.setEndStation("天津"); - train.setStartTime("2019-09-01 15:30:00"); - train.setEndTime("2019-09-01 16:50:00"); - train.setPrice(200); - train.setSeatNumber(1000); - -// SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); -// Timestamp addTime = Timestamp.valueOf(sdf.format(new Date())); - Timestamp addTime = new Timestamp(new Date().getTime()); - train.setAddTime(addTime); - int recordNumber = 0; - try { - recordNumber = trainDao.add(train); - System.out.println(recordNumber); - } catch (SQLException e) { - e.printStackTrace(); - } - } - @Test - public void testDelete() { - try { - int recordNumber = trainDao.delete(1); - System.out.println(recordNumber); - } catch (SQLException e) { - e.printStackTrace(); - } - } + // 创建TrainDao接口的具体实现类TrainDaoImpl的实例,后续将通过该实例调用TrainDao中定义的各个数据库操作方法, + // 来测试不同的列车信息相关的数据库操作功能。 + private TrainDao trainDao = new TrainDaoImpl(); - @Test - public void testUpdate() { - Train train = new Train(); - train.setTrainId(2); - train.setTrainNumber("XXX"); - train.setStartStation("北京"); - train.setEndStation("天津"); - train.setStartTime("2019-09-01 15:30:00"); - train.setEndTime("2019-09-01 16:50:00"); - train.setPrice(200); - train.setSeatNumber(1000); - Timestamp addTime = new Timestamp(new Date().getTime()); - train.setAddTime(addTime); - try { - int recordNumber = trainDao.update(train); - System.out.println(recordNumber); - } catch (SQLException e) { - e.printStackTrace(); - } - } + /** + * @Test注解表明这是一个JUnit测试方法,用于测试向数据库中添加单条列车信息的功能。 + * 在此方法中,先创建一个Train对象并设置好相应的列车属性信息,然后调用trainDao的add方法将该列车信息添加到数据库中, + * 最后通过打印返回结果来查看添加操作是否成功执行,若出现异常则打印异常栈信息方便排查问题。 + */ + @Test + public void testAdd() { + // 创建一个Train对象,该对象用于封装要添加到数据库中的列车信息,其各个属性对应数据库中列车信息表的不同字段。 + Train train = new Train(); + // 设置列车的车次编号,这里将其设置为"K322",这是一个示例车次,实际应用中应符合实际的车次命名规则和业务要求。 + train.setTrainNumber("K322"); + // 设置列车的起始站名称,将其设置为"北京",表示列车出发的站点。 + train.setStartStation("北京"); + // 设置列车的终点站名称,此处设为"天津",代表列车最终要到达的站点。 + train.setEndStation("天津"); + // 设置列车的出发时间,采用"yyyy-MM-dd HH:mm:00"格式的字符串来表示时间,这里设置的具体时间为2019-09-01 15:30:00, + // 该格式需与数据库中对应时间字段的存储格式相匹配,以确保能正确插入数据。 + train.setStartTime("2019-09-01 15:30:00"); + // 设置列车的到达时间,同样遵循"yyyy-MM-dd HH:mm:00"格式,设置为2019-09-01 16:50:00,用于表示列车预计到达终点站的时间。 + train.setEndTime("2019-09-01 16:50:00"); + // 设置列车的票价,单位通常为某种货币单位(比如人民币元),这里设置为200,仅作为测试用途的示例价格数值。 + train.setPrice(200); + // 设置列车的座位数量,此处设为1000个座位,同样是用于测试的一个示例数量值。 + train.setSeatNumber(1000); - @Test - public void testGetAll() { - try { - List list = trainDao.getAll(); - for(Train train : list) { - System.out.println(train.toString()); - } - } catch (SQLException e) { - e.printStackTrace(); - } - } + // 获取当前系统时间,并将其转换为Timestamp类型,用于设置列车信息的添加时间,即记录这条列车信息是什么时候被录入到系统中的。 + // 以下是两种获取Timestamp的方式,这里采用了直接利用Date类的getTime方法获取时间戳,再通过该时间戳构造Timestamp对象的方式。 + // 注释掉的代码是先使用SimpleDateFormat将Date对象格式化为指定的日期时间字符串格式("yyyy-MM-dd HH:mm:ss"), + // 再通过Timestamp的valueOf方法将格式化后的字符串转换为Timestamp类型的方式,两种方式都能达到目的,只是实现途径略有不同。 + // SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); + // Timestamp addTime = Timestamp.valueOf(sdf.format(new Date())); + Timestamp addTime = new Timestamp(new Date().getTime()); + train.setAddTime(addTime); - @Test - public void testGetById() { - try { - Integer trainId = 2; - Train train = trainDao.getById(trainId); - System.out.println(train.toString()); - } catch (SQLException e) { - e.printStackTrace(); - } - } + int recordNumber = 0; + try { + // 调用trainDao的add方法,该方法在TrainDao接口中定义,并由TrainDaoImpl类实现具体逻辑。 + // 其内部会构建合适的SQL插入语句,与数据库建立连接,然后将Train对象所包含的列车信息插入到数据库对应的列车信息表中, + // 返回值recordNumber通常表示受影响的数据库记录行数,在成功插入一条记录的情况下,一般返回值为1,这里将其打印输出, + // 以便查看添加操作是否按预期成功执行,如果出现SQLException异常(比如数据库连接问题、SQL语法错误等情况)则会进入catch块进行处理。 + recordNumber = trainDao.add(train); + System.out.println(recordNumber); + } catch (SQLException e) { + // 如果在执行添加列车信息的操作过程中出现了SQLException异常, + // 通过e.printStackTrace()方法打印异常的栈追踪信息,方便开发人员排查问题所在,确定是哪部分代码或者数据库相关配置导致了异常的出现。 + e.printStackTrace(); + } + } - @Test - public void testGetByTrainNumber() { - try { - String trainNumber="XXX"; - List list = trainDao.getByTrainNumber(trainNumber); - for(Train train : list) { - System.out.println(train.toString()); - } - } catch (SQLException e) { - e.printStackTrace(); - } - } + /** + * @Test注解表明这是一个JUnit测试方法,用于测试根据列车ID从数据库中删除对应列车信息的功能。 + * 在此方法中,调用trainDao的delete方法并传入指定的列车ID值,尝试从数据库中删除相应的列车记录, + * 最后通过打印返回结果来查看删除操作是否成功执行,若出现异常则打印异常栈信息以便排查问题。 + */ + @Test + public void testDelete() { + try { + // 调用trainDao的delete方法,该方法的具体实现位于TrainDaoImpl类中,其内部会构建相应的SQL删除语句, + // 根据传入的列车ID(这里传入的硬编码值为1,仅作为测试示例,实际应用中应根据具体业务需求获取要删除的列车ID), + // 在数据库中查找并删除对应的列车记录,处理数据库连接以及执行删除操作等相关事宜。 + // 返回值recordNumber通常表示受影响的数据库记录行数,若成功删除对应的列车记录,返回值一般为1;若数据库中不存在该ID对应的记录,则返回值为0。 + // 将返回的recordNumber打印输出,便于查看删除操作是否按预期成功执行。 + int recordNumber = trainDao.delete(1); + System.out.println(recordNumber); + } catch (SQLException e) { + e.printStackTrace(); + } + } - @Test - public void testGetByStartEndStation() { - try { - List list = trainDao.getByStartEndStation("上海", "广州", "2019-09-01"); - for(Train train : list) { - System.out.println(train.toString()); - } - } catch (SQLException e) { - e.printStackTrace(); - } - } - - @Test - public void testGetAllStartStation() { - try { - List list = trainDao.getAllStartStation(); - for(Train train : list) { - System.out.println(train.getStartStation()); - } - } catch (SQLException e) { - e.printStackTrace(); - } - } - @Test - public void testGetAllEndStation() { - try { - List list = trainDao.getAllEndStation(); + /** + * @Test注解表明这是一个JUnit测试方法,用于测试更新数据库中列车信息的功能。 + * 先创建一个包含更新后信息的Train对象,设置好相应的列车属性以及要更新的列车记录的ID,然后调用trainDao的update方法, + * 将这些更新内容应用到数据库中对应的列车记录上,最后通过打印返回结果来查看更新操作是否成功执行,若出现异常则打印异常栈信息方便排查问题。 + */ + @Test + public void testUpdate() { + Train train = new Train(); + // 设置要更新的列车记录在数据库中的唯一标识(ID),这里将其设置为2,代表要更新的是数据库中ID为2的列车记录, + // 通过这个ID可以准确找到对应的列车信息行进行更新操作,实际应用中该值应根据具体业务需求来确定,比如通过用户输入或者其他业务逻辑获取。 + train.setTrainId(2); + train.setTrainNumber("XXX"); + train.setStartStation("北京"); + train.setEndStation("天津"); + train.setStartTime("2019-09-01 15:30:00"); + train.setEndTime("2019-09-01 16:50:00"); + train.setPrice(200); + train.setSeatNumber(1000); + // 获取当前系统时间,并转换为Timestamp类型,用于设置列车信息的更新时间(这里假设更新操作需要记录更新时间,具体看业务需求), + // 其原理与前面设置添加时间类似,都是获取当前时间并转换为合适的数据库时间类型。 + Timestamp addTime = new Timestamp(new Date().getTime()); + train.setAddTime(addTime); + + try { + // 调用trainDao的update方法,该方法在TrainDao接口中定义并由TrainDaoImpl类实现具体更新逻辑, + // 其内部会根据传入的Train对象所携带的更新信息,在数据库中查找并更新对应ID的列车记录,例如构建合适的SQL更新语句、 + // 处理数据库连接以及执行更新操作等,返回值recordNumber通常表示受影响的数据库记录行数,若成功更新对应的列车记录,返回值一般为1; + // 若数据库中不存在该ID对应的记录,则返回值为0,将返回的recordNumber打印输出,便于查看更新操作是否按预期成功执行。 + int recordNumber = trainDao.update(train); + System.out.println(recordNumber); + } catch (SQLException e) { + e.printStackTrace(); + } + } + + /** + * @Test注解表明这是一个JUnit测试方法,用于测试从数据库中获取所有列车信息的功能。 + * 调用trainDao的getAll方法获取数据库中全部的列车记录,然后遍历获取到的列车信息列表,将每条列车信息打印输出, + * 以此来验证查询所有列车信息的功能是否能正确执行,查看返回的列车信息是否符合预期,若出现异常则打印异常栈信息以便排查问题。 + */ + @Test + public void testGetAll() { + try { + // 调用trainDao的getAll方法,该方法的具体实现位于TrainDaoImpl类中,其内部会构建相应的SQL查询语句, + // 执行查询操作从数据库的列车信息表中获取所有记录,并将这些记录封装为Train对象列表返回,以便后续进行遍历和处理。 + List list = trainDao.getAll(); + for (Train train : list) { + // 遍历获取到的列车信息列表,通过调用train对象的toString方法将每条列车信息以字符串的形式打印输出, + // toString方法通常会按照一定的格式展示列车对象的各个属性信息,方便查看查询结果的具体内容,了解所有列车的详细情况。 + System.out.println(train.toString()); + } + } catch (SQLException e) { + e.printStackTrace(); + } + } + + /** + * @Test注解表明这是一个JUnit测试方法,用于测试根据列车ID从数据库中获取对应列车信息的功能。 + * 在此方法中,先定义要查询的列车记录在数据库中的唯一标识(ID),然后调用trainDao的getById方法, + * 根据该ID查询并获取相应的列车记录,最后将获取到的列车信息打印输出,以此验证按ID查询列车信息的功能是否正确,若出现异常则打印异常栈信息方便排查问题。 + */ + @Test + public void testGetById() { + try { + // 定义要查询的列车记录在数据库中的唯一标识(ID),这里将其设置为2,代表要获取ID为2的列车信息,仅作为测试示例, + // 实际应用中可根据具体业务场景通过合适的方式获取相应的列车ID值,比如从用户输入、其他关联数据等途径获取。 + Integer trainId = 2; + // 调用trainDao的getById方法,该方法的具体实现位于TrainDaoImpl类中,其内部会构建合适的SQL查询语句, + // 根据传入的列车ID在数据库中查找并获取对应列车记录,将查询到的列车信息封装为Train对象返回,以便后续进行展示或其他处理。 + Train train = trainDao.getById(trainId); + // 打印输出获取到的列车信息,通过调用train对象的toString方法将列车对象的各个属性以字符串形式展示出来, + // 方便查看查询结果,确认获取到的列车信息是否符合预期。 + System.out.println(train.toString()); + } catch (SQLException e) { + e.printStackTrace(); + } + } + + /** + * @Test注解表明这是一个JUnit测试方法,用于测试根据列车车次编号从数据库中获取对应列车信息的功能。 + * 先定义要查询的列车车次编号,然后调用trainDao的getByTrainNumber方法,根据该车次编号查询并获取相应的列车记录, + * 最后遍历并打印输出获取到的列车信息,以此验证按车次编号查询列车信息的功能是否有效,若出现异常则打印异常栈信息方便排查问题。 + */ + @Test + public void testGetByTrainNumber() { + try { + // 定义要查询的列车车次编号,这里将其设置为"XXX",代表要获取车次编号为"XXX"的列车信息,仅作为测试示例, + // 实际应用中根据具体业务场景传入相应的车次编号值,比如用户输入想要查询的车次信息等情况。 + String trainNumber = "XXX"; + // 调用trainDao的getByTrainNumber方法,该方法的具体实现位于TrainDaoImpl类中,其内部可能会构建类似模糊查询(如果支持模糊查询的话) + // 或精确查询的SQL语句,根据传入的列车车次编号在数据库中查找并获取对应列车记录,将查询到的列车信息封装为Train对象列表返回,以便后续遍历展示。 + List list = trainDao.getByTrainNumber(trainNumber); + for (Train train : list) { + // 遍历获取到的列车信息列表,通过调用train对象的toString方法将每条列车信息以字符串形式打印输出, + // 方便查看查询到的符合条件的列车记录内容,确认是否获取到了期望的列车信息。 + System.out.println(train.toString()); + } + } catch (SQLException e) { + e.printStackTrace(); + } + } + + /** + * @Test注解表明这是一个JUnit测试方法,用于测试根据列车起始站、终点站以及出发日期从数据库中获取对应列车信息的功能。 + * 先传入指定的起始站、终点站和出发日期参数,然后调用trainDao的getByStartEndStation方法, + * 根据这些条件查询并获取符合要求的列车记录,最后遍历并打印输出获取到的列车信息,以此验证按多条件查询列车信息的功能是否正确,若出现异常则打印异常栈信息方便排查问题。 + */ + @Test + public void testGetByStartEndStation() { + try { + // 调用trainDao的getByStartEndStation方法,传入列车的起始站名称(这里设置为"上海")、终点站名称(设置为"广州")以及出发日期(设置为"2019-09-01"), + // 该方法的具体实现位于TrainDaoImpl类中,其内部会构建相应的SQL查询语句,根据这些条件在数据库中筛选出符合要求的列车记录, + // 执行查询操作并将查询到的列车信息封装为Train对象列表返回,以便后续进行遍历展示等操作。 + List list = trainDao.getByStartEndStation("上海", "广州", "2019-09-01"); + for (Train train : list) { + // 遍历获取到的列车信息列表,通过调用train对象的toString方法将每条列车信息以字符串形式打印输出, + // 方便查看查询到的符合条件的 + + System.out.println(train.toString()); + } + } catch (SQLException e) { + e.printStackTrace(); + } + } + + /** + * @Test注解表明这是一个JUnit测试方法,用于测试从数据库中获取所有列车起始站信息的功能。 + * 调用trainDao的getAllStartStation方法获取数据库中所有列车记录的起始站名称,然后遍历并打印输出这些起始站名称, + * 以此验证获取所有起始站信息的功能是否能正确执行,查看返回的起始站名称是否符合预期,若出现异常则打印异常栈信息以便排查问题。 + */ + @Test + public void testGetAllStartStation() { + try { + // 调用trainDao的getAllStartStation方法,该方法的具体实现位于TrainDaoImpl类中,其内部会构建相应的SQL查询语句, + // 执行查询操作从数据库的列车信息表中获取所有列车记录的起始站名称,并将这些名称封装为列表返回,以便后续进行遍历和打印输出操作。 + List list = trainDao.getAllStartStation(); + for (Train train : list) { + // 遍历获取到的起始站名称列表,直接打印输出每个起始站名称,方便查看查询结果,了解数据库中所有列车的出发站点情况。 + System.out.println(train.getStartStation()); + } + } catch (SQLException e) { + e.printStackTrace(); + } + } + + /** + * @Test注解表明这是一个JUnit测试方法,用于测试从数据库中获取所有列车终点站信息的功能。 + * 调用trainDao的getAllEndStation方法获取数据库中所有列车记录的终点站名称,然后遍历并打印输出这些终点站名称, + * 以此验证获取所有终点站信息的功能是否能正确执行,查看返回的终点站名称是否符合预期,若出现异常则打印异常栈信息以便排查问题。 + */ + @Test + public void testGetAllEndStation() { + try { + // 调用trainDao的getAllEndStationList list = trainDao.getAllEndStation(); for(Train train : list) { System.out.println(train.getEndStation()); }