(A18)Tapestry Core ：Configuring Tapestry-蒲公英云

(A18)Tapestry Core ：Configuring Tapestry

本文翻译出处 http://tapestry.apache.org/tapestry5/tapestry-core/guide/conf.html

本人翻译目的是用来学习Tapestry5的,共享出来希望大家批评指正。计划持续翻译。

chinajavawolf

配置 Tapestry

Tapestry 运行标准的 Java Servlet API 之上。对于 servlet 容器，像 tomcat,Tapestry 看来就像是一个 servlet 过滤器。这个 Tapestry 以很大的灵活性去匹配 URLs 不用要求很多 web.xml 内的配置。

web.xml

大部分配置出现在 servlet 部署描述符内， WEB-INF/web.xml

大多数配置是样板化的，对于所有应用都是相同的。

应用的特殊配置是确定应用的 root 包。 Tapestry 使用这个包名去定位你的包和组件类。

页面类必须放在 pages 子包里，组件必须放在 components 子包里。

你指定 root 包当作 context 参数。

PUBLIC “-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN”
“http://java.sun.com/dtd/web-app\_2\_3.dtd“ >
< web-app >
< display-name > My Tapestry Application display-name >
< context-param >
< param-name > tapestry.app-package param-name >
< param-value > org.example.myapp param-value >
context-param >
< filter >
< filter-name > app filter-name >
< filter-class > org.apache.tapestry.TapestryFilter filter-class >
filter >
< filter-mapping >
< filter-name > app filter-name >
< url-pattern > /* url-pattern >
filter-mapping >
web-app >

你可以以你想要得任何名称命名过滤器，尽管 ”app” 是一个通常的约定。

在这个例子里，页面类将被存入在 org.example.myapp.pages 包里（或者在它下面的子包里）。同样，组件类将被存放在 org.example.myapp.components 包里（或者在它下面的子包里）。

Tapestry 请求挑战 容器请求

Tapestry 过滤器匹配所有请求应用于 Tapestry ，并且传递 rest off 给 servlet 容器

在有命名冲突的时候,web应用里的真实文件优于Tapestry页。

Tapestry 承认 root URL,servlet 路径是一个简单的 ”/”, 并且呈现的应用页面是 ”Start” 页，如果它存在的话。

Tapestry IoC 配置

大部分其他的配制发生在你的应用模块建造者类里。这个应用模块建造者将经常定义新的服务，提供替换服务或者制造贡献（ contributions ）给服务配置。

Tapestry 在 services 包里寻找一个模块建造者类 ( 在 root 包下 ) 他由首字母大写的 < filter-name > （ App ）和附加的 ”Module” 构成。在前面的例子里，模块建造者类应该是 org.example.myapp.services.AppModule 。

如果有一个这样的类存在，他被增加到 IoC 注册中。在你的应用中没有模块这也不是个错误，尽管任何重要的应用都可能有一个模块。