tapestry注释介绍Annotations

tapestry在很大程度上依赖于Java注释，而不是XML文件，几乎它的所有配置。（另外，Tapestry的方法命名约定的意思是你在许多情况下不必使用注释）。

Tapestry的注解根据他们的目的被分为几个不同的模块。

Tapestry Core and IoC 注释

大多数的tapestry注释(Tapestry Core andIoC的定义)是非常具体的Tapestry组件或Tapestry的IoC服务：

Tapestry Component 注释

注释类型概要ActivationRequestParameter标志着一个领域一直保存在URL（不是组件）的页面激活的context。AfterRender标记注解的方法与AfterRender阶段。AfterRenderBody对应到BeforeRenderBody，允许额外的标记渲染一个组件体后，在此之前呈现的其余部分的组件的模板。AfterRenderTemplate对应到BeforeRenderTemplate，允许额外的标记后使组件的模板。BeforeRenderBody标记方法被调用组件时，渲染状态机在body元素出现在组件的模板。BeforeRenderTemplate相关联的组件，有一个模板，该阶段被调用来允许组件装饰它的一些附加的标记的模板。BeginRender此方法，应在开始呈现组件执行标记注释。BindParameter指定一个mixin这个必须的值对应于包含的组件的参数中的一个字段。Cached表示方法应该只进行一次计算和缓存的结果。CleanupRender标记注释的组件渲染状态机与终端阶段的组件方法。Component在另一个组件用于定义一个嵌入式组件。ContentType注释页面上的组件，用于识别的内容，返回页面的类型。DiscardAfter标记页面或组件的方法，放弃所有的持久化字段的变化。Environmental组件类定义一个字段，在运行时从环境服务替换一个只读值。Events注释应用到组件记录一个组件可能会触发什么事件。HeartbeatDeferred标记组件的方法，推迟Heartbeat结束。Id可选的注释，用于注射，它的存在是为了提供一个对象的id时，它不能确定通过其他方式（如从字段名）。ImmutableSessionPersistedObject标记注释可以放置在一个会话持久化对象，对象是不可改变的，因此不需要恢复到会话的请求。Import控制导入JavaScript栈和库以及样式表的注释。InjectComponent允许在模板中定义的组件被注入为只读属性。InjectContainer用于注入的组件包含该组件。InjectPage允许一对一页（在页面的根组件）被注入到另一个组件是一个只读字段。Log标记注释组件的方法，使调试级别的日志记录。Meta允许的每个组件的元数据的规范。Mixin定义一个实现mixin的一个组成部分。MixinAfter标记注解应用到一个mixin, mixin的渲染状态的行为声明被推迟到的mixin是连接组件的行为。MixinClasses用于连接一个或多个实例，混入一个嵌入式组件。Mixins用于连接一个或多个实例混入到一个嵌入式组件。OnEvent标记作为一个客户端事件处理程序的方法。PageActivationContext页面激活context处理程序（onActivate和onPassivate）建立一个字段的注释。PageAttached已过时。在Tapestry5.3开始不再使用。PageDetached已过时。在Tapestry5.3开始不再使用。PageLoaded使用方法注释的页面完全加载后，应调用的方法。PageReset当一个页面被重置的方法被调用的标记注释。Parameter注释放在​​一个字段，以表明它是一个组件参数。PathInject注解，基于路径的asset注入结合使用。Meta允许的每个组件的元数据的规范。Persist持续性，这意味着其价值仍然存在，从一个请求到下一个标识字段。Property字段的存取方法（getter和setter）的注释。RequestParameter注释可能被放置在事件处理程序方法的参数。Retain已过时。在Tapestry5.2开始不再使用。Secure一个标记注释，指出有问题的页面可能只通过HTTPS访问。Service适用Inject注解结合，以确定一个服务名称，而不是按类型。SessionAttribute用于映射一个页面或组件的属性值存储在会话中。SessionState标记注释的领域，这是一个会话状态对象（SSO）的ApplicationStateManager控制。SetupRender标记注释的方法，应执行在SetupRender阶段。SupportsInformalParameters用来识别一个组件，它可以支持非正式参数。WhitelistAccessOnly标识的页面应该只从客户端访问的白名单。

Tapestry IoC 注释

注释类型概要Advise一个注解，可以放置一个模块上的顾问方法。Autobuild通过ObjectLocator.autobuild（class）,指示要建的值应该是一个自动生成实例的类型进行注射。Contribute一个注解，可以放置在一个模块的贡献者的方法。Decorate一个注解，可以放置在一个模块的装饰方法。EagerLoad实现标记注释放在服务应急切地加载一个服务构建器方法：如果一个服务方法被调用。Inject这个注解服务是依赖注入到任意的Java Bean的方法相关的操作的东西。InjectResource已过时。在Tapestry5.3开始不再使用。InjectService注释使用的服务构建方法的参数被注入到服务构建器方法通过参数识别服务。IntermediateType用于引导tapestry强迫从一个原始类型时，一个字段或者参数的类型迫使tapestry中间型。Local限制搜索可能的服务只是同一个模块中包含的服务被注入一个特殊的标记注释。Marker用于定义一个或多个标记注释的服务实现。Match可选的但经常使用的注释，用来定义哪些服务适用于装饰服务的装饰方法。NotLazy标记方法，特别不是懒加载，即使在同一个界面的其他方法被建议为懒加载。Optional在一个模块作为可选的服务标记贡献法：如果不匹配的贡献与实际的服务，它是不是一个错误。Order与服务的装饰方法来控制装饰品出现的顺序。PostInjection注射后应调用的方法注释。PreventServiceDecoration一个服务标记不符合装饰。Primary注释标记用来表示一种服务，是一些常见的接口的主实例。Scope一个可选的注释，可以被放置在一个模块服务的建设方法，或实现类（使用服务时绑定）。ServiceId一个可选的注释，可以被放置在一个模块服务的建设方法，或实现类（当使用服务绑定通过的ServiceBinder）。Startup一个注解，可以放置在一个模块的启动方法。SubModule连接到模块类，此批注的其他模块类的，应该也可以添加到注册表。Symbol用于注射的符号值，通过符号名。UsesConfiguration一个文档接口服务的服务接口，一个无序的配置，以确定类型的贡献。UsesMappedConfiguration放在一个文档接口上有一个映射配置的服务接口，以确定类型的键（通常是一个字符串）和ofcontribution的类型。UsesOrderedConfiguration放在一个文档接口，服务接口的服务，有一个有序的配置，以确定该类型的贡献。UseWith诠释记录tapestry提供注解可以使用的context。Value注入一个文本值，而不是服务结合使用。

hibernate注释

注释类型概要CommitAfter标记为事务性的服务（或组件的方法）。