[jira] [Updated] (DIRMINA-371) Annotations to document concurrency

["Emmanuel Lecharny (JIRA)" <ji...@apache.org>]

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

Emmanuel Lecharny updated DIRMINA-371:
--------------------------------------
    Fix Version/s:     (was: 2.0.8)
                   3.0.0-M3

> Annotations to document concurrency
> -----------------------------------
>
>                 Key: DIRMINA-371
>                 URL: https://issues.apache.org/jira/browse/DIRMINA-371
>             Project: MINA
>          Issue Type: Improvement
>          Components: Core
>            Reporter: im-james
>            Priority: Trivial
>             Fix For: 3.0.0-M3
>
>
> Concurrency is not documented and it makes it had to understand MINA.
> At the very least, I would like to see an annotation in every class that  would say "This class is access by several threads" or "This class is thread safe".
> The best things that could happen is that this project adopt the use of these annotations: GuardedBy, Immutable, NotThreadSafe, ThreadSafe
> Here is the documentation for each one of these annotations:
> http://javaconcurrencyinpractice.com/annotations/doc/index.html
> You can find the source here:
> http://javaconcurrencyinpractice.com/jcip-annotations-src.jar
> and a binary here:
> http://javaconcurrencyinpractice.com/jcip-annotations.jar
> I want to highlight that the process of adding these annotations/or any kind of concurrency documentation will make concurrency flaws easier to see. (as you know concurrency flaws are 'invisible').
> I hope that you see like me that this is a very important task to do.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)