JSP注释（多种注释详解）

脚本程序（Scriptlet）中的注释

脚本程序中包含的是一段 Java 代码，所以在脚本程序中的注释与在 Java 中的注释是相同的。

脚本程序中包括下面 3 种注释方法。

1. 单行注释

单行注释的格式如下：

1. //注释内容

符号“//”后面的所有内容为注释的内容，服务器对该内容不进行任何操作。因为脚本程序在客户端通过查看源代码是不可见的，所以在脚本程序中通该方法注释的内容也是不可见的，并且后面将要提到的通过多行注释和提示文档进行注释的内容都是不可见的。

【例4】JSP 文件中包含以下代码：

1. <% int count=6; //定义一个计数变量%>计数变量 count 的当前值为：<%=count%>

访问该页面后，将会在客户端浏览器中输出以下内容：

1. 计数变量 cxnmt 的当前值为：6

通过查看 HTML 源代码，将会看到以下内容：

1. 计数变量 count 的当前值为：6

因为服务器不会对注释的内容进行处理，所以可以通过该注释暂时删除某一行代码。例如下面的代码。

【例5】使用单行注释暂时删除一行代码：

1. <%
2. String name="XYQ";
3. //name="XYQ2017";
4. %>
5. 用户名：<%=name%>

包含上述代码的 JSP 文件被执行后，将输出如下结果：

1. 用户名：XYQ

2. 多行注释

多行注释是通过“/”与“/”符号进行标记的，它们必须成对出现，在它们之间输入的注释内容可以换行。注释格式如下：

1. /*
2. 注释内容1
3. 注释内容2
4. */

为了程序界面的美观，开发人员习惯在每行注释内容的前面添加一个号，构成如下所示的注释格式：

1. /*
2. *注释内容1
3. *注释内容2
4. */

与单行注释一样，在“/”与“/”之间注释的所有内容，即使是 JSP 表达式或其他脚本程序，服务器都不会做任何处理，并且多行注释的开始标记和结束标记可以不在同一个脚本程序中同时出现。

【例6】在 JSP 文件中包含以下代码：

1. <%@ page contentType="text/html;charset=UTF-8"%>
2. <%
3. String state="0";
4. /*if(state.equals("0"))
5. {
6. //equals()方法用来判断两个对象是否相等
7. state="主版";
8. %>
9. 将变量state赋值为“主版”。

10. <%
11. }
12. */
13. %>
14. 变量state的值为：<%=state%>

包含上述代码的 JSP 文件被执行后，将输出如图 1 所示的结果。

若去掉代码中的“/”和“/”符号，则将输出如图 2 所示的结果。

图2 多行注释(二)

3. 文档注释。

该种注释会被 Javadoc 文档工具在生成文档时读取，文档是对代码结构和功能的描述。注释格式如下：

1. /**
2. 提示信息1
3. 提示信息2
4. */

该注释方法与上面介绍的多行注释很相似，但细心的读者会发现，它是以“/*”符号作为注释的开始标记，而不是“/”。与多行注释一样，对于被注释的所有内容，服务器都不会做任何处理。

【例7】在 Eclipse 开发工具中，在创建的 JSP 文件中输入以下代码：

1. <%!
2. int i = 0;
3. /**
4. @作者：dandelioncloud.cn
5. @功能：该方法用来实现一个简单的计数器
6. */
7. synchronized void add()
8. {
9. i++;
10. }
11. %>
12. <% add(); %>
13. 当前访问次数：<%=i%>

将鼠标指针移动到 <% add(); %> 代码上，将出现如图 3 所示的提示信息。

图3 提示文档注释