JAVA文件头注释格式

合集下载

javadoc的注释

javadoc的注释

javadoc的注释
Javadoc是一种用于Java源代码的注释格式,它可以被特定的工具提取并转换成一份可供开发者参考的文档。

Javadoc注释以`/`开头,以`/`结尾,通常位于类、方法或字段的前面。

它们允许开发者描述代码的功能、参数、返回值以及可能的异常情况。

Javadoc 注释通常包括以下几个部分:
1. 描述部分,对于类、方法或字段的描述,通常包括其作用、使用方法等信息。

2. 参数部分,如果是方法的注释,通常会包括对方法参数的描述,包括参数名、参数类型以及参数的作用。

3. 返回部分,对于方法的注释,会描述该方法的返回值类型以及可能的返回值情况。

4. 异常部分,对于方法的注释,会描述该方法可能会抛出的异常类型及异常情况。

Javadoc注释的好处在于它们可以被Javadoc工具解析并生成
代码文档,这样其他开发者就可以通过阅读文档了解代码的功能和
使用方法。

此外,Javadoc注释也可以提高代码的可读性,让其他
开发者更容易理解代码的含义和设计初衷。

除了以上提到的基本部分,Javadoc注释还可以包括一些其他
的标签,比如`@author`用于指定作者、`@version`用于指定版本号、`@see`用于指定相关的链接等。

这些标签可以进一步丰富Javadoc
注释的内容,使得生成的文档更加完整和详尽。

总之,Javadoc注释是Java语言中一种非常有用的注释格式,
它可以帮助开发者更好地理解和使用代码,同时也为代码文档的生
成提供了便利。

因此,在编写Java代码时,合理、规范地使用Javadoc注释是非常重要的。

java三种注释

java三种注释

java三种注释
java三种注释
1.java规定了三种注释⽅式:单⾏注释、多⾏注释、⽂档注释
2.单⾏注释和多⾏注释的作⽤:
对所写的程序进⾏解释和说明,增强可读性
调试所写的代码:例如对部分代码注释,进⾏运⾏来找到代码错误的地⽅
特点:单⾏注释和多⾏注释,注释的内容不参与编译
单⾏注释
格式:
class helloJava{
//单⾏注释:如下的main⽅法是程序的⼊⼝!
public static void main(String args[]){
//单⾏注释:如下的语句表⽰输出到控制台
System.out.println("Hello World!");
}
}
多⾏注释
格式:
/*
这⾥是多⾏注释
*/
⽂档注释(java特有)
格式:
/**
@author 指定java程序的作者
@version 指定源⽂件的版本
*/
注释内容可以被JDK提供的⼯具Javadoc所解析,⽣成⼀套以⽹页⽂件形式体现的该程序的说明⽂档命令: javadoc -d Myjavadoc -author -version 1.2注释.java
解释:命令⾏格式为Javadoc -d ⽂件夹名字 -author -version ⽂件名.Java
⽂件夹是⾃⼰随便起的,会被放在与Java⽂件相同的⽂件⽬录下。

注意:多⾏注释不能够嵌套使⽤。

java文档注释规范(一)

java文档注释规范(一)

java⽂档注释规范(⼀)https:///huangsiqian/article/details/82725214Javadoc⼯具将从四种不同类型的“源”⽂件⽣成输出⽂档:Java语⾔类的源⽂件(.java),包注释⽂件,概述注释⽂件和其他未处理的⽂件。

包注释⽂件(Package Comment File)每个包都有⾃⼰的⽂档注释。

有两种⽅式来创建包注释⽂件:package-info.java - 可以包含包的声明,包注解(anotation),包注释和Javadoc 标签(tag)。

包注释放在包声明之前。

这是JDK 5.0新引⼊的特性。

如下。

File: java/applet/package-info.java 注意:⽂档注释块内部⾏⾸的*号是可选的/*** Provides the classes necessary to create an applet and the classes an applet uses* to communicate with its applet context.* <p>* The applet framework involves two entities:* the applet and the applet context. An applet is an embeddable window (see the* {@link java.awt.Panel} class) with a few extra methods that the applet context* can use to initialize, start, and stop the applet.** @since 1.0* @see java.awt*/package ng.applet;package.html - 只能包含包注释和Javadoc标签,不能包含包注解。

java有效的注释说明

java有效的注释说明

java有效的注释说明Java是一种广泛使用的编程语言。

为了保证代码的清晰易懂以及方便后期维护,我们要给Java程序添加注释。

本文将从以下几个方面介绍Java有效的注释说明。

一、注释的种类Java程序中最常见的注释有三种:单行注释、多行注释、文档注释。

单行注释以"//"开头,多行注释以"/*"开头和"*/"结尾,文档注释以"/**"开头和"*/"结尾。

其中,文档注释最为重要,也最为常用。

二、文档注释的使用文档注释是Java程序中的重要注释,也是Java代码中最常用的注释之一。

文档注释可以让我们用简洁清晰的语言来描述代码的作用、参数、返回值等信息。

其具体写法如下:/*** <p>方法的作用</p>* @param 参数名参数说明* @return 返回值说明*/其中,p标签可以用来描述方法的作用,param标签用来描述参数的名称和说明,return标签用于描述方法的返回值。

