JSP语法

JSP（Java Server Pages）指令：

jsp指令负责告诉jsp引擎如何把页面翻译成servlet。

① 注释元素 (Comments Elements)

1. <!-- comment [<%= expression >] -->
   标准的HTML注释。JSP容器会将该注释发往客户端浏览器，但不在浏览器中显示，可以在HTML源文件中查看。

    comment    - 注释内容
    expression - 可选的java表达式，JSP容器会对表达式求值并将结果作为注释内容发往客户端

2. <%-- comment --%>
   JSP注释，JSP容器不会对该形式的注释进行编译，也不会将它发往客户端浏览器。

    comment - 注释内容

3. // comment
   /* comment */
   标准java注释，只能包含在scriptlet中。容器不对该部分内容编译；也不会发送到客户端浏览器。

    comment - 注释内容

② 脚本元素 (Scripting Elements)

1. <%! declaration %>
   声明块，在该块内声明的java变量可以在声明处到本jsp页面结尾处的范围内使用。
   jsp页面中类和方法的声明必须放在声明块内。

    declaration - 要声明的变量、类或方法

2. <% scriptlet %>
   脚本块，可以包含有效的java程序片段。

    scriptlet - 标准java代码

3. <%= expression %>
   表达式块，JSP容器会将表达式求值并输出到该位置。相当于<% out.print( expression ); %>。

    expression - 标准java表达式，末尾不可以加分号

③ 指令元素 (Directives Elements)

1. <%@ page autoFlush="false" buffer="8" contextType="ctinfo"
            errorPage="error_url" extends="javax.servlet.jsp.HttpJspPage"
            import="import_list" info="comment" isELIgnored="true"
            isErrorPage="false" isThreadSafe="true" language="java"
            session="true" pageEncoding="ISO-8859-1" %>
   page指令设定整个JSP页面的属性和相关功能。

    autoFlush="true|false"    - 是否自动清除输出流缓冲区。如果该属性指定为false，输出流缓冲区满后会抛出异常
    buffer="none|size in kb"  - 设定输出流缓冲区大小。none禁用缓冲
    contextType="ctinfo"      - 设定MIME类型和JSP网页的编码方式，中文为"text/html;charset=GB2312"
    errorPage="error_url"     - 设置页面发生异常时导向的页面
    extends="class_name"      - 设定JSP页面编译为servlet时的基类
    import="import_list"      - 导入java包，唯一可以重复出现的属性
    info="text"               - 设置本JSP页面的相关信息
    isELIgnored="true|false"  - 设置是否可以使用EL表达式
    isErrorPage="true|false"  - 设置本JSP页面是否为异常处理页面，只有异常处理页面才能使用exception对象
    isThreadSafe="true|false" - 设置本页面是否可以响应多个请求
    language="java"           - 设置JSP容器编译本页面使用什么样的语言，目前只有java一种
    session="true|false"      - 设置是否在页面中启用session
    pageEncoding="ISO-8859-1" - 设置JSP页面的编码方式

2. <%@ include file="relativeURLspec" %>
   inclued指令用来静态包含另外一个文件，可以是HTML文件、JSP文件、文本文件或者一段java程序。

    file="relativeURLspec" - 包含文件的路径

3. <%@ taglib uri="tagLibraryURI" tagdir="tagfile_dir" prefix="tagPrefix" %>
   taglib指令用来在页面中引入自定义标签。

    uri="tag_library_uri" - 自定义标签库TLD文件的存放位置
    tagdir="tag_file_dir" - tag文件的目录
    prefix="tag_prefix"   - 标签的前缀

④ 动作元素 (Action Elements)

1. <jsp:useBean id="id" spoce="page|application|request|session"
                class|beanName="class" type="type" />
   在页面中引入JavaBean，通常有如下应用形式：
   <jsp:userBean id="id" spoce="spoce" class="className" type="typeName" />
   <jsp:userBean id="id" spoce="spoce" type="typeName" class="className" />
   <jsp:userBean id="id" spoce="spoce" beanName="beanName" type="typeName" />
   <jsp:userBean id="id" spoce="spoce" type="typeName" beanName="beanName" />
   <jsp:userBean id="id" spoce="spoce" type="typeName">

    id       - javaBean实例化后的名字
    class    - 指定javaBean的类完全限定名
    beanName - 代表javaBean的名字，通常利用java.beans.Beans类的instantiate()方法初始化
    type     - 指定Scripting变量定义的类型
    spoce    - 该javaBean的可视范围，可以是如下值：
                page        －页面共享
                application －应用程序共享
                request     －请求范围共享
                session     －会话共享

2. <jsp:setProperty name="beanID" property="propertyName" value|param="value" />
   通常放在useBean元素体内，用来为javaBean指定参数值，通常有如下应用形式：
   <jsp:setProperty name="beanID" property="*" />
   <jsp:setProperty name="beanID" property="propertyName" />
   <jsp:setProperty name="beanID" property="propertyName" param="paramName" />
   <jsp:setProperty name="beanID" property="propertyName" value="value" />

     name     - 要设置的javaBean的ID
     property - 参数名称
     value    - 为属性指定值
     param    - 将属性的值设置为param指定的request变量的值

