十三、JSP动作

jsp动作利用xml语法格式的标记来控制servlet引擎的行为。利用jsp动作可以动态地插入文件、重用javabean组件、把用户重定向到另外的页面、为java插件生成html代码。

　　 jsp动作包括：

jsp:include：在页面被请求的时候引入一个文件。
jsp:usebean：寻找或者实例化一个javabean。
jsp:setproperty：设置javabean的属性。
jsp:getproperty：输出某个javabean的属性。
jsp:forward：把请求转到一个新的页面。
jsp:plugin：根据浏览器类型为java插件生成object或embed标记。
　　 13.1 jsp:include动作

　　 该动作把指定文件插入正在生成的页面。其语法如下：
＜jsp:include page="relative url" flush="true" /＞



　　 前面已经介绍过include指令，它是在jsp文件被转换成servlet的时候引入文件，而这里的jsp:include动作不同，插入文件的时间是在页面被请求的时候。jsp:include动作的文件引入时间决定了它的效率要稍微差一点，而且被引用文件不能包含某些jsp代码（例如不能设置http头），但它的灵活性却要好得多。

　　 例如，下面的jsp页面把4则新闻摘要插入一个“what's new ?”页面。改变新闻摘要时只需改变这四个文件，而主jsp页面却可以不作修改：

　　 whatsnew.jsp
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
＜title＞what's new＜/title＞
＜/head＞

＜body bgcolor="#fdf5e6" text="#000000" link="#0000ee"
      vlink="#551a8b" alink="#ff0000"＞

＜center＞
＜table border=5 bgcolor="#ef8429"＞
  ＜tr＞＜th class="title"＞
      what's new at jspnews.com＜/table＞
＜/center＞
＜p＞
here is a summary of our four most recent news stories:
＜ol＞
  ＜li＞＜jsp:include page="news/item1.html" flush="true"/＞
  ＜li＞＜jsp:include page="news/item2.html" flush="true"/＞
  ＜li＞＜jsp:include page="news/item3.html" flush="true"/＞
  ＜li＞＜jsp:include page="news/item4.html" flush="true"/＞
＜/ol＞
＜/body＞
＜/html＞



　　 13.2 jsp:usebean动作

　　 jsp:usebean动作用来装载一个将在jsp页面中使用的javabean。这个功能非常有用，因为它使得我们既可以发挥java组件重用的优势，同时也避免了损失jsp区别于servlet的方便性。jsp:usebean动作最简单的语法为：
＜jsp:usebean id="name" class="package.class" /＞



　　 这行代码的含义是：“创建一个由class属性指定的类的实例，然后把它绑定到其名字由id属性给出的变量上”。不过，就象我们接下来会看到的，定义一个scope属性可以让bean关联到更多的页面。此时，jsp:usebean动作只有在不存在同样id和scope的bean时才创建新的对象实例，同时，获得现有bean的引用就变得很有必要。

　　 获得bean实例之后，要修改bean的属性既可以通过jsp:setproperty动作进行，也可以在scriptlet中利用id属性所命名的对象变量，通过调用该对象的方法显式地修改其属性。这使我们想起，当我们说“某个bean有一个类型为x的属性foo”时，就意味着“这个类有一个返回值类型为x的getfoo方法，还有一个setfoo方法以x类型的值为参数”。

　　 有关jsp:setproperty动作的详细情况在后面讨论。但现在必须了解的是，我们既可以通过jsp:setproperty动作的value属性直接提供一个值，也可以通过param属性声明bean的属性值来自指定的请求参数，还可以列出bean属性表明它的值应该来自请求参数中的同名变量。

　　 在jsp表达式或scriptlet中读取bean属性通过调用相应的getxxx方法实现，或者更一般地，使用jsp:getproperty动作。

　　 注意包含bean的类文件应该放到服务器正式存放java类的目录下，而不是保留给修改后能够自动装载的类的目录。例如，对于java web server来说，bean和所有bean用到的类都应该放入classes目录，或者封装进jar文件后放入lib目录，但不应该放到servlets下。

　　 下面是一个很简单的例子，它的功能是装载一个bean，然后设置/读取它的message属性。

