Stripes Injection Enricher
Stripes Injection Enricher enriches Stripes Framework objects by satisfying injection points specified declaratively using annotations.
There are three injection-based enrichers provided by Stripes Injection Enricher out of the box:
@Resource
- Java EE resource injections@EJB
- EJB session bean reference injections@Inject
- CDI injections
The first two enrichers use JNDI to lookup the instance to inject.
The CDI injections are handled by treating the Stripes object as a bean capable of receiving standard CDI injections.
The @Resource
annotation gives you access to any object which is available via JNDI.
It follows the standard rules for @Resource
(as defined in the Section 2.3 of the Common Annotations for the Java Platform specification).
The @EJB
annotation performs a JNDI lookup for the EJB session bean reference using EJB 3.1 portable global JNDI names.
If no matching beans were found in those locations the injection will fail.
However, you can manually set the JNDI name to lookup using the mappedName
attribute for @EJB
, as well as the attributes mappedName
and name
attributes for @Resource
:
public class MyActionBean implements ActionBean {
@Inject
private FooService fooService;
@EJB
// or manually @EJB(mappedName = "java:global[/<app-name>]/<module-name>/BarService")
private BarService barService;
@Resource(name = "greeting")
// same as @Resource(mappedName = "java:comp/env/greeting")
private String greeting;
}
Note: In order for CDI injections to work, the web archive must be a bean archive. That means adding a beans.xml
file (can be empty) to the WEB-INF
directory.
Configuration
Maven dependency
Add Stripes Injection Enricher dependency to your project:
<dependency>
<groupId>com.samaxes.stripes</groupId>
<artifactId>stripes-injection-enricher</artifactId>
<version>VERSION</version>
</dependency>
Stripes filter configuration
Add Stripes Injection Enricher to Stripes filter Extension.Packages
configuration in web.xml
:
<init-param>
<param-name>Extension.Packages</param-name>
<param-value>com.samaxes.stripes.inject</param-value>
</init-param>
Requirements
Stripes Injection Enricher requires a Java EE 6-compliant application server providing support for JSR-299 (CDI).
It has been tested with the following application servers:
- GlassFish 3.1
- JBoss AS 7
- JBoss AS 6
License
This distribution is licensed under the terms of the Apache License, Version 2.0 (see LICENSE.txt).