CVS: Tapestry/doc/src/UsersGuide state.xml,1.1.2.1,1.1.2.2

Update of /cvsroot/tapestry/Tapestry/doc/src/UsersGuide
In directory sc8-pr-cvs1:/tmp/cvs-serv9155/doc/src/UsersGuide

Modified Files:
      Tag: hship-2-3
	state.xml 
Log Message:
Automatically register components as page listeners if they implement necessary interfaces
Major rework on page property persistance
[ 653358 ] IPage.getName() == qualified name
[ 608768 ] Changes saved AFTER IPage.detach()

Index: state.xml
===================================================================
RCS file: /cvsroot/tapestry/Tapestry/doc/src/UsersGuide/Attic/state.xml,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -C2 -d -r1.1.2.1 -r1.1.2.2
*** state.xml	22 Dec 2002 13:47:58 -0000	1.1.2.1
--- state.xml	30 Dec 2002 03:05:00 -0000	1.1.2.2
***************
*** 274,281 ****
  
  <para>
! The Java interface &PageDetachListener; is the event listener interface for this purpose.  Implementing
! the interface is only part of the job, registering with the page is also necessary, and there
! are timing issues.  The registration can't take place in the constructor, because
! a freshly instantiated component doesn't yet have its <varname>page</varname> property set.
  </para>
  
--- 274,283 ----
  
  <para>
! The Java interface &PageDetachListener; is the event listener interface for this purpose.  
! By simply implementing this interface
! , Tapestry will register the component as a listener and ensure that
! it receives even notifications at the right time (this works for the two other
! page event interfaces, &PageRenderListener; and &PageCleanupListener; as well; simply
! implement the interface and leave the rest to the framework).
  </para>
  
***************
*** 311,318 ****
      {
          initialize();
-         
-         getPage().addPageDetachListener(this);
      }
      
      public void pageDetached(PageEvent event)
      {
--- 313,323 ----
      {
          initialize();
      }
      
+     /**
+      *  The method specified by &PageDetachListener;
+      *
+      **/
+     
      public void pageDetached(PageEvent event)
      {
***************
*** 323,336 ****
  </example>
  	
- <note>
- <title>Coming in 2.4</title>
- <para>
- Along with support for <link linkend="state.page-properties.declarative">declarative properties</link>,
- 2.4 <emphasis>may</emphasis> simplify registerring.  Components that implement the key page
- listener interfaces (&PageDetachListener;, &PageRenderListener; or &PageCleanupListener;) will
- be automatically registerred with the page.
- </para>
- </note>
- 
  </section> <!-- state.component-properties -->
  
--- 328,331 ----



-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf