read-Atleap-3-Tiles学习
read-Atleap-Tiles学习
v Atleap没有像AppFuse那样使用sitemesh分离显示格式和布局，而是采用了struts的Tiles.
运行用户将内容和布局分离
模板就是一个使用JSP自定义标记符库描述页面布局的JSP页面。
模板充当的定义的角色，它定义了应用程序的外观而不指定内容。在运行期，用户可以将内容插入到模板页面，并且，一个或多个页面可以使用同一个模板。
tiles-config.xml时定义配置文件
<!-- Core layout -->
<!—definition标记用来创建一个tile作为一个定义的bean,在要求的scope内，该
Bean以指定的id保存
-->
<definition name=
".coreLayout" path="/WEB-INF/pages/layouts/core/coreLayout.jsp">
<!—put标记将属性传递给一个tile组件-->
<put name="titleKey"/>
<put name="content" />
<!—pubList创建一个列表，该列表作为属性传递给
列表元素使用add标记添加。Value是用来添加的值，可以是String或Object。
-->
<putList name="leftLayoutBlocksList">
<add value=".loginForm" />
<add value=".core.menu" />
</putList>
<putList name="rightLayoutBlocksList">
<add value=".searchForm" />
<add value=".switchLocaleForm" />
<add value=".editModeForm" />
</putList>
<!-- Default Javascript Files -->
<putList name="layoutScripts">
<add value="/scripts/core/klayers.js"/>
<add value="/scripts/core/global.jsp"/>
<add value="/scripts/core/validator.jsp"/>
<add value="/scripts/core/helptip.js"/>
<add value="/scripts/core/luceneQueryValidator.jsp"/>
</putList>
<!-- Default Stylesheet Files -->
<putList name="layoutStyles">
<add value="/styles/core/core.css"/>
<add value="/styles/core/helptip.css"/>
</putList>
</definition>
以下语句声明在页面使用一个属性值
<tiles:useAttribute id="leftLayoutBlocks" name="leftLayoutBlocksList"
classname="java.util.List" ignore="true"/>
以下语句声明创建一个组件定义
<tiles:insert definition="${layoutBlock}" />
tiles:insert插入一个tile组件，insert标记负责将内容插入到一个页面中。
<c:forEach items="${leftLayoutBlocks}" var="layoutBlock">
<tiles:insert definition="${layoutBlock}" />
</c:forEach>
以下语句获取由put标记放在请求作用域的内容
<tiles:get name="content" />
v Atleap 中新闻列表显示之Struts Tiles分析
i) Tiles中的coreLayout定义
<definition name=
".coreLayout" path="/WEB-INF/pages/layouts/core/coreLayout.jsp">
<!—put标记将属性传递给一个tile组件-->
<put name="titleKey"/>
<!—需要显示的主体内容页面属性，在此为要显示新闻列表-->
<put name="content" />
ii) 进入根下的index.jsp页面
<logic:redirect action="index" />
iii) struts-config.xml中的配置
<!-- Action to index -->
<action path="/index" type="org.apache.struts.actions.ForwardAction"
parameter=".core.index" />
iv) tiles-config.xml中的配置
<!--.core.index继承于.coreLayout-->
<definition name=".core.index" extends=".coreLayout">
<put name="content" value="/WEB-INF/pages/core/index.jsp" />
</definition>
v) /WEB-INF/pages/core/index.jsp
<%@ include file="/WEB-INF/pages/common/taglibs.jsp"%>
<atleap:errors />
<a href="javascript:void(printSpecial())">
<img src="<c:url value="/images/core/print.gif" />" width="17" height="13" border="0" />
</a>
<div id="printReady">
<atleap:contentIterator identifier="body" index="index" ignore="true">
<atleap:content identifier="body" index="${index}"/>
<br />
</atleap:contentIterator>
</div>
<div>
<!—insert标记符提供一个布局，并且允许用put标记传递内容给布局-->
<tiles:insert definition=".news.list" />
</div>
vi) Tiles-config.xml中.news.list"的配置
<definition name=".news.list" path="/WEB-INF/pages/news/newsList.jsp" controllerClass="com.blandware.atleap.webapp.action.news.NewsListController" />
vii) /WEB-INF/pages/news/newsList.jsp：真正显示新闻列表的地方
<%@ include file="/WEB-INF/pages/common/taglibs.jsp"%>
<atleap:constants className="com.blandware.atleap.webapp.util.news.NewsModuleWebConstants" var="NEWS_ITEMS_COLLECTION_KEY" />
<bean:size id="newsItemsCollectionSize" collection="${requestScope[pageScope.NEWS_ITEMS_COLLECTION_KEY]}" />
<c:if test="${newsItemsCollectionSize > 0}">
<h3>
<bean:message key="news.listItems" />
</h3>
</c:if>
<table cellpadding="0" cellspacing="0" border="0" class="tableView">
<c:forEach var="newsItem" items="${requestScope[pageScope.NEWS_ITEMS_COLLECTION_KEY]}">
<tr>
<th align="left">
<atleap:formatDate value="${newsItem.publicationDate}" /> <atleap:fieldValue valueMap="${newsItem.title}" ignore="true" />
</th>
</tr>
<tr>
<td>
<atleap:edit action="/news/callUpdateItem?id=${newsItem.id}">
<div>
<atleap:fieldValue valueMap="${newsItem.annotation}" ignore="true" filter="false" />
</div>
<div>
<atleap:message key="button.newsItemForm.moreInfo" var="moreInfoMsg"/>
<a href="${ctxPath}${newsItem.uri}" title="${moreInfoMsg}">
${moreInfoMsg}
</a>
</div>
</atleap:edit>
</td>
</tr>
</c:forEach>
</table>
<c:if test="${newsItemsCollectionSize > 0}">
<html:link action="news/showArchive"><bean:message key="news.archive" /></html:link>
</c:if>