　　 beantest.jsp
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
＜title＞reusing javabeans in jsp＜/title＞
＜/head＞

＜body＞
＜center＞
＜table border=5＞
  ＜tr＞＜th class="title"＞
      reusing javabeans in jsp＜/table＞
＜/center＞
＜p＞

＜jsp:usebean id="test" class="hall.simplebean" /＞
＜jsp:setproperty name="test"
          property="message"
          value="hello www" /＞
＜h1＞message: ＜i＞
＜jsp:getproperty name="test" property="message" /＞
＜/i＞＜/h1＞

＜/body＞
＜/html＞



　　 simplebean.java

　　 beantest页面用到了一个simplebean。simplebean的代码如下：
package hall;

public class simplebean {
  private string message = "no message specified";

  public string getmessage() {
    return(message);
  }

  public void setmessage(string message) {
    this.message = message;
  }
}



　　 13.3 关于jsp:usebean的进一步说明

　　 使用bean最简单的方法是先用下面的代码装载bean：
＜jsp:usebean id="name" class="package.class" /＞



　　 然后通过jsp:setproperty和jsp:getproperty修改和提取bean的属性。不过有两点必须注意。第一，我们还可以用下面这种格式实例化bean：
  ＜jsp:usebean ...＞
    body
  ＜/jsp:usebean＞



　　 它的意思是，只有当第一次实例化bean时才执行body部分，如果是利用现有的bean实例则不执行body部分。正如下面将要介绍的，jsp:usebean并非总是意味着创建一个新的bean实例。

　　 第二，除了id和class外，jsp:usebean还有其他三个属性，即：scope，type，beanname。下表简要说明这些属性的用法。 属性  用法  
id  命名引用该bean的变量。如果能够找到id和scope相同的bean实例，jsp:usebean动作将使用已有的bean实例而不是创建新的实例。  
class  指定bean的完整包名。  
scope  指定bean在哪种上下文内可用，可以取下面的四个值之一：page，request，session和application。
默认值是page，表示该bean只在当前页面内可用（保存在当前页面的pagecontext内）。
request表示该bean在当前的客户请求内有效（保存在servletrequest对象内）。
session表示该bean对当前httpsession内的所有页面都有效。
最后，如果取值application，则表示该bean对所有具有相同servletcontext的页面都有效。
scope之所以很重要，是因为jsp:usebean只有在不存在具有相同id和scope的对象时才会实例化新的对象；如果已有id和scope都相同的对象则直接使用已有的对象，此时jsp:usebean开始标记和结束标记之间的任何内容都将被忽略。

type  指定引用该对象的变量的类型，它必须是bean类的名字、超类名字、该类所实现的接口名字之一。请记住变量的名字是由id属性指定的。  
beanname  指定bean的名字。如果提供了type属性和beanname属性，允许省略class属性。  


　　 13.4 jsp:setproperty动作

　　 jsp:setproperty用来设置已经实例化的bean对象的属性，有两种用法。首先，你可以在jsp:usebean元素的外面（后面）使用jsp:setproperty，如下所示：
＜jsp:usebean id="myname" ... /＞
...
＜jsp:setproperty name="myname"
    property="someproperty" ... /＞



　　 此时，不管jsp:usebean是找到了一个现有的bean，还是新创建了一个bean实例，jsp:setproperty都会执行。第二种用法是把jsp:setproperty放入jsp:usebean元素的内部，如下所示：
＜jsp:usebean id="myname" ... ＞
  ...
  ＜jsp:setproperty name="myname"
     property="someproperty" ... /＞
＜/jsp:usebean＞



　　 此时，jsp:setproperty只有在新建bean实例时才会执行，如果是使用现有实例则不执行jsp:setproperty。

　　 jsp:setproperty动作有下面四个属性： 属性  说明  
name  name属性是必需的。它表示要设置属性的是哪个bean。  
property  property属性是必需的。它表示要设置哪个属性。有一个特殊用法：如果property的值是“*”，表示所有名字和bean属性名字匹配的请求参数都将被传递给相应的属性set方法。  
value  value属性是可选的。该属性用来指定bean属性的值。字符串数据会在目标类中通过标准的valueof方法自动转换成数字、boolean、boolean、byte、byte、char、character。例如，boolean和boolean类型的属性值（比如“true”）通过boolean.valueof转换，int和integer类型的属性值（比如“42”）通过integer.valueof转换。
value和param不能同时使用，但可以使用其中任意一个。

