You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2016/07/14 10:43:37 UTC
[04/38] isis git commit: ISIS-1465: fixes/improves javadoc comments
for IsisSessionFactory
ISIS-1465: fixes/improves javadoc comments for IsisSessionFactory
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/0510263b
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/0510263b
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/0510263b
Branch: refs/heads/master
Commit: 0510263b581d473137e0c65394a94170beca8a25
Parents: 0347eb1
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Wed Jul 13 06:18:55 2016 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Wed Jul 13 06:18:55 2016 +0100
----------------------------------------------------------------------
.../system/session/IsisSessionFactory.java | 25 ++++++++++----------
1 file changed, 12 insertions(+), 13 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/0510263b/core/runtime/src/main/java/org/apache/isis/core/runtime/system/session/IsisSessionFactory.java
----------------------------------------------------------------------
diff --git a/core/runtime/src/main/java/org/apache/isis/core/runtime/system/session/IsisSessionFactory.java b/core/runtime/src/main/java/org/apache/isis/core/runtime/system/session/IsisSessionFactory.java
index 80bc088..6573acf 100644
--- a/core/runtime/src/main/java/org/apache/isis/core/runtime/system/session/IsisSessionFactory.java
+++ b/core/runtime/src/main/java/org/apache/isis/core/runtime/system/session/IsisSessionFactory.java
@@ -22,6 +22,8 @@ package org.apache.isis.core.runtime.system.session;
import java.util.List;
import java.util.concurrent.Callable;
+import javax.inject.Inject;
+
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -48,24 +50,21 @@ import org.apache.isis.core.runtime.system.persistence.PersistenceSession;
import org.apache.isis.core.runtime.system.persistence.PersistenceSessionFactory;
import org.apache.isis.core.runtime.system.transaction.IsisTransactionManager;
import org.apache.isis.core.runtime.system.transaction.IsisTransactionManagerException;
-import org.apache.isis.core.runtime.systemusinginstallers.IsisComponentProviderUsingInstallers;
/**
- * Analogous (and in essence a wrapper for) a JDO <code>PersistenceManagerFactory</code>
- *
- * Creates an implementation of
- * {@link IsisSessionFactory#openSession(AuthenticationSession)} to create an
- * {@link IsisSession}, but delegates to subclasses to actually obtain the
- * components that make up that {@link IsisSession}.
+ * Is the factory of {@link IsisSession}s, also holding a reference to the current session using
+ * a thread-local.
+ *
+ * <p>
+ * The class can in considered as analogous to (and is in many ways a wrapper for) a JDO
+ * <code>PersistenceManagerFactory</code>.
+ * </p>
*
* <p>
- * The idea is that one subclass can use the {@link IsisComponentProviderUsingInstallers.InstallerLookup} design to
- * lookup installers for components (and hence create the components
- * themselves), whereas another subclass might simply use Spring (or another DI
- * container) to inject in the components according to some Spring-configured
- * application context.
+ * The class is only instantiated once; it is also registered with {@link ServicesInjector}, meaning that
+ * it can be {@link Inject}'d into other domain services.
+ * </p>
*/
-
public class IsisSessionFactory implements ApplicationScopedComponent {
@SuppressWarnings("unused")