Structs - 标签库（Bean）- -

Structs - 标签库（Bean）- -

                                      

Bean 标签库
        此标签库和Java Bean有很强的关联性，设计的本意是要在JSP 和JavaBean 之间提供一个接口。Struts 提供了一套小巧有用的标签库来操纵JavaBean和相关的对象：cookie、 header、 parameter、 define、write、message、 include、page、resource、size、struts。

1. bean:cookie、bean:header、bean:parameter
   这三个标签用来重新得到cookie, request header和request parameter。
   bean:header和bean:parameter标签定义了一个字符串；bean:cookie标签定义了一个Cookie对象。你可以使用value属性做为默认值。如果找不到指定的值，且默认值没有设定的话，会抛出一个request time异常。如果你期望返回多个值的话，可把multiple属性设为true。
   

   <bean:cookie id="sessionID" name="JSESSIONID" value="JSESSIONID-ISUNDEFINED"/>  // 这段代码定义了一个名为sessionID的脚本变量，如果找不到一个名为JSESSIONID的cookie，那sessionID  // 的值就被设置为JSESSIONID-ISUNDEFINED。

   
   下面代码会输出一些Cookie对象的一些属性：
   

   <jsp:getProperty name="sessionID " property="comment"/> …  <jsp:getProperty name="sessionID" property="domain"/> …  <jsp:getProperty name="sessionID" property="maxAge"/> …  <jsp:getProperty name="sessionID" property="path"/> …  <jsp:getProperty name="sessionID" property="value"/> …  <jsp:getProperty name="sessionID" property="version"/> …

   
   下面是在request中输出所有header的例子： 
   

   <%         java.util.Enumeration names =((HttpServletRequest) request).getHeaderNames(); %> … <%         while (names.hasMoreElements()) {         String name = (String) names.nextElement(); %> <bean:header id="head" name="<%= name %>"/> … <%= name %> … <%= head %> … <%         } %>

   
   下面是parameter的例子：
   

   <bean:parameter id="param1" name="param1"/>  <bean:parameter id="param2" name="param2" multiple="true"/>  // 此处定义了一个param2[]。  <bean:parameter id="param3" name="param3" value="UNKNOWN VALUE"/>

   
   于其它标签结合使用：
   

   <bean:header id="browser" name="User-Agent"/> <P>You are viewing this page with: <bean:write name="browser"/></P> ---------------------------------------------------------------------------------------------------------------------------------- <bean:cookie id="username" name="UserName" scope="session" value="New User" /> <P>Welcome <bean:write name="username" property="value"/!</P>    // 根据cookie创建一个新的Bean，如果用户名称已经存储在cookie中，它就不显示为一个新用户。

   
   
2. bean:define：有三个用途。
   一是定义新字符串常量：
   

   <bean:define id="foo" value="This is a new String"/>  <bean:define id="bar" value='<%= "Hello, " + user.getName() %>'/>  <bean:define id="last" scope="session" value='<%= request.getRequestURI() %>'/>

   
   二是复制一个现有的bean给新的bean：
   

   <bean:define id="foo" name="bar"/>     <bean:define id="baz" name="bop" type="com.mycompany.MyClass"/>  //定义脚本变量的类型，默认为Object

   
   三是复制一个现有的bean的属性给新的bean：
   

   <bean:define id="bop" name="user" property="role[3].name"/>   <bean:define id="foo" name="bar" property="baz" scope="request"  toScope="session"/>    //toScope属性指新bean的scope，默认为page

   上段代码的意思是把名为bar的bean的baz属性赋值给foo，foo的类型为String(默认)。
   
3. bean:include
   这个标签和bean:include标签和相似，不同点就是它定义了一个可以复用的脚本变量。用id属性命名一个新的脚本变量，还支持forward、href、page和transaction.属性，和html:link中的属性意义一样。
   

   <bean:include id="footerSpacer"  page="/long/path/footerSpacer.jsp"/>   然后你能够在多个地方(scope为page)调用：  <bean:write name="footerSpacer" />

   
   
4. bean:message
   用来实现对国际化的支持的一个标签，配合java.util数据包中定义的Locale和ResourceBundle类来完成这个任务，用java.text.MessageFormat类配置消息的格式。
       首先要指定资源文件的名称。这个文件会包含用默认语言编写的在程序中会出现的所有消息，这些消息以“关键字-值”的形式存储。文件需要存储在类路径下，路径要作为初始化参数传送给ActionServlet。
       实现国际化的规定：所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言-本地语言编写的消息。如果基本资源文件的名称是ApplicationResources.properties，那么用其他特定语言编写的资源文件的名称就应该是ApplicationResources_xx.properties(xx为ISO编码，如英语是en)。因此这些文件应包含相同的关键字，但关键字的值是用特定语言编写的。
       然后，ActionServlet的区域初始化参数必须与一个true值一起传送，这样ActionServlet就会在用户会话中的Action.LOCALE_KEY关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的web站点，它可以根据用户计算机上的设置的区域自动以相应的语言显示。
   
   使用特定的字符串来替换部分消息：
   

   在资源文件中的定义：info.myKey = The numbers entered are {0},{1},{2},{3}  标记的使用：<bean:message key="info.myKey" arg0="5" arg1="6" arg2="7" arg3="8"/>  Jsp页面的显示：The numbers entered are 5,6,7,8  // 最多支持4个参数

   
   
5. bean:page：把Jsp中的内部对象做为脚本变量。
   

   <bean:page id="requestObj" property="request"/>

   
   
6. bean:resource：获得应用程序的资源，这个资源可以是一个String或从java.io.InputStream中读入。使用ServletContext.getResource()ServletContext.getResourceAsStream() 方法检索web应用中的资源，如果在检索资源时发生问题，就会产生一个ruquest time异常。 

   <bean:resource id="webxml" name="/WEB-INF/web.xml"/>

   使用input属性时，资源会做为一个InputStream，如果不指定就被当成一个String。
   
   
7. bean:size：得到存储在array、collection或map中的数目，类型为java.lang.Integer。
   

   <bean:size id="count" name="employees" />

   
   
8. bean:struts：复制Struct 对象(三种类型)给新的bean，scope为page。
   

   <bean:struts id="form" formBean="CustomerForm"/>     <bean:struts id="fwd" forward="success"/>  <bean:struts id="map" mapping="/saveCustomer"/>

   
   
9. bean:write：以字符串形式输出bean的属性值。
   filter属性：设为true时，将HTML保留字转换为实体("<" 转换为 &lt);
   ignore属性：如果对象不存在，不会抛出异常。
   

   <bean:write name="userRegistration" property="email" scope="request"/>