Updated Branches:
  refs/heads/master a69532e69 -> f837632cf

Javadoc improvements


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

Branch: refs/heads/master
Commit: f837632cf10fc9f8d05419fe163aa42534a5ff15
Parents: 85ae067
Author: Martin Tzvetanov Grigorov <[email protected]>
Authored: Thu Feb 23 17:54:48 2012 +0100
Committer: Martin Tzvetanov Grigorov <[email protected]>
Committed: Thu Feb 23 17:54:48 2012 +0100

----------------------------------------------------------------------
 .../java/org/apache/wicket/page/IPageManager.java  |   12 ++++++++----
 1 files changed, 8 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/wicket/blob/f837632c/wicket-core/src/main/java/org/apache/wicket/page/IPageManager.java
----------------------------------------------------------------------
diff --git a/wicket-core/src/main/java/org/apache/wicket/page/IPageManager.java 
b/wicket-core/src/main/java/org/apache/wicket/page/IPageManager.java
index 97715ef..b7817f9 100644
--- a/wicket-core/src/main/java/org/apache/wicket/page/IPageManager.java
+++ b/wicket-core/src/main/java/org/apache/wicket/page/IPageManager.java
@@ -34,16 +34,21 @@ public interface IPageManager
         * Retrieve page instance with given id.
         * 
         * @param id
+        *      the id of the page to load
         * @return page instance or <code>null</code>
-        * @throws CouldNotLockPageException
+        * @throws CouldNotLockPageException if the page is already locked by 
another thread
+        * and the lock cannot be acquired for some timeout
         */
        public IManageablePage getPage(int id) throws CouldNotLockPageException;
 
        /**
         * Marks page as changed.
+        * <p><strong>Note:</strong>Only stateful pages are stored.</p>
         * 
         * @param page
-        * @throws CouldNotLockPageException
+        *      the page that should be stored in the page stores at the end of 
the request.
+        * @throws CouldNotLockPageException if the page is already locked by 
another thread
+        * and the lock cannot be acquired for some timeout
         */
        public void touchPage(IManageablePage page) throws 
CouldNotLockPageException;
 
@@ -64,8 +69,6 @@ public interface IPageManager
 
        /**
         * Invoked when new session has been created.
-        * 
-        * @param context
         */
        public void newSessionCreated();
 
@@ -73,6 +76,7 @@ public interface IPageManager
         * Invoked when the session has been expired.
         * 
         * @param sessionId
+        *      the id of the expired session
         */
        public void sessionExpired(String sessionId);
 

Reply via email to