SeamFramework.orgCommunity Documentation

Seam

1. Seam
1.1. Overview
I. Seam Configuration
2. Seam Config Introduction
2.1. Getting Started
2.2. The Princess Rescue Example
3. Seam Config XML provider
3.1. XML Namespaces
3.2. Adding, replacing and modifying beans
3.3. Applying annotations using XML
3.4. Configuring Fields
3.4.1. Initial Field Values
3.4.2. Inline Bean Declarations
3.5. Configuring methods
3.6. Configuring the bean constructor
3.7. Overriding the type of an injection point
3.8. Configuring Meta Annotations
3.9. Virtual Producer Fields
3.10. Notes on Configuring Interceptors
3.11. More Information
II. Seam Persistence
4. Seam Persistence Reference
4.1. Introduction
4.2. Getting Started
4.3. Transaction Management
4.3.1. Configuration
4.3.2. Declarative Transaction Management
4.4. Seam-managed persistence contexts
4.4.1. Using a Seam-managed persistence context with JPA
4.4.2. Seam-managed persistence contexts and atomic conversations
4.4.3. Using EL in EJB-QL/HQL
4.4.4. Setting up the EntityManager
III. Seam Servlet
Introduction
5. Installation
5.1. Maven dependency configuration
5.2. Pre-Servlet 3.0 configuration
6. Servlet event propagation
6.1. Servlet context lifecycle events
6.2. Application initialization
6.3. Servlet request lifecycle events
6.4. Servlet response lifecycle events
6.5. Servlet request context lifecycle events
6.6. Session lifecycle events
6.7. Session activation events
7. Injectable Servlet objects and request state
7.1. @Inject @RequestParam
7.2. @Inject @HeaderParam
7.3. @Inject ServletContext
7.4. @Inject ServletRequest / HttpServletRequest
7.5. @Inject ServletResponse / HttpServletResponse
7.6. @Inject HttpSession
7.7. @Inject HttpSessionStatus
7.8. @Inject @ContextPath
7.9. @Inject List<Cookie>
7.10. @Inject @CookieParam
7.11. @Inject @ServerInfo
7.12. @Inject @Principal
8. Exception handling: Seam Catch integration
8.1. Background
8.2. Defining a exception handler for a web request
9. Retrieving the BeanManager from the servlet context
IV. Seam Security
10. Security - Introduction
10.1. Overview
10.1.1. Authentication
10.1.2. Identity Management
10.1.3. External Authentication
10.1.4. Authorization
10.2. Configuration
10.2.1. Maven Dependencies
10.2.2. Third Party Dependencies
11. Security - Authentication
11.1. Basic Concepts
11.2. Built-in Authenticators
11.3. Which Authenticator will Seam use?
11.4. Writing a custom Authenticator
12. Security - Identity Management
12.1. TO DO
13. Security - External Authentication
13.1. TO DO
14. Security - Authorization
14.1. TO DO
V. Seam Faces
Introduction
15. Installation
15.1. Maven dependency configuration
15.2. Pre-Servlet 3.0 configuration
16. Faces Events Propagation
16.1. JSF Phase events
16.1.1. Seam Faces Phase events
16.1.2. Phase events listing
16.2. JSF system events
16.2.1. Seam Faces System events
16.2.2. System events listing
16.2.3. Component system events
17. Faces Scoping Support
17.1. @RenderScoped
17.2. @Inject javax.faces.contet.Flash flash
17.3. @ViewScoped
18. Messages API
18.1. Adding Messages
18.2. Displaying pending messages
19. Faces Artifact Injection
19.1. @*Scoped and @Inject in Validators and Converters
19.2. @Inject'able Faces Artifacts
20. Seam Faces Components
20.1. Introduction
20.2. <s:validateForm>
20.3. <s:viewAction>
20.3.1. Motivation
20.3.2. Usage
20.3.3. View actions vs the PreRenderViewEvent
20.4. UI Input Container
VI. Seam International
Introduction
21. Installation
22. Locales
22.1. Default Locale
22.2. User Locale
22.3. Available Locales
23. Timezones
23.1. Default TimeZone
23.2. User TimeZone
23.3. Available TimeZones
24. Messages
VII. Seam Catch
25. Seam Catch - Introduction
26. Seam Catch - Installation
26.1. Maven dependency configuration
27. Seam Catch - Usage
27.1. Exception handlers
27.2. Exception handler annotations
27.2.1. @HandlesExceptions
27.2.2. @Handles
27.3. Exception stack trace processing
27.4. Exception handler ordering
27.4.1. Traversal of exception type hierarchy
27.4.2. Handler precendence
27.5. APIs for exception information and flow control
27.5.1. CaughtException
27.5.2. ExceptionStack
28. Seam Catch - Framework Integration
28.1. Creating and Firing an ExceptionToCatch event
28.2. Default Handlers and Qualifiers
28.2.1. Default Handlers
28.2.2. Qualifiers
28.3. Supporting ServiceHandlers
Seam Catch - Glossary
VIII. Seam Remoting
29. Seam Remoting - Basic Features
29.1. Configuration
29.1.1. Dynamic type loading
29.2. The "Seam" object
29.2.1. A Hello World example
29.2.2. Seam.createBean
29.3. The Context
29.3.1. Setting and reading the Conversation ID
29.3.2. Remote calls within the current conversation scope
29.4. Working with Data types
29.4.1. Primitives / Basic Types
29.4.2. JavaBeans
29.4.3. Dates and Times
29.4.4. Enums
29.4.5. Collections
29.5. Debugging
29.6. Handling Exceptions
29.7. The Loading Message
29.7.1. Changing the message
29.7.2. Hiding the loading message
29.7.3. A Custom Loading Indicator
29.8. Controlling what data is returned
29.8.1. Constraining normal fields
29.8.2. Constraining Maps and Collections
29.8.3. Constraining objects of a specific type
29.8.4. Combining Constraints
30. Seam Remoting - Model API
30.1. Introduction
30.2. Model Operations
30.3. Fetching a model
30.3.1. Fetching a bean value
30.4. Modifying model values
30.5. Expanding a model
30.6. Applying Changes
31. Seam Remoting - Bean Validation
31.1. Validating a single object
31.2. Validating a single property
31.3. Validating multiple objects and/or properties
31.4. Validation groups
31.5. Handling validation failures
IX. Seam Rest
Introduction
32. Installation
32.1. Basics
32.2. Transitive dependencies
32.3. Registering JAX-RS components explicitly
33. Exception Handling
33.1. Seam Catch Integration
33.2. Declarative Exception Mapping
33.2.1. Annotation-based configuration
33.2.2. XML configuration
33.2.3. Declarative exception mapping processing
34. Bean Validation Integration
34.1. Validating HTTP requests
34.1.1. Validating entity body
34.1.2. Validating resource fields
34.1.3. Validating other method parameters
34.2. Validation configuration
34.3. Using validation groups
35. Templating support
35.1. Creating JAX-RS responses using templates
35.1.1. Accessing the model
35.2. Built-in support for templating engines
35.2.1. FreeMarker
35.2.2. Apache Velocity
35.2.3. Pluggable support for templating engines
35.2.4. Selecting prefered templating engine
36. RESTEasy Client Framework Integration
36.1. Using RESTEasy Client Framework with Seam REST
36.2. Manual ClientRequest API
36.3. ClientExecutor Configuration
37. Seam REST Dependencies
37.1. Transitive Dependencies
37.2. Optional dependencies
37.2.1. Seam Catch
37.2.2. Seam Config
37.2.3. FreeMarker
37.2.4. Apache Velocity
37.2.5. RESTEasy
X. Seam Validation
38. Introduction
39. Installation
39.1. Prerequisites
39.2. Maven setup
39.3. Manual setup
40. Dependency Injection
40.1. Retrieving of validator factory and validators via dependency injection
40.2. Dependency injection for constraint validators
41. Method Validation
XI. Seam Wicket
Introduction
42. Installation
43. Seam for Apache Wicket Features
43.1. Injection
43.2. Conversation Control
43.3. Conversation Propagation
XII. Seam Solder
44. Getting Started
44.1. Maven dependency configuration
44.2. Transitive dependencies
44.3. Pre-Servlet 3.0 configuration
45. Enhancements to the CDI Programming Model
45.1. Preventing a class from being processed
45.1.1. @Veto
45.1.2. @Requires
45.2. @Exact
45.3. @Client
45.4. Named packages
45.5. @FullyQualified bean names
46. Annotation Literals
47. Evaluating Unified EL
48. Resource Loading
48.1. Extending the resource loader
49. Logging
50. Annotation and AnnotatedType Utilities
50.1. Annotated Type Builder
50.2. Annotation Instance Provider
50.3. Annotation Inspector
50.4. Synthetic Qualifiers
50.5. Reflection Utilities
51. Obtaining a reference to the BeanManager
52. Bean Utilities
53. Properties
53.1. Working with properties
53.2. Querying for properties
53.3. Property Criteria
53.3.1. AnnotatedPropertyCriteria
53.3.2. NamedPropertyCriteria
53.3.3. TypedPropertyCriteria
53.3.4. Creating a custom property criteria
53.4. Fetching the results
54. Unwrapping Producer Methods
55. Default Beans
56. Generic Beans
56.1. Using generic beans
56.2. Defining Generic Beans
57. Service Handler