0pp0手机电子书怎么调亮度

書名： Java Web從入門到精通（第2版）
作者名：明日科技
本章字數： 1490字
更新時間： 2020-11-28 17:38:23

5.4 JSP注釋

由于JSP頁面由HTML、JSP、Java腳本等組成，所以在其中可以使用多種注釋格式，本節將對這些注釋的語法進行講解。

5.4.1 HTML中的注釋

視頻講解：光盤\TM\lx\5\08 HTML中的注釋．mp4

HTML語言的注釋不會被顯示在網頁中，但是在瀏覽器中選擇查看網頁源代碼時，還是能夠看到注釋信息的。其語法格式如下：

        //注釋文本

【例5.16】在HTML中添加注釋。代碼如下：

        //顯示數據報表的表格
        <table>
            …
        </table>

上述代碼為HTML的一個表格添加了注釋信息，其他程序開發人員可以直接從注釋中了解表格的用途，無須重新分析代碼。在瀏覽器中查看網頁代碼時，上述代碼將完整地被顯示，包括注釋信息。

5.4.2 帶有JSP表達式的注釋

視頻講解：光盤\TM\lx\5\09帶有JSP表達式的注釋．mp4

在JSP頁面中可以嵌入代碼片段，在代碼片段中也可加入注釋。在代碼片段中加入的注釋同Java的注釋相同，包括以下3種情況。

1．單行注釋

單行注釋以“//”開頭，后面接注釋內容，其語法格式如下：

        //注釋內容

【例5.17】在代碼片段中加入單行注釋的幾種情況。代碼如下：

        <%
            String username="";        //定義一個保存用戶名的變量
            //根據用戶名是否為空輸出不同的信息
            if ("".equals(username)) {
                System.out.println("用戶名為空");
            } else {
                //System.out.println("您好！" + username);
            }
        %>

在上面的代碼中，通過單行注釋可以讓語句“System.out.println("您好！" + username); ”不執行。

2．多行注釋

多行注釋以“/*”開頭，以“*/”結束。在這個標識中間的內容為注釋內容，并且注釋內容可以換行。其語法格式如下：

為了程序代碼的美觀，習慣上在每行注釋內容的前面加上一個“*”，構成以下的注釋格式：

        /＊
         ＊ 注釋內容1
         ＊ 注釋內容2
         ＊…
         ＊/

【例5.18】在代碼片段中添加多行注釋，代碼如下：

        <%
        /＊
        ＊ function：顯示用戶信息
        ＊ author:wgh
        ＊ time:2016-10-21
        ＊/
        %>
        用戶名：無語<br>
        部&nbsp; &nbsp；門：Java Web部門 <br>
        權&nbsp; &nbsp；限：系統管理員

說明

服務器不會對“/*”與“*/”之間的內容進行任何處理，包括JSP表達式及其他的腳本程序，并且多行注釋的開始標記和結束標記在同一個腳本程序中可以不同時出現。

3．提示文檔注釋

提示文檔注釋在被Javadoc文檔工具生成文檔時讀取，文檔是對代碼結構和功能的描述。其語法格式如下：

        /＊＊
          提示信息1
          提示信息2
          …
        ＊/

同多行注釋一樣，為了程序代碼的美觀，也可以在每行注釋內容的前面加上一個“*”，構成以下的注釋格式：

        /＊＊
          ＊ 提示信息1
          ＊ 提示信息2
          ＊…
        ＊/

說明

提示文檔注釋方法與多行注釋很相似，但細心的讀者會發現，它以“/**”作為注釋的開始標記，而不是“/*”。與多行注釋一樣，被“/**”和“*/”注釋的所有內容，服務器都不會做任何處理。

【例5.19】在代碼片段中添加提示文檔注釋，代碼如下：

        <%!
        int number=0;
        /＊＊
        ＊ function：計數器
        ＊ return：訪問次數
        ＊/
        int count(){
            number++;
            return number;
        }
        %>
        <%=count() %>

圖5.6 顯示的提示信息

在Eclipse中，將鼠標移動到count()方法上時，將顯示如圖5.6所示的提示信息。

5.4.3 隱藏注釋

視頻講解：光盤\TM\lx\5\10隱藏注釋．mp4

在文檔中添加的HTML注釋雖然在瀏覽器中不顯示，但是可以通過查看源代碼看到這些注釋信息。所以嚴格來說，這種注釋是不安全的。不過JSP還提供了一種隱藏注釋，這種注釋不僅在瀏覽器中看不到，在查看HTML源代碼時也看不到，所以這種注釋的安全性比較高。

隱藏注釋的語法格式如下：

        <%-- 注釋內容 --%>

【例5.20】在JSP頁面中添加隱藏注釋。（實例位置：光盤\TM\sl\5\4）

編寫一個名稱為index.jsp的文件，在該頁面中首先定義一個HTML注釋，內容為“顯示用戶信息”，然后再定義由注釋文本和JSP表達式組成的HTML注釋語句，最后再添加文本，用于顯示用戶信息。index.jsp文件的代碼如下：

        <html>
        <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
        <title>隱藏注釋的應用</title>
        </head>
        <body>
        <%-- 顯示用戶信息開始 --%>
        用戶名：無語<br>
        部&nbsp; &nbsp；門：Java Web部門 <br>
        權&nbsp; &nbsp；限：系統管理員
        <%-- 顯示用戶信息結束 --%>
        </body>
        </html>

運行程序，將顯示如圖5.7所示的結果。

圖5.7 頁面運行結果

頁面運行后，選擇“查看”/“源文件”命令，將打開如圖5.8所示的HTML源文件。在該文件中，將無法看到添加的注釋內容。

圖5.8 查看HTML源代碼的效果

說明

JSP編譯時會忽略掉隱藏注釋，所以即使隱藏注釋中存在語法錯誤，也不會影響程序的運行。

5.4.4 動態注釋

視頻講解：光盤\TM\lx\5\11動態注釋．mp4

由于HTML注釋對JSP嵌入的代碼不起作用，因此可以利用它們構成動態的HTML注釋文本。

【例5.21】在JSP頁面中添加動態注釋。示例代碼如下：

        <! -- <%=new Date()%> -->

上述代碼將當前日期和時間作為HTML注釋文本。

官术网_书友最值得收藏!

Java Web從入門到精通（第2版）

5.4 JSP注釋

5.4.1 HTML中的注釋

5.4.2 帶有JSP表達式的注釋

5.4.3 隱藏注釋

5.4.4 動態注釋