JBoss Seam 中用于双向注入的注解

JBoss Seam 中用于双向注入的注解

用于双向注入的注解
注解	用法	说明
@In   ●value — 指定上下文变量名。默认是组件属性名。可选地，指定一个JSF EL表达式，放在 #{...} 符号中。 ●create — 指定若上下文变量名在所有上下文中均未定义，Seam应该创建一个组件作为上下文变量，名字即为所要求的名字。默认为false。 ●required — 指定若上下文变量名在所有上下文中均未定义，Seam应抛出异常。	@In	在每次组件调用开始时，从上下文变量注入组件属性。如果上下文变量是null，那么一个异常将被抛出。
@In(required=false)	在每次组件调用开始时，从上下文变量注入组件属性。上下文变量可以是null。
@In(create=true)	在每次组件调用开始时，从上下文变量注入组件属性。如果上下文变量是null，那么Seam实例化这个组件。
@In(value="contextVariableName")	显式指定上下文变量的名字，而不再使用注解定义的实例变量名。
@In(value="#{customer.addresses['shipping']}")	在每次组件调用开始时，用一个JSF EL表达式的计算结果来注入组件属性。
@Out   ●value — 指定上下文变量名。默认为组件属性名。 ●required — 指定若注射出时组件属性为null，Seam应抛出异常。	@Out	在调用结束后注射出Seam组件属性到上下文变量。若属性为null，则抛出一个异常。
@Out(required=false)	在调用结束后注射出Seam组件属性到上下文变量。属性可以为null。
@Out(scope=ScopeType.SESSION)	在调用结束后注射出非Seam组件属性到指定scope。或者，若没有明确指定scope，则使用此 @Out 属性所属组件的scope。（如果此组件是无状态的，则使用 EVENTscope 。）
@Out(value="contextVariableName")	显式指定上下文变量名，而非使用注解中指定的实例变量名。
@Unwrap   支持 管理器组件（manager component） 模式，在该模式中一个Seam组件管理一些其他将被注入的class实例的生命周期。它在组件的getter方法中出现。	@Unwrap	指定注解的getter方法返回的对象是被注入的，而非组件实例本身。
@Factory   支持 工厂组件（factory component） 模式，在该模式中，一个Seam组件负责初始化上下文变量值。 如果出现非faces的request，在渲染response的时候，它用于初始化所需要的状态特别有用。它出现在组件方法中。 ●value — 指定上下文变量值。若为getter方法，默认为JavaBean属性名。 ●scope — 指定Seam应绑定返回值的作用域。仅针对于返回一个值的工厂方法有意义。 ●autoCreate — 无论什么时候请求变量，此工厂方法将自动被调用，即使@In未指定create=true。	@Factory("processInstance") public void createProcessInstance() { ... }	说明当上下文变量没有值时，此组件的方法被用来初始化上下文变量值。它用于返回值是 void 的方法。
@Factory("processInstance", scope=CONVERSATION) public ProcessInstance createProcessInstance() { ... }	声明方法返回一个值，当上下文变量没有值时Seam应使用此值初始化命名上下文变量值。它用于返回一个值的方法。 若没有指明scope，则使用 @Factory 方法所在组件的scope（除非组件是无状态的，则使用 EVENT 上下文）。
@Logger   该注解让你注入一个 日志（Log）	@Logger("categoryName")   value — 指定日志category。默认是组件类名。	使用 org.jboss.seam.log.Log 的实例注入一个组件字段。对于Entity Bean，该字段必须声明为static。
@RequestParameter   该注解让你注入一个request参数值	@RequestParameter("parameterName")   value —指定request参数名。默认为组件属性名。	将request的参数值注入组件属性。基本类型的转化被自动地完成。