[jira] Updated: (SHIRO-216) Add @Documented to Shiro authorization annotations

["Matt Brictson (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/SHIRO-216?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Matt Brictson updated SHIRO-216:
--------------------------------

    Priority: Minor  (was: Major)

> Add @Documented to Shiro authorization annotations
> --------------------------------------------------
>
>                 Key: SHIRO-216
>                 URL: https://issues.apache.org/jira/browse/SHIRO-216
>             Project: Shiro
>          Issue Type: Improvement
>          Components: Authorization (access control) 
>    Affects Versions: 1.1.0
>            Reporter: Matt Brictson
>            Priority: Minor
>
> Since security concerns are an important part of good API documentation, it would be nice if the Shiro authorization annotations like @RequiresUser and @RequiresPermissions were included in standard Javadoc output.
> For example, if a method in my application has this signature:
> @RequiresAuthentication
> public Account getAccount() { ... }
> It would be nice if the javadoc generated for my method included the fact that the @RequiresAuthentication annotation is present.
> I believe this can be done by simply adding @java.lang.annotation.Documented to each of the Shiro annotation types. See:
> http://download.oracle.com/javase/6/docs/api/java/lang/annotation/Documented.html
> As a point of reference, Spring annotations like @Transactional and @PreAuthorize do have the @java.lang.annotation.Documented annotation.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.