团队六七周作业
完善版需求规格说明书
- 《需求规格说明书》初稿不足之处:
1.开发工具写错
2.游戏风格与游戏特点内容重复
制定团队编码规范
阅读《构建之法》第四章内容,讨论并总结
- 使用的工具
JDK:
IDEA:
Android Studio:
编码规范
-
目的
制定统一的编码规范,使项目组成员养成良好的编程习惯,提高代码的效率及可读性,使代码达到很好的整合控制。 -
依据
仿照Sun公司基本的JAVA规范。 -
具体规范
3.1 编码风格
-
缩进
1. 建议以4个空格为单位。
2. 语句块的"{"、"}"配对对齐,并与其前一行对齐,语句块类的语句缩进建议每个"{"、"}"单独占一行,便于匹对。 -
空格
原则上变量、类、常量数据和函数在其类型,修饰名称之间适当空格并据情况对齐。
关键字原则上空一格,如:if ( ... 等。运算符的空格规定如下:"::"、"->"、"["、"]"、"++"、"--"、"~"、"!"、"+"、"-"(指正负号)、"&"(引用)等几个运算符两边不加空格(其中单目运算符系指与操作数相连的一边),
其它运算符(包括大多数二目运算符和三目运算符"?:"两边均加一空格,在作函数定义时还可据情况多空或不空格来对齐,但在函数实现时可以不用。","运算符只在其后空一格,需对齐时也可不空或多空格。不论是否有括号,对语句行后加的注释应用适当空格与语句隔开并尽可能对齐。个人认为此项可以依照个人习惯决定遵循与否。 -
对齐
原则上关系密切的行应对齐,对齐包括类型、修饰、名称、参数等各部分对齐。另每一行的长度不应超过屏幕太多,必要时适当换行,换行时尽可能在","处或运算符处,换行后最好以运算符打头,并且以下各行均以该语句首行缩进,但该语句仍以首行的缩进为准,即如其下一行为“{”应与首行对齐。变量定义最好通过添加空格形成对齐,同一类型的变量最好放在一起。如下例所示:
int Value;
int Result;
int Length;
个人认为此项可以依照个人习惯决定遵循与否。
- 空行
不得存在无规则的空行,比如说连续十个空行。程序文件结构各部分之间空两行,若不必要也可只空一行,各函数实现之间一般空两行,由于每个函数还要有函数说明注释,故通常只需空一行或不空,但对于没有函数说明的情况至少应再空一行。对自己写的函数,建议也加上“//------”做分隔。函数内部数据与代码之间应空至少一行,代码中适当处应以空行空开,建议在代码中出现变量声明时,在其前空一行。类中四个“p”之间至少空一行,在其中的数据与函数之间也应空行。
- 注释
JAVA代码注释
- 综述
注释是软件可读性的具体体现。
程序注释量一般占程序编码量的20%,软件工程要求不少于20%。
程序注释不能用抽象的语言,要精确表达出程序的处理说明。
注释必不可少,但也不应过多,不要被动的为写注释而写注释。
- 以下是四种必要的注释:
A 标题、附加说明。
B 函数、类等的说明。
对几乎每个函数都应有适当的说明,通常加在函数实现之前,在没有函数实现部分的情况下则加在函数原型前,其内容主要是函数的功能、目的、算法等说明,参数说明、返回值说明等,必要时还要有一些如特别的软硬件要求等说明。
C 在代码不明晰或不可移植处必须有一定的说明。
D 及少量的其它注释,如自定义变量的注释等。
注释有块注释和行注释两种,分别是指:"/**/"和"//"
-
3.2 代码效率
综述
编程过程中一定要考虑代码执行的效率,大家在以后的开发工作中有什么具体的经验可以继续完善。
-
具体实现
把要循环的数组或列表,长度赋予某个变量,在for循环体中调用改变量即可。
-
异常处理
程序处理 1. 在程序调试过程中可以让程序抛出异常,以便发现问题;当程序调试完毕须捕获异常,进行处理。 2. 对于空指针一样,一定要在程序编写时考虑到这种情况,并做相应处理。
-
日常交流
4.1互相促进
a. 项目开发过程中,按照功能模块来划分每个人的任务,当有两个人完成各自模块后,进行交换交流,除检查其功能是否完成外,互相检查代码规范,代码质量是非常重要的。 b. 可以在程序开发过程中,多考虑一层,考虑功能的重用性 c. 每周一进行项目组总节,通告项目组人员自己学到什么,与大家分享,共同提高。 d. 有好的想法或者对项目组有益的都可以提出来讨论研究。
数据库设计
- 《打地鼠》cmd文件
- ER图
后端架构设计
Redis做缓存系统,MySQL做数据库。
尽量把重复实现的模块部署为远程服务,新增的业务调用远程服务提供的功能来实现相关的业务,不依赖于里面具体的代码实现,例如将用户、管理员登陆模块整合,来减少程序的累赘。
App操作中由于经常涉及用户登录操作,登录就需要使用到用户名和密码,为了安全起见,在登录密码时显示密码的次数越少越好,因此,最好是使用https协议。
基本的方案是所有涉及安全性的API请求都必须使用HTTPS协议。
就项目启动后的后台来看,根据程序实际情况,不考虑分布式部署架构,尽量使用一开始就使用Redis。好处:既能用作缓存,又能充当队列服务,而且并发性能高,能在长时间内应对业务压力,非常适合初期的项目。并且可以使用Redis验证用户信息,充当消息队列。而文件服务初期可以选择文件云存储服务,减少开发者的压力。
关于登陆方面服务器接收到app发送的用户名和密码后,验证用户名和密码是否正确。
如果错误则返回错误信息。如果验证正确,生成一个随机的不重复的token字符串(例如"daf32da456hfdh"),在Redis中维护一个映视表,建立token字符串和用户信息的对应关系表。就类似于有人希望进入一个上了锁的房间,他使用用户名和密码打开了这把锁后,进入房间,找到房间管理员,让管理员提供一把钥匙。
数据转码。
我们需要处理多个不同设备,多个操作系统和屏幕分辨率,我们的内容存储和处理时应与设备无关。所以,图像和视频的转码是必不可少的。我们的应用程序需要收集设备的配置,如内存、编码和屏幕分辨率,作为API的上下文。我们的API应该使用此上下文来选择内容版本。基于我们接受到的设备上下文,我们可以预先准备好一些最多的被请求的版本的内容。可以使用FFMPEG转码,FFMPEG是最可靠和应用最广的转码框架。可以修改FFMPEG,使其满足需求。转码是在数据输入端完成的。
由于网络环境,关键是要尽可能节省资源,使通信尽可能地轻量。我们所有的HTTP请求都使用okhttp客户端,okhttp使用SPDY协议,能够弹性处理连接失败,透明恢复。总而言之,尽可能将麻烦的事情交给专业人员来完成。同理,通讯需求,都可以切换到MQTT,这是一个轻量级的机器对机器的连接协议。
TODOList
学号 | 组员 | 分工 | 用时 | 工作量百分比 |
---|---|---|---|---|
20162309 | 邢天岳 | 数据库设计 | 1h | 15% |
20162311 | 张之睿 | 完善版需求规格说明书 | 1h | 15% |
20162312 | 张家铖 | 制定团队编码规范 | 2h | 30% |
20162313 | 苑洪铭 | 后端架构设计 | 45min | 12% |
20162324 | 春旺 | 需求象限、WBS图、功能分配截图、燃尽图 | 2h | 30% |
20162325 | 金立清 | 团队分工&督促进度&编写博客 | 2h | 30% |
总结与反思
-
1.在分任务的时候,能力强的组员也容易避重就轻,这就让剩下的同学比较难做了…
-
2.大家对自己要完成的任务,认知上并不清晰明了,不太懂老师布置的要求和意图以及自己究竟如何下手。
-
3.这周因为各种事情,周日24点时我还没能收集各部分完整的材料,希望以后可以尽量避免。
——金立清