myeclipse中java文件头注释格式设置

windows->preferences->java->Code Templates->comments->Type->edit

Eclipse注释规范模版总结

新建类文件

/**

* @ClassName:     ${file_name}

* @Description:   ${todo}(用一句话描述该文件做什么)

*

* @author         ${user}

* @version        V1.0

* @Date           ${date}
${time}

*/

方法

/**

* @Title:       
${enclosing_method}

* @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="[email protected]">Jerryli</a>

* @version 1.0

*

*/

注意选择自动添加注释

养成一个规范的习惯是最好的。

选菜单

windows-->preference

Java-->Code Style-->Code Templates

code-->new Java files

选中点编辑

${filecomment}

${package_declaration}

/**

* @author 作者姓名  E-mail: email地址

* @version 创建时间:${date} ${time}

* 类说明

*/

${typecomment}

${type_declaration}

Eclipse注释规范模版总结

1、  具体操作

(1)在eclipse中,打开Window->Preference->Java->Code
Style->Code Template

(2)然后展开Comments节点就是所有需设置注释的元素,参照2注释规范对应设置即可

2、  注释规范

(1)文件(Files)注释标签

/**

*
FileName:     ${file_name}

*
@Description: ${todo}(用一句话描述该文件做什么)

* All rights
Reserved, Designed By ZTE-ITS

*
Copyright:    Copyright(C) 2010-2011

*
Company       ZTE-ITS WuXi LTD.

*
@author:    名字

*
@version    V1.0

*
Createdate:         ${date}
${time}

*

*
Modification  History:

*
Date         Author        Version        Discription

*

* ${date}       wu.zh          1.0             1.0

* Why
& What is modified: <修改原因描述>

*/

(2)类型(Types)注释标签(类的注释):

/**

*
@ClassName:     ${type_name}

*
@Description:${todo}(这里用一句话描述这个类的作用)

*
@author:    Android_Robot

*
@date:        ${date} ${time}

*

*
${tags}

*/

(3)字段(Fields)注释标签:

/**

*
@Fields ${field} : ${todo}(用一句话描述这个变量表示什么)

*/

(4)构造函数标签:

/**

*
@Title:        ${enclosing_type}

*
@Description:    ${todo}(这里用一句话描述这个方法的作用)

*
@param:    ${tags}

*
@throws

*/

(5)方法(Methods)标签:

/**

*
@Title: ${enclosing_method}

*
@Description: ${todo}(这里用一句话描述这个方法的作用)

*
@param: ${tags}

*
@return: ${return_type}

*
@throws

*/

(6)覆盖方法(Overriding Methods)标签:

/**

*
<p>Title: ${enclosing_method}</p>

*
<p>Description: </p>

*
${tags}

*
${see_to_overridden}

*/

(7)代表方法(Delegate Methods)标签:

/**

*
${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

原文地址:https://www.cnblogs.com/bluestorm/p/8757389.html

时间: 2024-10-25 18:57:03

myeclipse中java文件头注释格式设置的相关文章

Eclipse中java文件头注释格式设置

Eclipse中java文件头注释格式设置 Eclipse中java文件头注释格式设置 windows->preferences->java->Code Templates->comments->Type->edit Eclipse注释规范模版总结 新建类文件 /** * @ClassName:     ${file_name} * @Description:   ${todo}(用一句话描述该文件做什么) * * @author          ${user} * 

java文档注释 编写格式

java 文档注释 在sun主页上有java文档注释的编写格式 How to Write Doc Comments for the Javadoc Tool http://java.sun.com/j2se/javadoc/writingdoccomments/ 不过是英文的 @author dfeixtay @version 0.10 2010-10-04 1 注释文档的格式注释文档将用来生成HTML格式的代码报告,所以注释文档必须书写在类.域.构造函数.方法.定义之前.注释文档由两部分组成—

java文档注释规范(一)

https://blog.csdn.net/huangsiqian/article/details/82725214 Javadoc工具将从四种不同类型的“源”文件生成输出文档:Java语言类的源文件(.java),包注释文件,概述注释文件和其他未处理的文件. 包注释文件(Package Comment File)每个包都有自己的文档注释.有两种方式来创建包注释文件: package-info.java - 可以包含包的声明,包注解(anotation),包注释和Javadoc 标签(tag).

如何为我们的程序编写开发文档——Java文档注释

Java文档注释是用于生成Java API文档的注释,通过在程序中的类.属性.方法部分加上注释,就可以用javadoc命令生成漂亮的API文档,是程序员进阶的必备技能. 注意,文档注释只说明紧跟其后的类.属性或者方法. Javadoc文档生成命令为: -author和-version可以省略. 根据在文档中显示的效果,文档注释分为三部分.举例如下: 第一部分是简述.如下图中被红框框选的部分: 简述部分写在一段文档注释的最前面,第一个点号 (.) 之前 (包括点号). 第二部分是详细说明部分.该部

JAVA 文档注释,类的说明,HTML说明文档的生成

有的时候,我们会写一些类,编译成.class文件,给别人使用,那么,别人不知道这个类有哪些方法,如何调用. 所以我们需要做一个类的说明文档. 可以采用在.java类里面进行注释,通过注释来生成类的说明文档的方法. 一..java中注释的写法: Test1.java /* 文档注释 */ /** 此类是对数组进行取最值,排序等操作的 @author 张三 @version 1.0 */ public class Test1{ /** 取Int数组里面的最大值 @param arr 传入一个int数

用prel实现的文件头注释工具

最近想开源一套软件,对于一些代码都要在文件头上加上固定格式的版本信息.自己用perl写了一个小工具,拿出来分享. 1 #!/usr/bin/perl -W 2 # 3 # Copyright (c) 2014 Nijie. All rights reserved. 4 # License: GPL-2 5 # 6 # File: comments.pl 用于增加c/c++文件注释 7 # Create by Nijie 2014.07.23 8 # 9 10 use strict; 11 use

Java - 34 Java 文档注释

Java 文档注释 Java只是三种注释方式.前两种分别是// 和/* */,第三种被称作说明注释,它以/** 开始,以 */结束. 说明注释允许你在程序中嵌入关于程序的信息.你可以使用javadoc工具软件来生成信息,并输出到HTML文件中. 说明注释,使你更加方便的记录你的程序的信息. javadoc 标签 javadoc工具软件识别以下标签: 标签 描述 示例 @author 标识一个类的作者 @author description @deprecated 指名一个过期的类或成员 @dep

VA中用文件头注释和函数头注释Suggestions

写C++代码,不能不用VA,这里贴两个我最常用的注释Suggestions. [1.File Header 文件头注释] /*** @file     $FILE_BASE$.$FILE_EXT$* @brief    * @details  * @author   [email protected]* @date     $YEAR$-$MONTH$-$DAY$*/$end$ [2.Function Header 函数头注释] /*** @brief   $end$* @param   $Me

MyEclipse中Java链接MySQL

MyEclipse中Java链接MySQL.先解压JDBC的jar文件.配置环境. 下面我写了段Java程序加载JDBC驱动连接MySQL的代码 GetConn.java package mysql; import java.sql.*; public class GetConn {    public Connection conn = null;                        //创建Connection对象    public Connection getConnectio