[ https://issues.apache.org/jira/browse/DIRMINA-371?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Julien Vermillard updated DIRMINA-371: -------------------------------------- Fix Version/s: (was: 3.0.0-M1) 2.0.6 > 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.6 > > > 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. For more information on JIRA, see: http://www.atlassian.com/software/jira