Return-Path: 
 <ant-dev-return-15251-apmail-jakarta-ant-dev-archive=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-ant-dev-archive@jakarta.apache.org
Received: (qmail 5809 invoked by uid 500); 2 Jul 2001 17:09:00 -0000
Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
Reply-To: ant-dev@jakarta.apache.org
list-help: <mailto:ant-dev-help@jakarta.apache.org>
list-unsubscribe: <mailto:ant-dev-unsubscribe@jakarta.apache.org>
list-post: <mailto:ant-dev@jakarta.apache.org>
Delivered-To: mailing list ant-dev@jakarta.apache.org
Received: (qmail 3401 invoked from network); 2 Jul 2001 17:03:15 -0000
Sender: minger@sedonacorp.com
Message-ID: <3B40AA5B.38807F78@sedonacorp.com>
Date: Mon, 02 Jul 2001 13:07:39 -0400
From: matt.inger@sedonacorp.com
X-Mailer: Mozilla 4.76 [en] (X11; U; Linux 2.2.19-7.0.1 i686)
X-Accept-Language: en
MIME-Version: 1.0
To: ant-dev@jakarta.apache.org
Subject: some useful tasks
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Filter-Version: 1.3 (netra1)
X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N

i have written the following tasks for my installer which i think
might be helpful for other users.  Attached are the class headers
which describe the syntax and the functionality of these tasks.
The first one is a "switch" task, and the second is a "prompt"
task.  I know these could be done by using the <script> task
and the Rhino javascript engine, but it's much nicer to have a well
defined task for these.

Opinions anyone?

/***
 * Task definition for the ANT task to switch on a particular value
 * Usage:
 *
 *   Task declaration in the project:
 *     <taskdef name="switch" classname="com.sedona.ant.taskdef.Switch"
/>
 *
 *   Task calling syntax:
 *     <switch value="value" [caseinsensitive="true|false"] >
 *       <case value="val"
 *             [target="targetname" |
 *              (property="propname" propertyvalue="setval")] />+
 *       [<default [target="targetname" |
 *                  (property="propname" propertyvalue="setval")] />
 *     </switch>
 *
 *
 *   Attributes:
 *       value           -> The value to switch on
 *       caseinsensitive -> Should we do case insensitive comparisons?
                            (default is false)
 *
 *   Subitems:
 *       case     --> A single case specification for what to do when a
 *                    particular value is encountered.
 *        Attributes:
 *          value           --> The value to match
 *          target          --> The name of a target to execute if
matched
 *          property        --> The name of a property to set if matched

 *          propertyvalue   --> The value to set the named property to
 *
 *       default  --> The default case for when no match is found.  This

 *                    has the same syntax as the case item, but the
value
 *                    attribute is ignored.
 *
 *   Notes:
 *       1.  The property and propertyvalue attributes are tied together

 *           and one cannot be present without the other.
 *       2.  The target attribute is mutually exclusive with the
 *           (property,propertyvalue) attribute pair, and will throw
 *           an exception if both are present.
 */


/***
 * Task definition for the ANT task to prompt the user for information
 * Usage:
 *
 *   Task declaration in the project:
 *     <taskdef name="prompt" classname="com.sedona.ant.taskdef.Prompt"
/>
 *
 *   Task calling syntax:
 *     <prompt message="message" propertyname="propname"
 *             [defaultvalue="value" | allowempty="true|false"]
 *     >
 *        [ <allow value="value" ]*
 *     </prompt>
 *
 *   Attributes:
 *       message -> The message to display to the user
 *       propertyname -> The name of the property to set with the
received input
 *       defaultValue -> The default value if the user just hits enter
 *       allowempty   -> Whether or not an empty value is allowed
 *
 *   Subitems:
 *       <allow  value="value" /> --> allow this value to be input.  By
supplying
 *                                    one or more of this subitem, you
limit the
 *                                    input to a range of specific
allowable
 *                                    values.  Any value input that is
not explicitly
 *                                    allowed is rejected.  (good for
y/n questions)
 *
 *   Notes:
 *       1. The defaultvalue and allowempty attributes are mutually
exclusive,
 *          and if both are specified, the defaultvalue attribute takes
precedence.
 */


--
Matt Inger (matt.inger@sedonacorp.com)
Sedona Corporation
455 S. Gulph Road, Suite 300
King of Prussia, PA 19406
(484) 679-2213
"Self-respect - the secure feeling that no one,
 as yet, is suspicious." -H.L. Mencken