• 团队作业第二周


    需求规格说明书

    • 上次的《需求规格说明书》初稿有哪些不足?
    • 上周是我们敲定最终实现什么类型的app,并一起为之提供想法完善内容的第一周,我们大家对我们最终应该完成什么还只是有一个大概的概念,因此需求规格说明书也只是有个框架,其中的诸多内容(例如:用例图,软件和界面的验收标准)上周我们还无法补充进去,只是空有一个写着自己要向什么方向努力的框架。
    • 本周对《需求规格说明书》的修改:
    • 1.《需求规格说明书》中的修改在Markdown文件中的体现
      Markdown
      PDF
    • 2.绘制了该app的功能介绍图
    • 3.参考其他标准的《需求规格说明书》,描写了具体用户的使用场景和用户需求分析。

    团队的编码规范

    1.命名规则(前五条为基本原则,后五条为具体规定)

    • 一、使用可以准确说明变量、字段、类、接口、包等完整的英文描述符;
    例如,采用类似 FirstName,ListAllUsers 或 CorporateCustomer 这样的名字,严禁使用汉语拼音及不相关单词命名
    
    • 二、采用该领域的术语;
    例如:图中的顶点用Vertex而非Point;
    
    • 三、尽量少用缩写,但如果要使用,也请使用公共缩写和习惯缩写等;
    例如:广度优先搜索按规范应为:BreadthFirstSearch可简写为BFS;
    
    • 四、避免使用相似或者仅在大小写上有区别的名字。
    例如:避免I和l在其中反复出现的名字。
    
    • 五、命名应尽可能简短。
    例如:如上第四条中长度超过15个字符的,可以使用公共缩写和习惯缩写。
    
    • 六、包命名:
      包名一律小写, 少用缩写和长名;
    例如:package javafoundations;
    
    • 七、类或接口命名:
      类或接口名是个一名词,采用大小写混合的方式,每个单词的首字母大写,其中,规定抽象类前加Abstract异常类后加Exception。
    例如:AbstractJobs/EmptyCollectionExceptions 
    
    • 八、变量命名:
      采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写;
      变量名不应以下划线或美元符号开头;
    反例:$name或_name
    

    尽量避免单个字符的变量名,除非是一次性的临时变量。临时变量通常被取名为i,j,k,m和n,它们一般用于整型;
    c,d,e,它们一般用于字符型;
    组件或部件变量使用其类型名或类型名缩写作其后缀;

    例如:fileMenu;
    

    集合类型变量,例如数组和矢量,应采用复数命名或使用表示该集合的名词做后缀。

    • 九、常量命名:
      全部采用大写,单词间用下划线隔开。
    例如:MAX_NUMBER_COUNT; 
    
    • 十、方法命名:
      方法名是一个动词,采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写;
      取值类可使用get前缀,设值类可使用set前缀,判断类可使用is(has)前缀。
    例如:setName;
    

    2.代码风格

    1.缩进:
    程序块要采用缩进风格编写,缩进只使用TAB键,不能使用空格键(编辑器中请将TAB设置为4格);
    方法体的开始、类的定义、以及if、for、do、while、switch、case语句中的代码都要采用缩进方式;
    2.对齐:
    程序块的分界符左大括号"{" 和右大括号"}"都另起一行,应各独占一行并且位于同一列;
    对齐只使用TAB键,不使用空格键;
    不允许把多个短语句写在一行中,即一行只写一条语句;
    if、for、do、while、case、switch、default等语句自占一行;
    不论if、for等语句后面跟的语句数是否为1,均需要打大括号。
    3.换行:
    一行的长度超过80个字符需要换行,换行规则如下:
    在一个逗号后面断开;
    在一个操作符前面断开;
    长表达式要在低优先级操作符处划分新行;
    新行缩进2个TAB。
    4.间隔:
    类、方法及相对独立的程序块之间、变量说明之后必须加空行;
    关键字之后要留空格, 象if、for、while  等关键字之后应留一个空格再跟左括号"(", 以突出关键字;
    方法名与其左括号"("之间不要留空格, 以与关键字区别;
    二元操作符如" >="、" <="、" +"、" *"、" %"、" &&"、" ||"、" <<" ," ^" 等的前后应当加空格;
    一元操作符如" !"、" ~"等前后不加空格;
    for语句中的表达式应该被空格分开。
    5.包的导入:
    整个包导入,然后根据自己的需要进行修改,切忌擅自删除包内内容;

    3.注释

    1.文件注释:
    1.文件注释:所有的源文件都应该在开头有一个注释,其中列出文件的版权声明、文件名、功能描述以及创建、修改记录:

    例如:
    /**
     *Copyright(C)2019-2020 Android APP Set;
     *FileName:app.java
     *Description:java
     *History:
     *版本号  作者   日期        简要操作
     *1.0    王振澳  2019/12/1  Create
     **/
    

    2.类或接口注释:
    采用JavaDoc文档注释,在类、接口定义之前应当对其进行注释,包括类、接口的描述、最新修改者、版本号、参考链接等;
    注:JavaDoc文档注释:描述Java的类、接口、构造方法、方法、以及字段。每个文档注释都会被置于注释定界符/...*/之中,一个注释对应一个类、接口或成员。该注释应位于声明之前。文档注释的第一行(/)不需缩进,随后的文档注释每行都缩进1格(使星号纵向对齐)。

     例如:
    /**
     *测试类(类功能的描述)
     *@author wangzhenao(最新的作者)
     *@version 1.0(最新版本号)
     *@see Java(参考资料)
     **/
    

    3.注释格式:
    单行注释格式//
    多行注释格式/……/
    注:单行注释上方空一行,以明确注释的作用域;

    4.选择理由

    • 1.提高我们的编码效率。整齐划一的代码方便我们进行复制粘贴嘛!
    • 2.提高代码的可读性,使得开发人员能够更容易的理解代码。
    • 3.方便团队协同工作。大家使用同一的规范,这样就消除了五花八分的书写方式,同一协调!
    • 4.养成写规范代码的习惯,有助我们的成长。

    团队项目的数据库设计

    • 数据库设计
    • ER图

    项目的后端架构设计

    • 主页面
    • 全部习惯(尚未完成)
    • 番茄钟
    • 名人名言
    • 百度

    团队分工

    成员 分工
    吴东泽 博客的撰写,画各种图,协助姬旭
    王振澳 api的调用及实现
    杨凯涵 服务器的搭建及分配任务
    曹骞 界面设计
    姬旭 各个按钮的调用,页面的实现
    • 根据情况具体动态分配

    象限法确定优先级

    • 功能介绍图(WBS):

    TODOList及燃尽图

    • TodoList任务树

    • 燃尽图

    本次分工及工作量比例

    学号 成员 分工 比例
    20182312 吴东泽 博客的撰写,画各种图 20%
    20182318 王振澳 api的调用及实现 20%
    20182321 杨凯涵 核心代码的实现及分配任务 20%
    20182323 曹骞 界面设计 20%
    20182334 姬旭 布局及界面美化 20%

    本周小组会议及交互总结

    • 随着时间愈发的邻近,我们不仅讨论的时间减少了,而且积极性方面也较之前有了一定程度上的下降,频繁的碰壁,让我们对自己的方向感到迷茫,但我们正竭尽全力克服这一困难。
    • 在本周中,我们组的人都顺利完成了自己的任务,杨凯涵同学为我们分配的任务,并身先士卒的搭建服务器和数据库,可惜碰壁了,但本周基本任务即代码已完成,姬旭同学完成了页面之间的调用,曹骞同学完成了页面设计,吴东泽同学完成了本周博客和其中的所有要求事项,并对他们的工作进行了一定程度的协助,王振澳同学在api方面已经成功运行,只差将其连接到我们的app中。

    参考资料

    Java编码规范总结

  • 相关阅读:
    佛教:禅宗和净土--佛教的归途
    佛教:从精英到世俗
    佛教:神迹的演变。
    收藏品:MP3播放器
    淘书百胜楼
    Spring注解是如何生效的?
    logstash6.8.3 导入 CSV 文件到 ElasticSearch
    三个线程交替按顺序打印ABC之条件队列的理解
    谈谈多线程
    ElasticSearch如何更新集群的状态
  • 原文地址:https://www.cnblogs.com/shouko/p/11966353.html
Copyright © 2020-2023  润新知