JCIP annotations

What do folks think about including jcip-annotations.jar
from  
jcip.net into JBC 2.0.0?  Allows us to use annotations like 

GuardedBy, Immutable, etc. and although they don't DO much
except be  
informative at the moment, it is possible that compile-time
checks or  
tests could be implemented later to make sure such contracts
are  
adhered to.

	http://jcip.net/
	http://jci
p.net/annotations/doc/index.html

Cheers,
--
Manik Surtani

Lead, JBoss Cache
JBoss, a division of Red Hat

Email: manikjboss.org
Telephone: +44 7786 702 706
MSN: maniksurtani.org
Yahoo/AIM/Skype: maniksurtani



_______________________________________________
jbosscache-dev mailing list
jbosscache-devlists.jboss.org
https://lists.jboss.org/mailman/listinfo/jbosscache-dev

Bela added GuardedBy and Immutable to JGroups. He probably
did not want
to bother with yet another jar. 

If we really follow these annotations it will improve code
readability
significantly. I keep my copy of JCIP handy.

+1.

On Thu, 2007-02-08 at 17:38 +0000, Manik Surtani wrote:
> What do folks think about including
jcip-annotations.jar from  
> jcip.net into JBC 2.0.0?  Allows us to use annotations
like  
> GuardedBy, Immutable, etc. and although they don't DO
much except be  
> informative at the moment, it is possible that
compile-time checks or  
> tests could be implemented later to make sure such
contracts are  
> adhered to.
> 
> 	http://jcip.net/
> 	http://jci
p.net/annotations/doc/index.html
> 
> Cheers,
> --
> Manik Surtani
> 
> Lead, JBoss Cache
> JBoss, a division of Red Hat
> 
> Email: manikjboss.org
> Telephone: +44 7786 702 706
> MSN: maniksurtani.org
> Yahoo/AIM/Skype: maniksurtani
> 
> 
> 
> _______________________________________________
> jbosscache-dev mailing list
> jbosscache-devlists.jboss.org
> https://lists.jboss.org/mailman/listinfo/jbosscache-dev

_______________________________________________
jbosscache-dev mailing list
jbosscache-devlists.jboss.org
https://lists.jboss.org/mailman/listinfo/jbosscache-dev

On 8 Feb 2007, at 20:49, Bela Ban wrote:

> I already have GuardedBy and Immutable in JGroups.
However, we  
> should think about a common shared library of
annotations that  
> might express even a bit more complex predicates (e.g.
using  
> temporal logic).

Are these from JCIP.net?  Or have you written your own
GuardedBy and  
Immutable in org.jgroups.xxx?

>
> We should come up with a lits of useful annotations...

+1.  What else do you have in mind, in addition to the JCIP
ones  
(Immutable, GuardedBy, ThreadSafe and NotThreadSafe)?

>
> Manik Surtani wrote:
>> What do folks think about including
jcip-annotations.jar from  
>> jcip.net into JBC 2.0.0?  Allows us to use
annotations like  
>> GuardedBy, Immutable, etc. and although they don't
DO much except  
>> be informative at the moment, it is possible that
compile-time  
>> checks or tests could be implemented later to make
sure such  
>> contracts are adhered to.
>>
>>     http://jcip.net/
>>     http://jci
p.net/annotations/doc/index.html
>>
>> Cheers,
>> -- 
>> Manik Surtani
>>
>> Lead, JBoss Cache
>> JBoss, a division of Red Hat
>>
>> Email: manikjboss.org
>> Telephone: +44 7786 702 706
>> MSN: maniksurtani.org
>> Yahoo/AIM/Skype: maniksurtani
>>
>>
>>
>> _______________________________________________
>> jbosscache-dev mailing list
>> jbosscache-devlists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/jbosscache-dev
>
>
> -- 
> Bela Ban
> Lead JGroups / JBoss Clustering team
> JBoss - a division of Red Hat
>

_______________________________________________
jbosscache-dev mailing list
jbosscache-devlists.jboss.org
https://lists.jboss.org/mailman/listinfo/jbosscache-dev

+1 for using jcip-annotations, whether we include
jcip-annotation.jar or 
private label them into their own package.

+1 for reading JCIP, its the best Java concurrency book
yet.

I'm a big believer in classes being documented as
thread-safe or 
thread-unsafe.  This helps avoid bugs where the calling
class doesn't 
protect access to an unprotected shared mutable object. 

Vladimir Blagojevic wrote:
> Bela added GuardedBy and Immutable to JGroups. He
probably did not want
> to bother with yet another jar. 
>
> If we really follow these annotations it will improve
code readability
> significantly. I keep my copy of JCIP handy.
>
> +1.
>
> On Thu, 2007-02-08 at 17:38 +0000, Manik Surtani
wrote:
>   
>> What do folks think about including
jcip-annotations.jar from  
>> jcip.net into JBC 2.0.0?  Allows us to use
annotations like  
>> GuardedBy, Immutable, etc. and although they don't
DO much except be  
>> informative at the moment, it is possible that
compile-time checks or  
>> tests could be implemented later to make sure such
contracts are  
>> adhered to.
>>
>> 	http://jcip.net/
>> 	http://jci
p.net/annotations/doc/index.html
>>
>> Cheers,
>> --
>> Manik Surtani
>>
>> Lead, JBoss Cache
>> JBoss, a division of Red Hat
>>
>> Email: manikjboss.org
>> Telephone: +44 7786 702 706
>> MSN: maniksurtani.org
>> Yahoo/AIM/Skype: maniksurtani
>>
>>
>>
>> _______________________________________________
>> jbosscache-dev mailing list
>> jbosscache-devlists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/jbosscache-dev
>>     
>
> _______________________________________________
> jbosscache-dev mailing list
> jbosscache-devlists.jboss.org
> https://lists.jboss.org/mailman/listinfo/jbosscache-dev
>
>   

_______________________________________________
jbosscache-dev mailing list
jbosscache-devlists.jboss.org
https://lists.jboss.org/mailman/listinfo/jbosscache-dev