2017-2018-1 JaWorld 第六、七周作业

时间:2022-04-21 20:30:20

2017-2018-1 JaWorld 第六、七周作业

修改需求规格说明书

上次的《需求规格说明书》初稿有哪些不足?

  • 王译潇同学回答:

  1. 引言和目的性考虑的不是很周全。

  2. 应该花时间把要做的产品原型先搞清楚,游戏更应该把功能定义好。

  3. 确定前端后端用什么来开发。

  4. 不要一个人做太多方面的工作。

  5. 不是很容易保证产品不拖延。

  6. check时间间隔不能过长。

  7. 前期的市场调研不是很充分全面。

  8. 用户背景不够全面具有代表性。

  • 张师瑜补充:

  1. 关于游戏整体的界面设计操作等不够完善。

  2. 软件通信接口等需求暂未确定,还待补充。

后端架构

  • 将静态图片作为游戏舞台,把所有移动物体作为精灵,我们定义了Sprite类,即精灵类,游戏中的飞机、子弹、奖励道具等都是继承自该类,我们通过moveTo()、move()等方法控制精灵的位置。

编码规范

原则

统一:统一是指,对于同一个概念,在程序中用同一种表示方法,比如对于供应商,既可以用supplier,也可以用provider,但是我们只能选定一个使用,至少在一个Java项目中保持统一。统一是作为重要的,如果对同一概念有不同的表示方法,会使代码混乱难以理解。即使不能取得好的名称,但是只要统一,阅读起来也不会太困难,因为阅读者只要理解一次。

达意:达意是指,标识符能准确的表达出它所代表的意义,比如: newSupplier, OrderPaymentGatewayService等;而 supplier1, service2,idtts等则不是好的命名方式。准确有两成含义,一是正确,而是丰富。如果给一个代表供应商的变量起名是 order,显然没有正确表达。同样的,supplier1, 远没有targetSupplier意义丰富。

简洁:简洁是指,在统一和达意的前提下,用尽量少的标识符。如果不能达意,宁愿不要简洁。比如:theOrderNameOfTheTargetSupplierWhichIsTransfered太长, transferedTargetSupplierOrderName则较好,但是transTgtSplOrdNm就不好了。省略元音的缩写方式不要使用,我们的英语往往还没有好到看得懂奇怪的缩写。

骆驼法则:Java中,除了包名,静态常量等特殊情况,大部分情况下标识符使用骆驼法则,即单词之间不使用特殊符号分割,而是通过首字母大写来分割。比如: supplierName, addNewContract,而不是 supplier_name, add_new_contract。

英文:尽量使用通俗易懂的英文单词,如果不会可以向队友求助,实在不行则使用汉语拼音,避免拼音与英文混用。比如表示归档,用archive比较好。

包名规范

使用小写和数字组合,不要出现其他字符和符号。例如:com.aps.alg

类名命名规范

首字母大写
后缀命名

方法名命名规范

  • 首字母小写,动词在前

变量命名规范

静态常量:全大写用下划线分割

枚举:全大写,用下划线分割

其他:首字母小写,骆驼法则

局部变量: 参数和局部变量名首字母小写,骆驼法则。尽量不要和域冲突,尽量表达这个变量在方法中的意义。

排版风格

规则一:程序块采用缩进风格编写,缩进为4个空格位。排版不混合使用空格和TAB键。

规则二:在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符,后不应加空格。

规则三:函数体的开始,类的定义,结构的定义,if、for、do、while、switch及case语句中的程序都应采用缩进方式。

规则四:功能相对独立的程序块之间或for、if、do、while、switch等语句前后应加一空行。

规则五:if、while、for、case、default、do等语句自占一行。

规则六:若语句较长(多于80字符),可分成多行写,划分出的新行要进行适应的缩进,使排版整齐,语句可读。

规则七:一行最多写一条语句。

规则八:类先成员变量,后内部函数接口;关键字public、protected、private依次按照顺序排版。

规则九:编写条件的时候采用“常量==变量”格式

工作分工

成员 分工 比例
陈是奇 查资料 5%
马平川 后端架构 5%
王译潇 编码规范 30%
李昱兴 查资料 5%
林臻 查资料 5%
张师瑜 推进工作进展、修改说明书的内容、完成markdown形式以及上传码云、写博客 50%

感想

  • 这周事情很多,团队博客进行的较晚。但是即使我每天都督促组内,大部分成员还是周日下午给我导致我准备的很匆忙。希望以后这种现象能够避免。(from 张师瑜)