Exactly; @Retain is your way of saying to Tapestry "this field is not
final, but don't worry, I've got it under control."  With @Retain,
Tapestry effectively ignores the field entirely.  This can be enough
rope to hang yourself (in terms of dangling references to objects that
should be garbage collected, or accidentally sharing user-specific
state between different users), which is why this is not the default
behavior for otherwise un-annotated fields.

On Tue, Apr 8, 2008 at 2:43 PM, Filip S. Adamsen <[EMAIL PROTECTED]> wrote:
> org.apache.tapestry.annotations
>  Annotation Type Retain
>
>  Marker annotation placed on fields whose value should be retained past the
> end of the request. This is most often associated with fields that are
> lazily loaded. By marking such fields with the Retain annotation, the fields
> will not be discarded at the end of the request.
>
>  This is quite different from Persist, because the value that's allowed to
> be retained is not stored persistently; it is simply not cleared out. A
> subsequent request, even from the same user, may be processed by a different
> instance of the page where the value is still null.
>
>  This annotation should only be used with lazily-evaluated objects that
> contain no client-specific information.
>
>
> http://tapestry.apache.org/tapestry5/apidocs/org/apache/tapestry/annotations/Retain.html
>
>  -Filip
>
>
>  On 2008-04-08 23:08, DavidWei wrote:
>
> > I am using T5 for my current application. There are cases when I need to
> have
> > a field's value retain after the request. I know using @Persist it will
> > work, but I do not want to store so many values in session. I found there
> > are some samples which use @Retain. By definition, it is said as "By
> marking
> > such fields with the Retain annotation, the fields will not be discarded
> at
> > the end of the request... This is quite different from Persist, because
> the
> > value that's allowed to be retained is not stored persistently; it is
> simply
> > not cleared out...".
> >
> > If it is not cleaned out after the request, when is it cleaned out?
> >
> > Thanks,
> >
> > David
> >
>
>
>  ---------------------------------------------------------------------
>  To unsubscribe, e-mail: [EMAIL PROTECTED]
>  For additional commands, e-mail: [EMAIL PROTECTED]
>
>



-- 
Howard M. Lewis Ship

Creator Apache Tapestry and Apache HiveMind

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to