【文章標題】在JSP中用自定義標籤實現集合的遍歷——山寨版<c:foreach>

【文章作者】曾健生

【作者郵箱】[email protected]

【作者QQ】190678908

*******************************************************************************

在JSTL中，標籤<c:foreach></c:foreach>可方便地遍歷集合或陣列，在瞭解了自定義標籤後，可動手實現<c:foreach>標籤的功能。

在編寫自定義標籤前，總要把實驗環境搭建好^-^

首先，定義一個

package com.javaeye.newjueqi;

/**

*實驗類Person

*/

publicclass Person {

private String name;

privateintage;

public String getName() {

returnname;

}

publicvoid setName(String name) {

this.name = name;

}

publicint getAge() {

returnage;

}

publicvoid setAge(int age) {

this.

}

}

既然是遍歷集合，那麼集合也是必須的，我們在測試頁面TestMyELTag.jsp上寫下如下的JSP程式碼，生成一個測試用途的集合ArrayList，集合中有三個元素

<%

//第1個人物件

Person p1=new Person();

p1.setName("Tom");

p1.setAge(23);

//第2個人物件

Person p2=new Person();

p2.setName("Mike");

p2.setAge(33);

//第3個人物件

Person p3=new Person();

p3.setName("Jack");

p3.setAge(43);

ArrayList list=new ArrayList();

list.add( p1 );

list.add( p2 );

list.add( p3 );

//把ArrayList儲存在application

pageContext.setAttribute( "PersonList", list );

%>

在編寫“山寨版”<c:foreach>前，有必要先了解一下正版的<c:foreach>的標準用法是怎麼樣的。如果用<c:foreach>遍歷上述的集合寫法如下：

<c:forEachitems="${pageScope.personlist}" var="per">

${per.name } -- ${per.age }<br>

</c:forEach>

<c:foreach>是迴圈控制，可以將集合中的成員循序遍歷一遍，執行方式為條件符合時，將會重複執行<c:foreach>的本體內容。

<c:foreach>中的屬性的含義：items是被迭代的集合物件，var是用來存放現在指向的成員，上面的程式碼執行後的結果如圖1所示：

圖1

我們實現一個自定義的標籤<newjueqi: myforEach>，模擬實現<c:forEach>的功能，用法如下：

<!-- 使用自定義標籤模擬實現<c:forEach>中集合的遍歷功能 -->

<newjueqi:myforEach items="${pageScope.personlist}" var="per">

${per.name } -- ${per.age }<br>

</newjueqi:myforEach>

效果如圖1 所示

下面是正式的程式碼：

1．編寫一個自定義的標籤類。

/**

*完成模擬<c:forEach>標籤遍歷集合的功能

*/

publicvoid doTag() throws JspException, IOException {

// 定義一個迭代器

Iterator i=null;

//如果集合是Colleciton型別

if( itemsinstanceof Collection )

{

//獲取Collection的迭代器

i=( (Collection)items).iterator();

}

//如果集合是陣列型別

elseif( itemsinstanceof Object[] )

{

//用Arrays的靜態方法asList把陣列轉換為一個List集合，由於asList接受的引數

//是可變引數，所以為了防止轉換出錯必須要把傳入的引數強制為陣列

i=Arrays.asList((Object[])items).iterator();

}

else

{

thrownew RuntimeException("不能轉換");

}

//進行迭代

while( i.hasNext() )

{

//取得集合中迭代器指向的物件

Object obj=i.next();

//用setAttribute方法把物件和指定的變數連線起來

//例如標籤中有屬性var="per",標籤體中有EL表示式式：$(per.name)

//寫了下面的一句話後EL表示式就可理解為obj.getName(),表示呼叫的是

//物件相應的getXXX()

pageContext.setAttribute( var, obj );

//執行標籤體的內容

jspFragment.invoke( null );

}

}

2.根據自定義標籤的寫法，首先寫一個tld檔案配置自定義標籤。由於標籤<newjueqi: myforEach>是帶有屬性和標籤體的，所以編寫如下：

<!-- 配置一個自定義標籤 -->

<tag>

<!-- 指定自定義標籤的名字 -->

<name>myforEach</name>

<!-- 指定當前標籤關聯的 Java 類 -->

<tag-class>com.javaeye.newjueqi.MyForEach</tag-class>

<!-- 指定標籤體的型別: -->

<body-content>scriptless</body-content>

<attribute>

<name>items</name>

<required>true</required>

<rtexprvalue>true</rtexprvalue>

</attribute>

<attribute>

<name>var</name>

<required>true</required>

<rtexprvalue>true</rtexprvalue>

</attribute>

</tag>

3.在JSP頁面中匯入標籤。

<%@ taglib prefix="newjueqi" uri="http://newjueqi.javaeye.com/myforEach" %>

4.在JSP頁面中使用自定義標籤測試實際的效果。

<!-- 使用自定義標籤模擬實現<c:forEach>中集合的遍歷功能 -->

<newjueqi:myforEach items="${pageScope.personlist}" var="per">

${per.name } -- ${per.age }<br>

</newjueqi:myforEach>

執行的實際效果如圖 1所示

結語：這個自定義標籤遍歷集合的功能還不完善，譬如不能遍歷Map集合中的元素，但它們的編寫思路是一致的， Map集合中需要進一步封裝物件。