mina-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Emmanuel Lecharny (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DIRMINA-371) Annotations to document concurrency
Date Sun, 07 Jun 2009 07:50:07 GMT

     [ 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: 2.0.0-RC1

Seems to be a good idea to have for 2.0 final. Not urgent, but usefull.

> 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: 2.0.0-RC1
>
>
> 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 is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message