大家好，又见面了，我是你们的朋友全栈君。如果您正在找激活码,请点击查看最新教程,关注关注公众号 “全栈程序员社区” 获取激活教程,可能之前旧版本教程已经失效.最新Idea2022.1教程亲测有效,一键激活。
Jetbrains全系列IDE稳定放心使用
开发过程中经常看到源码中的注释，感叹大佬的注释为何写得那么清新脱俗，决定简单研究一下IDEA中的注释
众所周知，Java中的注释标识分为三种：
// [1]
/* */ [2]
/** */ [3]
第一种是单行注释 //之后的部分皆为注释
第二种和第三种注释可以将注释内容限制在斜杠之间，这是单行注释无法完成的
public void setNameAndAge(/*名称*/String name, /**年龄*/String age){
this.name = name;
this.age = age;
}
第二种注释用的相对较少
这里主要说一下第三种注释：/** */的情况，这是可以被javadoc所识别的注释，即这种注释可以被JDK中的文档工具所感知，从而实现注释的抽取等操作。
e.g.
我们还可以通过javadoc命令对第三种注释中的内容进行抽取，整合成一个文档，由于这些知识点非常General, 随处可见，不谈。
言归正传，本文只涉及第三种注释，主要内容分为以下部分：
- 注释的显示状态切换
- 如何在注释中添加超链接
- 制表符的添加
- IDEA中其它常用的HTML标签
注释状态切换：
之前看大佬们的注释都是:
而我的注释：
为何源码中别人的注释和自己写的注释显示效果完全不一样呢 其实是设置问题而已(今天才知道… 尴尬了)
点击图中的铅笔就可以切换为注解源码，效果如下：
再点击图中左上角的图标就切换回了注释的阅览视图
注释中添加超链接的方法：
(1) 使用@see
场景：
有类Student:
package com.test.springbatch.query;
import lombok.Data;
@Data
public class Student {
private String name;
private String age;
public String pub;
public void printWords(String words){
System.out.println(words);
}
}
在类User的注释中加入指向Student类以及其中属性和方法的超链接:
图中的5个@see注解后的链接分别指向Student类、age属性、pub属性、getName方法、printWords方法 需要注意的是#age会被标红，因为age是private的，但这不对链接的功用产生影响
点击左上角的图标切换为阅览视图之后：
此时点击指定的链接即跳转至指定的Class/Field/Method
(2) 使用@link
切换视图后：
plus: 注释中制表符的实现：
加上li标签即可, 效果：
注意 ： 使用<li>时最好用<ul>标签作为其父标签：
/** * <ul> * <li> sss * <li> sss * <li> sss * </ul> */
public class User {
private String name;
private String age;
public String getName(){
return "";
}
}
不写<ul>默认也为无序列表
若用<ol>做父标签则为有序列表：
/** * <ol> * <li> sss * <li> sss * <li> sss * </ol> */
public class User {
private String name;
private String age;
public String getName(){
return "";
}
}
效果：
除上述的制表符，IDEA中的注释中还可使用其它常用的标签
<em></em>；<i></i>对Html稍有了解的人都知道这两个标签，效果为使字体倾斜。
/** * hello, today is <em>SUNDAY</em>! * hello, today is <i>SUNDAY</i>! */
@Data
public class User {
public class User {
效果：
图中SUNDAY字样被倾斜显示。
<p>标签，该标签无特殊显示效果，仅仅作为段落开始的标志
/** * <p> * hello world * * hello world */
@Data
public class User {
效果：
可见<p>标签下的内容作为一个段落，并不会如原注释般换行
当写为：
/** * <p> * hello world * <p> * hello world */
@Data
public class User {
效果为：
此时两个hello world从属于不同的<p>,故具有换行效果。
plus: 需要注意，不使用p标签 注释文字默认也是不换行的：
/** * hello world * * hello world */
@Data
public class User {
效果：
<pre class="code">标签 如同Markdown中写代码需要使用使用代码块一样，注释中若需要写代码的话可用此标签
/** * <pre class="code"> * @Configuration * class A{ * private String name; * private String age; * * } * </pre> */
@Data
public class User {
注意，代码块中某些特殊字符需要进行转义处理，图中的@是@转义后的字符，否则无法被识别。效果：
End
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/188951.html原文链接：https://javaforall.net
