svn commit: r397558 - /tapestry/tapestry4/branches/4.0/framework/src/java/org/apache/tapestry/AbstractPage.java

[bw...@apache.org]

Author: bwallace
Date: Thu Apr 27 07:46:03 2006
New Revision: 397558

URL: http://svn.apache.org/viewcvs?rev=397558&view=rev
Log:
[TAPESTRY-854] Added note about deprecation of initialize method

Modified:
    tapestry/tapestry4/branches/4.0/framework/src/java/org/apache/tapestry/AbstractPage.java

Modified: tapestry/tapestry4/branches/4.0/framework/src/java/org/apache/tapestry/AbstractPage.java
URL: http://svn.apache.org/viewcvs/tapestry/tapestry4/branches/4.0/framework/src/java/org/apache/tapestry/AbstractPage.java?rev=397558&r1=397557&r2=397558&view=diff
==============================================================================
--- tapestry/tapestry4/branches/4.0/framework/src/java/org/apache/tapestry/AbstractPage.java (original)
+++ tapestry/tapestry4/branches/4.0/framework/src/java/org/apache/tapestry/AbstractPage.java Thu Apr 27 07:46:03 2006
@@ -151,7 +151,10 @@
      * of the page. This is most useful when properties have non-null initial values.
      * <p>
      * Subclasses may override this implementation (which is empty).
-     * 
+     * <p>
+     * Deprecation note: Pages should implement {@link PageBeginRenderListener} and perform all initialization
+     * in pageBeginRender. This combined with not having instance variables ensures a pristine Page being
+     * put back into the pool and re-initialized properly prior to being rendered.
      * @since 2.2
      * @deprecated To be removed in 4.1 with no replacement.
      * @see PageDetachListener



---------------------------------------------------------------------
To unsubscribe, e-mail: tapestry-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tapestry-dev-help@jakarta.apache.org