ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dona...@apache.org
Subject cvs commit: jakarta-ant-myrmidon/site/src/xdocs converters.xml
Date Thu, 20 Jun 2002 00:28:58 GMT
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="peter@apache.org">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:ant-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-dev-help@jakarta.apache.org>


Mime
View raw message