587
社区成员
恭喜你已经完成了软工实践的第一次作业,并将逐步迈进到第二次作业的能力提升中。本次作业将聚焦于澳大利亚网球公开赛的赛事项目,期待各位同学大展身手哦!
为了不遗漏作业内容,这里有一份checklist方便你快速查阅
完成对澳大利亚网球公开赛相关数据的收集,并实现一个能够对赛事数据进行统计的控制台程序
https://gitcode.net/weixin_46376442/project-c
https://gitcode.net/weixin_46376442/project-java
'\n'
,编码统一使用UTF-8
.gitignore
忽略,如编译器生成的项目文件、输出文件、class、jar包、exe等,确保不会提交到GitCode上,参考 [附录3]。实现一个命令行程序,不妨称之为AOSearch。
本次作业所需数据均爬取自澳大利亚网球公开赛官网【该爬取行为仅用于课程教学】
假设有一个软件可以输出2023年澳大利亚网球公开赛的选手信息和比赛结果。
输入指令和输出文件以命令行参数传入。例如我们在命令行窗口(cmd)中输入:
//C语言类
AOSearch.exe input.txt output.txt
//Java语言
Java -jar AOSearch.jar input.txt output.txt
功能1:输出所有选手信息
当input.txt的内容为
players
则会输出参与澳洲网球公开赛的所有选手信息到output.txt,输出格式如下:其中full_name
对应选手全名,gender
为选手性别, nationality
为国籍。换行使用'\n',编码统一使用UTF-8。
输出格式:
full_name:string
gender:string
nationality:string
-----
...
输出样例:
full_name:Radu Albot
gender:male
nationality:Moldova
-----
full_name:Marcelo Arevalo
gender:male
nationality:El Salvador
-----
...
功能2:输出正式赛每日结果
当input.txt的内容为
result 0116
则会输出1月16日的所有比赛结果到output.txt,输出格式如下; 其中time
对应比赛实际开始时间,winner
为比赛胜利者姓名缩写,如为团体比赛请列出获胜团体所有成员姓名缩写。格式如'menber1 & menber2'
,score
表示比赛中每一轮双方的比分,每一轮的格式如'score1 | score2'
。
输出格式:
time:hh:mm
winner:string
score:string
-----
...
输出样例:
time:00:14
winner:C. Gauff
score:6:1 | 4:6
-----
time:04:13
winner:B. Krejcikova & K. Siniakova 1
score:6:4 | 6:3
-----
...
附加功能:输出资格赛结果
当input.txt的内容为
result Q1
则会输出澳大利亚网球公开赛第一赛季的所有比赛结果到output.txt,输出格式如下; 其中time
对应比赛实际开始时间,winner
为比赛胜利者姓名缩写,如为团体比赛请列出获胜团体所有成员姓名缩写。格式如'menber1 & menber2'
,score
表示比赛中每一轮双方的比分,每一轮的格式如'score1 | score2'
。
输出格式:
time:hh:mm
winner:string
score:string
-----
...
输出样例:
time:00:14
winner:C. Gauff
score:6:1 | 4:6
-----
time:04:13
winner:B. Krejcikova & K. Siniakova 1
score:6:4 | 6:3
-----
...
补充说明:
对于input.txt,有可能会出现多行输入的样例,例如:
players
result 0116
result 0116
players
此时的输出文件output.txt中的内容为:
full_name:Radu Albot
gender:male
nationality:Moldova
-----
full_name:Marcelo Arevalo
gender:male
nationality:El Salvador
-----
...
-----
time:00:14
winner:C. Gauff
score:6:1 | 4:6
-----
time:04:13
winner:B. Krejcikova & K. Siniakova 1
score:6:4 | 6:3
-----
...
-----
time:00:14
winner:C. Gauff
score:6:1 | 4:6
-----
time:04:13
winner:B. Krejcikova & K. Siniakova 1
score:6:4 | 6:3
-----
...
-----
full_name:Radu Albot
gender:male
nationality:Moldova
-----
full_name:Marcelo Arevalo
gender:male
nationality:El Salvador
-----
...
-----
其中,每个指令的输出紧贴上一个指令的输出,无需空行。
假如输入无法处理的指令,例如:
Error
N/A
input.txt样例:
player
Players
result0116
result 1312
result sss
result 116
result 0130
result Q5
players
output.txt输出:
Error
-----
Error
-----
Error
-----
N/A
-----
N/A
-----
N/A
-----
N/A
-----
N/A
-----
full_name:Radu Albot
gender:male
nationality:Moldova
-----
full_name:Marcelo Arevalo
gender:male
nationality:El Salvador
-----
...
-----
如果现在我们要把这个功能放到不同的环境中去(例如,命令行,Windows图形界面程序,网页程序,手机App),就会碰到困难:代码散落在各个函数中,很难剥离出来作为一个独立的模块运行以满足不同的需求。
这些代码的种类不同,混杂在一起对于后期的维护扩展很不友好,所以它们的组织结构就需要精心的整理和优化。
我们希望把基本功能里的:
这两个功能独立出来,成为一个独立的模块(class library, DLL, 或其它),这样的话,命令行和GUI的程序都能使用同一份代码。为了方便起见,我们称之为计算核心"Core模块",这个模块至少可以在几个地方使用:
把计算核心在单元测试框架中做过完备的测试后,我们就可以在算法层级保证了这个模块的正确性。
但我们知道软件并非只有计算核心,实际的软件是交付给最终用户的软件,除了计算核心外,还需要有一定的界面和必要的辅助功能。
这个Core模块和使用它的其他模块之间则要通过一定的API来交流。那么API应该怎么设计呢?
为了方便起见,我们可以从下面的最简单的接口开始(仅举例,你的代码里可能没有这个函数):
int countChar(File *file)
这个函数表示输出一个文件指针,返回这个文件的字符数。
假设我们用Core封装了这个接口,那么我们的测试程序可以是这样:
File *in = fopen("input.txt","r");
int count = 100;
Assert(countChar(in) == count);
当然,这样的测试程序并不充分,希望大家测试时不要像这样偷懒。
请根据自己以往积累的测试经验,在编码完成之后,提交产品之前,设计测试用例,并编写单元测试,对自己的项目进行测试。
首先,至少应采用白盒测试用例设计方法来设计测试用例,其他测试方法不限。其次,要设计至少10个测试用例,确保你的程序能够正确处理各种情况。最后,结合测试评估的要求,对自己的测试设计进行评价,这些测试用例能满足该程序测试的要求吗?
另一个重要的措施是要把单元测试自动化,这样每个人都能很容易地运行它,并且可以使单元测试每天都运行。每个人都可以随时在自己的机器上运行。团队一般是在每日构建中运行单元测试的,这样每个单元测试的错误就能及时被发现并得到修改。
助教在测试时,将运行自动测试程序编译源文件并运行,进行批量测试,因此请保证项目的组织目录符合要求。
对于使用Java语言的项目有以下要求:
AOSearch.java
文件,且AOSearch.java中包含 public static void main(String[] args)
方法xxxxxxxxx (文件夹名字为学号)
|- src
|- AOSearch.java(主程序,可以从命令行接收参数;确保文件名一致、区分大小写)
|- Lib.java(包含其它自定义函数,可以有多个,对名字不做要求)
|- data(文件夹,存放程序的数据)
|- AOSearch.jar
|- README.md
描述你的项目,包括如何运行、功能简介、作业链接、博客链接等
|- codestyle.md
描述你之前定的代码风格
对于使用C++ 语言的项目有以下要求:
AOSearch.cpp
文件,且AOSearch.cpp的main函数可以接收命令行参数(如int main(int argv, char** argc)
)xxxxxxxxx (文件夹名字为学号)
|- src
|- AOSearch.cpp(主程序,可以从命令行接收参数;确保文件名一致、区分大小写)
|- Lib.cpp(包含其它自定义函数,可以有多个,对名字不做要求)
|- Lib.h(包含其它自定义函数,可以有多个,对名字不做要求)
|- data(文件夹,存放程序的数据)
|- AOSearch.exe
|- README.md
描述你的项目,包括如何运行、功能简介、作业链接、博客链接等
|- codestyle.md
描述你之前定的代码风格
本次自动测试会加入各种各样出错情况的测试,要求开发者程序不能崩溃,并且能够尽可能精确报错。你可以有“容错性”的出错设计,但必须输出必要的提示或说明。
若有对题目不理解的地方,可在QQ群中直接提问。
PSP是卡耐基梅隆大学(CMU)的专家们针对软件工程师所提出的一套模型:Personal Software Process (PSP, 个人开发流程,或称个体软件过程)。
PSP | Personal Software Process Stages | 预估耗时(分钟) | 实际耗时(分钟) |
---|---|---|---|
Planning | 计划 | ||
• Estimate | • 估计这个任务需要多少时间 | ||
Development | 开发 | ||
• Analysis | • 需求分析 (包括学习新技术) | ||
• Design Spec | • 生成设计文档 | ||
• Design Review | • 设计复审 | ||
• Coding Standard | • 代码规范 (为目前的开发制定合适的规范) | ||
• Design | • 具体设计 | ||
• Coding | • 具体编码 | ||
• Code Review | • 代码复审 | ||
• Test | • 测试(自我测试,修改代码,提交修改) | ||
Reporting | 报告 | ||
• Test Repor | • 测试报告 | ||
• Size Measurement | • 计算工作量 | ||
• Postmortem & Process Improvement Plan | • 事后总结, 并提出过程改进计划 | ||
合计 |
一个功能完备的程序不是一蹴而就的。通过将每日赛程的统计需求划分为4个部分,可将一个大任务划分为可操作的小任务,同时最好按照任务难度或紧急程度指定各个任务的完成次序。因此,在动手开发之前,要先估计将在程序各模块开发所需耗费的时间,以及完成整个项目所需的时间,将这个[估计值]记录下来,写成PSP 的形式。
PSP的目的是:记录工程师如何实现需求的效率,和我们使用项目管理工具(例如微软的Project Professional,或者禅道等)进行项目进度规划类似。
有关PSP的更多内容,请自行阅读邹欣老师的博客:工程师的能力评估和发展
请阅读邹欣老师的博客:源代码管理,了解源代码管理的10个实践问题。
本次作业要求使用GitCode进行源代码管理,代码有进展即签入GitCode。签入记录不合理的项目会被助教抽查询问项目细节。
对代码签入的具体要求如下:根据需求划分功能后,每做完一个功能,编译成功后,应至少commit一次。具体的功能划分,请自行定义,并在撰写博客时体现出来,遵循自己对需求的功能划分来提交代码即可。
如果对Gitcode的内容不熟悉,可以点击《git入门》进行学习
请根据自己以往积累的测试经验,在编码完成之后,提交产品之前,设计测试用例,并编写单元测试,对自己的项目进行测试。以下是对测试的几个具体要求:
首先,至少应采用白盒测试用例设计方法来设计测试用例,其他测试方法不限;
其次,要设计至少10个测试用例,确保你的程序能够正确处理各种情况;
最后,结合测试评估的要求,对自己的测试设计进行评价,这些测试用例能满足该程序测试的要求吗?
另一个重要的措施是要让单元测试自动化,这样每个人都能很容易地运行它,随时在自己的机器上运行,并且可以使单元测试每天都运行。团队一般是在每日构建中运行单元测试的,这样每个单元测试的错误就能及时被发现并得到修改。
有关单元测试的更多内容,推荐阅读邹欣老师的博客:单元测试和回归测试
这个作业属于哪个课程 | <班级的链接> |
---|---|
这个作业要求在哪里 | <作业要求的链接> |
这个作业的目标 | <写上具体方面> |
其他参考文献 | ... |
|这个作业属于哪个课程|<班级的链接>|
|-- |-- |
|这个作业要求在哪里|<作业要求的链接>|
|这个作业的目标|<写上具体方面>|
|其他参考文献|... |
[toc]
作业基本信息...
## Gitcode项目地址
## PSP表格
## 解题思路描述
### 问题1
### 问题2
...
## 接口设计和实现过程
...
## 关键代码展示
...
## 性能改进
...
## 单元测试
...
## 异常处理
...
## 心得体会
...
作业基本信息...
## 目录:
1. [Gitcode项目地址](#1)
2. [PSP表格](#2)
3. [解题思路描述](#3)
4. [接口设计和实现过程](#4)
5. [关键代码展示](#)
6. [性能改进](#)
7. [单元测试](#)
8. [心得体会](#)
## <span id="1">1. Gitcode项目地址</span>
### 问题1
### 问题2
### ...
## <span id="2">2. PSP表格</span>
...
## <span id="3">3. 解题思路描述</span>
...
## <span id="4">4. 接口设计和实现过程</span>
...
## <span id="5">5. 关键代码展示</span>
...
## <span id="6">6. 性能改进</span>
...
## <span id="7">7. 单元测试</span>
...
## <span id="8">8. 异常处理</span>
...
## <span id="9">9. 心得体会</span>
...