第一次个人编程作业

这个作业属于哪个课程 https://edu.cnblogs.com/campus/gdgy/CSGrade22-34
这个作业要求在哪里 https://edu.cnblogs.com/campus/gdgy/CSGrade22-34/homework/13229
这个作业的目标 编写论文查重系统,实现性能分析和单元测试等

项目地址

GitHub地址

PSP表格

PSP2.1 Personal Software Process Stages 预估耗时(分钟) 实际耗时(分钟)
Planning 计划 60 60
· Estimate · 估计这个任务需要多少时间 30 30
Development 开发 240 240
· Analysis · 需求分析 (包括学习新技术) 60 80
· Design Spec · 生成设计文档 20 20
· Design Review · 设计复审 10 10
· Coding Standard · 代码规范 (为目前的开发制定合适的规范) 10 10
· Design · 具体设计 60 40
· Coding · 具体编码 100 90
· Code Review · 代码复审 10 10
· Test · 测试(自我测试,修改代码,提交修改) 40 100
Reporting 报告 30 60
· Test Repor · 测试报告 10 20
· Size Measurement · 计算工作量 10 10
· Postmortem & Process Improvement Plan · 事后总结, 并提出过程改进计划 20 20
· 合计 710 800

计算模块接口的设计与实现过程

类设计

  • MainPaperCck:接收文件路径并执行查重
  • HammingUtils:通过海明距离计算相似度
  • ShortStringException:自定义的短文本异常类
  • SimHashUtils:simHash计算工具类
  • TxtIOUtil:文本输入/输出工具类
  • MainTest:单元测试类,用于测试

SimHashUtils计算simHash的实现流程

计算模块接口部分的性能改进

计算模块部分单元测试展示

部分测试代码

    @Test
    public void origAndAllTest(){
        String[] str = new String[6];
        str[0] = TxtIOUtil.readTxt("D:/Javacode/3122004880/orig.txt");
        str[1] = TxtIOUtil.readTxt("D:/Javacode/3122004880/orig_0.8_add.txt");
        str[2] = TxtIOUtil.readTxt("D:/Javacode/3122004880/orig_0.8_del.txt");
        str[3] = TxtIOUtil.readTxt("D:/Javacode/3122004880/orig_0.8_dis_1.txt");
        str[4] = TxtIOUtil.readTxt("D:/Javacode/3122004880/orig_0.8_dis_10.txt");
        str[5] = TxtIOUtil.readTxt("D:/Javacode/3122004880/orig_0.8_dis_15.txt");
        String ansFileName = "D:/Javacode/3122004880/ansAll.txt";
        for(int i = 0; i <= 5; i++){
            double ans = HammingUtils.getSimilarity(SimHashUtils.getSimHash(str[0]), SimHashUtils.getSimHash(str[i]));
            TxtIOUtil.writeTxt(ans, ansFileName);
        }
    }

覆盖率

计算模块部分异常处理说明

在 ShortStringException 类中,四个构造方法分别用于处理不同的异常场景,每个构造方法的设计目标都是为了能够根据不同的需求和上下文提供足够的信息。下面是详细介绍每种异常的设计目标,以及每种异常的单元测试样例和可能出现的错误场景。

无参构造方法 ShortStringException()

设计目标:这个构造方法不带任何信息,只抛出一个基本的 ShortStringException。用于当错误的具体原因不需要详细描述时,只想简单地通知调用者发生了异常。
单元测试样例:

@Test(expected = ShortStringException.class)
public void testShortStringException_NoMessage() throws ShortStringException {
    // 假设某个方法抛出了异常
    throw new ShortStringException();
}

错误场景:在某些情况下,不需要提供具体的错误消息。例如在处理某个输入过短时,只需要抛出异常表示输入不符合要求即可。

带消息的构造方法 ShortStringException(String message)

设计目标:这个构造方法允许开发者提供一条详细的消息来描述具体错误原因。它的目的是帮助开发者或调用者更好地理解问题的具体内容。
单元测试样例:

@Test
public void testShortStringException_WithMessage() {
    try {
        throw new ShortStringException("字符串太短");
    } catch (ShortStringException e) {
        assertEquals("字符串太短", e.getMessage());
    }
}

错误场景:当输入的字符串长度小于某个阈值时,可以通过抛出异常并带上详细的消息来告知调用者错误的原因。例如,处理文本摘要生成时,如果文本过短,可以通过这个方式抛出具体的异常。

带消息和原因的构造方法 ShortStringException(String message, Throwable cause)

设计目标:这个构造方法不仅可以提供错误消息,还可以传递引发该异常的原始异常。它的设计目标是提供更丰富的调试信息,特别是在异常是由其他异常导致时,可以追踪整个错误链。
单元测试样例:

@Test
public void testShortStringException_WithMessageAndCause() {
    try {
        Throwable rootCause = new NullPointerException("原始异常");
        throw new ShortStringException("字符串太短", rootCause);
    } catch (ShortStringException e) {
        assertEquals("字符串太短", e.getMessage());
        assertTrue(e.getCause() instanceof NullPointerException);
        assertEquals("原始异常", e.getCause().getMessage());
    }
}

错误场景:当字符串长度不足且这一错误是由另一个底层异常(如 NullPointerException)引发时,可以使用这个构造方法提供原始的异常信息,帮助更好地定位问题。例如在数据处理链中,如果由于空指针异常导致字符串长度不足,可以通过这个方式提供更多调试信息。

带原因的构造方法 ShortStringException(Throwable cause)

设计目标:这个构造方法允许开发者传递引发此异常的原始异常,但不提供额外的消息。这适合当开发者不需要额外的描述信息,仅仅希望保留和传递原始异常。
单元测试样例:

@Test
public void testShortStringException_WithCause() {
    try {
        Throwable rootCause = new NullPointerException("原始异常");
        throw new ShortStringException(rootCause);
    } catch (ShortStringException e) {
        assertTrue(e.getCause() instanceof NullPointerException);
        assertEquals("原始异常", e.getCause().getMessage());
    }
}

错误场景:当开发者想传递底层异常信息但不需要额外的错误描述时,这种构造方法很有用。例如,在处理文本时,某个依赖的方法抛出异常导致字符串异常时,开发者可以通过这个方式传递原始异常,而无需创建新的错误消息。

posted @   江天一色无纤尘丶  阅读(13)  评论(0编辑  收藏  举报
点击右上角即可分享
微信分享提示