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

Javadoc Variable

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

相关推荐

    activiti5.14-javadoc

    7. **流程变量**:流程变量在流程实例中存储数据,`ExecutionService` 和 `TaskService` 都提供操作变量的方法,如 `setVariable()` 和 `getVariable()`。 8. **表单与用户任务**:Activiti 提供了与表单集成的能力...

    CheckStyle结果分析

    **提示**: Variable “CA” missing Javadoc. **说明**: 变量“CA”缺少 Javadoc 注释。 **解决方法**: 为变量添加 Javadoc 注释。 **示例**: ```java /** * Represents a constant value. */ private static ...

    idea生成带注释的get/set方法插件

    对于注释,Idea默认会生成如下的JavaDoc格式注释: ```java /** * @return the <variableName> */ public <VariableType> get<VariableName>() { return <variableName>; } /** * @param <variableName> the ...

    JAVA注解(Annotation).doc

    - `@Target`可以指定注解应用于TYPE(类、接口、枚举)、FIELD(字段)、METHOD(方法)、PARAMETER(参数)、CONSTRUCTOR(构造函数)、LOCAL_VARIABLE(局部变量)、ANNOTATION_TYPE(注解类型)、PACKAGE(包)...

    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) 6.2.3撷取方法(Extracting a Method) 6.3列入(Inlining) 6.3.1列入常数(Inlining a Constant) 6.3.2列入区域变量(Inlining a Local Variable) 6.3.3列入方法...

    CheckStyle常见错误.docx

    11. Variable “CA” missing javadoc 错误解决方法:在“CA“变量前添加 javadoc 注释:/ CA. */(注意:一定记得加上 CA后面的“.”) 在 Java 中,每个变量都应该有 javadoc 说明,以便其他开发者了解该变量的...

    java 注释模版那些事儿

    在Java中,我们有三种主要的注释类型:单行注释(//)、多行注释(/*...*/)和Javadoc注释(/**...*/)。单行注释常用于临时性的代码调试,而多行注释则适用于较长的解释。Javadoc注释则专门用于生成API文档,它是以...

    Google Java编程风格指南

    - **变量名**:局部变量和实例变量使用驼峰式命名,首字母小写(如`variableName`)。 - **常量名**:全大写字母,单词间用下划线分隔(如`CONSTANT_NAME`)。 - **包名**:全小写字母,使用点分隔(如`...

    Java元注解是Java注解的重要特性,下面我就来详解常见的4大Java元注解

    * ElementType.LOCAL_VARIABLE:用于注解局部变量。 * ElementType.ANNOTATION_TYPE:用于注解其他注解类型。 * ElementType.PACKAGE:用于注解包。 @Target 的作用是指定注解可以应用于哪些程序元素,从而提高注解...

    Eclipse说明详见

    622撷取区域变量(Extracting a Local Variable)180 623撷取方法(Extracting a Method)182 63列入(Inlining)187 631列入常数(Inlining a Constant)187 632列入区域变量(Inlining a Local Variable)189 633列入方法...

    JAVA编码规范.doc

    2. **Javadoc**:每个公共类和公共方法都应有Javadoc,描述其功能、参数、返回值和可能抛出的异常。 **三、成员函数标准** **(一)命名成员函数** - 存取成员函数(getter和setter)应遵循`getVariableName`和`...

    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 ...

    最全面的 Android 编码规范指南.doc

    - 变量名和方法名使用小驼峰式命名,首字母小写,如`variableName`。 - 常量名全大写,单词间用下划线分隔,如`CONSTANT_NAME`。 5. 编程实践 - 注重代码可读性,避免过度复杂化。 - 使用适当的异常处理,避免...

    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 ...

    JAVA编程命名规范Java-开发命名规范

    这里的scope代表变量的作用域,type代表变量的类型,而VariableName则是变量的名称。在Java中,变量类型和首字母的对照关系需要遵守一定的规则。例如,整型变量通常使用i、j、k作为首字母,布尔型变量使用b,字符型...

    eclipse代码/注释规范

    - 变量和方法名使用小驼峰式命名,首字母小写,如`variableName`、`methodName`。 - 常量全大写,用下划线分隔单词,如`CONSTANT_NAME`。 6. **导入管理**: - 避免使用星号导入(`import *`),以减少命名冲突...

    2009年出版 java编程规范

    - **属性的命名**:形容词或名词开头,如memberVariable。 - **变量的命名**:与属性命名类似,但通常更短,如tempVar。 - **常量的命名**:全大写字母,单词间用下划线分隔,如CONSTANT_VALUE。 - **参数的命名*...

    IKExpression技术 运算表达式完美解析

    最后,"JavaDoc2.1.0"文件夹中包含的是IKExpression库的API文档,通过阅读这些文档,开发者可以深入了解每个类和方法的功能,便于深入使用和二次开发。 总之,IKExpression技术是一个强大的工具,它为Java开发者...

Global site tag (gtag.js) - Google Analytics