1.1 Bean标记
这个标记库中包含用于定义新bean、访问bean及其属性的标记。Struts框架提供了多种自定义标记用来在JSP页中处理JavaBean。这些标记被封装在一个普通的标记库中,在文件struts-bean.tld中定义了它的标记库描述器。Bean标记库将标记定义在四个子类别中:
- 创建和复制bean的标记
- 脚本变量定义标记
- bean翻译标记
- 消息国际化标记
1.1.1 Bean复制标记
可定义新bean,可复制现有bean,还可从现有bean复制属性。
<bean:define>标记用来:
- 定义新字符串常数
- 将现有的bean复制到新定义的bean对象
- 复制现有bean的属性来创建新的bean
<bean:define>标记属性:
属性 | 描述 |
Id | 新定义的bean脚本变量名称,必须设置 |
Type | 定义引入脚本变量的类 |
Value | 为id属性定义的脚本变量分配一个新的对象 |
Name | 目标bean的名称。若value属性没有设置,这个属性就必须设置 |
property | Name属性定义的bean的属性名称,用来定义新的bean |
Scope | 源bean的作用域。若没有设置,搜索范围是从页作用域到应用程序作用域 |
toScope | 目标bean的作用域。若没有设置,默认值是页作用域 |
例如:定义一个bean:
<bean:define id=”test” value=”this is a test”/>
源bean在页作用域中被拷贝大哦请求作用域中的另一个bean:
<bean:define id=”targetBean” name=”sourceBean”
scope=”page” toScope=”request”/>
1.1.2 定义脚本变量的标记
从多种资源中定义和生成脚本变量,这些资源包括cookie,请求参数,HTTP标头等等。属性如下:
属性 | 描述 |
Id | 脚本变量和要定义的页作用域属性的名称 |
Name | cookie/标头/参数的名称 |
multiple | 如果这个属性设置了任意一个数值,所有匹配的cookie都会被积累并存储到一个Cookie[](一个数组)类型的bean里。若无设置,指定cookie的第一个值将作为Cookie类型的值 |
Value | 如果没有匹配的cookie或数值,就返回这个属性指定的默认值 |
例如:
<bean:cookie id=”myCookie” name=”userName”/>
脚本变量名称是myCookie,用来创建这个属性的cookie的名称是userName。
<bean:header id=”myHeader” name=”Accept-Language”/>
脚本变量名称是myHeader,请求标头的名称是Accept-Language.
<bean:parameter id=”myParameter” name=”myParameter”>
脚本变量名称是myPatameter,它保存的请求参数的名称也是myParameter.
<bean:include>标记将对一个资源的响应进行检索,并引入一个脚本变量和字符串类型的页作用域属性。这个资源可以是一个页,一个ActionForward或一个外部URL。与<jsp:include>的不同是资源的响应被存储到一个页作用域的bean中,而不是写入到输出流。属性如下:
属性 | 描述 |
Id | 脚本变量和要定义的页作用域属性的名称 |
Page | 一个内部资源 |
forward | 一个ActionForward |
Href | 要包含的资源的完整URL |
例如:
<bean:include id=”myInclude” page=”MyJsp?x= 1 ” />
脚本变量的名称是myInclude,要检索的响应来自资源MyJsp?x=1。
<bean:resource>标记将检索web应用中的资源,并引入一个脚本变量和InputStream或字符串类型的页作用域属性。如果在检索资源时发生问题,就会产生一个请求时间异常。属性如下:
属性 | 描述 |
Id | 脚本变量和要定义的页作用域属性的名称 |
Name | 资源的相对路径 |
Input | 如果这个属性不存在,资源的类型就是字符串 |
例如:
<bean:resource id=”myResource” name=”/WEB-INF/images/myResource.xml”/>
脚本变量的名称是myResource,要检索的资源的名称是myResource.xml。
1.1.3 显示Bean属性
标记库中定义了<bean:write>标记,用来将bean的属性输送到封装的JSP页写入器。这个标记与<jsp:getProperty>类似,属性如下:
属性 | 描述 |
Name | 要进行属性显示的bean的名称 |
property | 要显示的属性的名称。如果这个属性类有java.beans.PropertyEditor,getAsText()或toString 方法会被调用 |
Scope | Bean的作用域,若没有设置,搜索范围是从页到应用程序作用域 |
Filter | 如果设置true,属性中的所有特殊HTML字符都将被转化为相应的实体引用 |
Ignore | 如果设置false,当发现属性时会产生一个请求时间异常,否则返回null |
例如:
<bean:write name=”myBean” property=”myProperty” scope=”request”
filter=”true”/>
myBean的属性myProperty将会被显示,作用域为请求,如果发现任何HTML特殊字符都将被转化为相应的实体引用。
1.1.4 消息标记和国际化
strtus框架支持国际化和本地化。用户在他们的计算机中定义自己所在的区域,当web应用程序需要输出一条消息时,它将引用一个资源文件,在这个文件中所有的消息都使用了适当的语言。一个应用程序可能提供了很多资源文件,每个文件提供了用不同语言编写的消息。如果没有找到所选语言的资源文件,就将使用默认的资源文件。
struts框架对国际化的支持是使用<bean:message>标记,以及使用java.util数据包中定义的Locale和ResourceBundle类来实现Java2平台对这些任务的支持。Java.text.MessageFormat类定义的技术可以支持消息的格式。利用此功能,开发人员不需了解这些类的细节就可进行国际化和设置消息的格式。
用strtus实现国际化和本地化:
第一步要定义资源文件的名称,这个文件会包含用默认语言编写的在程序中会出现的所有消息。这些消息以“关键字-值”的形式存储,如下:
error.validation.location = The entered location is invalid
这个文件需要存储在类的路径下,而且它的路径要作为初始化参数传送给ActionServlet作为参数进行传递时,路径的格式要符合完整Java类的标准命名规范。比如,如果资源文件存储在WEB-INF/classes目录中,文件名是ApplicationResources.properties,那么需要传递的参数值是ApplicationResources。如果文件在WEB-INF/classes/com/test中,那么参数值就应该是com.test. ApplicationResources.
为了实现国际化,所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言-本地语言编写的消息。如果基本资源文件的名称是ApplicationResources.properties,那么用其他特定语言编写的资源文件的名称就应该是ApplicationResources_xx.properties(xx为ISO编码,如英语是en)。因此这些文件应包含相同的关键字,但关键字的值是用特定语言编写的。
ActionServlet的区域初始化参数必须与一个true值一起传送,这样ActionServlet就会在用户会话中的Action.LOCALE_KEY关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的web站点,它可以根据用户计算机上的设置的区域自动以相应的语言显示。
我们还可以使用特定的字符串来替换部分消息,就象用java.text.MessageFormat的方法一样:
error.invalid.number = The number {0} is valid
我们可以把字符串{0}替换成任何我们需要的数字。<bean:message>标签属性如下:
属性 | 描述 |
Key | 资源文件中定义消息关键字 |
Locale | 用户会话中存储的区域对象的属性名称。若没有设置,默认值是Action.LOCALE_KEY |
Bundle | 在应用程序上下文中,存储资源对象的属性的名称。如果没有设置这个属性,默认值是Action.MESSAGE_KEY |
arg0 | 第一个替换参数值 |
arg1 | 第二个替换参数值 |
arg2 | 第三个替换参数值 |
arg3 | 第四个替换参数值 |
例如:资源文件中定义了一个消息:
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