Debian Codegraph @

api/src/main/javadoc/overview.html

raw
1 <html>
2
3 <body>
4
5 <p>Contexts and Dependency Injection (CDI) defines a set of
6 complementary services that help improve the structure of application
7 code.</p>
8
9 <ul>
10 <li>A well-defined lifecycle for stateful
11 {@linkplain javax.enterprise.inject beans} bound to well-defined
12 lifecycle {@linkplain javax.enterprise.context contexts}, where
13 the set of contexts is {@linkplain javax.enterprise.context.spi
14 extensible}</li>
15 <li>A sophisticated, typesafe {@linkplain javax.enterprise.inject
16 dependency injection mechanism}, including the ability to select
17 dependencies at either {@linkplain javax.inject.Qualifier development}
18 or {@linkplain javax.enterprise.inject.Alternative deployment} time,
19 without verbose configuration</li>
20 <li>Support for Java EE modularity and the Java EE component
21 architecture&mdash;the modular structure of a Java EE application is
22 taken into account when resolving dependencies between Java EE
23 components</li>
24 <li>{@linkplain javax.enterprise.inject Integration} with the
25 Unified Expression Language, allowing any bean to be used directly
26 within a JSF or JSP page</li>
27 <li>The ability to {@linkplain javax.decorator decorate} injected
28 beans</li>
29 <li>The ability to associate
30 {@linkplain javax.interceptor interceptors} with beans via typesafe
31 {@linkplain javax.enterprise.inject interceptor bindings}</li>
32 <li>An {@linkplain javax.enterprise.event event} notification model</li>
33 <li>A web {@linkplain javax.enterprise.context.ConversationScoped
34 conversation context} in addition to the three standard
35 web contexts defined by the Java Servlets specification</li>
36 <li>An {@linkplain javax.enterprise.inject.spi SPI} allowing portable
37 extensions to integrate cleanly with the container</li>
38 </ul>
39
40 <p>CDI allows objects to be bound to lifecycle contexts, to be
41 injected, to be associated with interceptors and decorators, and to
42 interact in a loosely coupled fashion by
43 {@linkplain javax.enterprise.event.Event firing} and
44 {@linkplain javax.enterprise.event.Observes observing} events.
45 {@linkplain javax.enterprise.inject Various kinds} of objects are
46 injectable, including EJB 3 session beans, managed beans,
47 {@linkplain javax.enterprise.inject.Produces producer methods} and
48 Java EE resources. We refer to these objects in general terms as beans
49 and to instances of beans that are bound to contexts as contextual
50 instances.</p>
51
52 </body>
53
54 </html>