Java程序员如何写出漂亮的代码?_惠州计算机Java培训学校
作者:hz_admin02发布时间:2022-04-05分类:惠州计算机学校浏览:628
存在问题:
好多小伙伴对编码的格式作用模糊,以为只要完成功能就行,其实这种观点是错误的,一定要重视代码规范,不然你哭的地都找不到。
如何实施:
良好的代码开发习惯对人对己都是非常有用的,良好的代码开发习惯包括,方法封装的独立性,注释添加的合理性,代码布局书写的工整性,当然这些东西没有写的很好也不影响程序的编译与运行,也就是说在初期开发的时候是不受什么影响的,但是对于后期的维护与他人的对你的代码维护就能显示出这方面的重要性了;
今天主要跟大家分享一下一个在程序员这个地方一种公认的书写规范,可以说总结的还是相对全一些的,希望可以对大家有帮助,篇幅可能有点长,如果一篇文章写不完,我会把部分内容放到第二篇中;
一、代码文本注释规范
1)、一般情况下,源程序有效注释量必须在20%以上
注解:需要用SourceCounter工具查看代码的备注说明百分比
2)、源文件头部应进行注释,列出:版权说明、版本号、生成日期、作者、模块功能、主要函数及其功能、修改日志等
注解:例如/*
*Entrance Guard System
*7-Jan-2012Auther.Zhang0.2 Version
*Copyright & the right of find interpretation auther
*synopsis:响应上位机的具体实现,服务于message.c
**/
3)、函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值、调用关系(函数、表)等
注解:例如 /*******************************************************************
函数说明 :对函数的简单说明
入口参数 :入口参数及功能
返回类型 :
初始时间 :2012-2-22Lebaishi
修改记录 :2012-3-23支持下载过程中意外断网,下次下载不出错
用途功能:简述此函数的简单用途与目的
********************************************************************/
4)、注释的内容要清楚、明了,含义准确,防止注释二义性
5)、避免在注释中使用缩写,特别是非常用缩写
6)、注释应与其描述的代码相近,对代码的注释应放在其上方或右方(对单条语句的注释)相邻位置,不可放在下面,如放于上方则需与其上面的代码用空行隔开
7)、对于所有有物理含义的变量、常量,如果其命名不是充分自注释的,在声明时都必须加以注释,说明其物理含义。变量、常量、宏的注释应放在其上方相邻位置或右方
8)、数据结构声明(包括数组、结构、类、枚举等),如果其命名不是充分自注释的,必须加以注释。对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注释放在此域的右方
9)、全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明
注解:对于注释,单行的注释要与其上面的内容用空行隔开
10)、避免在一行代码或表达式的中间插入注释
11)、在程序块的结束行右方加注释标记,以表明某程序块的结束
注解:以方便当代码段较长,特别是多重嵌套时的代码可读性
二、代码版本命名规范
1)、代码版本分为:稳定版本和开发版本
版本号的命名参照linux内核命名规则,采用r.x.y点十进制方式命名
r:目前发布的主版本号(与硬件相匹配,与每一版电路板相匹配)
x:偶数代表稳定版本,奇数代表开发中版本
y:开发过程中的错误修补升级版本
为了区分不同版本间的差异,需要在r.x.y后加上-LBS(作者名缩写)
2)、版本号升级及变更说明:
r:跟随硬件电路的升级而变更,例如升级到二系的门禁板,此版本号置为2,依次类推
x:第一次开发置为1,出厂维护无法解决并返回研发室重新开发则置为3(奇数递增),依次类推,每次形成稳定版本出厂时,此版本号置为小于自己的最大偶数
y:开发过程中由0到999递增,出厂后此版本号不变,出厂维护的每次升级将此版本号递增1,出厂维护无法解决并返回研发室重新开发则置为0,重新计数
注解:r是匹配硬件电路的主版本号,x是内部开发的主版本号(奇数),在开发阶段y是调试修改升级的次版本号,在出厂维护阶段y是维护版本号
三、代码函数实现规范
1)、在同一软件产品内,应规划好接口部分标识符(变量、结构、函数及常量)的命名,防止编译、链接时产生冲突
注解:例如在门禁开发中,可以以MJ_开头作为函数首部命名相关函数
2)、用正确的反义词组命名具有互斥意义的变量或相反动作的函数等,提供以下积累(其他待积累)
add / remove begin / end create / destroy put / get
insert / delete first / last get / releaseup / down
add / delete lock / unlock open / closecut / paste
min / max old / new start / stopsend / receive
next / previous source / target show / hidesource / destination
increment / decrement
3)、不要设计多用途面面俱到的函数,一个函数仅完成一件功能
4)、尽量不要编写依赖于其他函数内部实现的函数
注解:例如为了实现某个功能而在模块的函数里面调用其他的函数,这样影响函数的独立性
5)、避免单独使用无意义或含义不清的动词为函数命名(例如:process、handle)
6)、最好不要把与函数返回值类型不同的变量,以系统默认的转换方式或强制转换方式作为返回值返回
注解:如果要返回int 型变量最好让其函数返回类型也为int
7)、设计高扇入、合理扇出的函数(扇出是指一个函数直接调用其它函数的数目,而扇入是指有多少上级函数调用它)
点击咨询直接了解更多相关资料,我在惠州北大青鸟新方舟等你。
本文内容转载自网络,版权归原作者所有,如有侵权请联系我们进行删除。
标签:惠州计算机软件培训惠州计算件软件开发惠州计算机软件基础惠州计算机JAVA软件开发惠州Java培训学校惠州Java培训JAVA语言Java是什么Java开发JAVA入门
- 惠州计算机学校排行
- 标签列表
-
- Java (3694)
- 北大青鸟 (3713)
- 软件开发 (3613)
- JAVA (3413)
- UI设计入门 (2093)
- 惠州北大青鸟 (4375)
- 惠州IT培训 (2558)
- UI设计培训 (2090)
- 惠州UI设计培训 (2095)
- 惠州UI设计培训学校 (2090)
- 惠州计算机软件培训 (6260)
- 惠州计算件软件开发 (6260)
- 惠州计算机软件基础 (6261)
- 惠州计算机JAVA培训 (3574)
- 惠州计算机Java软件开发 (3620)
- 惠州计算机JAVA软件开发 (4645)
- 惠州计算机JAVA软件开发学校 (3338)
- 惠州计算机Java软件开发培训 (3338)
- 北大青鸟IT计算机学校 (5048)
- 北大青鸟IT软件学校 (5062)
- 北大青鸟IT学校 (5059)
- 惠州计算机UI设计软件开发 (2088)
- UI设计基础教程 (2088)
- UI设计是什么 (2088)
- UI设计教程 (2088)
- 网站分类
-
- 计算机教程
- 计算机入门
- 职业学校
- 新闻动态
- 专业课程
- 热门技术
- SEO
- 培训教程
- windows
- linux教程
- 系统集成
- 网站开发
- Html5
- 办公软件
- 师资力量
- 热点问答
- 联系我们
- 计算机学校
- 惠州计算机学校
- 河源计算机学校
- 广州计算机学校
- 深圳计算机学校
- 湛江计算机学校
- 佛山计算机学校
- IT计算机培训信息
- 设计专业
- UI
- 影视特效
- 游戏动漫设计
- Photoshop
- AI设计
- 软件教程
- Java技术
- C语言/C++语言培训
- C#
- Python技术
- PHP
- 数据库
- SQL Server
- 网络教程
- 网络安全
- 网络营销
- 软件专业
- 大数据专业
- 前端开发专业
- 软件测试专业
- Python专业
- 软件实施
- 珠海计算机学校
- 初中生学什么好
- 计算机认证
- 文章归档
-
- 2024年10月 (32)
- 2024年9月 (29)
- 2024年8月 (68)
- 2024年7月 (59)
- 2024年6月 (43)
- 2024年5月 (48)
- 2024年4月 (80)
- 2024年3月 (65)
- 2024年2月 (54)
- 2024年1月 (25)
- 2023年12月 (12)
- 2023年11月 (73)
- 2023年10月 (134)
- 2023年9月 (34)
- 2023年8月 (3)
- 2023年7月 (3)
- 2023年6月 (12)
- 2023年5月 (30)
- 2023年4月 (72)
- 2023年3月 (11)
- 2023年2月 (34)
- 2023年1月 (37)
- 2022年12月 (78)
- 2022年11月 (359)
- 2022年6月 (1193)
- 2022年5月 (570)
- 2022年4月 (1567)
- 2022年3月 (982)
- 2022年2月 (54)
- 2022年1月 (182)
- 2021年9月 (308)
- 2021年8月 (1704)
- 2021年7月 (2423)
- 2021年6月 (1806)
- 2021年5月 (1569)
- 2021年4月 (1380)
- 2021年3月 (1255)
- 2021年2月 (709)
- 2021年1月 (1521)
- 2020年12月 (3626)
- 2020年11月 (1646)
- 2020年10月 (1046)
- 2020年9月 (592)
- 最近发表
-
- 江门信息:伪造健在证明材料骗取工伤保险待遇真刑!|||计算机软件培训学校
- 汕头信息:深化组团挂联汕头这场义诊助力百千万工程|||大学生计算机培训学校
- 东莞信息:石龙石龙人社分局持续举办南粤家政技能培训班|||广州计算机编程培训
- 东莞信息:虎门虎门镇首个人才交流服务中心揭牌成立|||计算机职业技能培训班
- 中山信息:中山市人社局持续开展讲诚信不欠薪根治欠薪法治宣传活动|||计算机培训机构
- 东莞信息:南城南城街道开展职业技能展示活动|||计算机网络培训学校
- 东莞信息:东莞市金秋招聘月就业服务行动招聘会暨东莞市第三届全国个体工商户服务月活动|||计算机专业维修学校
- 茂名信息:来宾市人社局赴我市开展劳务协作交流活动|||电脑计算机编程培训学校
- 汕头信息:家政高手同台比武!汕头市举办2024年南粤家政职业技能大赛|||广州市北大青鸟计算机职业培训学校
- 东莞信息:莞城街道金秋招聘月暨重点群体招聘会活动|||广州计算机软件培训