用于定义组件的注解 | ||
注解 | 用法 | 说明 |
@Name | @Name("componentName") | 为一个类定义一个Seam组件。所有Seam组件都需要这个注解。 |
@Scope | @Scope(ScopeType.CONVERSATION) ScopeType为枚举: ●EVENT ●PAGE ●CONVERSATION ●SESSION ●BUSINESS_PROCESS ●APPLICATION ●STATELESS | 定 义默认的组件上下文。当范围没有显式定义时,默认的范围取决于组件的类型。对于无状态会话Bean,默认是STATELESS;对于Entity Bean和Stateful Session Bean,默认是CONVERSATION;对于JavaBean,默认是EVENT。 |
@Role | @Role(name="roleName",scope=ScopeType.SESSION) ●name:上下文变量名字。 ●scope:上下文变量的作用域。和@Scope一样。 | 允许一个Seam组件绑定多个上下文变量。@Name/@Scope注解定义一个”默认角色“。每一个@Role注解定义一个附加角色。 |
@Roles | @Roles({ @Role(name="user",scope=ScopeType.SESSION), @Role(name="currUser",scope=ScopeType.CONVERSARION) }) | 允许指定多个额外角色。 |
@BypassInterceptors | @BypassInterceptors | 取消在特定组件或一个组件方法上的所有拦截器。 |
@JndiName | @JndiName("my/jndi/name") | Seam查找EJB组件的JNDI名。如果没有显式指定JDNI名,Seam将使用由org.jboss.seam.core.init.jndiPattern指定的JNDI模式。 |
@Conversational | @Conversational | 声明一个对话作用域组件是对话式的,亦即只有长期运行的对话处于活动状态时,组件中的方法才可以被调用。 |
@Startup | @Scope(APPLICATION) @Startup(depends="org.jboss.seam.bpm.jbpm") depends:依赖于,指定在此之前必须启动的命名组件(如果已安装) | 指定某个Application Scope组件在初始化时立即启动。它主要用于特别的内置组件,用于引导象JNDI,数据源等等关键性的设施。 |
@Scope(SESSION) @Startup | 指定某个Session Scope组件在Session建立时立即启动。 | |
@Install | @Install(false) | 指定组件是否应该被默认安装。没有@Install注解表明该组件应该被安装。 |
@Install(dependencies="org.jboss.seam.bpm.jbpm") | 如果指定的依赖组件被安装,那么该组件才被安装。 | |
@Install(genericDependencies=ManageQueneSender.class) | 如果指定的类的某个实现组件被安装,那么该组件才安装。当无法确认依赖组件的唯一公开名时,这就有用了。 | |
@Install(classDependencies="org.hibernate.Session") | 如果指定的类在Classpath中,那么该组件才安装。 | |
@Install(precedence=BUILT_IN) | 指定组件的优先级别。如果具有相同名字的多个组件存在,具有高优先级才被安装, 定义的优先级别是 ●BUILT_IN:所有内置的Seam组件的优先级别 ●FRAMEWORK:用于扩展Seam的框架组件的优先级别 ●APPLICATION:应用程序的组件优先级别(默认优先级) ●DEPLOYMENT:在特定部署中重载应用程序组件的组件优先级别 ●MOCK:在测试时MOCK对象使用的优先级别 | |
@Synchronized | @Synchronized(timeout=1000) | 如果组件被多个客户端并发访问,Seam应该串行化请求。如果一个请求在给定的时间段内没有得到组件的锁,将抛出一个例外。 |
@Readonly | @Readonly | 声明JavaBean组件或者组件方法在调用结束时不要求状态复制。 |
@AutoCreate | @AutoCreate | 声明组件将被自动建立,即使客户端不定义create=true |