IT兄弟連 JavaWeb教程 JSP中的注釋
- 2019 年 10 月 5 日
- 筆記
版權聲明：本文為博主原創文章，遵循 CC 4.0 BY-SA 版權協議，轉載請附上原文出處鏈接和本聲明。
本文鏈接：https://blog.csdn.net/ITXDL123/article/details/90089781
由於JSP頁面由HTML、JSP、Java腳本等組成，所以在其中可以使用多種注釋格式
HTML中的注釋
HTML語言的注釋不會被顯示在網頁中，但是在瀏覽器中選擇查看網頁源代碼時，還是能夠看到注釋的信息的。其語法格式如下：
//注釋文本
例：在HTML中添加註釋，代碼如下：
//顯示數據報表的表格
<table>
…
</table>
上述代碼為HTML的一個表格添加了注釋信息，其他程序開發人員可以直接從注釋中了解表格的用途，無須重新分析代碼。在瀏覽器中查看網頁代碼時，上述代碼將完整地被顯示，包括注釋信息。
帶有JSP表達式的注釋
在JSP頁面中可以嵌入代碼片段，在代碼片段中也可以加入注釋。在代碼片段中加入的注釋同Java的注釋相同，包括以下3種情況：
● 單行注釋
單行注釋以"//"開頭，後面接注釋內容，其語法格式如下：
//注釋內容
例：在代碼片段中加入單行注釋的幾種情況，代碼如下：
<%
String username = ""; //定義一個保存用戶名的變量
//genuine用戶名是否為空輸出不同的信息
if("".equals(username)){
System.out.println("用戶名為空");
}else{
//System.out.println("您好" + username);
}
%>
在上面的代碼中，通過單行注釋可以讓語句"System.out.println("您好" + username);"不執行。
● 多行注釋
多行注釋以"/*"開頭，以"*/"結束。在這個標識中間的內容為注釋內容，並且注釋內容可以換行。其語法格式如下：
/*
注釋內容1
注釋內容2
…
*/
為了程序代碼的美觀，習慣上在每行注釋內容的前面加上一個"*"，構成以下的注釋格式：
/*
* 注釋內容1
* 注釋內容2
* …
*/
例：在代碼片段中添加多行注釋，代碼如下：
<%
/*
* function : 顯示用戶信息
* author : syx
* time : 2018-8-1
*/
%>
服務器不會對多行注釋之間的內容進行任何處理，包括JSP表達式及其他的腳本程序，並且多行注釋的開始標記和結束標記在同一個腳本程序中可以不同時出現。
● 提示文檔注釋
提示文檔注釋在被javadoc文檔工具生成文檔時讀取，文檔時對代碼結構和功能的描述。其語法格式如下：
/**
提示信息1
提示信息2
…
*/
同多行注釋一樣，為了程序代碼的美觀，也可以在每行注釋內容的前面加上一個"*"，構成如下的注釋格式：
/**
* 提示信息1
* 提示信息2
* …
*/
例：在代碼片段中添加提示文檔注釋，代碼如下：
<%! int number – 0;
/**
* function : 計數器
* return : 訪問次數
*/
int count(){
number++;
return number;
}
%>
<%=count() %>
隱藏注釋
在文檔中添加的HTML注釋雖然在瀏覽器中不顯示，但是可以通過查看源代碼看到這些注釋信息。所以嚴格來說，這種注釋是不安全的，不過JSP還提供了一種隱藏注釋，這種注釋不僅在瀏覽器中看不到，在查看HTML源代碼時也看不到，所以這種注釋的安全性比較高。隱藏注釋的語法格式如下：
<%– 注釋內容 –%>
例：在JSP頁面中添加隱藏注釋
編寫一個名稱為index.jsp的文件，在該頁面中首先定義一個HTM注釋，內容為"顯示用戶信息"，然後在定義由注釋文本和JSP表達式組成的HTML注釋語句，最後再添加文本，用於顯示用戶信息，index.jsp文件的代碼如下：
<html>
<head>
<meta charset="UTF-8">
<title>兄弟連IT教育</title>
</head>
<body>
<%– 顯示用戶信息 –%>
用戶名：—<br>
部門：—<br>
<%– 顯示用戶信息結束 –%>
</body>
動態注釋
由於HTML注釋對JSP嵌入的代碼不起作用，因此可以利用他們構成動態的HTML注釋文本。
例：在JSP頁面中添加動態注釋。代碼如下：
<!– <%=new Date()%> –%>
上述代碼將當前日期和時間作為HTML注釋文本。
