由于JSP页面有HTML、JSP、Java脚本等组成,所以在其中可以使用多种注释格式。
1、HTML中的注释
HTML语言的注释不会被显示在网页中,但是在浏览器中选择查看网页源代码时,还是能够看到注释信息的。语法:
<!-- 注释文本 -->
2、带有JSP表达式的注释
在JSP页面中可以嵌入代码片段,在代码片段中也可加入注释。在代码片段中加入的注释同Java的注释相同,同样也是包括以下3种情况。
2.1 单行注释
// 注释内容
示例:在JSP页面中加入单行注释。
<%
Date date = new Date(); //获取日期对象
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); //设置日期时间格式
String today = df.format(date); //获取当前系统时间
%>
2.2 多行注释
/*
* 注释内容1
* 注释内容2
*/
2.3 文档注释
提示文档注释在被Javadoc文档工具生成文档时读取,文档是对代码结构和功能的描述。
/**
* 提示信息1
* 提示信息2
* @author pan_junbiao
*/
示例:在代码片段中添加提示文档注释。
<%!
int number=0; //声明全局变量
/**
* function:计数器
* return:访问次数
*/
int count(){
number++;
return number;
}
%>
刷新次数:<%= count() %>
3、隐藏注释
通过在文档中添加的HTML注释虽然在浏览器中不显示,但是可以通过查看源代码看到这些注释信息。所以严格来说,这种注释是不安全的。不过JSP还提供了一种隐藏注释,这种注释不仅在浏览器中看不到,而且在查看HTML源代码时,也看不到,所以这种注释的安全性比较高。隐藏注释的语法格式如下:
<%-- 注释内容 --%>
说明:JSP编译时会忽略掉隐藏注释,所以即使隐藏注释中存在语法错误,也不会影响程序的运行。
4、动态注释
由于HTML注释对JSP嵌入的代码不起作用,因此可以利用它们的组合构成动态的HTML注释文本。在JSP页面中添加动态注释。示例代码如下:
<!-- <%=new Date()%> -->
示例:在JSP页面中添加动态注释。
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ page import="java.util.Date" %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>动态注释</title>
</head>
<body>
<!-- <%=new Date()%> -->
</body>
</html>