• 软件工程第四次作业—代码规范—[结对刘成志]


    一、 本次代码规范目的

      (一)制定10条切实可行的代码规范

      (二)根据制定方案实际执行情况

    二、代码规范的要求

    代码规范作业地址:https://edu.cnblogs.com/campus/nenu/SWE2017FALL/homework/993

    三、代码规范的实施过程

    (一)结对编程所制定的十条代码规范:

      1.括号位置匹配,每一个‘{‘必须在代码结束后的相应位置有与其匹配的‘}’。

      2.函数中的方法名全部用小写英文显示。

      3.申请的变量都用小写显示。

      4.必要的单行注释用‘//’跟在代码下方或后方。

      5.在函数方法前需要必要的说明用 “/*”和“*/”进行多行注释。

      6.方法外的全局变量定义为static类型。

      7.对于前期进行测试的无效代码进行删除。

      8.方法与方法之间基本会有一到两个Enter键。

      9.申请的集合设置类型为Object类型,可以放字符串和数值类型。

      10.基本实现一行一操作代码,增强代码阅读可读性。

    (二)规范执行情况:(**注:chen为陈建宇/liu为刘成志)

    代码规范约定 规范执行情况 规则是否有效/是否进行更改
    括号位置匹配,每一个‘{‘必须在代码结束后的相应位置有与其匹配的‘}’。 if/while条件不自动生成,Chen在if条件处出过两次括号不对齐/liu在代码删除的时候直接将}前面的缩进删到代码后 规范有效/不进行更改
    函数中的方法名全部用小写英文显示。 chen触发五次(定义方法名后一个单词首字母用大写)/刘触发两次次(定义方法名每个单词首字母大写) 规范有效/不进行更改
    函数中的变量名全部用小写英文显示。 chen触发一次,在定义栈时候变量用大写 规范有效/不进行更改
    必要的单行注释用‘//’跟在代码下方或后方。 两人前期同时触发多次(后期代码加注释) 规范有效/不进行更改
    函数方法前需要必要的说明用 “/*”和“*/”进行多行注释。 两人前期同时触发多次(后期代码加注释) 规范有效/不进行更改
    方法外的全局变量定义为static类型。 chen触发两次(调试时候进行更改) 规范有效/不进行更改
    对于前期进行测试的无效代码进行删除。 chen触发八次/liu触发十二次(前期测试代码时候用//或者/**/来注释了不用的代码) 规范有效/不进行更改
    方法与方法之间基本会有一到两个Enter键。 liu触发三次 规范有效/不进行更改
    申请的集合设置类型为Object类型,可以放字符串和数值类型。 chen触发一次(调试程序过程中发现错误) 规范有效/不进行更改
    基本实现一行一操作代码,增强代码阅读可读性。 liu触发三次(多个变量在同行进行定义) 规范有效/不进行更改

    三、代码规范总结

      1.结对编程中因为是两个人一起编程,根据不同人的不同习惯,必要的代码规范还是有必要进行统一的定义。

      2.相关代码的注释是必要的,可能单个人所写的方法其他人不一定能很快能读懂。

      3.变量和方法名的定义要有一定意义,不能随意定义。

      4.必要的换行,增加代码直观阅读性。

      5.后期调试注明谁在哪块进行调试,修改某块代码。

  • 相关阅读:
    表格边框的合并
    solr服务搭建
    JedisClient操作redis 单机版和集群版
    redis集群的搭建
    FastDfs的搭建
    打开与关闭端口
    zookeper分布式搭建1
    zookeper分布式搭建
    Zookeeper的安装
    Linux下Jdk的安装
  • 原文地址:https://www.cnblogs.com/chjy/p/7649826.html
Copyright © 2020-2023  润新知