转载

JSP注释分类及声明应用浅谈

JSP注释常用的有两种：HTML注释和隐藏注释（JSP注释），那么他们又有什么格式上的要求和特点呢？来开始我们的介绍吧：

◆HTML 注释：

说明：能在客户端显示的一个注释，标记内的所有JSP脚本元素、指令和动作正常执行，也就是说编译器会扫描注释内的代码行。

语法：

例1

!-- This file displays the user's information --

在客户端的HTML源代码中产生和上面一样的数据：

例2

!-- This page was loaded on %= (new java.util.Date()).toString() % --

在客户端的HTML源代码中显示为:

◆隐藏注释（JSP注释）：

说明：用隐藏注释标记的字符会在JSP编译时被忽略掉，标记内的所有JSP脚本元素、指令和动作都将不起作用。 JSP编译器不是会对注释符之间的语句进行编译的，它不会显示在客户的浏览器中。

语法：<%-- comment --%>

那么简单介绍过后，现在我们分别就他们的各自的特点来进一步详细的进行介绍，另外还有声明方面的应用：

1．HTML注释

该注释在客户端可通过查看源文件的方法看到。

JSP语法：!--注释[ %= 表达式% ] --

例1

!-- This file displays the user login screen --

在客户端页面源程序中显示为：

!-- This file displays the user login screen --

例2

页面调用日期为：

%= (new java.util.Date()).toLocaleString() % --

在客户端页面源程序中显示为：

!--页面调用日期为:January 1, 2000 --

描述：

可以在注释中使用任何有效的JSP表达式。表达式是动态的，当用户第一次调用该页面或该页面后来被重新调用时，该表达式将被赋值。JSP引擎对HTML注释中的表达式执行完后，其执行的结果将直接插入到表达式显示的地方。然后该结果和HTML注释中的其它内容一起输出到客户端。在客户端可通过查看源文件的方法看到该注释。

2．JSP注释

JSP注释作为JSP页面的文档资料，但是该注释在客户端通过查看源文件的方法是看不到的。即该注释不发送到客户端。

JSP语法：%-- 注释 --%

例如

%@ page language="java" %  
html  
headtitle注释测试/title/head  
body  
h2注释测试/h2  
%-- 在页面源代码中，这个注释是看不见的 --%  
/body  
/html

描述：

JSP引擎对JSP注释不作任何处理。JSP注释既不发送到客户端，也不在客户端的JSP页面中显示。在客户端查看源文件时也看不到。因此，如果你想在JSP页面源程序中写文档说明时，JSP注释是很有用的。

注意：在JSP注释中，不能使用--%，但是如果你一定要使用的话，可以通过使用--%/来避开。

3. 声明

在JSP页面脚本语言中声明变量或方法

JSP语法：%! 声明；[声明;]+…… %

例子

%! int i =8; %  
%! int n, m, k,j; %  
%! String s = new String("hello"); %

描述：

在JSP文件中，一次可以声明一个或多个变量和方法，它们之间用分号隔开。在声明时使用JAVA语言时，必须符合JAVA语言规范。

注意：

◆变量必须先声明，然后才能使用。

◆声明必须以分号结尾,但是在表达式中则不用。

◆通过page指令导入的包中已声明的变量或方法,可以在主JSP文件中直接使用它们。

◆一般情况下，一个声明的有效范围是本页面。但是，如果JSP源文件用jsp:include指令或include指令包含一些静态文件，声明的有效范围将会扩大，也就是说：声明在该静态文件中也有效。但是如果JSP源文件中用jsp:include指令包含进来一个动态文件，主JSP文件中的声明在该动态文件中将不起作用。

4. 表达式

在JSP脚本语言中，可以使用任何有效的表达式。

JSP语法：%= 表达式 %
　
例子1：

%! String s = new String("hello"); %
font color="blue"%=s%/font

例子2：

随机显示一个数字：

font color="blue"%=java.lang.Math.random()%/font
　
描述：

表达式用于求值，然后其值转化为字符串,而且插入在JSP文件中显示该表达式的地方。而且可以在文本中使用表达式。表达式标签能包含符合JAVA语言规范的任何有效表达式，但是要注意：不能使用分号作为表达式的结尾，然而，在脚本段%……%标签中，表达式要求以分号作为结尾。

5. 脚本段

在JSP页面脚本语言中，包含一段有效的代码片段。

JSP注释语法：% 代码段 %

例1：

%=java.lang.Math.random()%  
%  
for(int i=0;i8;i++)  
{ out.println(i); }  
%  
% 　  
long n=6666;  
application.setAttribute("maxNumber",Long.toString(n));  
out.println(application.getAttribute("maxNumber"));  
%

描述：

在脚本段能声明多个变量和方法。能使用任何有效的表达式。能使用任何JSP隐含的对象或任何用jsp:useBean标签声明的对象。能使用页面语言中任何有效的语句，如果使用Java语言，必须符合JAVA语言程序规范。

说明：假如脚本段有输出语句，则输出内容被存储在out对象中，通过out对象输出到JSP页面中。

以上介绍的是JSP注释的基本语法，有了以上的几条规则，我们就可以方便的书写一般的JSP文件了。比如我们前面测试Resin用的那个例子只有一句话，使用的就是表达式的语法，2＋2=%=2+2%,前面一部分对应的是需要直接打印的HTML文本，%,%对中的是Java语句,加了个等号就表示要返回表达式的值，并打印到客户端。翻译成对应的Servlet语句，大概就是：

out.println("2+2="+(2+2));

这样的一个语句如果改成

System.out.println("2+2="+(2+2));

并在console上运行，那么运行的结果就是2+2=4

通过上文对JSP注释方面的介绍以及JSP语言声明方面的使用注意事项，你对JSP注释是不是有了新的认识呢？希望对成长的你有所帮助。

正文到此结束