<引言>
Eclipse 中提供了一个非常人性化的功能,可以自动生成注释为我们程序员做项目时提供便利,并且注释内容还具有定制化
可以根据自己的喜好配置不同的样式。
<正文>
首先我们需要找到,配置注释的地方。
Window --> preferences --> java --> Code Style --> Code Templates.
然后就能看到这个画面
红线部分可以看你现在的注释配置样式默认的样式都是很简单的/**/样式。
然后我们可以通过箭头处的 import 导入自己定义的或者其他人的模板样式的XML配置文件。
注意:XML文件的名字必须是: codetemplates.xml
模板的内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<templates>
<template
autoinsert="false"
context="typecomment_context"
deleted="false"
description="Comment for created types"
enabled="true"
id="org.eclipse.jdt.ui.text.codetemplates.typecomment"
name="typecomment">
/**
*@author lhy
*@date ${date}
*${tags}
*/
</template>
<template
autoinsert="false"
context="fieldcomment_context"
deleted="false"
description="Comment for fields"
enabled="true"
id="org.eclipse.jdt.ui.text.codetemplates.fieldcomment"
name="fieldcomment">
/**
*@Fields ${field} : ${todo}(用一句话描述这个变量表示什么)
*/
</template>
<template
autoinsert="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}.
*${tags}
*/
</template>
<template
autoinsert="false"
context="methodcomment_context"
deleted="false"
description="Comment for non-overriding methods"
enabled="true"
id="org.eclipse.jdt.ui.text.codetemplates.methodcomment"
name="methodcomment">
/**
*${tags}
*@return ${return_type}
*/
</template>
<template
autoinsert="true"
context="overridecomment_context"
deleted="false"
description="Comment for overriding methods"
enabled="true"
id="org.eclipse.jdt.ui.text.codetemplates.overridecomment"
name="overridecomment">
/*
*<p>Title: ${enclosing_method}</p>
*<p>Description: </p>
*${tags}
*${see_to_overridden}
*/
</template>
<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>
<template
autoinsert="false"
context="gettercomment_context"
deleted="false"
description="Comment for getter method"
enabled="true"
id="org.eclipse.jdt.ui.text.codetemplates.gettercomment"
name="gettercomment">
/**
*@return ${bare_field_name}
*/
</template>
<template
autoinsert="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>
</templates>
需要修改那个地方只需要在那个样式处直接修改即可。
导入配置文件后,勾选如下选项(允许创建类的时候自动添加注释,也可以不选)如下图,然后应用
当写完一个方法或者变量的时候 在前面打出 /** 三个符号再按回车,就能自动生成注释了,效果如下下图