现代程序设计 作业6 - 简单而有意义的题目

这是这个课件的一部分:  现代程序设计 (课程设计中, 征求意见稿)

好多同学们都说题目难,这回我们来一个简单而很有意义的。  :)

写代码爽还是读代码爽? 往一堆乱麻中再加上一些线索,似乎比较容易;然而从这一团乱麻中理出头绪,还是比较难的。下图来自 知乎的一个讨论

image

 

我们练习了这么多作业,所有作业都是从头写程序,但是我们到了真正的项目组或公司里,通常我们会改进一个已经存在项目 (这个项目说不定已经存在好多年了),这个项目的文档也不多,编码规范也不是太完美。 这时候我们怎么办?  我们当然可以通过下面的办法:

  1. 理解程序
  2. 在不损害程序现有功能的情况下,修复bug 或增加新功能
  3. 同时有计划地通过重构或重写,改进这个程序,让它更好地被程序员理解,更好地能适应可能产生的变化。

这个作业就是这样一个例子。

假设有一组水平不高的程序员,或者一个水平不高的程序员(比如我),在很久以前为了学习Java, 就写了一个 Java 的围棋下棋程序 (不是人工智能,只是在屏幕上展现下棋的过程),  后来C# 出现之后,他又随意地把程序改写为C#,  经过简单测试之后,他就把程序放在一边了。

 

image

 

现在我们拿到了这个代码,程序还可以编译成功,但是不巧的是一个关键函数只有函数体,没有具体的实现了。例如:

int  GetLiberty(int x, int y, StoneColor c ) //判断当前的位置上的棋子和相连的一组棋子一共有多少气

这个程序原来总共有30行(算上空行和单字符行),但是由于种种原因, 这个函数只剩下了一句话

return 1;

现在请用递归和非递归两种方式把它实现出来。

 

关于个棋子或一组相连的棋子有多少气,有没有气, 十分简单。

详细的规则请看网上的许多教程。  举两个非常简单的例子:

image  如果此时该黑棋下,黑棋下在 (A,1) 的位置, 那么黑棋就把白棋 A2 的棋子吃掉了。如果此时该白旗下,白棋下在 C1 的位置,那么白棋就把两颗黑棋吃掉了。

image 此时,黑白双方谁能占据 O4 的位置, 就能够决定两个黑棋有没有气。

 

(上面的题目已经在课堂上搞定了,我们再扩展一下)

目前给同学们的程序能在下面两种情况下浏览棋局:

a) 直接在棋盘上面点击,程序就会按照黑白相间的次序走棋。

b) 用户可以用程序打开一个棋谱文件 (*.sgf),  然后按 “>” 按钮,程序就会按次序下棋。

大家注意到用户界面上还有一个 “<” 按钮,  这是让用户把下棋的步骤倒回去 (如果上一步一方吃掉了许多棋子, 那么我们还要把这些吃掉的棋子恢复好)

函数说明在这里:

image

这个函数的大部分都没有实现,现在我们要实现它。 (要求: 所有的修改都只在这一个函数体里面

我们的同学们学了《现代程序设计》,搞定下面的挑战应该不成问题:

1) 把程序编译通过, 跑起来。

    读懂程序,在你觉得比较难懂的地方加上一些注释,这样大家就能比较容易地了解这些程序在干什么。

     把正确的 playPrev(GoMove) 的方法给实现了。 如果大家不会下围棋,那就需要大家实地或者上网练习一下围棋的死活,提子是怎么回事。这个应该一个小时就能搞定。

2)根据你选择的教材 (三本之一或更多),点评一下这个程序设计方面的不足,例如:

     编码风格,

     程序架构,有哪些不符合良好的设计,这个程序的设计模式 (MVC等) 是高端大气国际化的么? 等等。 

     程序的错误处理,文件处理,UI 等等

     大家可能会想到,这个程序虽然说编译都过了,但说不定有很多基本的小问题没解决,VS 的强大的编译器和代码分析工具能把它们都找出来? 当然可以:

      image

     大家可以运行 VS 的代码分析工具,找到这个程序的这些问题,并改进。下面是报告的一部分:

image

这些改进可以是很小的,例如,把所有函数的命名都规范化,这算一个改进。同学们至少要把Code Analysis 报告的所有问题给解决了。

关于Code Analysis 的更多信息:

http://msdn.microsoft.com/en-us/library/ee1hzekz.aspx

http://msdn.microsoft.com/zh-cn/library/vstudio/ms182278.aspx 

 

3) 程序的注释

    所有人都觉得注释很重要,写程序不写注释的同学真是RP 比较低。。。

    那么,就请把这个程序中被标成 “zzzz” 的注释都恢复过来。 当然,你可以用中文写注释。

4) 选择题: (提示: 这个题目另外算分,满分10分,需要挣分的同学就可以考虑这个选择题)

对于功能上的小问题, 那么你怎么改进呢? 请选出 1-2个你想做的改进,然后运用你的各种编程技术和能力把这些改进给实现了(必须明确指出改进/增加了哪一个功能)。

      把所有的改进都实现之后,把代码签入 GitHub, 经历了这一番改动,你的程序和别的同学的程序就很不一样了。

如果大家有时间并有兴趣,可以做一些大的改进:

      a) 如果我要把这个程序变成一个可以人机对战的小游戏 (假设你的AI 模块已经写好,这里我们就可以让一个函数返回一个合法的位置就可以), 那这个程序的架构应该怎么变化?  请把这个功能写出来。

      b) 如果我想让这个程序变成两个用户可以通过网络对战,这个程序的架构要怎么变化?

 

另: 大家在读程序的时候可以测试一下自己的会发什么样的脑电波。 :)  看看下面的论文:

http://wwwiti.cs.uni-magdeburg.de/~feigensp/experiments/fMRI/fse_fMRI-Poster.pdf

posted @ 2013-10-22 11:00  SoftwareTeacher  阅读(2712)  评论(4编辑  收藏  举报