javax.enterprise.inject
Annotation Type Produces


@Target(value={METHOD,FIELD})
@Retention(value=RUNTIME)
@Documented
public @interface Produces

Identifies a producer method or field. May be applied to a method or field of a bean class.

A producer method must be a non-abstract method of a managed bean class or session bean class. A producer method may be either static or non-static. If the bean is a session bean, the producer method must be either a business method of the EJB or a static method of the bean class.

 public class Shop {
    @Produces @ApplicationScoped 
    @Catalog @Named("catalog") 
    List<Product> getProducts() { ... }
    ...
 } 
 

A producer field must be a field of a managed bean class or session bean class. A producer field may be either static or non-static. If the bean is a session bean, the producer field must be a static field of the bean class.

 public class Shop { 
    @Produces @ApplicationScoped 
    @Catalog @Named("catalog") 
    List<Product> products = ...;
    ...
 } 
 

If a producer method sometimes returns a null value, or if a producer field sometimes contains a null value when accessed, then the producer method or field must have scope @Dependent.

A producer method return type or producer field type may not be a type variable.

If the producer method return type or producer field type is a parameterized type, it must specify an actual type parameter or type variable for each type parameter.

If the producer method return type or producer field type is a parameterized type with a type variable, it must have scope @Dependent.

A producer method may have any number of parameters. All producer method parameters are injection points.

public class OrderFactory {
 
    @Produces @ConversationScoped
    public Order createCurrentOrder(@New(Order.class) Order order, @Selected Product product) {
       order.setProduct(product);
       return order;
    }
 
 }

A bean may declare multiple producer methods or fields.

Producer methods and fields are not inherited by bean subclasses.

Interceptors and decorators may not declare producer methods or fields.

Author:
Gavin King, Pete Muir
See Also:
@Disposes



Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41