一、项目Github地址
https://github.com/huangzihaohzh/WordCounter
二、PSP表格
PSP2.1 | Personal Software Process Stages | 预估耗时(分钟) | 实际耗时(分钟) |
Planning | 计划 | 60 | 90 |
· Estimate | · 估计这个任务需要多少时间 | 60 | 90 |
Development | 开发 | 1260 | 1320 |
· Analysis | · 需求分析 | 60 | 45 |
· Design Spec | · 生成设计文档 | 60 | 90 |
· Design Review | · 设计复审 | 60 | 45 |
· Coding Standard | · 代码规范 | 30 | 90 |
· Design | · 具体设计 | 60 | 150 |
· Coding | · 具体编码 | 540 | 480 |
· Code Review | · 代码复审 | 90 | 60 |
· Test | · 测试(自我测试,修改代码,提交修改) | 360 | 360 |
Reporting | 报告 | 180 | 160 |
· Test Report | · 测试报告 | 120 | 120 |
· Size Measurement | · 计算工作量 | 30 | 20 |
· Postmortem & Process Improvement Plan | · 事后总结, 并提出过程改进计划 | 30 | 20 |
合计 | 1500 | 1570 | |
三、解题思路
- 阅读需求文档(个人项目文档),大致了解题目的要求。由需求文档可知,题目要求编写一个根据用户输入的参数,对文本文件进行字符、单词、行数的技术并显示。此外还需要对所编程序进行测试,并按要求填写PSP表格以及撰写博文;
- 为了更合理地进行设计,决定先阅读下《构建之法》,了解了PSP表格的制订、回归测试的设计以及软件工程的工作量和质量的衡量标准等;
- 对于本项目,对用户的输入需要进行检查和分为参数组和文件名两项,考虑用正则表达式来进行处理,对于各类计数功能的实现也考虑用正则表达式去实现,对于“-a”选项对应的代码行 / 空行 / 注释行的处理则相对复杂一点,需要进一步寻找资料。
四、设计实现过程
主要涉及与实现
- 用户输入检查:使用正则表达式对用户输入的参数和地址进行检查,检查输入是否符合参数格式以及地址格式是否正确;
- 参数提取与存储:对用户输入进行分类存储,用户输入参数存到参数列表中,地址/文件名存入到一个字符串字段中。
- 按用户参数进行不同的操作:遍历参数列表,对不同的参数调用对应的方法获取计数值并加以显示。
流程图如下
五、测试
单元测试
测试代码
public class Test {
private TextFile textFile = null;
//Constructor
public Test(String filePath) throws Exception{
this.textFile = new TextFile(filePath);
}
//测试TextFile.charNumCounter()
public void testCharNumCounter(){
int charNum = textFile.charNumCounter();
if(charNum>=0)
System.out.println("文件字符数为:"+charNum);
else
System.out.println("字符数计算出错");
}
//测试TextFile.wordNumCounter()
public void testWordNumCounter(){
int wordNum = textFile.wordNumCounter();
if(wordNum>=0)
System.out.println("文件单词数为:"+wordNum);
else
System.out.println("单词计算出错");
}
//测试TextFile.lineNumCounter()
public void testLineNumCounter() throws IOException {
int lineNum = textFile.lineNumCounter();
if(lineNum>=0)
System.out.println("文件行数为:"+lineNum);
else
System.out.println("行数计算错误");
}
}
测试结果
D:\123.txt
文件字符数为:80
文件单词数为:6
文件行数为:2
整体测试
空文件测试(内有一空行,文件大小0KB)
命令:java -jar wc.jar -c -w -l "D:\test_txt\Empty.txt"
测试结果:
文件字符数为:0
文件单词数为:0
文件行数为:1
只有一个字符的文件测试
命令:java -jar wc.jar -c -w -l "D:\test_txt\OnlyOneChar.txt"
测试结果:
文件字符数为:1
文件单词数为:0
文件行数为:1
只有一个词的文件测试
命令:java -jar wc.jar -c -w -l "D:\test_txt\OnlyOneWord.txt"
测试结果:
文件字符数为:4
文件单词数为:1
文件行数为:1
只有一行的文件测试
命令:java -jar wc.jar -c -w -l "D:\test_txt\OnlyOneLine.txt"
测试结果:
文件字符数为:59
文件单词数为:3
文件行数为:1
一个典型的源文件测试
命令:java -jar wc.jar -c -w -l "D:\test_txt\Current.txt"
测试结果:
文件字符数为:27
文件单词数为:6
文件行数为:2
-x参数测试
命令:java -jar wc.jar -x -c -w -l
测试结果:
D:\test_txt\OnlyOneChar.txt
文件字符数为:1
文件单词数为:0
文件行数为:1
测试图片
总结
在本次项目开发过程中,有以下几点总结与教训:
- 要加大前期计划与分析的时间投入
- 拒绝拖延症,早开始,早结束