donaldp 2002/06/19 17:28:58
Added: site/src/xdocs converters.xml
Log:
Add in start of documentation about converters
Revision Changes Path
1.1 jakarta-ant-myrmidon/site/src/xdocs/converters.xml
Index: converters.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<title>On Converters in Ant 2</title>
<author email="[EMAIL PROTECTED]">Peter Donald</author>
</properties>
<body>
<section name="Introduction">
<p>This section will describe in detail the converter
architecture.
Converting occurs during configuring process of a task. When a
value
must be converted from one type (usually String) to the type of
an
attribute.</p>
</section>
<section name="Converters as Types">
<p>Like most of the other pluggable elements in Ant, a Converter
is just
another <a href="types.html">type</a>. In this case each
converter converts
from a source type to a destination class.</p>
<p>Converters used when you need to convert from type to another
type.
Usually this occurs when mapping the attributes of ModelElements
onto
a java class during the <a
href="configuring.html">configuration</a>
process.</p>
<p>For example, if the attribute is of type Integer then the
runtime
will attempt to convert froma "java.lang.String" to a
"java.lang.Integer". In the case that there is a converter that
is
capable of directly between source type and destination this
converter
is used. In the case where there is no direct coverter then the
runtime
searches for a converter that is capable of doing conversion.</p>
<p>The search process is as follows;</p>
<ul>
<li>Check if current class can be converted to destination
type.</p>
<li>Repeat search for all interfaces that class implements.</p>
<li>Repeat search for super class.</p>
</ul>
</section>
</body>
</document>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
