Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to 'bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java')
-rw-r--r--bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java44
1 files changed, 25 insertions, 19 deletions
diff --git a/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java b/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java
index 21105f2f2..c44e834f6 100644
--- a/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java
+++ b/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java
@@ -25,34 +25,40 @@ import org.eclipse.e4.core.internal.contexts.ContextObjectSupplier;
import org.eclipse.e4.core.internal.contexts.EclipseContext;
/**
- * An injection factory is used to inject data and services from a context into a domain object. The
- * injection will try to find fields and methods in the user objects that correspond to the names of
- * the services present in the context. Subsequent changes to the context after injection will cause
- * the affected items to be re-injected into the object. Thus the object will remain synchronized
- * with the context once it has been injected.
+ * An injection factory is used to inject data and services from a context into
+ * a domain object. The injection will try to find fields and methods in the
+ * user objects that correspond to the names of the services present in the
+ * context. Subsequent changes to the context after injection will cause the
+ * affected items to be re-injected into the object. Thus the object will remain
+ * synchronized with the context once it has been injected.
* <p>
- * If annotations are supported by the runtime, matching of methods and fields to be injected is
- * also performed using the annotations defined in packages javax.inject and
- * org.eclipse.e4.core.di.annotations.
+ * If annotations are supported by the runtime, matching of methods and fields
+ * to be injected is also performed using the annotations defined in packages
+ * javax.inject and org.eclipse.e4.core.di.annotations.
* </p>
* <p>
- * The injection of values is generally done as a number of calls. User objects that want to
- * finalize the injected data (for instance, to perform calculations based on multiple injected
- * values) can place such calculations in a method with the <tt>javax.annotation.PostConstruct</tt> annotation.
+ * The injection of values is generally done as a number of calls. User objects
+ * that want to finalize the injected data (for instance, to perform
+ * calculations based on multiple injected values) can place such calculations
+ * in a method with the <code>javax.annotation.PostConstruct</code> annotation.
* </p>
* <p>
- * When injecting values, all fields are injected prior to injection of methods. When values are
- * removed from the context or the context is disposed, injection of null values occurs in the
- * reverse order: methods and then fields. As a result, injection methods can safely make use of
- * injected field values. The order in which methods are injected is undefined, so
- * injection methods should not rely on other injection methods having been run already. Methods
- * and field on superclasses are injected before methods in fields on the subclasses.
+ * When injecting values, all fields are injected prior to injection of methods.
+ * When values are removed from the context or the context is disposed,
+ * injection of null values occurs in the reverse order: methods and then
+ * fields. As a result, injection methods can safely make use of injected field
+ * values. The order in which methods are injected is undefined, so injection
+ * methods should not rely on other injection methods having been run already.
+ * Methods and field on superclasses are injected before methods in fields on
+ * the subclasses.
* </p>
* <p>
- * When a context is disposed, the injection factory will attempt to notify all injected objects by
- * calling methods with the <tt>javax.annotation.PreDestroy</tt> annotation.
+ * When a context is disposed, the injection factory will attempt to notify all
+ * injected objects by calling methods with the
+ * <code>javax.annotation.PreDestroy</code> annotation.
*
* This class is not intended to be extended by clients.
+ *
* @noinstantiate This class is not intended to be instantiated by clients.
* @since 1.3
*/

Back to the top