* As this task is not a core ANT task, you will need to declare it in your
* build file. You will need to add something such as the following (the nested
* classpath element tells ANT where to find the task).
*
*
* <taskdef name="template-compiler" classname="org.bodington.ant.TemplateBuilderTask">
* <classpath>
* <pathelement location="${build}/bodserver.jar"/>
* </classpath>
* </taskdef>
*
*
*
* | Attribute | *Description | *Required | *
|---|---|---|
| templatedir | *the source directory of the (HTML) templates. | *Yes | *
| templateclasses | *the output directory for the template class files. | *Yes | *
| bodhome | *sets the value of the system property bodington.home.
* See the example below. |
* Yes | *
| xmlwarn | *sets whether or not XML parse errors and warnings in the templates are
* reported (default: true). |
* No | *
| buildpathref | *a reference to the CLASSPATH required by the underlying task. See the
* example below. * NOTE: having the buildpathref as a reference to what
* ANT terms a path-like structure allows for the CLASSPATH to be
* expressed in a cross-platform way (even a mixture of OS platform
* conventions!). |
* Yes | *
buildpathref
* refers in the following way.
*
*
*
* <path id="template.build.path">
* <pathelement location="${java.home}/lib/tools.jar"/>
* <pathelement location="${build.bodington.classes}"/>
* <pathelement location="${tomcat-4}/common/lib/servlet.jar"/>
* </path>
*
*
*
* You can then call the task (within a target) using the following entry:
*
*
*
* <template-compiler templatedir="${build.bodington}/templates"
* templateclasses="${build.bodington}/WEB-INF/template_classes"
* bodhome="${build.bodington}/WEB-INF"
* buildpathref="template.build.path"/>
*
*
*
* @author Alexis O'Connor
* @see Apache ANT
*/
public class TemplateBuilderTask extends Task
{
private String buildpath;
private String templatedir;
private String templateclasses;
private String bodhome;
private boolean xmlWarn = true;
/**
* Set the value of the buildpathref attribute.
* @param buildpathref the value to be set.
*/
public void setBuildpathRef(Reference buildpathref)
{
Path path = new Path(getProject());
path.setRefid(buildpathref);
this.buildpath = path.toString();
}
/**
* Set the value of the templatedir attribute.
* @param templatedir the value to be set.
*/
public void setTemplatedir(File templatedir)
{
this.templatedir = templatedir.getAbsolutePath();
}
/**
* Set the value of the templateclasses attribute.
* @param templateclasses the value to be set.
*/
public void setTemplateclasses(File templateclasses)
{
this.templateclasses = templateclasses.getAbsolutePath();
}
/**
* Set the value of the bodhome attribute.
* @param bodhome the value to be set.
*/
public void setBodHome(File bodhome)
{
this.bodhome = bodhome.getAbsolutePath();
}
/**
* Set the value of the xmlwarn attribute. If
* true, errors and warnings in the XML templates will be
* reported (default: true).
* @param xmlWarn the value to be set.
*/
public void setXmlWarn(boolean xmlWarn)
{
this.xmlWarn = xmlWarn;
}
/**
* Execute the task.
* @see org.apache.tools.ant.Task#execute()
*/
public void execute()
{
Vector v = new Vector();
v.add("-templateDir");
v.add(templatedir);
v.add("-classesDir");
v.add(templateclasses);
v.add("-classpath");
v.add(buildpath);
v.add("-bodHome");
v.add(bodhome);
if (xmlWarn)
v.add("-xmlWarn");
String[] args = (String[]) v.toArray(new String[v.size()]);
TemplateBuilder.main(args);
}
}