param  param是可选的。它指定用哪个请求参数作为bean属性的值。如果当前请求没有参数，则什么事情也不做，系统不会把null传递给bean属性的set方法。因此，你可以让bean自己提供默认属性值，只有当请求参数明确指定了新值时才修改默认属性值。
例如，下面的代码片断表示：如果存在numitems请求参数的话，把numberofitems属性的值设置为请求参数numitems的值；否则什么也不做。

＜jsp:setproperty name="orderbean"
property="numberofitems"
param="numitems" /＞

如果同时省略value和param，其效果相当于提供一个param且其值等于property的值。进一步利用这种借助请求参数和属性名字相同进行自动赋值的思想，你还可以在property（bean属性的名字）中指定“*”，然后省略value和param。此时，服务器会查看所有的bean属性和请求参数，如果两者名字相同则自动赋值。



　　 下面是一个利用javabean计算素数的例子。如果请求中有一个numdigits参数，则该值被传递给bean的numdigits属性；numprimes也类似。

　　 jspprimes.jsp
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
＜title＞在jsp中使用javabean＜/title＞
＜/head＞

＜body＞

＜center＞
＜table border=5＞
  ＜tr＞＜th class="title"＞
      在jsp中使用javabean＜/table＞
＜/center＞
＜p＞

＜jsp:usebean id="primetable" class="hall.numberedprimes" /＞
＜jsp:setproperty name="primetable" property="numdigits" /＞
＜jsp:setproperty name="primetable" property="numprimes" /＞

some ＜jsp:getproperty name="primetable" property="numdigits" /＞
digit primes:
＜jsp:getproperty name="primetable" property="numberedlist" /＞

＜/body＞
＜/html＞



　　 注：numberedprimes的代码略。

　　 13.5 jsp:getproperty动作

　　 jsp:getproperty动作提取指定bean属性的值，转换成字符串，然后输出。jsp:getproperty有两个必需的属性，即：name，表示bean的名字；property，表示要提取哪个属性的值。下面是一个例子，更多的例子可以在前文找到。
＜jsp:usebean id="itembean" ... /＞
...
＜ul＞
  ＜li＞number of items:
      ＜jsp:getproperty name="itembean" property="numitems" /＞
  ＜li＞cost of each:
      ＜jsp:getproperty name="itembean" property="unitcost" /＞
＜/ul＞



　　 13.6 jsp:forward动作

　　 jsp:forward动作把请求转到另外的页面。jsp:forward标记只有一个属性page。page属性包含的是一个相对url。page的值既可以直接给出，也可以在请求的时候动态计算，如下面的例子所示：
＜jsp:forward page="/utils/errorreporter.jsp" /＞
＜jsp:forward page="＜%= somejavaexpression %＞" /＞



　　 13.7 jsp:plugin动作

　　 jsp:plugin动作用来根据浏览器的类型，插入通过java插件 运行java applet所必需的object或embed元素。

　　 附录：jsp注释和字符引用约定

　　 下面是一些特殊的标记或字符，你可以利用它们插入注释或可能被视为具有特殊含义的字符。 语法  用途  
＜%-- comment --%＞  jsp注释，也称为“隐藏注释”。jsp引擎将忽略它。标记内的所有jsp脚本元素、指令和动作都将不起作用。  
＜!-- comment --＞  html注释，也称为“输出的注释”，直接出现在结果html文档中。标记内的所有jsp脚本元素、指令和动作正常执行。  
＜＼%  在模板文本（静态html）中实际上希望出现“＜%”的地方使用。  
%＼＞  在脚本元素内实际上希望出现“%＞”的地方使用。  
＼'  使用单引号的属性内的单引号。不过，你既可以使用单引号也可以使用双引号，而另外一种引号将具有普通含义。  
＼"  使用双引号的属性内的双引号。参见“＼'”的说明。