`
samjavaeye
  • 浏览: 187697 次
  • 性别: Icon_minigender_1
  • 来自: 深圳
社区版块
存档分类
最新评论

Javadoc Variable

 
阅读更多
【原因分析】
java类中的成员变量没有写Javadoc注释。例如下面这个java类中的name变量:
public class Person {
        private String name;
}
 
【影响分析】
不完整的注释将会给代码的维护带来更大的难度,使java代码的可读性下降。
 
【修改建议】
在日常开发的时候养成良好的编码习惯,注释尽可能写得详细和完整。例如:
public class Person {
        /**
         * 姓名
         */
        private String name;
}
分享到:
评论

相关推荐

    java-decoded:基于一些书籍的学习Java编程语言的个人笔记,例如Cay Horstmann的《 Big Java Early Objects》

    Javadoc评论 Provide documentation comments for every class, every method, every parameter variable, and every return value.您可以通过以下命令从Shell窗口调用javadoc实用程序: javadoc MyClass.java或者,...

    Eclipse 中文教程

    6.2.2撷取区域变量(Extracting a Local Variable) 181 6.2.3撷取方法(Extracting a Method) 183 6.3列入(Inlining) 188 6.3.1列入常数(Inlining a Constant) 188 6.3.2列入区域变量(Inlining a Local Variable) 190 ...

    eclipse 中文版教程

    622 撷取区域变量(Extracting a Local Variable) 239 623 撷取方法(Extracting a Method) 242 63 列入(Inlining) 247 631 列入常数(Inlining a Constant) 248 632 列入区域变量(Inlining a Local Variable) 250 ...

    Eclipse中文教程文档

    6.2.2擷取區域變數(Extracting a Local Variable) 238 6.2.3擷取方法(Extracting a Method) 241 6.3列入(Inlining) 246 6.3.1列入常數(Inlining a Constant) 247 6.3.2列入區域變數(Inlining a Local Variable) 249 ...

    Eclipse整合开发工具-基础篇

    6.2.2擷取區域變數(Extracting a Local Variable) 238 6.2.3擷取方法(Extracting a Method) 241 6.3列入(Inlining) 246 6.3.1列入常數(Inlining a Constant) 247 6.3.2列入區域變數(Inlining a Local Variable) 249 ...

    Eclipse – 整合开发工具

    234 6.2.2擷取區域變數(Extracting a Local Variable) 238 6.2.3擷取方法(Extracting a Method) 241 6.3列入(Inlining) 246 6.3.1列入常數(Inlining a Constant) 247 6.3.2列入區域變數...

    spring 最新框架jar

    Be sure that your `JAVA_HOME` environment variable points to the `jdk1.8.0` folder extracted from the JDK download. ### Check out sources `git clone git@github....

    Eclipse从入门到精通.rar

    6.2.2 撷取区域变量(Extracting a Local Variable)...................... 239 6.2.3 撷取方法(Extracting a Method).......... 242 6.3 列入(Inlining)....... 247 6.3.1 列入常数(Inlining a Constant)...........

    thymeleaf-extras-springsecurity-3.0-master.zip

    Distribution packages (binaries + sources + javadoc) can be downloaded from SourceForge. Features This module provides a new dialect called org.thymeleaf.extras.springsecurity3.dialect....

    java7帮助文档

    You can check the status variable of the applet while it is loading to determine if the applet is ready to handle requests from JavaScript code; see Handling Initialization Status With Event Handlers....

    JAVA入门1.2.3:一个老鸟的JAVA学习心得 PART1(共3个)

    8.4.3 Javadoc注释 206 8.5 小结:包让Java的类更清晰优雅 208 8.6 习题 209 第9章 再看数组、字符串和main()方法 210 教学视频:29分钟 9.1 数组也是类 210 9.1.1 得到数组的长度 210 9.1.2 加餐:不可改变...

    Java入门1·2·3:一个老鸟的Java学习心得.PART3(共3个)

    8.4.3 Javadoc注释 206 8.5 小结:包让Java的类更清晰优雅 208 8.6 习题 209 第9章 再看数组、字符串和main()方法 210 教学视频:29分钟 9.1 数组也是类 210 9.1.1 得到数组的长度 210 9.1.2 加餐:不可改变...

    day021-反射和注解笔记和代码.rar

    3. LOCAL_VARIABLE:可以在局部变量上使用注解 4. METHOD:可以在普通方法上使用注解 5. PACKAGE:可以在包上使用注解 6. PARAMETER:可以在参数列表上使用注解 7. TYPE:可以在...

    Eclipse中文教程

    Eclipse中文教程三册全集 0.环境说明 .................................................................... 8 1.Eclipse 简介....................................................................

    Eclipse中文教程.pdf

    Eclipse – 整合开发工具(基础篇) Jacky Lee 2005/03/01 教程特点: 1、图文并茂的详细介绍了eclipse的使用方法 2、虽然是pdf,但是非影音版,所有相当清晰 3、含文档结构目录,可以方便的跳转到对应章节 ...

Global site tag (gtag.js) - Google Analytics