svn commit: r1150274 - in /tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5: annotations/PageDetached.java runtime/PageLifecycleListener.java

[hl...@apache.org]

Author: hlship
Date: Sun Jul 24 03:45:42 2011
New Revision: 1150274

URL: http://svn.apache.org/viewvc?rev=1150274&view=rev
Log:
TAP5-1508: Mark @PageDetached and PageLifecycleListener.pageDetached() as deprecated, for later removal

Modified:
    tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java
    tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/runtime/PageLifecycleListener.java

Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java?rev=1150274&r1=1150273&r2=1150274&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java Sun Jul 24 03:45:42 2011
@@ -14,14 +14,15 @@
 
 package org.apache.tapestry5.annotations;
 
+import org.apache.tapestry5.ioc.annotations.UseWith;
+
 import java.lang.annotation.Documented;
-import static java.lang.annotation.ElementType.METHOD;
 import java.lang.annotation.Retention;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
 import java.lang.annotation.Target;
 
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
 import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*;
-import org.apache.tapestry5.ioc.annotations.UseWith;
 
 /**
  * Method annotation used for methods that should be invoked when the page is detached at the end of a request, before
@@ -32,14 +33,15 @@ import org.apache.tapestry5.ioc.annotati
  * <p/>
  * To be clear: methods with this annotation (or name) are still invoked even in Tapestry 5.2, which does away with the
  * page pool.
- * 
+ *
  * @see PageAttached
+ * @deprecated In Tapestry 5.3, with no replacement (detach logic no longer meaningful now that pages are singletons).
  */
 @Target(METHOD)
 @Retention(RUNTIME)
 @Documented
 @UseWith(
-{ COMPONENT, MIXIN, PAGE })
+        {COMPONENT, MIXIN, PAGE})
 public @interface PageDetached
 {
 

Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/runtime/PageLifecycleListener.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/runtime/PageLifecycleListener.java?rev=1150274&r1=1150273&r2=1150274&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/runtime/PageLifecycleListener.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry5/runtime/PageLifecycleListener.java Sun Jul 24 03:45:42 2011
@@ -28,6 +28,8 @@ public interface PageLifecycleListener
     /**
      * Invoked when the page is detached, allowing components a chance to clear out any temporary or client specific
      * state.
+     *
+     * @deprecated In Tapestry 5.3, with no replacement (detach logic no longer meaningful now that pages are singletons).
      */
     void containingPageDidDetach();