Return-Path: Delivered-To: apmail-jakarta-commons-dev-archive@www.apache.org Received: (qmail 90161 invoked from network); 3 Mar 2004 22:32:25 -0000 Received: from daedalus.apache.org (HELO mail.apache.org) (208.185.179.12) by minotaur-2.apache.org with SMTP; 3 Mar 2004 22:32:25 -0000 Received: (qmail 92059 invoked by uid 500); 3 Mar 2004 22:32:07 -0000 Delivered-To: apmail-jakarta-commons-dev-archive@jakarta.apache.org Received: (qmail 91984 invoked by uid 500); 3 Mar 2004 22:32:07 -0000 Mailing-List: contact commons-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Jakarta Commons Developers List" Reply-To: "Jakarta Commons Developers List" Delivered-To: mailing list commons-dev@jakarta.apache.org Received: (qmail 91952 invoked by uid 500); 3 Mar 2004 22:32:07 -0000 Received: (qmail 91949 invoked from network); 3 Mar 2004 22:32:06 -0000 Received: from unknown (HELO minotaur.apache.org) (209.237.227.194) by daedalus.apache.org with SMTP; 3 Mar 2004 22:32:06 -0000 Received: (qmail 90113 invoked by uid 1449); 3 Mar 2004 22:32:19 -0000 Date: 3 Mar 2004 22:32:19 -0000 Message-ID: <20040303223219.90112.qmail@minotaur.apache.org> From: leosutic@apache.org To: jakarta-commons-sandbox-cvs@apache.org Subject: cvs commit: jakarta-commons-sandbox/attributes/site/xdocs tutorial.xml index.xml navigation.xml X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N leosutic 2004/03/03 14:32:19 Modified: attributes project.xml attributes/site/xdocs index.xml navigation.xml Added: attributes/site/xdocs tutorial.xml Log: Improved documentation. Revision Changes Path 1.12 +6 -47 jakarta-commons-sandbox/attributes/project.xml Index: project.xml =================================================================== RCS file: /home/cvs/jakarta-commons-sandbox/attributes/project.xml,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- project.xml 21 Feb 2004 16:13:41 -0000 1.11 +++ project.xml 3 Mar 2004 22:32:19 -0000 1.12 @@ -17,58 +17,17 @@ = --> - ../sandbox-build/project.xml - Attributes - commons-attributes - - - - 2.0alpha - 2003 - Commons Attributes - A package for handling runtime information about types (including Java classes) - - - Leo Sutic 1.9 +33 -8 jakarta-commons-sandbox/attributes/site/xdocs/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/jakarta-commons-sandbox/attributes/site/xdocs/index.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- index.xml 19 Feb 2004 14:49:14 -0000 1.8 +++ index.xml 3 Mar 2004 22:32:19 -0000 1.9 @@ -20,7 +20,7 @@ Leo Sutic - Jakarta Commons Attributes + Overview @@ -35,11 +35,35 @@

-
-

- You can grab the snapshot jars here: -

+
+ + +

+ Download the following files and put them in your $ANT_HOME/lib directory: +

+ + +
+ + +

+ Download the following files: +

+ -

Drop the client API and the ant task jars into your ${maven repository}/commons-attributes/jars/ directory, and the - maven plugin in your ${maven home}/plugins/ directory. You can now use attributes in your Java code, provided that - you declare a dependency on the client API:

+

Drop the -api and -compiler jars into your ${maven repository}/commons-attributes/jars/ + directory, and the Maven -plugin in your ${maven home}/plugins/ directory. + You can now use attributes in your Java code, provided that you declare a dependency on the client API:

commons-attributes @@ -65,6 +89,7 @@

The attribute compiler will act as a precompiler to the java:compile goal, so you do not need to do anything else.

+
1.3 +14 -17 jakarta-commons-sandbox/attributes/site/xdocs/navigation.xml Index: navigation.xml =================================================================== RCS file: /home/cvs/jakarta-commons-sandbox/attributes/site/xdocs/navigation.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- navigation.xml 19 Feb 2004 14:49:14 -0000 1.2 +++ navigation.xml 3 Mar 2004 22:32:19 -0000 1.3 @@ -17,21 +17,18 @@ = --> - - Jakarta Commons Attributes - - - - - - - - - - - - - - - + Jakarta Commons Attributes + + + + + + + + + + + + + 1.1 jakarta-commons-sandbox/attributes/site/xdocs/tutorial.xml Index: tutorial.xml =================================================================== Leo Sutic Tutorial

Commons Attributes enables Java programmers to use C#/.Net-style attributes in their code. Please see the Javadoc overview for a thorough explanation of the features and how the project integrates into the development process.

Download the following files and put them in your $ANT_HOME/lib directory:

Download the following files:

Drop the -api and -compiler jars into your ${maven repository}/commons-attributes/jars/ directory, and the Maven -plugin in your ${maven home}/plugins/ directory. You can now use attributes in your Java code, provided that you declare a dependency on the client API:

commons-attributes commons-attributes-api SNAPSHOT ]]>

The attribute compiler will act as a precompiler to the java:compile goal, so you do not need to do anything else.

Commons Attributes enables you to add attributes to your code:

As the example shows, the attributes are type-safe and provides for validation of values.

Can add attributes to classes Yes
Can add attributes to nested classes Yes
Can add attributes to methods and constructors Yes
Can add attributes to return values of methods Yes
Can add attributes to method parameters Yes
Can add attributes to fields Yes
Type safe attributes Yes
Attribute inheritance Yes, add the @@Inheritable() attribue to any attribute you wish to be inheritable.
Inheritance without access to superclass source code Yes
Named parameters in attribute declaration Yes, corresponds to setter methods. A Sealable interface enables the instance to become read-only when all relevant setters have been called.
Ability to quickly find all classes with a specific attribute Yes, via attribute indexes.
Ant task Yes
Maven plugin Yes
Object attributes don't have to be serializable Yes
Multiple attributes with same tag on an element Yes, this is controlled by the attribute itself
Incremental compilation Yes
Attribute storage Generated classes
Runtime code size 21kB
Unit test coverage Excellent
--------------------------------------------------------------------- To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org For additional commands, e-mail: commons-dev-help@jakarta.apache.org