`
samjavaeye
  • 浏览: 193726 次
  • 性别: 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或者,...

    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 的作用是指定注解可以应用于哪些程序元素,从而提高注解...

    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开发手册(终极版)

    同时,每个公开的类、接口和方法都应有Javadoc,便于他人理解和使用。 3. **代码结构**:推荐使用标准的MVC架构,保持代码模块化。提倡面向接口编程,减少类之间的耦合。对于单例模式,推荐使用饿汉式或静态内部类...

    eclipse代码/注释规范

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

    2009年出版 java编程规范

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

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

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

    jdk-11.0.19-windows包下载

    - **Local-Variable Type Inference**(JSR 305):引入了`var`关键字,使得局部变量类型推断更加简洁。 - **Text Blocks**:新的字符串语法,使多行文本更易于阅读和编写。 - **Improved Javadoc**:增强了Javadoc...

    JAVA命名规范 编程

    7. **变量的命名**:变量(Variable)命名有多种风格,但Java中常用的是匈牙利标记法,如`intDocCount`,前缀表示数据类型,后缀为表意的英文名。对于全局变量,有时会在前面加上`g_`前缀,如`g_strUserInfo`。变量...

Global site tag (gtag.js) - Google Analytics