Return-Path: X-Original-To: apmail-commons-commits-archive@minotaur.apache.org Delivered-To: apmail-commons-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 557F56A41 for ; Mon, 30 May 2011 19:58:56 +0000 (UTC) Received: (qmail 65103 invoked by uid 500); 30 May 2011 19:58:56 -0000 Delivered-To: apmail-commons-commits-archive@commons.apache.org Received: (qmail 65043 invoked by uid 500); 30 May 2011 19:58:56 -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 65036 invoked by uid 99); 30 May 2011 19:58:56 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 30 May 2011 19:58:56 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.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, 30 May 2011 19:58:54 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id C6B8D23889E1; Mon, 30 May 2011 19:58:34 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1129334 - /commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/plugins/Declaration.java Date: Mon, 30 May 2011 19:58:34 -0000 To: commits@commons.apache.org From: simonetripodi@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20110530195834.C6B8D23889E1@eris.apache.org> Author: simonetripodi Date: Mon May 30 19:58:34 2011 New Revision: 1129334 URL: http://svn.apache.org/viewvc?rev=1129334&view=rev Log: added missing javadoc Modified: commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/plugins/Declaration.java Modified: commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/plugins/Declaration.java URL: http://svn.apache.org/viewvc/commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/plugins/Declaration.java?rev=1129334&r1=1129333&r2=1129334&view=diff ============================================================================== --- commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/plugins/Declaration.java (original) +++ commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/plugins/Declaration.java Mon May 30 19:58:34 2011 @@ -57,6 +57,8 @@ public class Declaration /** * Constructor. + * + * @param pluginClassName The name of the class of the object to be instantiated (will be load in the init method) */ public Declaration( String pluginClassName ) { @@ -69,6 +71,8 @@ public class Declaration /** * Constructor. + * + * @param pluginClass The class of the object to be instantiated (will be load in the init method) */ public Declaration( Class pluginClass ) { @@ -79,6 +83,9 @@ public class Declaration /** * Create an instance where a fully-initialised ruleLoader instance is provided by the caller instead of having the * PluginManager "discover" an appropriate one. + * + * @param pluginClass The class of the object to be instantiated (will be load in the init method) + * @param ruleLoader Class which is responsible for dynamically loading this plugin's rules on demand */ public Declaration( Class pluginClass, RuleLoader ruleLoader ) { @@ -94,6 +101,8 @@ public class Declaration * the input xml to refer back to the original declaration. *

* For plugins declared "in-line", the id is null. + * + * @param id The id that the user associated with a particular plugin declaration in the input xml */ public void setId( String id ) { @@ -119,6 +128,8 @@ public class Declaration * consider significant. *

* The "id" and "class" properties are treated differently. + * + * @param p The properties have to be copied into the properties member of this object */ public void setProperties( Properties p ) { @@ -139,6 +150,9 @@ public class Declaration /** * Must be called exactly once, and must be called before any call to the configure method. + * + * @param digester The Digester instance where plugin has to be plugged + * @param pm The plugin manager reference */ public void init( Digester digester, PluginManager pm ) throws PluginException @@ -203,8 +217,10 @@ public class Declaration *

* On return, any custom rules associated with the plugin class have been loaded into the Rules object currently * associated with the specified digester object. + * + * @param digester The Digester instance where plugin has to be plugged + * @param pattern The pattern the custom rules have to be bound */ - public void configure( Digester digester, String pattern ) throws PluginException {