[jira] [Commented] (TAP5-2288) Improve JavaDoc clarity for @Cached annotation.

["Michael Gentry (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/TAP5-2288?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13904501#comment-13904501 ] 

Michael Gentry commented on TAP5-2288:
--------------------------------------

The cheat sheet also specifies:

"@Cached only works on methods that take no parameters."

The JavaDoc omits this, too.


> Improve JavaDoc clarity for @Cached annotation.
> -----------------------------------------------
>
>                 Key: TAP5-2288
>                 URL: https://issues.apache.org/jira/browse/TAP5-2288
>             Project: Tapestry 5
>          Issue Type: Improvement
>          Components: tapestry-core
>            Reporter: Michael Gentry
>            Priority: Minor
>              Labels: documentation
>
> The JavaDoc for the @Cached annotation:
> https://github.com/apache/tapestry-5/blob/master/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Cached.java
> Says:
> "Indicates that a method should only be evaluated once and the result cached. All further calls to the method will return the cached result."
> This implies the value is cached forever, but this link says per-request:
> http://tapestry.apache.org/component-cheat-sheet.html
> Please correct the JavaDoc or cheat sheet to specify the actual cached duration (forever, session, request, etc).
> Thanks!



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)