三、注释的规范在Java中,注释也是需要遵循一定的规范的。

首先,注释应该写在被注释项的前面或者后面,不需要对齐代码。

其次,注释应该简洁明了,避免出现过于冗长的注释。

最后,避免在注释中出现包含比代码本身还复杂的格式和语法。

四、注释的使用场景注释的使用场景包括以下几个方面:首先,注释可以用来描述程序中的重要变量、方法、类的作用和功能。

其次,注释可以在调试程序时帮助快速定位问题所在。

最后,注释还可以在代码交接、阅读和修改时提供较为清晰的方向和思路。

综上所述,Java有效的注释是保证代码清晰易懂、方便维护的重要方面之一。

Java程序员应该养成良好的注释习惯,在代码编写上也应该注重注释的规范性、简洁性和对实际需求的协调性。

IDEA中如何设置文件头注释和方法注释(详解)

IDEA中如何设置文件头注释和方法注释(详解)

IDEA中如何设置文件头注释和方法注释(详解)在IntelliJ IDEA中,可以通过一些设置来自定义文件头注释和方法注释,使代码更加规范和易读。

下面我将详细介绍如何设置文件头注释和方法注释。

首先,我们需要打开IDEA的设置窗口。

可以通过点击菜单栏的“File”->“Settings”或直接按下快捷键“Ctrl + Alt + S”打开设置窗口。

一、文件头注释的设置:1. 打开设置窗口后,选择“Editor”->“File and Code Templates”选项。

3. 在右侧的文件列表中选择“File Header”文件。

这是文件头注释所使用的模板。

4. 在“Template text”输入框中,可以设置文件头注释的内容。

在输入框中,可以使用一些预定义变量来动态地生成注释,例如:-${DATE}:当前日期-${TIME}:当前时间-${USER}:当前使用IDEA的用户名-${YEAR}:当前年份-${ORGANIZATION}:项目组织名称-${PACKAGE_NAME}:当前文件的包名等例如,一个常见的Java文件头注释模板可以设置为:```/***/```5.当设置完注释模板后,点击“OK”按钮保存设置。

二、方法注释的设置:1. 在设置窗口中,选择“Editor”->“File and Code Templates”选项。

3. 在右侧的文件列表中选择“Java Method”文件。

这是方法注释所使用的模板。

4. 在“Template text”输入框中,可以设置方法注释的内容。

同样可以使用一些预定义变量来动态生成注释。

例如,一个常见的Java方法注释模板可以设置为:```/***/```5.当设置完注释模板后,点击“OK”按钮保存设置。

以上就是设置文件头注释和方法注释的详细步骤。

在实际的开发中,根据团队的规范和项目的需要,可以根据上述步骤进行定制化的设置。

这样的设置能够提高代码的可读性和可维护性,也便于团队成员之间的协作。

Java语言编程规范(华为公司)

Java语言编程规范(华为公司)

Java语言编程规范(华为公司)DKBA华为技术有限公司企业技术规范DKBAXXXX-2001.12代替(DKBA200106-003)Java语言编程规范2001-12-XX发布2001-12-XX实施华为技术有限公司发布VVVVVVV VVVVVVVVVVVX。

XVX.X VX.X VX.X VX.XVX.X 目次前言 .............................................................................. .. (3)1 范围112 规范性引用文件113 术语和定义114 排版规范124.1 规则121.*程序块要采用缩进风格编写,缩进12的空格数为4个。

