html 注释_java基础- Java编程规范与注释
一 前言
java编程规约是指在java代码编写过程中通俗的约定;通常我们是要遵守这些规范;这好比我们在生活中要遵守的道德准则,如果你做的事情超出了道德的底线,那就有可能会受到社会抨击;在java编程中也是类似的道理,如果你编写的代码不是很规范,尽管功能实现的功能强大,但其他java编程人员都看不懂你的代码,别人就认为你这是垃圾代码,后期的维护工作就会很艰难,而且心里肯定对你很不爽;如果在工作中遇见这种情况,你l的eader就有可能让你重写编写代码;
二 命名规范
良好的代码命名规则习惯有助于我们快速浏览代码,让代码的可读性强,易于他人阅读,后期维护工作简单;
2.1 驼峰命名法
驼峰命名法(Camel-Case)是程序编程的通俗约定,其分为大驼峰写法和小驼峰写法;
- 大驼峰:每一个单词首字母大写,随后的字母小写;示例:ILoveJavaProgramer
- 小驼峰: 第一个单词全小写,之后的单词首字母大写,其余字母小写;示例:iLoveJavaProgramer
2.2 包名写法
比如我有个域名是: java.com; 我现在要创建工程的包结构,那么通常包的命名规则是将域名反写,之后跟具体的包名;所有的包名都统一使用小写;
示例:com.java.zszxz.service
2.3 类名,接口名,文件名写法
类名,接口名,文件名写法统一采用大驼峰写法;
示例:
- 类名:FileInputStream
- 接口名:InputStream
- 文件名:UserMapper.xml
2.4 方法名,字段名写法
方法名 和 字段名称 统一采用小驼峰命名写法;
示例:
- 方法名:getUser()
- 字段名: fieldInfomation
2.4 常量名写法
常量是特殊的字段,也就是特殊的变量,其约定的写法跟之前稍有不同,其采用的写法是所有单词的字母都大写,单词之间使用下划线隔开;
示例: I_LOVE_JAVA_PROGRAMER
三 代码注释
代码的注释的作用主要是进行代码解释,类似你买了一个硬件设备,你要看说明书才知道怎么用这个设备,注释就起到了说明书的功能;代码注释的第二个功能是能注释到你当前写的代码,但后面又可能用到该代码,舍不得删除的情况;
3.1 单行注释
单行注释源于c++,其意指能注释掉一行代码,使用两个斜杆(//);
示例: // 我是知识追寻者,你是谁?觉得文章不错能帮助到你,那还不关注下?
3.2 多行注释
多行注释的风格源于c;其是斜杆和星号开头,中间部分是内容,以星号和斜杆结束(/ ............... /);
示例: / 今天你的小伙伴来找你了吗? /
3.3 文档注释
文档注释是指能够通过jdk的javadoc命令使注释生成html帮助文档,比如开发人员常看的jdk 的 API帮助文档;使用格式是以斜杆和2个星号开头,中间是内容,以星号和斜杆结束(/* .................... /);
通常文档注释只对 public 和 protect 级别的的成员进行注释,内部私有的成员是不提供给外部;
常用标签介绍:
了解更多标签示例请看:java文档注释
使用示例:
public class Doc {@Deprecatedprivate String buguaiguai;private String love;/*** @see java.lang.Object#toString()* @see java.lang.String* @see String* {@link System}* {@link System#getProperties()}* <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a>* @param love is favorite* @return the love* @deprecated <p>buguaiguai</p>* @throws RuntimeException contribution the java world* @since zszxz* @version 1.0.0* @author lsc/zszxz/youku1327*/public String getLove(String love){return "love";}
}
生成doc命令
javadoc -d tagerPath sourcePath/className.java
命令过程:
C:Users林>javadoc -d C:mydatageneratordoc C:javaworkspaceforresourcestudy-01basesrcmainjavacomyouku1327basedocDoc.java
正在加载源文件C:javaworkspaceforresourcestudy-01basesrcmainjavacomyouku1327basedocDoc.java...
正在构造 Javadoc 信息...
正在创建目标目录: "C:mydatageneratordoc"
标准 Doclet 版本 1.8.0_131
正在构建所有程序包和类的树...
正在生成C:mydatageneratordoccomyouku1327basedocDoc.html...
正在生成C:mydatageneratordoccomyouku1327basedocpackage-frame.html...
正在生成C:mydatageneratordoccomyouku1327basedocpackage-summary.html...
正在生成C:mydatageneratordoccomyouku1327basedocpackage-tree.html...
正在生成C:mydatageneratordocconstant-values.html...
正在构建所有程序包和类的索引...
正在生成C:mydatageneratordocoverview-tree.html...
正在生成C:mydatageneratordocindex-all.html...
正在生成C:mydatageneratordocdeprecated-list.html...
正在构建所有类的索引...
正在生成C:mydatageneratordocallclasses-frame.html...
正在生成C:mydatageneratordocallclasses-noframe.html...
正在生成C:mydatageneratordocindex.html...
正在生成C:mydatageneratordochelp-doc.html...C:Users林>
生成结果:
四 空行与缩进
4.1 空行
空行是指不同功能的代码之间要做到空行,以便于区分;
- 通常类名接口名,与其成员保持2个空行,如果有注释其也算一个空行;
- 不同类别的成员之间保持一个空行;
- 方法逻辑与方法名空一行;
示例:
/*
* 类的注释不需要空行
* /
public class zszxz {// 成员与类或者接口包池2个空行,包括注释;private String love;private Integer age; // 不同类别的成员保持一行private String gender;// 相同类名的成员不用空行public String getLove(){return "love"; // 方法逻辑与方法名空一行}}
4.2 缩进
类和属性;方法和逻辑;它们之间的缩进都是以4个空格为单位,可以使用制表符来代替多个空格,作者的一个制表符设置的是2个空格;
示例:
/*
* 类的开头不需要空格
* /
public class zszxz {// 成员与类或者接口保持4个空格private String love;private Integer age; // 成员与类或者接口保持4个空格private String gender;// 成员与类或者接口保持4个空格public String getLove(){ //成员与类或者接口保持4个空格return "love"; // 方法逻辑与方法名保持4个空格}}
html 注释_java基础- Java编程规范与注释相关推荐
- 生成注释_java基础- Java编程规范与注释
一 前言 java编程规约是指在java代码编写过程中通俗的约定:通常我们是要遵守这些规范:这好比我们在生活中要遵守的道德准则,如果你做的事情超出了道德的底线,那就有可能会受到社会抨击:在java编程 ...
- java编程规范换行_Java编程规范整理
近期即将开始编码阶段,特地整理一下各方面的编程规范与命名约定,以便内部团队风格统一. 文章大多从网络上收集汇总而来,参考列表附在文章末尾. Java编程规范整理 基本命名规范 包命名 包名按照域名的范 ...
- java 标识变量_Java变量与数据类型之一:Java编程规范,关键字与标识符
原标题:Java变量与数据类型之一:Java编程规范,关键字与标识符 大家好,这次要给大家带来的是Java变量与数据类型.本文是第一集:Java编程规范,关键字与标识符. 一.编程规范 任何地方的名字 ...
- Java编程规范(一)
Java编程规范 编程规约 命名风格 常量定义 代码格式 OOP约束 来源:阿里巴巴 编程规约 命名风格 不能以下划线或者美元符号开始或结束 **反例**:_name / __name / $name ...
- JAVA编程规范总结
JAVA编程规范总结: 1.编码规范好处: 1.减少维护成本和时间 2.增加可读性,方便自己和维护的技术人员二次改善 3.提高开发效率,团队协作 4.养成好习惯,提高自身修炼 2.命名规范: 1.尽量 ...
- java与数据类型相关的十个关键字_乐字节Java变量与数据类型之一:Java编程规范,关键字与标识符...
大家好,这次要给大家带来的是Java变量与数据类型.本文是第一集:Java编程规范,关键字与标识符. 一.编程规范 任何地方的名字都需要见名知意: 代码适当缩进 书写过程成对编程 对代码进行合理注释 ...
- “华为云企业级Java编程规范”学习笔记
一."Java基础语句"编程规范 Switch 语句要有defualt分支,除非Swich的条件变量是枚举类型; 多条件分支语句最后应包含一个else分支; 二."类的使 ...
- 阿里巴巴Java开发规范线程池_阿里巴巴java编程规范.pdf
阿里巴巴java编程规范 目录 一.编程规约1 (一) 命名规约1 (二) 常量定义3 (三) 格式规约4 (四) OOP 规约6 (五) 集合处理 10 (六) 并发处理 12 (七) 控制语句 1 ...
- sun公司java编程规范【转载】
java编程规范要学习的大致内容有如下部分,一个目录: Java编码规范 1 1.说明 3 1.1为什么要有编码规范 3 1.2版权声明 3 2.文件名(File Names) 3 2.1文件后缀(F ...
最新文章
- 结合ashx来在DataGrid中显示从数据库中读出的图片
- linux fedora14 u盘运行,Win7下Fedora 14 硬盘或U盘安装指南
- JAVAspringboot微服务b2b Spring MVC+mybatis+spring cloud+spring boot+spring security
- 推荐系统依据近期浏览进行推荐
- python idle退出_【ZZ】windows+python2.7在IDLE中执行sys.exit()出现的问题及解决方案
- java加载自己写的类_java 自定义类加载器从磁盘或网络加载类
- .NET Core 基于 Grafana Loki 日志初体验
- 28.卷1(套接字联网API)---原始套接字
- SVG 学习四 基础API
- Android WebView开发(三):WebView性能优化
- 【vue 四级联动】
- windows_删除多余网络适配器(删除/卸载多余网卡)/删除TAP虚拟网卡NIC
- 华为畅享8plus停产了吗_畅享和畅玩的区别_华为畅享8plus买完后悔了
- IIS express 配置和500.22错误解决详解
- 学好英语的42个经典要诀
- 华为防火墙产品介绍及工作原理
- 论文模型构建的步骤_最新论文:智能安全情报分析模型的构建
- Java 替换文件中的内容信息
- Druid监控页面配置reset-enable的说明
- HTML入门手敲学习笔记
热门文章
- 多线程随机数组生成+双线程快速排序(C++实现)(0.2秒排100W个数字)
- 埃尔米特插值(等距节点,只用一个点的导数构造n+1阶Hermite多项式)Python实现
- mfc cedit 默认显示内容_拼多多评价不显示的几大原因,看完之后才知道是触碰了这几个环节...
- 强化学习——值迭代和策略迭代
- Centos系统更改yum源为163
- 十三、IntelliJ IDEA 中的版本控制介绍(下)
- [hdu4333]Revolving Digits
- mysql报错ERROR 1206 (HY000): The total number of locks exceeds the lock table size的解决方法...
- Android 通过 XMPP 实现聊天功能,App Engine Assisted Group Chat (开源)
- 摄像机的上方向(UpDirection)- 使用WPF演示