Return-Path: Delivered-To: apmail-commons-commits-archive@minotaur.apache.org Received: (qmail 68948 invoked from network); 19 Jul 2010 19:39:56 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 19 Jul 2010 19:39:56 -0000 Received: (qmail 43983 invoked by uid 500); 19 Jul 2010 19:39:56 -0000 Delivered-To: apmail-commons-commits-archive@commons.apache.org Received: (qmail 43921 invoked by uid 500); 19 Jul 2010 19:39:55 -0000 Mailing-List: contact commits-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@commons.apache.org Delivered-To: mailing list commits@commons.apache.org Received: (qmail 43914 invoked by uid 99); 19 Jul 2010 19:39:55 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 19 Jul 2010 19:39:55 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 19 Jul 2010 19:39:52 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 1BE0823889B6; Mon, 19 Jul 2010 19:38:59 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r965598 - /commons/sandbox/at-digester/trunk/src/java/org/apache/commons/digester/annotations/package.html Date: Mon, 19 Jul 2010 19:38:59 -0000 To: commits@commons.apache.org From: simonetripodi@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20100719193859.1BE0823889B6@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: simonetripodi Date: Mon Jul 19 19:38:58 2010 New Revision: 965598 URL: http://svn.apache.org/viewvc?rev=965598&view=rev Log: reorganized ToC modified introduction Modified: commons/sandbox/at-digester/trunk/src/java/org/apache/commons/digester/annotations/package.html Modified: commons/sandbox/at-digester/trunk/src/java/org/apache/commons/digester/annotations/package.html URL: http://svn.apache.org/viewvc/commons/sandbox/at-digester/trunk/src/java/org/apache/commons/digester/annotations/package.html?rev=965598&r1=965597&r2=965598&view=diff ============================================================================== --- commons/sandbox/at-digester/trunk/src/java/org/apache/commons/digester/annotations/package.html (original) +++ commons/sandbox/at-digester/trunk/src/java/org/apache/commons/digester/annotations/package.html Mon Jul 19 19:38:58 2010 @@ -25,7 +25,7 @@ meta data-based definition of rules for Digester. This improves maintainability of both Java code and XML documents, as rules are now defined in POJOs and generating Digester - parsers at run-time.

+ parsers at run-time, avoiding manual updates.


@@ -37,13 +37,9 @@
[Rule Elements]
- [Matching Patterns] + [Bootstrapping]
- [Including rules files in other rules files] -
- [Including programmatically-created rules] -
- [Creating a digester from XML] + [Service provider interface]
@@ -60,15 +56,28 @@

Annotation Rules

-

Annotation Rules are defined by the combination of: +

A digester rule on a POJO is expressed through one or more annotations. + An annotation is considered a digester rule definition if its retention + policy contains RUNTIME and if the annotation itself is annotated with + org.apache.commons.digester.annotations.DigesterRule.

+ +

The DigesterRule is defined by the combination of:

    -
  • an annotation that reflect a Digester rule;
    • -
  • a handler that has to be invoked during the class traversal;
    • -
  • a rule provider that creates the pattern, rule pair.
    • +
  • the reflected rule class by the annotation;
    • +
  • the handler class that has to be invoked during the class traversal;
    • +
  • the rule provider that produces the pattern, rule pair.
- The Annotation Rules are applied on types, methods and fields.

-

+

Digester annotations can target any of the following ElementTypes:

+
    +
  • FIELD for Digester rules concerning attributes;
    • +
  • METHOD for Digester rules concerning methods calls;
    • +
  • PARAMETER for Digester rules concerning methods parameters setting;
    • +
  • TYPE for constrained beans.
    • +
+

While other ElementTypes are not forbidden, the Digester + annotations processor does not have to recognize and process annotation + rules placed on such types.