Struts标记--bean

    技术2022-05-11  60

    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数据包中定义的LocaleResourceBundle类来实现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(xxISO编码,如英语是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

     

    最新回复(0)