3. <jsp:getProperty name="beanID" propetry="property" />
   将指定的javaBean属性值写到输出流。

    name     - 要取得属性值的javaBean的实例化的名称
    property - 要取得的属性的名字

4. <jsp:include page="page_url" flush="true|false" />
   动态包含一个文件到JSP页面。

    page  - 一个路径或一个java表达式，JSP容器会对表达式求值并将结果作为路径
    flush - 是否自动清空被包含页面的输出流缓冲区

5. <jsp:forward page="page_url" />
   将客户端所发出的请求，从一个JSP页面转交给另外一个JSP页面，该动作标签后的scriptlet将不被执行。

    page - 要导航的目标路径。可以是一个表达式，由容器求值后将结果作为路径

6. <jsp:param name="name" value="value" />
   只能配合<jsp:include>、<jsp:forward>和<jsp:plugin>使用，为这些动作标签提供request参数。

    name  - 指定提供的request参数的名称
    value - 指定提供的request参数的值

7. <jsp:plugin type="bean|applet" code="classFileName" codebase="fileDirName"
               [name="instanceName"] [active="URIToArchive,..."]
               [align="bottom|top|middle|left|right"] [height="displayPixels"]
               [width="displayPixels"] [hspace="leftRightPixels"] [title="title"]
               [vspace="tipBottomPixels"] [iepluginurl="URLToPlugin"]
               [jreversion="JREVersion"] [nsplugurl="URLToPlagin"] />
   在页面中插入对象，生成的HTML标签是<object>或者<embed>。

    type        - 指定将被执行的对象类型，必须指定，没有默认值
    code        - 指定被Java Plugin执行的Java类名称，必须以.class结尾，并且必须在codebase指定的目录下
    codebase    - 指定Java类的路径，默认为JSP网页所在的路径
    name        - Bean或Applet的名字
    active      - 指定用于codebase目录下类装载器预装载的存档文件的路径，可以提高执行效率
    align       - 对齐方式
    height      - 以象素为单位的高度
    width       - 以象素为单位的宽度
    hspace      - 以象素为单位的左右补白的大小
    vspace      - 以象素为单位的上下补白的大小
    title       - 插件显示的标题
    jreversion  - 表示执行Applet或Bean所需的JRE的版本，默认为1.1
    nspluginurl - 表示Netscape Navigator用户能够使用的JRE的下载地址
    iepluginurl - 表示IE用户能够使用的JRE的下载地址

8. <jsp:params></jsp:params>
   放在<jsp:plugin>动作标签体内，包含若干<jsp:param>，为插件提供参数。

9. <jsp:fallback>prompt Text</jsp:fallback>
   放在<jsp:plugin>动作标签体内，当浏览器不支持插件时，显示该动作标签指定的文本信息。

11. <jsp:directive />
    指令元素的XML表示形式。有如下用法：
    <jsp:directive.page />    - 对应<%@ page %>指令
    <jsp:directive.taglib />  - 对应<%@ taglib %>指令
    <jsp:directive.include /> - 对应<%@ include %>指令

12. <jsp:declaration>declaration</jsp:declaration>
    声明块的XML表示形式，对应于<%! declaration %>。

12. <jsp:scriptlet>scriptlet</jsp:scriptlet>
    脚本块的XML表示形式，对应于<% scriptlet %>。

13. <jsp:expression>expression</jsp:expression>
    表达式块的XML表示形式，对应于<%= expression %>。

14. <jsp:text></jsp:text>
    在JSP Document中，输出template数据。

15. <jsp:output doctype-public="publicContext" doctype-root-element="rootName"
                doctype-system="systemContext" omit-xml-declaration="[true|false]|[yes|no]" />
    在JSP Docuemnt中，输出型如<!DOCTYPE rootName PUBLIC "publicContext" "systemContext">
    的文档类型声明。另外，还用于控制是否由JSP容器创建XML声明。

     doctype-public       - 指定XML文件文档类型声明的PUBLIC值
     doctype-root-element - 指定要验证的XML文档的根元素的名称
     doctype-system       - 指定XML文件文档类型声明的SYSTEM值
     omit-xml-declaration - 指定JSP容器是否创建一个默认的XML声明

16. <jsp:root version="1.2|2.0">

17. <jsp:attribute name="attributeName" trim="true|false">attributeValue</jsp:attribute>
    主要有两个用途，一是在<jsp:element>动作标签中定义XML元素的属性；二是设定标准或自定义标签的属性。

     name           - 指定属性的名称
     trim           - 指定属性值前后的空白字符是否被忽略
     attributeValue - 指定属性的值

18. <jsp:body>bodyText</jsp:body>
    用来定义XML元素标签的文本内容，必须放在<jsp:element>动作标签体内。

19. <jsp:element name="elementName" />
    用来动态定义XML元素的标签。

     name - XML元素标签的名称