首页 > 代码库 > JSP 语法/标签
JSP 语法/标签
┣1.declaration
声明的X M L形式语法为:
<jsp:declaration> declaration goes here < /jsp:declaration>
举例如下:
<%! public String f(int i) { if (i<3) return("..."); ... } %>
相应的X M L语句为:
<jsp:declaration> <![CDATA[ public String f(int i) { if (i<3) return("..."); } ]]>
</jsp:declaration>
下面是相关的D T D文件片断:
<!ELEMENT jsp:declaration (#PCDATA) >
下面是Declaration的使用实例:
<%! int i = 0;%>
<%
System.out.println(i);
%>
或者可以定义如下形式:
<jsp:declaration>int i = 0;</jsp:declaration>
<%
System.out.println(i);
%>
┣2.directive
作为X M L文档的page指为:
<jsp:directive.page page_directive_attr_list />
举例如下。
一般的page指为:
<%@ page info="my latest JSP Example V1.1" %>
相应的X M L相容语法:
<jsp:directive.page info="my latest JSP Example V1.1" />
┣3.expression
声明的X M L形式语法为:
<jsp:expression> expression goes here < /jsp:expression>
举例如下:
<%= str + i + " " + date%>
相应的X M L语句为:
<jsp:expression>
String str ="aasasda";
int i = 5;
java.util.Date date = new Date();
</jsp:expression>
下面是相关的D T D文件片断:
<!ELEMENT jsp:expression (#PCDATA) >
例子如下:
<%! int i = 0;%>
<%=i%>
┣4.fallback
当plug-in不能启动时用来显示的文本信息。如果plug-in启动了但不能运行,一般会有对话框弹出解释错误的信息。
<jsp:params>
<jsp:param name="molecule" value="http://www.mamicode.com/molecules/benzene.mol" />
</jsp:params>
<jsp:fallback>
<p>Unable to load applet</p>
</jsp:fallback>
</jsp:plugin>
┣5.forward
属性:
page="{relativeURL | <%= expression %>}",这里是一个表达式或是一个字符串用于说明你将要定向的文件或URL。这个文件可以是JSP,程序段,或者其它能够处理request对象的文件(如asp,cgi,php)。
<jsp:param name="parameterName" value="http://www.mamicode.com/{parameterValue | }" />+向一个动态文件发送一个或多个参数,这个文件一定是动态文件。如果你想传递多个参数,你可以在一个JSP文件中使用多个<jsp:param>。name指定参数名,value指定参数
<jsp:forward page="/do/login">
<jsp:param name="username" value="http://www.mamicode.com/test" />
</jsp:forward>
┣6.getProperty
获取Bean的属性值,用于显示在页面中
JSP 语法
<jsp:getProperty name="beanInstanceName" property="propertyName" />
例子:
<jsp:useBean id="calendar" scope="page" class="employee.Calendar" />
<h2>
Calendar of <jsp:getProperty name="calendar" property="username" />
</h2>
┣7.include
作为X M L文档的i n c l u d e指为:
<jsp:directive.include file=" relativeURLspec" flush="true|false" />
举例如下。
一般的i n c l u d e指令:
<%@ include file="copyright.hmtl" %>
相应的X M L相容语法:
<jsp:directive.include file="htmldocs/logo.html" />
例如:
┣8.page
你可以在一个页面中用上多个<% @ page %>指令,但是其中的属性只能用一次,不过也有个例外,那就是import属性。因为import属性和Java中的import语句差不多(参照Java Language),所以你就能多用此属性几次了。
无论你把<% @ page %>指令放在JSP的文件的哪个地方,它的作用范围都是整个JSP页面。不过,为了JSP程序的可读性,以及好的编程习惯,最好还是把它放在JSP文件的顶部。
语法
<%@ page
[ language="java" ]
[ extends="package.class" ]
[ import="{package.class | package.*}, ..." ]
[ session="true | false" ]
[ buffer="none | 8kb | sizekb" ]
[ autoFlush="true | false" ]
[ isThreadSafe="true | false" ]
[ info="text" ]
[ errorPage="relativeURL" ]
[ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ]
[ isErrorPage="true | false" ]
例子
<%@ page import="java.util.*, java.lang.*" %>
<%@ page buffer="5kb" autoFlush="false" %>
<%@ page errorPage="error.jsp" %>
┣9.param
<HTML>
<BODY>
<% double i=Math.random();
%>
< jsp:forward page="proc.jsp" >
<jsp:param name="number" value="http://www.mamicode.com/" />
< /jsp:forward>
</BODY>
</HTML>
proc.jsp:
<HTML>
<BODY><FONT Size=3>
<%String str=request.getParameter("number");
double n=Double.parseDouble(str);
%>
< P>传递的随机数是:<BR>
< %=n%>
</BODY>
</HTML>
┣10.params
<jsp:plugin type=applet code="Molecule.class" codebase="/html">
<jsp:params>
<jsp:param name="molecule" value="http://www.mamicode.com/molecules/benzene.mol" />
</jsp:params>
<jsp:fallback>
<p>Unable to load applet</p>
</jsp:fallback>
</jsp:plugin>
┣11.plugin
具体如下:
属性:
type="bean | applet".将被执行的插件对象的类型,你必须得指定这个是Bean还是applet,因为这个属性没有缺省值。
code="classFileName"将会被Java插件执行的Java Class的名字,必须以.class结尾。这个文件必须存在于codebase属性指定的目录中。
codebase="classFileDirectoryName"将会被执行的Java Class文件的目录(或者是路径),如果你没有提供此属性,那么使用<jsp:plugin>的jsp文件的目录将会被使用。
name="instanceName"这个Bean或applet实例的名字,它将会在Jsp其它的地方调用。archive="URIToArchive, ..."一些由逗号分开的路径名,这些路径名用于预装一些将要使用的class,这会提高applet的性能.
align="bottom | top | middle | left | right"图形,对象,Applet的位置,有以下值: bottom、top、middle、left 、right
height="displayPixels" width="displayPixels" Applet或Bean将要显示的长宽的值,此值为数字,单位为象素
hspace="leftRightPixels" vspace="topBottomPixels" Applet或Bean显示时在屏幕左右,上下所需留下的空间,单位为象素。
jreversion="JREVersionNumber | 1.1" Applet或Bean运行所需的Java Runtime Environment (JRE) 的版本,缺省值是 1.1。
nspluginurl="URLToPlugin" Netscape Navigator用户能够使用的JRE的下载地址,此值为一个标准的URL,如http://www.aspcn.com/jsp
iepluginurl="URLToPlugin" IE用户能够使用的JRE的下载地址,此值为一个标准的URL,如http://www.aspcn.com/jsp
<jsp:params> [ <jsp:param name="parameterName" value="http://www.mamicode.com/{parameterValue | }"]...
<jsp:params>
<jsp:param name="molecule" value="http://www.mamicode.com/molecules/benzene.mol" />
</jsp:params>
<jsp:fallback>
<p>Unable to load applet</p>
</jsp:fallback>
</jsp:plugin>
┣12.root
<jsp:root>元素有两个作用,一个是用于标识JSP文件为JSP文档,另一个是用于包装非格式良好的XML文档。
<jsp:root>元素有一个必备的属性version,用于指明页面使用的JSP规范的版本,例如代码所示:
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.0">
此外,<jsp:root>元素还可以有0个或多个xmlns属性,用于声明名称空间。在JSP文档中,不能使用taglib指令,取而代之的是使用xmlns属性,形式为xmlns:prefix="uri",uri标识要使用的标签库。在JSP1.2规范中,要求所有的标签库声明都要在<jsp:root>元素上,而JSP2.0规范则没有这个要求,我们可以在使用标签时再声明。例如,我们要使用JSTL中的标签<c:forEach>,可以直接在<c:forEach>上声明使用的标签库,如下:
<c:forEach xmlns:c="http://java.sun.com/jsp/jstl/core" var="counter" begin="1" end="${3}">
<row>${counter}</row>
</c:forEach>
┣13.scriptlet
包含一个有效的程序段.
JSP 语法
<% code fragment %>
例子
<%
String name = null;
if (request.getParameter("name") == null) {
%>
<%@ include file="error.html" %>
<%
} else {
foo.setName(request.getParameter("name"));
if (foo.getName().equalsIgnoreCase("integra"))
name = "acura";
if (name.equalsIgnoreCase( "acura" )) {
%>
描述
一个scriptlet能够包含多个jsp语句,方法,变量,表达式
因为scriptlet,我们便能做以下的事:
声明将要用到的变量或方法(参考 声明).
编写JSP表达式(参考 表达式).
使用任何隐含的对象和任何用<jsp:useBean>声明过的对象
编写JSP语句 (如果你在使用Java语言,这些语句必须遵从Java Language Specification,).
任何文本,HTML标记,JSP元素必须在scriptlet之外
当JSP收到客户的请求时,scriptlet就会被执行,如果scriptlet有显示的内容,这些显示的内容就被存在out对象中
┣14.setProperty
设置Bean中的属性值.
JSP语法
<jsp:setProperty
name="beanInstanceName"
{
property= "*" |
property="propertyName" [ param="parameterName" ] |
property="propertyName" value="http://www.mamicode.com/{string | <%= expression "
}
/>
例子
<jsp:setProperty name="mybean" property="*" />
<jsp:setProperty name="mybean" property="username" />
<jsp:setProperty name="mybean" property="username" value="http://www.mamicode.com/Steve" />
描述
<jsp:setProperty>元素使用Bean给定的setter方法,在Bean中设置一个或多个属性值。你在使用这个元素之前必须得使用<jsp:useBean>声明此Bean.因为,<jsp:useBean>和<jsp:setProperty>是联系在一起的,同时这他们使用的Bean实例的名字也应当相匹配(就是说,在<jsp:setProperty>中的name的值应当和<jsp:useBean>中id的值相同)
你能使用多种方法利用<jsp:setProperty>来设定属性值 :
通过用户输入的所有值(被做为参数储存中request对象中)来匹配Bean中的属性
通过用户输入的指定的值来匹配Bean中指定的属性
在运行时使用一个表达式来匹配Bean的属性
每一种设定属性值的方法都有其特定的语法,下面我们会来讲解
属性及其用法
name="beanInstanceName"
表示已经在<jsp:useBean>中创建的Bean实例的名字.
property="*"
储存用户在Jsp输入的所有值,用于匹配Bean中的属性。在Bean中的属性的名字必须和request对象中的参数名一致.
从客户传到服器上的参数值一般都是字符类型 ,这些字符串为了能够在Bean中匹配就必须转换成其它的类型,下面的表中列出了Bean属性的类型以及他们的转换方法.
把字符串转化为其它类型的方法. Property 类型
方法
boolean or Boolean
java.lang.Boolean.valueOf(String)
byte or Byte
java.lang.Byte.valueOf(String)
char or Character
java.lang.Character.valueOf(String)
double or Double
java.lang.Double.valueOf(String)
integer or Integer
java.lang.Integer.valueOf(String)
float or Float
java.lang.Float.valueOf(String)
long or Long
java.lang.Long.valueOf(String)
如果request对象的参数值中有空值,那么对应的Bean属性将不会设定任何值。同样的,如果Bean中有一个属性没有与之对应的Request参数值,那么这个属性同样也不会设定.
property="propertyName" [ param="parameterName" ]
使用request中的一个参数值来指定Bean中的一个属性值。在这个语法中,property指定Bean的属性名,param指定request中的参数名.
如果bean属性和request参数的名字不同,那么你就必须得指定property和param ,如果他们同名,那么你就只需要指明property就行了.
如查参数值为空(或未初始化),对应的Bean属性不被设定.
property
="propertyName" value="http://www.mamicode.com/{string | <%= expression "
使用指定的值来设定Bean属性。这个值可以是字符串,也可以是表达式。如果这个字符串,那么它就会被转换成Bean属性的类型(查看上面的表).如果它是一个表达式,那么它类型就必须和它将要设定的属性值的类型一致。
如果参数值为空,那么对应的属性值也不会被设定。另外,你不能在一个<jsp:setProperty>中同时使用param和value
技巧
如果你使用了property="*",那么Bean的属性没有必要按Html表单中的顺序排序
┣15.tablib
┣16.text
例子:
<h1><jsp:text>dd</jsp:text></h1>
┣17.useBean
指的是创建一个Bean实例并指定它的名字和作用范围。
用于定位或示例一个JavaBeans组件。<jsp:useBean>首先会试图定位一个Bean实例,如果这个Bean不存在,那么<jsp:useBean>就会从一个class或模版中进行示例。
为了定位或示例一个Bean,<jsp:useBean>会进行以下步聚,顺序如下:
通过给定名字和范围试图定位一个Bean.
对这个Bean对象引用变量以你指定的名字命名.
如果发现了这个Bean,将会在这个变量中储存这个引用。如果你也指定了类型,那么这个Bean也设置为相应的类型.
如果没有发现这个Bean,将会从你指定的class中示例,并将此引用储存到一个新的变量中去。如果这个class的名字代表的是一个模版,那么这个Bean被java.beans.Beans.instantiate示例.
如果<jsp:useBean>已经示例(不是定位)了Bean,同时<jsp:useBean>和</jsp:useBean>中有元素,那么将会执行其中的代码.
<jsp:useBean>元素的主体通常包含有<jsp:setProperty>元素,用于设置Bean的属性值。正如上面第五步所说的,<jsp:useBean>的主体仅仅只有在<jsp:useBean>示例Bean时才会被执行,如果这个Bean已经存在,<jsp:useBean>能够定位它,那么主体中的内容将不会起作用
id="beanInstanceName"
在你所定义的范围中确认Bean的变量,你能在后面的程序中使用此变量名来分辨不同的Bean
这个变量名对大小写敏感,必须符合你所使用的脚本语言的规定,在Java Programming Language中,这个规定在Java Language 规范已经写明。如果这个Bean已经在别的<jsp:useBean>中创建,那么这个id的值必须与原来的那个id值一致.
scope="page | request | session | application"
Bean存在的范围以及id变量名的有效范围。缺省值是page,以下是详细说明:
page - 你能在包含<jsp:useBean>元素的JSP文件以及此文件中的所有静态包含文件中使用Bean,直到页面执行完毕向客户端发回响应或转到另一个文件为止。
request - 你在任何执行相同请求的Jsp文件中使用Bean,直到页面执行完毕向客户端发回响应或转到另一个文件为止。你能够使用Request对象访问Bean,比如request.getAttribute(beanInstanceName)
session - 从创建Bean开始,你就能在任何使用相同session的Jsp文件中使用Bean.这个Bean存在于整个Session生存周期内,任何在分享此Session的Jsp文件都能使用同一Bean.注意在你创建Bean的Jsp文件中<% @ page %>指令中必须指定session=true
application - 从创建Bean开始,你就能在任何使用相同application的Jsp文件中使用Bean.这个Bean存在于整个application生存周期内,任何在分享此application的Jsp文件都能使用同一Bean.
class="package.class"
使用new关键字以及class构造器从一个class中示例一个bean.这个class不能是抽象的,必须有一个公用的,没有参数的构造器.这个package的名字区别大小写。
type="package.class"
如果这个Bean已经在指定的范围中存在,那么写这个Bean一个新的数据库类型 。如果你没有使用class或beanName指定type,Bean将不会被示例.package和class的名字,区分大小写.
beanName="{package.class | <%= expression %>}" type="package.class"
使用java.beans.Beans.instantiate方法来从一个class或连续模版中示例一个Bean,同时指定Bean的类型。
beanName可以是package和class也可以是表达式,它的值会传给Beans.instantiate.tupe的值可以和Bean相同。
package 和 class 名字区分大小写.
例子:
<jsp:useBean id="cart" scope="session" class="session.Carts" />
<jsp:setProperty name="cart" property="*" />
<jsp:useBean id="checking" scope="session" class="bank.Checking" >
<jsp:setProperty name="checking" property="balance" value="http://www.mamicode.com/0.0" />
</jsp:useBean>