* Singleton injector access. This should be used as main entry point for
* injection. A different {@link InjectorFactory} can be plugged in for testing.
*
+ * Given the following class:
+ * <pre>
+ * class Pojo {
+ * @EJB
+ * private Service service;
+ *
+ * ...
+ * }
+ * </pre>
+ * injecting the EJB into a POJO is accomplished as follows:
+ * <pre>
+ * Pojo pojo = new Pojo();
+ * SimpleInjector injector = new SimpleInjector();
+ * injector.inject(pojo);
+ * </pre>
+ *
+ * Note that it is recommended to cache the injector because the injector does caching
+ * of the types that it injects into. Caching the injector makes sure that a class is not
+ * analysed again for annotation every time injection is used.
+ *
* @author Erik Brakkee
*/
public class SimpleInjector {