122.*分界符(如大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。

在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。

133.*较长的语句、表达式或参数(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。

134.*不允许把多个短语句写在一行中,即一行只写一条语句5.*if, for, do, while, case,13switch, default 等语句自占一行,且if, for, do, while等语句的执行语句无论多少都要加括号{}。

6.*相对独立的程序块之间、变量说明13之后必须加空行。

7.*对齐只使用空格键,不使用TAB键。

14VVVVVVV VVVVVVVVVVVX。

XVX.X VX.X VX.X VX.XVX.X 8.*在两个以上的关键字、变量、常量14进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如.),后不应加空格。

java编码规范

java编码规范

1范围2规范性引用文件3定义和缩略语4文件组织4.1 文件结构规则4-1-1:包名只允许使用小写字母,包命名格式如下:“倒置的公司域.产品名.模块名”,模块名可以根据产品结构划分为多级模块。

如:package com.h3c.xlog.nta.dao;规则4-1-2:Java源代码文件使用‘src’作为一级目录,按照包名成树状目录结构存放。

如:…\src\com\h3c\xlog\nta\dao\Sample.java规则4-1-3:Java源代码文件名与类名相同4.2 文件格式标准Java源代码文件头格式如下/*** Copyright (c) 2007,Hangzhou H3C Technologies Co.,Ltd.All rights reserved.* </* ...........................................................................* Product :iMC V300R002* Module Name;* Date Created:YYYY-MM-DD* Creator:* Description;** ...........................................................................* Modification History* DATE NAME DESCRIPTION* ..........................................................................* YYYY-MM-DD John XXXX project,new code file.** .........................................................................*/规则4-2-1:任何一个代码源文件必须包含有标准的文件头,且其中的文件名、产品、日期、作者等内容填写完整。

idea创建JAVAClass时自动生成头部文档注释的方法

idea创建JAVAClass时自动生成头部文档注释的方法

idea创建JAVAClass时⾃动⽣成头部⽂档注释的⽅法IDEA设置⽂档注释模板
创建Class⽂件时⾃动⽣成的头部注释如图
如何配置idea的头部注释格式,可以⽣成像之前的注释格式⼀样的⽂档注释?
File->settings->Editor->File and Code Templates->Files->Class
原先模板
#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
#parse("File Header.java")
public class ${NAME} {
}
修改后模板
#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
/**
\* Created with IntelliJ IDEA.
\* @author: xiyue
\* Date: ${DATE}
\* Time: ${TIME}
\* To change this template use File | Settings | File Templates.
\* Description:
\*/
public class ${NAME} {
}
到此这篇关于idea创建JAVA Class时⾃动⽣成头部⽂档注释的⽅法的⽂章就介绍到这了,更多相关idea⽣成头部⽂档注释内容请搜索以前的⽂章或继续浏览下⾯的相关⽂章希望⼤家以后多多⽀持!。

java代码注释规范

java代码注释规范

java代码注释规范展开全文一、规范存在的意义应用编码规范对于软件本身和软件开发人员而言尤为重要,有以下几个原因:1、好的编码规范可以尽可能的减少一个软件的维护成本, 并且几乎没有任何一个软件,在其整个生命周期中,均由最初的开发人员来维护;2、好的编码规范可以改善软件的可读性,可以让开发人员尽快而彻底地理解新的代码;3、好的编码规范可以最大限度的提高团队开发的合作效率;4、长期的规范性编码还可以让开发人员养成好的编码习惯,甚至锻炼出更加严谨的思维;二、命名规范1、一般概念1、尽量使用完整的英文描述符2、采用适用于相关领域的术语3、采用大小写混合使名字可读4、尽量少用缩写,但如果用了,必须符合整个工程中的统一定义5、避免使用长的名字(小于 15 个字母为正常选择)6、避免使用类似的名字,或者仅仅是大小写不同的名字7、避免使用下划线(除静态常量等)2、标识符类型说明1、包( Package )的命名Package 的名字应该采用完整的英文描述符,都是由一个小写单词组成。

并且包名的前缀总是一个顶级域名,通常是 com、edu、gov、mil、net、org 等;如: com.yjhmily.test2、类( Class )的命名类名应该是个一名词,采用大小写混合的方式,每个单词的首字母大写。

尽量保证类名简洁而富于描述。

使用完整单词,避免缩写词( 除非工程内有统一缩写规范或该缩写词被更广泛使用,像 URL , HTML)如: FileDescription3、接口( Interface )的命名基本与 Class 的命名规范类似。

在满足 Classd 命名规则的基础之上,保证开头第一个字母为”I”,便于与普通的 Class区别开。

其实现类名称取接口名的第二个字母到最后,且满足类名的命名规范;如: IMenuEngine4、枚举( Enum )的命名基本与 Class 的命名规范类似。

在满足 Classd 命名规则的基础之上,保证开头第一个字母为”E” ,便于与普通的 Class区别开。

JAVA代码注释规范

JAVA代码注释规范

JAVA代码注释规范目录JA V A代码注释规范 (1)注释的原则 (1)注释的简洁 (1)注释的一致性 (1)注释的位置 (2)注释的数量 (2)删除无用注释 (2)复杂的注释 (2)多余的注释 (2)必加的注释 (3)JA V A注释技巧 (3)JA V A注释具体实现 (4)源文件注释 (4)类(模块)注释: (5)接口注释: (5)构造函数注释: (6)方法注释: (6)方法内部注释: (7)全局变量注释: (7)局部(中间)变量注释: (7)常量 (7)p.s. 注释使用统一的注释文件 (8)注释的原则注释形式统一在整个应用程序中,使用具有一致的标点和结构的样式来构造注释。

如果在其他项目组发现他们的注释规范与这份文档不同,按照他们的规范写代码,不要试图在既成的规范系统中引入新的规范。

注释的简洁内容要简单、明了、含义准确,防止注释的多义性,错误的注释不但无益反而有害。

注释的一致性在写代码之前或者边写代码边写注释,因为以后很可能没有时间来这样做。

另外,如果有机会复查已编写的代码,在今天看来很明显的东西六周以后或许就不明显了。

通常描述性注释先于代码创建,解释性注释在开发过程中创建,提示性注释在代码完成之后创建。

修改代码的同时修改相应的注释,以保证代码与注释的同步。

注释的位置保证注释与其描述的代码相邻,即注释的就近原则。

对代码的注释应放在其上方相邻或右方的位置,不可放在下方。

避免在代码行的末尾添加注释;行尾注释使代码更难阅读。

不过在批注变量声明时,行尾注释是合适的;在这种情况下,将所有行尾注释要对齐。

注释的数量注释必不可少,但也不应过多,在实际的代码规范中,要求注释占程序代码的比例达到20%左右。

注释是对代码的“提示”,而不是文档,程序中的注释不可喧宾夺主,注释太多了会让人眼花缭乱,注释的花样要少。

不要被动的为写注释而写注释。

删除无用注释在代码交付或部署发布之前,必须删掉临时的或无关的注释,以避免在日后的维护工作中产生混乱。

idea类的注释模板

idea类的注释模板

idea类的注释模板在IntelliJ IDEA中,你可以使用文件头注释模板和类注释模板,以便在创建新类或文件时自动生成注释。

以下是在IDEA中设置这些注释模板的步骤:文件头注释模板:1. 打开IntelliJ IDEA。

2. 转到"File" > "Settings"(Windows/Linux)或"IntelliJ IDEA" > "Preferences"(macOS)。

3. 在设置窗口中,选择"Editor" > "File and Code Templates"。

4. 在"Files" 选项卡下,选择"Includes" 列表中的"File Header"。

5. 在右侧的编辑区域中,你可以定义文件头注释的模板。

例如:```java/*** Description: ${DESCRIPTION}** @author ${USER}* @date ${DATE}* @time ${TIME}*/```在模板中,`${DESCRIPTION}`、`${USER}`、`${DATE}`、`${TIME}` 等是占位符,IntelliJ IDEA 会根据实际情况替换这些占位符。

类注释模板:1. 在"Files" 选项卡下,选择"Includes" 列表中的"File Header.java"。

2. 在右侧的编辑区域中,你可以定义Java类的注释模板。

例如:```java#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end#if (${IMPORT_BLOCK} && ${IMPORT_BLOCK} != "")${IMPORT_BLOCK}#end#if (${VISIBILITY} == "DEFAULT")class ${NAME} #else${VISIBILITY} ${NAME} #end#if (${SUPERCLASS} && ${SUPERCLASS} != "") extends ${SUPERCLASS} #end#if (${INTERFACES} && ${INTERFACES} != "") implements ${INTERFACES} #end{${BODY}}```同样,`${PACKAGE_NAME}`、`${IMPORT_BLOCK}`、`${VISIBILITY}`、`${NAME}` 等是占位符。

java 注释标准

java 注释标准

java 注释标准在Java开发中,注释被广泛应用于代码的编写与维护过程中。

通过注释,开发人员可以为自己的代码添加解释说明,方便其他开发人员理解和使用代码。

本文将介绍Java中常用的注释标准,以及它们的使用方法与注意事项。

一、单行注释单行注释以"//"开头,用于对单行代码进行解释说明。

它可以出现在代码的任何位置,对该行代码进行注释,不会影响代码的执行。

例如:```javaint x = 10; // 定义一个整型变量x,初始值为10二、多行注释多行注释以"/*"开头,以"*/"结尾,用于对多行代码进行注释。

多行注释常用于对函数、类或一段代码的功能进行描述。

例如:```java/** 计算两个整数的和* @param a 整数1* @param b 整数2* @return 两个整数的和*/public int add(int a, int b) {return a + b;}三、文档注释文档注释以"/**"开头,以"*/"结尾,用于对类、接口、方法、字段等进行详细的描述。

文档注释是Java API文档的一部分,在生成API 文档时会被提取出来。

例如:```java/*** 学生类*/public class Student {/*** 学生姓名*/private String name;/*** 获取学生姓名* @return 学生姓名*/public String getName() {return name;}/*** 设置学生姓名* @param name 学生姓名*/public void setName(String name) { = name;}}四、注释的使用方法与注意事项1. 注释应该简洁明了,使用清晰的语言描述代码的功能、用途、参数、返回值等信息,以便其他开发人员理解和使用。

2. 注释应该与代码保持同步更新,避免注释与代码不一致的情况发生。

java 版权注释说明

java 版权注释说明

java 版权注释说明Java版权注释说明在编写Java程序时,经常需要在代码中添加版权注释说明。

版权注释是对代码版权归属、作者信息、许可证等信息的声明,可以保护程序的知识产权,防止他人滥用或盗用代码。

本文将详细介绍Java 版权注释的规范和使用方法。

一、版权注释的作用版权注释是程序员为了保护自己的代码权益而添加的一段文字,它包含了代码的版权归属、作者信息、许可证等内容。

版权注释的作用主要有以下几点:1. 明确版权归属:版权注释可以明确代码的版权归属,避免他人滥用或盗用代码。

2. 保护知识产权:通过版权注释,程序员可以声明自己对代码的知识产权,避免他人未经授权使用代码。

3. 提供作者信息:版权注释中包含了作者的信息,可以让其他人了解到代码的作者是谁。

4. 规范开源许可证:通过版权注释,可以明确代码采用的开源许可证,让其他人了解到代码的使用规范。

二、版权注释的格式在Java中,版权注释通常放置在源代码文件的开头,以多行注释的形式进行添加。

通常,版权注释的格式如下所示:/*** 版权声明** 版权归属:xxx公司/个人* 作者:xxx* 创建日期:xxxx年xx月xx日* 版本号:x.x** 许可证:xxx许可证** 本程序是根据xxx许可证发布的,你可以在遵守许可证的前提下自由使用、复制、修改、发布本程序。

* 具体的许可证条款请查阅许可证文档。

*/在上述格式中,版权声明部分包含了版权归属、作者、创建日期和版本号等信息;许可证部分介绍了程序的开源许可证。

三、版权注释的准则在使用Java版权注释时,需要遵循以下几个准则:1. 明确版权归属:版权注释中应明确程序的版权归属,包括公司或个人的名称。

2. 作者信息:版权注释中应包含作者的姓名或用户名,方便其他人了解代码的作者。

3. 创建日期:版权注释中应包含程序的创建日期,方便其他人了解代码的起始时间。

4. 版本号:版权注释中应包含程序的版本号,方便自己和他人跟踪代码的版本信息。

javadoc注释规范

javadoc注释规范

javadoc注释规范javadoc做注释一. Java 文档// 注释一行/* ...... */ 注释若干行/** ...... */ 注释若干行,并写入 javadoc 文档通常这种注释的多行写法如下:/*** .........* .........*/javadoc -d 文档存放目录 -author -version 源文件名.java这条命令编译一个名为“源文件名.java”的 java 源文件,并将生成的文档存放在“文档存放目录”指定的目录下,生成的文档中 index.html 就是文档的首页。

-author 和 -version 两个选项可以省略。

二. 文档注释的格式1. 文档和文档注释的格式化生成的文档是 HTML 格式,而这些 HTML 格式的标识符并不是 javadoc 加的,而是我们在写注释的时候写上去的。

比如,需要换行时,不是敲入一个回车符,而是写入 <br>,如果要分段,就应该在段前写入 <p>。

文档注释的正文并不是直接复制到输出文件 (文档的 HTML 文件),而是读取每一行后,删掉前导的 * 号及 * 号以前的空格,再输入到文档的。

如/*** This is first line. <br>***** This is second line. <br>This is third line.*/2. 文档注释的三部分先举例如下/*** show 方法的简述.* <p>show 方法的详细说明第一行<br>* show 方法的详细说明第二行* @param b true 表示显示,false 表示隐藏* @return 没有返回值*/public void show(boolean b) {frame.show(b);}第一部分是简述。

文档中,对于属性和方法都是先有一个列表,然后才在后面一个一个的详细的说明简述部分写在一段文档注释的最前面,第一个点号 (.) 之前 (包括点号)。

java注解类型命名规则

java注解类型命名规则

在Java 中,注解的命名规则与其他标识符的命名规则类似。

以下是一些通用的命名规则和建议:
1. 首字母小写驼峰式命名:注解的名称应该以小写字母开头,并且采用驼峰式命名法。

例如:`myAnnotation`。

2. 使用清晰、有意义的名字:注解的名称应该能够准确地描述它所表示的含义或功能。

3. 避免使用保留字或关键字:不要将注解的名称选为Java 的保留字或关键字,以避免编译错误。

4. 使用名词或名词短语:注解的名称应该使用名词或者能够表示名词短语的形式,以便更好地描述被注解的元素。

5. 使用后缀`Annotation`:为了明确表示一个标注是一个注解类型,可以在注解名称后添加`Annotation` 后缀,以示区分。

例如:`MyAnnotationAnnotation`。

Java注释模板

Java注释模板

Java注释模板/**** 项⽬名称:${project_name}* 类名称:${type_name}* 类描述:* 创建⼈:${user}* 创建时间:${date} ${time}* 修改⼈:${user}* 修改时间:${date} ${time}* 修改备注:* @version**/----------------------------------------------------------------------------------------------------------设置注释模板的⼊⼝: Window->Preference->Java->Code Style->Code Template 然后展开Comments节点就是所有需设置注释的元素啦。

现就每⼀个元素逐⼀介绍:⽂件(Files)注释标签:/*** @Title: ${file_name}* @Package ${package_name}* @Description: ${todo}(⽤⼀句话描述该⽂件做什么)* @author A18ccms A18ccms_gmail_com* @date ${date} ${time}* @version V1.0*/类型(Types)注释标签(类的注释):/*** @ClassName: ${type_name}* @Description: ${todo}(这⾥⽤⼀句话描述这个类的作⽤)* @author A18ccms a18ccms_gmail_com* @date ${date} ${time}** ${tags}*/字段(Fields)注释标签:/*** @Fields ${field} : ${todo}(⽤⼀句话描述这个变量表⽰什么)构造函数标签:/*** <p>Title: </p>* <p>Description: </p>* ${tags}*/⽅法(Constructor & Methods)标签:/*** @Title: ${enclosing_method}* @Description: ${todo}(这⾥⽤⼀句话描述这个⽅法的作⽤) * @param ${tags} 设定⽂件* @return ${return_type} 返回类型* @throws*/覆盖⽅法(Overriding Methods)标签:/* (⾮ Javadoc)* <p>Title: ${enclosing_method}</p>* <p>Description: </p>* ${tags}* ${see_to_overridden}*/代表⽅法(Delegate Methods)标签:/*** ${tags}* ${see_to_target}*/getter⽅法标签:/*** @return ${bare_field_name}*//*** @param ${param} 要设置的 ${bare_field_name}*/简单模板例⼦:view plaincopy to clipboardprint?<?xml version="1.0" encoding="UTF-8"?><templates><template autoinsert="true" context="fieldcomment_context" deleted="false" description="字段的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.fieldcomment" name="fieldcomment">/*** @Fields ${field} : ${todo}(⽤⼀句话描述这个变量表⽰什么)*/</template><template autoinsert="true" context="gettercomment_context" deleted="false" description="getter ⽅法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.gettercomment" name="gettercomment">/*** @return ${bare_field_name}*/</template><template autoinsert="true" context="constructorcomment_context" deleted="false" description="创建的构造函数的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.constructorcomment" name="constructorcomment">/*** <p>Title:${file_name} </p>* <p>Description: 构造函数</p>* ${tags}*/</template><template autoinsert="true" context="filecomment_context" deleted="false" description="已创建的 Java ⽂件的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.filecomment" name="filecomment">/*** @Title: ${file_name}* @Package ${package_name}* @Description: ${todo}(⽤⼀句话描述该⽂件做什么)* @author DAIGUANGJIU* @date ${date} ${time}* @version V1.0*/</template><template autoinsert="true" context="settercomment_context" deleted="false" description="setter ⽅法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.settercomment" name="settercomment">/*** @param ${param} 要设置的 ${bare_field_name}*/</template><template autoinsert="true" context="typecomment_context" deleted="false" description="创建的类型的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.typecomment" name="typecomment">/*** @author ${user}** ${tags}* ${tags}* ${see_to_target}*/</template><template autoinsert="true" context="overridecomment_context" deleted="false" description="覆盖⽅法的注释"enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.overridecomment" name="overridecomment">/** (⾮ Javadoc)* <p>Title: ${enclosing_method}</p>* <p>Description: </p>* ${tags}* ${see_to_overridden}*/</template><template autoinsert="true" context="methodcomment_context" deleted="false" description="⾮覆盖⽅法的注释"enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.methodcomment" name="methodcomment">/*** ${tags}*/</template></templa<?xml version="1.0" encoding="UTF-8"?><templates><template autoinsert="true" context="fieldcomment_context" deleted="false" description="字段的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.fieldcomment" name="fieldcomment">/*** @Fields ${field} : ${todo}(⽤⼀句话描述这个变量表⽰什么)*/</template><template autoinsert="true" context="gettercomment_context" deleted="false" description="getter ⽅法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.gettercomment" name="gettercomment">/*** @return ${bare_field_name}*/</template><template autoinsert="true" context="constructorcomment_context" deleted="false" description="创建的构造函数的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.constructorcomment" name="constructorcomment">/*** <p>Title:${file_name} </p>* <p>Description: 构造函数</p>* ${tags}*/</template><template autoinsert="true" context="filecomment_context" deleted="false" description="已创建的 Java ⽂件的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.filecomment" name="filecomment">/*** @Title: ${file_name}* @Package ${package_name}* @Description: ${todo}(⽤⼀句话描述该⽂件做什么)* @author DAIGUANGJIU* @date ${date} ${time}* @version V1.0*/</template><template autoinsert="true" context="settercomment_context" deleted="false" description="setter ⽅法的注释" enabled="true"* @param ${param} 要设置的 ${bare_field_name}*/</template><template autoinsert="true" context="typecomment_context" deleted="false" description="创建的类型的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.typecomment" name="typecomment">/*** @author ${user}** ${tags}*/</template><template autoinsert="true" context="delegatecomment_context" deleted="false" description="代表⽅法的注释"enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.delegatecomment" name="delegatecomment">/*** ${tags}* ${see_to_target}*/</template><template autoinsert="true" context="overridecomment_context" deleted="false" description="覆盖⽅法的注释"enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.overridecomment" name="overridecomment">/** (⾮ Javadoc)* <p>Title: ${enclosing_method}</p>* <p>Description: </p>* ${tags}* ${see_to_overridden}*/</template><template autoinsert="true" context="methodcomment_context" deleted="false" description="⾮覆盖⽅法的注释"enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.methodcomment" name="methodcomment">/*** ${tags}*/</template></templa例⼦2:view plaincopy to clipboardprint?<?xml version="1.0" encoding="UTF-8"?><templates><templateautoinsert="false"context="constructorcomment_context"deleted="false"description="Comment for created constructors"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.constructorcomment"name="constructorcomment">/*** 创建⼀个新的实例 ${enclosing_type}.*/</template><templateautoinsert="true"context="settercomment_context"deleted="false"description="Comment for setter method"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.settercomment" name="settercomment">/*** @param ${param} the ${bare_field_name} to set*/</template><templateautoinsert="false"context="methodcomment_context"deleted="false"description="Comment for non-overriding methods"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.methodcomment" name="methodcomment">/*** 此⽅法描述的是:* @author: wangxiongdx@* @version: ${date} ${time}*/</template>autoinsert="true"context="delegatecomment_context"deleted="false"description="Comment for delegate methods"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.delegatecomment" name="delegatecomment">/*** ${tags}* ${see_to_target}*/</template><templateautoinsert="false"context="filecomment_context"deleted="false"description="Comment for created Java files"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.filecomment"name="filecomment">/*** ⽂件名:${file_name}** 版本信息:* ⽇期:${date}* Copyright ⾜下 Corporation ${year}* 版权所有**/</template><templateautoinsert="false"context="gettercomment_context"deleted="false"description="Comment for getter method"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.gettercomment" name="gettercomment">/*** ${bare_field_name}** @return the ${bare_field_name}* @since CodingExample Ver(编码范例查看) 1.0*/</template><templateautoinsert="true"context="overridecomment_context"deleted="false"description="Comment for overriding methods"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.overridecomment" name="overridecomment">/* (non-Javadoc)* ${see_to_overridden}*/</template><templateautoinsert="false"deleted="false"description="Comment for fields"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.fieldcomment" name="fieldcomment">/*** ${field}:${todo}(⽤⼀句话描述这个变量表⽰什么)** @since Ver 1.1*/</template><templateautoinsert="false"context="typecomment_context"deleted="false"description="Comment for created types"enabled="true"id="org.eclipse.jdt.ui.text.codetemplates.typecomment" name="typecomment">/*** 此类描述的是:* @author: wangxiongdx@* @version: ${date} ${time}*/</template></templates>。

Javadoc标签和Javadoc注释规范说明

Javadoc标签和Javadoc注释规范说明

Javadoc标签和Javadoc注释规范说明最近看源码,⼀些Javadoc常见的注释整理下Javadoc是Sun公司提供的⼀个技术,从程序源代码中抽取类、⽅法、成员等注释形成⼀个和源代码配套的API帮助⽂档。

Javadoc命令是⽤来⽣成⾃⼰的API⽂档,使⽤⽅式:javadoc 源⽂件名.javajavadoc -d ⽂档存放⽬录源⽂件名.java通过IDEA⽣成Javadoc : Tools -> Generate JavaDocjavadoc标签标签说明@author作者标识@version版本号@return对函数返回值的描述@deprecated标识过期API(为了保证兼容性,仍可⽤,但不推荐⽤)@throws构造函数或⽅法会抛出的异常@exception同@throws@see引⽤,查看相关的内容,如类,⽅法,变量等,必须顶头写{@link 包.类#成员}引⽤,同@see,但可写在任意位置{@value}对常量注释,如果其值包含在⽂档中,通过改标签引⽤常量的值{@code}}{@code text}将⽂本标记为code,会被解析成 text } ,在Javadoc成只要涉及到类名或者⽅法名,都需要使⽤@code进⾏标记@param说明⽅法的参数@inheritDoc⽤于继承⽗类中的Javadoc,⽗类的⽂档注释,被继承到了⼦类javadoc注释规范⼀、 Java⽂档// 注释⼀⾏/ * */ 注释若⼲⾏/** ……*/ 注释若⼲⾏,写⼊Javadoc⽂档⼆、⽂档格式写在类上的⽂档标注⼀般分为三段:第⼀段:概要描述,通常⽤⼀句话或者⼀段话简要描述该类的作⽤,以英⽂句号结束第⼆段:详细描述,通常⽤⼀段或者多段话来详细描述该类的作⽤,⼀般每段话都以英⽂句号作为结束第三段:⽂档标注,⽤于标注作者,创建时间,参阅类等信息⽣成⽂档是HTML格式。

换⾏<br>分段<p>(写在段前))⽰例/*** show ⽅法的简述.* <p>show ⽅法的详细说明第⼀⾏<br>* show ⽅法的详细说明第⼆⾏* @param b true 表⽰显⽰,false 表⽰隐藏* @return 没有返回值*/public void show(boolean b) {frame.show(b);}补充:Java的三种注释 Javadoc标记*三种注释⽅法:1、单⾏注释 //注释的内容2、多⾏注释 /*......*/3、/**......*/,这种⽅式和第⼆种⽅式相似。

java编码规范_缩进和注释

java编码规范_缩进和注释

java编码规范_缩进和注释1. 缩进排版(Indentation)4个空格常被作为缩进排版的⼀个单位。

缩进的确切解释并未详细指定(空格 vs. 制表符)。

⼀个制表符等于n个空格(视具体的编辑器⽽定,Eclipse默认⼀个制表符为4个字符)。

3.1 ⾏长度(Line Length)尽量避免⼀⾏的长度超过80个字符,因为很多终端和⼯具不能很好处理之。

注意:鉴于Eclipse开发⼯具⼯作区的左侧和右侧都被⾮代码编辑器所占据,因此建议每⾏的代码长度不要超过70个字符。

3.2 换⾏(Wrapping Lines)当⼀个表达式⽆法容纳在⼀⾏内时,可以依据如下⼀般规则断开之:·在⼀个逗号后⾯断开;·在⼀个操作符前⾯断开;·宁可选择较⾼级别(higher-level)的断开,⽽⾮较低级别(lower-level)的断开;·新的⼀⾏应该与上⼀⾏同⼀级别表达式的开头处对齐。

·如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边,那就代之以缩进8个空格,或者以调⽤参数的⾸个括号对齐,或者以⾸个运对齐。

以下是断开⽅法调⽤的⼀些例⼦:someMethod(longExpression1, longExpression2, longExpression3,longExpression4,longExpression5);var = someMethod1(longExpression1,someMethod2(longExpression2, longExpression3));以下是两个断开算术表达式的例⼦。

前者更好,因为断开处位于括号表达式的外边,这是个较⾼级别的断开。

longName1 = longName2 * ( longName3 + longName4 - longName5 ) +4 * longname6; //推荐使⽤longName1 = longName2 * ( longName3 + longName4- longName5 ) + 4 * longname6; //应避免这样使⽤以下是两个缩进⽅法声明的例⼦。

java语言三种注释的语法格式以及用途

java语言三种注释的语法格式以及用途

java语言三种注释的语法格式以及用途
Java语言中有三种注释方式,它们分别是:
1. 单行注释:
语法格式:使用两个斜杠(//)开始注释,后面跟随注释内容。

示例:
```java
// 这是一个单行注释
int x = 10; // 将 x 的值设为 10
```
用途:用于在一行中对代码进行简要说明,帮助开发者理解代码的功能和意图。

2. 多行注释:
语法格式:使用 / 开始注释,使用 / 结束注释。

示例:
```java
/
这是一个多行注释,可以跨越多行。

在这里说明代码的功能和作用。

/
int y = 20; / 将 y 的值设为 20 /
```
用途:用于对代码块进行详细说明,可以跨越多行。

通常用于解释复杂的代码逻辑或提供额外的信息。

3. Javadoc 注释:
语法格式:使用 / 开始注释,使用 / 结束注释。

这种注释方式也被称为Javadoc 注释。

示例:
```java
/
这是一个 Javadoc 注释,用于描述类的功能和属性。

在这里编写对类的描述信息。

/
public class MyClass { / ... / }
```
用途:用于生成 Javadoc 文档。

通过 Javadoc 工具,可以将注释解析为HTML 格式的文档,提供给开发人员参考和查阅。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

/** * ${tags} * ${see_to_target} */
(8)getter 方法标签:
/**
* @Title:
${enclosing_method} <BR>
* @Description: please write your description <BR>
* @return:
${field_type} <BR>
*/
(9)setter 方法标签:
/** * @Title: ${enclosing_method} <BR> * @Description: please write your description <BR> * @return: ${field_type} <BR> */
ren
Eclipse 注释规范模版总结
1、 具体操作
(1)在 eclipse 中,打开 Window->Preference->Java->Code Style->Code Template
(2)然后展开 Comments 节点就是所有需设置注释的元素,参照 2 注释规范对应设置即可
2、 注释规范
(1)文件(Files)注释标签
* @Description: ${todo}(这里用一句话描述这个方法的作用)
* @param:
${tags}
* @return:
${return_type}
* @throws
* @author
${user}
* @Date
${date} ${time}
*/
输入设置模板:
/** * ${file_name} Create on ${date} * * Copyright (c) ${date} by taotaosoft * * @author <a href="xiuzhong.li@">Jerryli</a> * @version 1.0 * */
* @author: 名字
* @version V1.0
* Createdate:
${date} ${time}
*
* Modification History:
* Date
Author
Version
Discription
*
* ${date}
wu.zh
1.0
1.0
* Why & What is modified: <修改原因描述>
* @param: ${tags}
* @throws
*/
(5)方法(Methods)标签:
/** * @Title: ${enclosing_method} * @Description: ${todo}(这里用一句话描述这个方法的作用) * @param: ${tags} * @return: ${return_type} * @throws */
/**
* FileName:
${file_name}
* @Description: ${todo}(用一句话描述该文件做什么)
* All rights Reserved, Designed By ZTE-ITS
* Copyright: Copyright(C) 2010-2011
* Company
ZTE-ITS WuXi LTD.
*/
(3)字段(Fields)注释标签:
/** * @Fields ${field} : ${todo}(用一句话描述这个变量表示什么) */
(4)构造函数标签:
/**
* @Title:
${enclosing_type}
* @Description: ${todo}(这里用一句话描述这个方法的作用)
* @ClassName:
${file_name}
* @Description: ${todo}(用一句话描述该文件做什么)
*
* @author
${user}
* @version
V1.0
* @Date
${date} ${time}
*/
方法
/**
* @Title:
${enclosing_method}
(6)覆盖方法(Overriding Methods)标签:
/** * <p>Title: ${enclosing_method}</p> * <p>Description: </p> * ${tags} * ${see_to_overridden} */
(7)代表方法(Delegate Methods)标签:
myeclipse 中 java 文件头注释格式设置
2011-10-08 13:11:33| 分类: IDE|举报|字号 订阅
windows->preferences->java->Code Templates->comments->Type->edit
Eclipse 注释规范模版总结
新建类文件
/**
注意选择自动添加注释
养成一个规dows-->preference Java-->Code Style-->Code Templates code-->new Java files
选中点编辑
${filecomment} ${package_declaration} /** * @author 作者姓名 E-mail: email 地址 * @version 创建时间:${date} ${time} * 类说明 */ ${typecomment} ${type_declaration}
*/
(2)类型(Types)注释标签(类的注释):
/** * @ClassName:
${type_name}
* @Description:${todo}(这里用一句话描述这个类的作用)
* @author: Android_Robot
* @date:
${date} ${time}
*
* ${tags}
相关文档
最新文档