Struts2標籤庫經常使用標籤

基本概述

     對於一個MVC框架而言，重點是實現兩部分：業務邏輯控制器部分和視圖頁面部分。Struts2做爲一個優秀的MVC框架，也把重點放在了這兩部分上。控制器主要由Action來提供支持，而視圖則是由大量的標籤來提供支持。

     在JavaWeb中，Struts2標籤庫是一個比較完善，並且功能強大的標籤庫，它將全部標籤都統一到一個標籤庫中，從而簡化了標籤的使用，它還提供主題和模板的支持，極大地簡化了視圖頁面代碼的編寫，同時它還提供對ajax的支持，大大的豐富了視圖的表現效果。與JSTL(JSP Standard Library，JSP 標準標籤庫)相比，Struts2標籤庫更加易用和強大。

 

PS：使用標籤，須要引入Struts2核心jar包，在jsp頭部，加入<%@ taglib uri="/struts-tags" prefix="s" %>

 

Struts2的模板和主題

     Struts2的UI標籤都是基於模板和主題的。所謂模板，就是一些代碼，Struts2標籤使用這些代碼渲染生成相應的HTML代碼。模板是一個UI標籤的外在表現形式，而且每一個標籤都會有本身對應的模板。若是爲全部的UI標籤提供樣式和視覺效果類似的模板， 那麼這一系列的模板就造成了一個主題。

     Struts2 默認提供了4 種主題，分別爲 simple、xhtml、css_xhtml和Ajax。

• simple主題：這是最簡單的主題，使用該主題時，每一個UI標籤只生成最基本的HTML元素，沒有任何附加功能。
• xhtml主題：這是Struts2的默認主題，它對simple主題進行了擴展，提供了佈局功能、Label顯示名稱、以及與驗證框架和 國際化框架的集成。
• css_xhtml：該主題是xhtml的擴展，在對xhtml的基礎之上添加對CSS的支持和控制。
• Ajax：繼承自對xhtml，提供 Ajax支持。

 

這4種內建主題中，xhtml爲默認主題，但xhtml有必定的侷限性。由於它使用表格進行佈局，而且只支持每一行放一個表單項，這樣一來，一旦遇到複雜的頁面佈局，xhtml就難以勝任了。此時，就須要改變Struts2的默認主題。

     一般，經過設置常量struts.ui.theme，來改變默認主題，具體作法是在struts.xml或者struts.properties文件中增長相應的配置。好比想要設置使用simple的主題，那麼須要在struts.xml中增長以下配置:

<constant name="struts.ui.theme" value="simple"/>

或者在struts.properties文件中增長以下配置:

struts.ui.theme=simple

Struts2標籤庫的分類

 

控制標籤

if-elseif-else

<%--一、if elseif else的使用 --%>
<% //存入請求域中一個學生的成績
    request.setAttribute("score", 89);
%>
<!-- 判斷學生成績，輸出成績所對應的ABCD -->
<s:if test="#request.score>90">
    優秀
</s:if>
<s:elseif test="#request.score>80">
    良好
</s:elseif>
<s:else>
    通常
</s:else>

iterator

<s:iterator value="customers">
<%--s:iterator是struts2的一個迭代標籤，它的value屬性取值是一個OGNL表達式
var屬性：它的取值就是一個普通的字符串.
用了var：把每次遍歷的對象做爲value，把var的值做爲key，存入ContextMap中
沒用var：把每次遍歷的對象壓入棧頂，再下次遍歷以前彈棧(從棧頂移走)。
begin：開始遍歷的索引
end：遍歷的結束索引
step：遍歷的步長。 
status：計數器對象
    count 已經遍歷的集合元素個數
    index 當前遍歷元素的索引值
    odd   是否奇數行
    even  是否偶數行
    first 是否第一行
    last  是否最後一行
--%>
     <TR style="FONT-WEIGHT: normal; FONT-STYLE: normal; BACKGROUND-COLOR: white; TEXT-DECORATION: none">
          <TD><s:property value="custName"/></TD>
          <TD><s:property value="custLevel"/></TD>
          <TD><s:property value="custSource"/></TD>
          <TD><s:property value="custIndustry"/</TD>
          <TD><s:property value="custAddress"/></TD>
          <TD><s:property value="custPhone"/></TD>
     </TR>
</s:iterator>

數據標籤

property

• id：可選屬性，指定該元素的標識。
• default：可選屬性，若是要輸出的屬性值爲null，則顯示default屬性的指定值。
• escape：可選屬性，指定是否忽略HTML代碼。
• value：可選屬性，指定須要輸出的屬性值，若是沒有指定該屬性，則默認輸出ValueStack棧頂的值

<%-- 輸出值棧中的值 --%>
<s:property value="custName"/>

a

<%--使用struts2的超連接標籤發送請求：
    <s:a>鏈接內容</s:a>
    屬性：
    href：指定url路徑
    action：請求的動做名稱（類名）
    namespace：動做名稱所在的名稱空間
    id：指定id
    method：指定Action調用方法
 --%>
 <s:a action="addUIUser" namespace="/user">添加用戶</s:a>
 <s:a action="editUIUser" namespace="/user"> 編輯用戶
     <s:param name="userid" value="%{'1'}"></s:param>
 </s:a>
 <a href="${pageContext.request.contextPath}/user/editUIUser.action?userid=1">原始超連接標籤-編輯用戶</a>

