(no commit message)
[utils] / support / cdi / src / site / xdoc / index.xml
1 <?xml version="1.0"?>
2 <document xmlns="http://maven.apache.org/XDOC/2.0"
3   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4   xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
5   
6   <properties>
7     <title>user guide</title>
8     <author email="erik@brakkee.org">Erik Brakkee</author>
9   </properties>
10   <body>
11     <section name="Overview">
12       <p>The CDI (Contexts and Dependency Injection, JSR-299) support library contains support for
13         injecting contextual references into any object. This is useful for integration of CDI in
14         application managed objects or for integration in third-party frameworks. Injection based on
15         for instance @EJB, @Resource, and @PersistenceContext becomes a one liner. 
16       </p>
17       <p>
18         This is a key component for integrating Java EE dependency injection into several (web) 
19         frameworks since it allows Java EE dependency injection into regular objects.
20       </p>
21       <p>Package overview:</p>
22       <ul>
23         <li><a href="apidocs/org/wamblee/cdi/package-summary.html">cdi</a></li>
24       </ul>
25       <p>Test support with Weld</p>
26       <ul>
27         <li><a href="testapidocs/org/wamblee/cdi/package-summary.html">cdi</a>: This package
28           contains the <code>BeanManagerSetup</code> class which can be used to quickly setup a
29           beanmanager in Java SE (currently based on Weld).</li>
30       </ul>
31       <div class="infoMessage"><strong>Note</strong>:
32         You need a Java EE 6 environment to use CDI. 
33       </div>
34
35     </section>
36
37     <section name="Maven POM configuration">
38       <table>
39         <tr>
40           <th>groupId</th>
41           <th>artifactId</th>
42         </tr>
43         <tr>
44           <td>org.wamblee</td>
45           <td>wamblee-support-cdi</td>
46         </tr>
47       </table>
48       <p>Use the same named artifact with scope <code>test</code> and <type>test-jar</type> to use
49         the JavaSE testsupport class.</p>
50     </section>
51
52   </body>
53 </document>