Bundled Master

  • View
    154

  • Download
    11

Embed Size (px)

Text of Bundled Master

Seam Documentation

Reference Guide3.1.0.Final

1. Credits ......................................................................................................................... 1 1.1. List of contributors .............................................................................................. 1 1.2. Would you like to contribute? .............................................................................. 2 2. Seam ............................................................................................................................ 5 2.1. Overview ............................................................................................................ 5 2.2. Seam Bill of Materials ......................................................................................... 5 I. Solder ............................................................................................................................ 9 Introduction ............................................................................................................... xi 3. Getting Started .................................................................................................. 13 3.1. Maven dependency configuration ............................................................... 13 3.2. Transitive dependencies ............................................................................ 14 3.3. Pre-Servlet 3.0 configuration ...................................................................... 14 4. Enhancements to the CDI Programming Model ................................................. 17 4.1. Preventing a class from being processed ................................................... 17 4.1.1. @Veto ........................................................................................... 17 4.1.2. @Requires ..................................................................................... 18 4.2. @Exact .................................................................................................... 18 4.3. @Client .................................................................................................... 4.4. Named packages ...................................................................................... 4.5. @FullyQualified bean names ..................................................................... 5. Annotation Literals ............................................................................................ 6. Evaluating Unified EL ........................................................................................ 6.1. @Resolver ................................................................................................ 7. Injecting Resources and System Properties ...................................................... 7.1. Resource Loading ..................................................................................... 7.1.1. Extending the Resource Loader ...................................................... 7.2. System Properties ..................................................................................... 8. Logging, redesigned .......................................................................................... 8.1. JBoss Logging: The foundation .................................................................. 8.2. Solder Logging: Feature set ...................................................................... 8.3. Typed loggers ........................................................................................... 8.4. Native logger API ...................................................................................... 8.5. Typed message bundles ........................................................................... 8.6. Implementation classes ............................................................................. 8.6.1. Generating the implementation classes ............................................ 8.6.2. Including the implementation classes in Arquillian tests ..................... 9. Annotation and AnnotatedType Utilities ............................................................ 9.1. Annotated Type Builder ............................................................................. 9.2. Annotation Instance Provider ..................................................................... 9.3. Annotation Inspector ................................................................................. 9.4. Synthetic Qualifiers ................................................................................... 9.5. Reflection Utilities ..................................................................................... 10. Obtaining a reference to the BeanManager ...................................................... 11. Bean Utilities .................................................................................................... 19 19 20 23 25 25 27 27 28 28 31 31 33 33 35 36 37 37 39 41 41 42 43 44 45 47 49

iii

Seam Documentation

12. Property Utilities .............................................................................................. 51 12.1. Working with properties ........................................................................... 51 12.2. Querying for properties ............................................................................ 12.3. Property Criteria ...................................................................................... 12.3.1. AnnotatedPropertyCriteria ............................................................. 12.3.2. NamedPropertyCriteria .................................................................. 12.3.3. TypedPropertyCriteria ................................................................... 12.3.4. Creating a custom property criteria ................................................ 12.4. Fetching the results ................................................................................. Unwrapping Producer Methods ....................................................................... Default Beans .................................................................................................. Generic Beans ................................................................................................. 15.1. Using generic beans ............................................................................... 15.2. Defining Generic Beans ........................................................................... Service Handler ................................................................................................ XML Configuration Introduction ....................................................................... 17.1. Getting Started ........................................................................................ 52 53 53 53 54 54 54 57 59 61 61 64 67 69 69

13. 14. 15.

16. 17.

17.2. The Princess Rescue Example ................................................................ 71 18. Solder Config XML provider ............................................................................ 73 18.1. XML Namespaces ................................................................................... 73 18.2. Adding, replacing and modifying beans .................................................... 74 18.3. Applying annotations using XML .............................................................. 75 18.4. Configuring Fields ................................................................................... 76 18.4.1. Initial Field Values ........................................................................ 76 18.4.2. Inline Bean Declarations ............................................................... 78 18.5. Configuring methods ............................................................................... 79 18.6. Configuring the bean constructor .............................................................. 81 18.7. Overriding the type of an injection point .................................................... 82 18.8. Configuring Meta Annotations .................................................................. 82 18.9. Virtual Producer Fields ............................................................................ 83 18.10. More Information ................................................................................... 84 Introduction .......................................................................................................... lxxxv 19. Installation ....................................................................................................... 87 19.1. Pre-Servlet 3.0 configuration .................................................................... 87 20. Servlet event propagation ................................................................................ 89 20.1. Servlet context lifecycle events ................................................................ 89 20.2. Application initialization ............................................................................ 90 20.3. Servlet request lifecycle events ................................................................ 91 20.4. Servlet response lifecycle events ............................................................. 93 20.5. Servlet request context lifecycle events .................................................... 94 20.6. Session lifecycle events ........................................................................... 96 20.7. Session activation events ........................................................................ 96 21. Injectable Servlet objects and request state .................................................... 99 21.1. @Inject @RequestParam ........................................................................ 99

iv

21.2. @Inject @HeaderParam ........................................................................ 100 21.3. @Inject Servle