debug

     debug標籤用於調試Struts2，使用它會在頁面中生成一個debug標籤，點擊後會顯示服務器各類對象信息，包括值棧、ContextMap等。

<s:debug/>

date

<%--s:date標籤的使用：
    它是用於格式化輸出日期
    name屬性：取值是一個ognl表達式，表示要格式化的日期對象
    format屬性：指定格式
    var屬性：取值是一個普通的字符串。
           把格式化好的日期字符串做爲value，把var的取值做爲key。存入contextMap中
--%>
<% request.setAttribute("myDate",new Date());
  /*  SimpleDateFormat format = new SimpleDateFormat("yyyy年MM月dd日");
   String date = format.format(new Date());
   out.println(date); */
%>
${requestScope.myDate}<br/>
<s:property value="#request.myDate"/>
<s:date name="#request.myDate" format="yyyy年MM月dd日" var="sdate"/>
<br>
格式化後的日期：<s:property value="#sdate"/>
<br/>
${sdate}

url

<%-- url標籤
    做用：用於存放一個路徑
    屬性：
        action：動做名稱
        namespace：名稱空間
        var：取值是一個普通字符串。他會把action和namespace組成一個url做爲value，把var的取值做爲一個key，存入contextMap中
--%>
<s:url action="addUIUser" namespace="/user" var="myurl"/>
<a href="<s:property value='#myurl'/>">添加用戶——url</a>

表單標籤

表單標籤的通用屬性

屬性名	主題	數據類型	說明
title	simple	String	設置表單元素的title屬性
disabled	simple	String	設置表單元素是否可用
label	xhtml	String	設置表單元素的label屬性
labelPosition	xhtml	String	設置label元素的顯示位置，可選值 : top 和 left(默認)
name	simple	String	設置表單元素的name屬性，與Action中的屬性名對應
value	simple	String	設置表單元素的值
cssClass	simple	String	設置表單元素的class
cssStyle	simple	String	設置表單元素的style屬性
required	xhtml	Boolean	設置表單元素爲必填項
requiredpositon	xhtml	String	設置必填標記(默認爲*)相對於label元素的位置，可選值：left 和right(默認)
tabindex	simple	String	設置表單元素的tabindex屬性

 

<form>標籤的經常使用屬性及描述

屬性名	是否必填	類型	說明
action	否	String	指定提交時對應的action，不須要action後綴
enctype	否	String	HTML表單enctype屬性
method	否	String	HTML表單method屬性
namespace	否	String	所提交action的命名空間

 

<s:submit>標籤的經常使用屬性

屬性名	是否必填	類型	說明
action	否	String	指定提交時對應的action
method	否	String	指定action中調用的方法

 

<s:password>標籤的經常使用屬性說明

屬性名	說明
Name	用於指定密碼輸入框的名稱
Size	用於指定密碼輸入框的顯示寬度，以字符數爲單位
MaxLength	用於限定密碼輸入框的最大輸入字符串個數
showPassword	是否顯示初始值，即便顯示也仍爲密文顯示，用掩碼代替

 

<s:radio>標籤的屬性及說明

屬性名	是否必填	類型	說明
List	是	Cellection、Map、Enmumeration、Iterator，array	用於生成單選框中的集合
listKey	否	String	指定集合對象中的哪一個屬性做爲選項的value
listValue	否	String	指定集合對象中的哪一個屬性做爲選項的內容

 

<s:checkboxlist>標籤的經常使用屬性及說明

屬性名	是否必填	類型	說明
name	否	String	指定該元素的name
list	是	Cellection、Map、Enmumeration、Iterator，array	用於生成多選框的集合
listKey	否	String	生成checkbox的value屬性
listValue	否	String	生成checkbox後面顯示的文字

 

select標籤的經常使用屬性及說明

屬性名	是否必填	類型	說明
list	是	Cellection、Map、Enmumeration、Iterator，array	用於生成下拉框的集合
listKey	否	String	生成選項的value屬性
listValue	否	Strmg	生成選項的顯示文字
headerKey	否	String	在全部的選項前再加額外的一個選項做爲其標題的value值
headerValue	否	String	顯示在頁面中header選項的內容
Multiple	否	Boolean	指定是否多選，默認爲 false
emptyOption	否	Boolean	是否在標題和真實的選項之間加一個空選項
size	否	Int	下拉框的高度，即最多能夠同時顯示多少個選項

案例

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib uri="/struts-tags" prefix="s" %>
<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title>註冊界面</title>
    </head>
    <body>
        <s:form action="register" namespace="">
            <s:textfield name="username" label="用戶名" key="Switch"/>       
            <s:password name="password" label="密碼"/>
            <s:radio name="gender" list="#{'0':'男','1':'女'}" label="性別" value="0" />
            <s:textfield name="age" label="年齡"/>
            <s:select name="city" list="#{'bj':'北京','sh':'上海','gz':'廣州','sz':'深圳'}" label="城市" headerKey="-1" headerValue="---請選擇城市---" emptyOption="true"/>
            <s:checkboxlist name="hibbies" list="#{'code':'寫代碼','algorithm':'算法','movie':'電影'}" label="愛好"/>
            <s:checkbox name="married" label="是否已婚" value="true" labelposition="left"/>
            <s:textarea name="description" label="自我介紹" rows="5" cols="20"/>
            <s:file name="phone" label="頭像"/>
            <s:submit value="提交"/>
            <s:reset value="重置"/>
        </s:form>
    </body>
</html>