[2/2] git commit: WICKET-4631 Session object JavaDocs

[mg...@apache.org]

WICKET-4631 Session object JavaDocs


Project: http://git-wip-us.apache.org/repos/asf/wicket/repo
Commit: http://git-wip-us.apache.org/repos/asf/wicket/commit/227de67f
Tree: http://git-wip-us.apache.org/repos/asf/wicket/tree/227de67f
Diff: http://git-wip-us.apache.org/repos/asf/wicket/diff/227de67f

Branch: refs/heads/wicket-1.5.x
Commit: 227de67f248d58a3211e73dccc631386841166b9
Parents: dbfb06a
Author: Martin Tzvetanov Grigorov <mg...@apache.org>
Authored: Tue Jun 26 15:11:57 2012 +0300
Committer: Martin Tzvetanov Grigorov <mg...@apache.org>
Committed: Tue Jun 26 15:11:57 2012 +0300

----------------------------------------------------------------------
 .../src/main/java/org/apache/wicket/Session.java   |   15 +++------------
 1 files changed, 3 insertions(+), 12 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/wicket/blob/227de67f/wicket-core/src/main/java/org/apache/wicket/Session.java
----------------------------------------------------------------------
diff --git a/wicket-core/src/main/java/org/apache/wicket/Session.java b/wicket-core/src/main/java/org/apache/wicket/Session.java
index ccc014c..a91c6a0 100644
--- a/wicket-core/src/main/java/org/apache/wicket/Session.java
+++ b/wicket-core/src/main/java/org/apache/wicket/Session.java
@@ -49,18 +49,9 @@ import org.slf4j.LoggerFactory;
  * Holds information about a user session, including some fixed number of most recent pages (and all
  * their nested component information).
  * <ul>
- * <li><b>Access via Component </b>- If a RequestCycle object is not available, the Session can be
- * retrieved for a Component by calling {@link Component#getSession()}. As currently implemented,
- * each Component does not itself have a reference to the session that contains it. However, the
- * Page component at the root of the containment hierarchy does have a reference to the Session that
- * holds the Page. So {@link Component#getSession()} traverses the component hierarchy to the root
- * Page and then calls {@link Page#getSession()}.
- * 
- * <li><b>Access via Thread Local </b>- In the odd case where neither a RequestCycle nor a Component
- * is available, the currently active Session for the calling thread can be retrieved by calling the
- * static method Session.get(). This last form should only be used if the first two forms cannot be
- * used since thread local access can involve a potentially more expensive hash map lookup.
- * 
+ * <li><b>Access</b> - the Session can be retrieved either by {@link Component#getSession()}
+ * or by directly calling the static method Session.get().
+ *
  * <li><b>Locale </b>- A session has a Locale property to support localization. The Locale for a
  * session can be set by calling {@link Session#setLocale(Locale)}. The Locale for a Session
  * determines how localized resources are found and loaded.