实用简约的JAVA注释标签-高手必备
来源:互联网 发布:java程序员做什么 编辑:程序博客网 时间:2024/06/05 11:50
大家在开发中写JAVA注释谁都会,不会一般写得少或者随便写,其实这是习惯问题,与开发进度无关。养成良好的习惯会觉得写出来的代码很专业,很有成就感 。最近看开源框架里面的JAVA注释。觉得很有意思。做下记录:
通常注释包括以下几个部分:
功能描述,参数,作者,版本,看另一方法
参数:@param
作者: @author Administrator
版本:@version
看另一方法:@see #resolveClass(Class) 会生成一个跳转到同类的resolveClass方法
描述一般用HTML标签
java注释支持许多HTML标签。下面介绍常用的标签:
</br> 换行,一行简要功能后详细的描述可以换行再写
<tt></tt> 在注释用到其他的类名可以用该标签格式化,会使类名显示与众不同哦。效果如下:
<p> 段落,该标签可自动换行并空出一行
{@link String} 链接到String类
前面介绍了tt标签可以配合起来使用 {@link ClassA <tt>ClassA</tt>} 前面一个ClassA是类名,第二个ClassA是显示文字
<pre></pre>有时候会在注释中写一段示例代码。一般写法会不换行的。
不加pre的话全部换行会无效,效果如下:
加上换行就好多了,效果如下:
<h1></h1>
<h2></h2>
...
<h4></h4>
最后来一张综合性的:
java代码:
- /**
- * <h1>全局的类加载器</h1>
- * </br>
- * 继承于{@link ClassLoader},并重写了<tt>ClassLoader</tt>的{@link #findClass(String)}
- * 方法
- *
- * <p>该类主要是为了实现按业务模块隔离不同业务的类.防止jar冲突
- * </br>原有的<tt>URLClassLoader#findClass</tt>实现为
- * <pre>
- * protected Class<?> findClass(final String name)
- throws ClassNotFoundException
- {
- try {
- return (Class)
- AccessController.doPrivileged(new PrivilegedExceptionAction() {
- public Object run() throws ClassNotFoundException {
- String path = name.replace('.', '/').concat(".class");
- Resource res = ucp.getResource(path, false);
- if (res != null) {
- try {
- return defineClass(name, res);
- } catch (IOException e) {
- throw new ClassNotFoundException(name, e);
- }
- } else {
- throw new ClassNotFoundException(name);
- }
- }
- }, acc);
- } catch (java.security.PrivilegedActionException pae) {
- throw (ClassNotFoundException) pae.getException();
- }
- }
- * </pre>
- *<p>如果想更多的了解该类请访问<a href="http://bernoulli.iteye.com/">bernoulli的博客</a>
- * @author 阿信
- * @version 1.2,2013.10.15
- * @see #findClass(String)
- *
- */
- public class GlobalClassLoader extends ClassLoader {
- @Override
- protected Class<?> findClass(String name) throws ClassNotFoundException {
- return super.findClass(name);
- }
截图:
上面的标签都是常用的标签。开始强制自己使用,过两天就习惯了。非常方便实用,注释也非常优美看上去非常专业,心里真是美滋滋。
0 0
- 实用简约的JAVA注释标签-高手必备
- java高手之路上的必备基础知识
- 实用的网站设计简约原则
- 常用的Java注释标签
- JAVA迭代:foreach语法测试,简约实用
- 炒汇高手必备的素质
- 高手必备的六点!
- 最实用30个电脑技巧(高手必备)
- 常用Java注释标签
- java 注释标签说明
- 常用Java注释标签
- 简单的Java程序 简约不简单
- 成为java高手之路--java注释
- Swift 的标签注释
- 技术高手必备的几大素质
- 注释必备
- Java注释常用标签实例
- 想成为JAVA高手么,给你几个实用的方法 — IT技术 - 赛迪网
- find命令
- 【畅言】不把C作为第一门语言是个好主意么?-----转自 http://www.csdn.net/article/2014-07-01/2820467
- U872-结算成本处理步骤及索引处理
- 云计算里的安全:警惕云服务被恶意利用
- MongoDB数据库插入、更新和删除操作详解
- 实用简约的JAVA注释标签-高手必备
- CppCMS渲染content中内容到页面上
- 无需App Store,无线发布iOS应用(OTA)
- 内存泄露错误
- Mac 下 Chrome多个Tab之间切换
- 第一篇:知识库,Apache Jena,DL,Description Logic,Ontology。
- 监控 Linux 性能的 18 个命令行工具(转)
- 后缀数组+二分poj3261
- poj 1852 ants(模拟+想象力)