src/main/org/apache/tools/ant/taskdefs/optional/jsp/JspC.java - ant - Git at Google

 /*
  * The Apache Software License, Version 1.1
  *
  * Copyright (c) 2001-2002 The Apache Software Foundation.  All rights
  * reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  *
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in
  *    the documentation and/or other materials provided with the
  *    distribution.
  *
  * 3. The end-user documentation included with the redistribution, if
  *    any, must include the following acknowlegement:
  *       "This product includes software developed by the
  *        Apache Software Foundation (http://www.apache.org/)."
  *    Alternately, this acknowlegement may appear in the software itself,
  *    if and wherever such third-party acknowlegements normally appear.
  *
  * 4. The names "The Jakarta Project", "Ant", and "Apache Software
  *    Foundation" must not be used to endorse or promote products derived
  *    from this software without prior written permission. For written
  *    permission, please contact apache@apache.org.
  *
  * 5. Products derived from this software may not be called "Apache"
  *    nor may "Apache" appear in their names without prior written
  *    permission of the Apache Group.
  *
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  * SUCH DAMAGE.
  * ====================================================================
  *
  * This software consists of voluntary contributions made by many
  * individuals on behalf of the Apache Software Foundation.  For more
  * information on the Apache Software Foundation, please see
  * <http://www.apache.org/>.
  */

 package org.apache.tools.ant.taskdefs.optional.jsp;

 import java.io.File;
 import java.util.Date;

 import java.util.Vector;
 import java.util.Enumeration;

 import org.apache.tools.ant.BuildException;
 import org.apache.tools.ant.DirectoryScanner;
 import org.apache.tools.ant.Project;

 import org.apache.tools.ant.taskdefs.MatchingTask;
 import org.apache.tools.ant.taskdefs.optional.jsp.compilers.JspCompilerAdapter;
 import org.apache.tools.ant.taskdefs.optional.jsp.compilers.JspCompilerAdapterFactory;

 import org.apache.tools.ant.types.Path;
 import org.apache.tools.ant.types.Reference;

 /**
  * Runs a JSP compiler.
  *
  * <p> This task takes the given jsp files and compiles them into java
  * files. It is then up to the user to compile the java files into classes.
  *
  * <p> The task requires the srcdir and destdir attributes to be
  * set. This Task is a MatchingTask, so the files to be compiled can be
  * specified using includes/excludes attributes or nested include/exclude
  * elements. Optional attributes are verbose (set the verbosity level passed
  * to jasper), package (name of the destination package for generated java
  * classes and classpath (the classpath to use when running the jsp
  * compiler).
  * <p> This task supports the nested elements classpath (A Path) and
  * classpathref (A Reference) which can be used in preference to the
  * attribute classpath, if the jsp compiler is not already in the ant
  * classpath.
  *
  * <p><h4>Usage</h4>
  * <pre>
  * &lt;jspc srcdir="${basedir}/src/war"
  *       destdir="${basedir}/gensrc"
  *       package="com.i3sp.jsp"
  *       verbose="9"&gt;
  *   &lt;include name="**\/*.jsp" /&gt;
  * &lt;/jspc&gt;
  * </pre>
  *
  * @author Steve Loughran
  * @author <a href="mailto:mattw@i3sp.com">Matthew Watson</a>
  * <p> Large Amount of cutting and pasting from the Javac task...
  * @author James Davidson <a href="mailto:duncan@x180.com">duncan@x180.com</a>
  * @author Robin Green <a href="mailto:greenrd@hotmail.com">greenrd@hotmail.com</a>
  * @author <a href="mailto:stefan.bodewig@epost.de">Stefan Bodewig</a>
  * @author <a href="mailto:jayglanville@home.com">J D Glanville</a>
  * @since 1.5
  */
 public class JspC extends MatchingTask {
     /* ------------------------------------------------------------ */
     private Path classpath;
     private Path src;
     private File destDir;
     private String packageName ;
     /** name of the compiler to use */
     private String compilerName = "jasper";

     /**
      *  -ieplugin &lt;clsid&gt; Java Plugin classid for Internet Explorer
      */
     private String iepluginid ;
     private boolean mapped ;
     private int verbose = 0;
     protected Vector compileList = new Vector();
     Vector javaFiles = new Vector();

     /**
      *  flag to control action on execution trouble
      */
     protected boolean failOnError = true;

     /**
      *  -uribase &lt;dir&gt; The uri directory compilations should be relative to
      *  (Default is "/")
      */

     private File uribase;

     /**
      *  -uriroot &lt;dir&gt; The root directory that uri files should be resolved
      *  against,
      */
     private File uriroot;

     /**
      *  -webinc &lt;file&gt; Creates partial servlet mappings for the -webapp option
      */
     private File webinc;

     /**
      *  -webxml &lt;file&gt; Creates a complete web.xml when using the -webapp option.
      */

     private File webxml;

     /**
      *  web apps
      */
     protected WebAppParameter webApp;


     private static final String FAIL_MSG
         = "Compile failed, messages should have been provided.";
     /* ------------------------------------------------------------ */
     /**
      * Path for source JSP files.
      */
     public void setSrcdir(Path srcDir) {
         if (src == null) {
             src = srcDir;
         } else {
             src.append(srcDir);
         }
     }
     public Path getSrcDir(){
         return src;
     }
     /* ------------------------------------------------------------ */
     /**
      * Set the destination directory into which the JSP source
      * files should be compiled.
      */
     public void setDestdir(File destDir) {
         this.destDir = destDir;
     }
     public File getDestdir(){
         return destDir;
     }
     /* ------------------------------------------------------------ */

     /**
      * Set the name of the package the compiled jsp files should be in.
      */
     public void setPackage(String pkg){
         this.packageName = pkg;
     }

     public String getPackage(){
         return packageName;
     }

     /* ------------------------------------------------------------ */
     /**
      * Set the verbose level of the compiler
      */
     public void setVerbose(int i){
         verbose = i;
     }
     public int getVerbose(){
         return verbose;
     }

     /* ------------------------------------------------------------ */
     /**
      * should the build halt if compilation fails? default=true
      */
     public void setFailonerror(boolean fail) {
         failOnError = fail;
     }
     /**
      * Gets the failonerror flag.
      */
     public boolean getFailonerror() {
         return failOnError;
     }
     /* ------------------------------------------------------------ */
     public String getIeplugin() {
         return iepluginid;
     }
     /**
      * Java Plugin CLASSID for Internet Explorer
      */
     public void setIeplugin(String iepluginid_) {
         iepluginid = iepluginid_;
     }
     /* ------------------------------------------------------------ */
     public boolean isMapped() {
         return mapped;
     }
     /**
      * If true, generate separate write() calls for each HTML line
      * in the JSP.
      */
     public void setMapped(boolean mapped_) {
         mapped = mapped_;
     }

     /**
      * The URI context of relative URI references in the JSP pages.
      * If it does not exist then it is derived from the location
      * of the file relative to the declared or derived value of uriroot.
      *
      * @param  uribase  The new Uribase value
      */
     public void setUribase(File uribase) {
         this.uribase = uribase;
     }

     public File getUribase() {
         return uriroot;
     }

     /**
      *  The root directory that uri files should be resolved
      *  against. (Default is the directory jspc is invoked from)
      *
      * @param  uriroot  The new Uribase value
      */
     public void setUriroot(File uriroot) {
         this.uriroot = uriroot;
     }

     public File getUriroot() {
         return uriroot;
     }


     /* ------------------------------------------------------------ */
     /**
      * Set the classpath to be used for this compilation.
      */
     public void setClasspath(Path cp) {
         if (classpath == null) {
             classpath = cp;
         } else {
             classpath.append(cp);
         }
     }

     /**
      * Adds a path to the classpath.
      */
     public Path createClasspath() {
         if (classpath == null) {
             classpath = new Path(project);
         }
         return classpath.createPath();
     }

     /**
      * Adds a reference to a classpath defined elsewhere
      */
     public void setClasspathRef(Reference r) {
         createClasspath().setRefid(r);
     }
     public Path getClasspath(){
         return classpath;
     }

     /**
      *  Filename for web.xml.
      *
      * @param  webxml  The new Webxml value
      */
     public void setWebxml(File webxml) {
         this.webxml = webxml;
     }

     public File getWebxml() {
         return this.webxml;
     }

     /**
      *  output filename for the fraction of web.xml that lists
      *  servlets.
      * @param  webinc  The new Webinc value
      */
     public void setWebinc(File webinc) {
         this.webinc = webinc;
     }

     public File getWebinc() {
         return this.webinc;
     }

     /**
      * Adds a single webapp.
      *
      * @param  webappParam  add a web app parameter
      */
     public void addWebApp(WebAppParameter webappParam)
         throws BuildException {
         //demand create vector of filesets
         if (webApp == null) {
             webApp = webappParam;
         } else {
             throw new BuildException("Only one webapp can be specified");
         }
     }

     public WebAppParameter getWebApp() {
         return webApp;
     }

     /**
      * Class name of a JSP compiler adapter.
      */
     public void setCompiler(String compiler) {
         this.compilerName = compiler;
     }

     /**
     * get the list of files to compile
     */
     public Vector getCompileList(){
         return compileList;
     }

     /**
      * execute by building up a list of files that
      * have changed and hand them off to a jsp compiler
      */
     public void execute()
         throws BuildException {
         // first off, make sure that we've got a srcdir
         if (src == null) {
             throw new BuildException("srcdir attribute must be set!",
                                      location);
         }
         String [] list = src.list();
         if (list.length == 0) {
             throw new BuildException("srcdir attribute must be set!",
                                      location);
         }

         if (destDir != null && !destDir.isDirectory()) {
             throw new
                 BuildException("destination directory \"" + destDir +
                                "\" does not exist or is not a directory",
                                location);
         }

         File dest = getActualDestDir();

         //bind to a compiler
         JspCompilerAdapter compiler =
             JspCompilerAdapterFactory.getCompiler(compilerName, this);

         // if the compiler does its own dependency stuff, we just call it right now
         if (compiler.implementsOwnDependencyChecking()) {
             doCompilation(compiler);
             return;
         }

         //the remainder of this method is only for compilers that need their dependency work done
         JspMangler mangler = compiler.createMangler();

         // scan source directories and dest directory to build up both copy
         // lists and compile lists
         resetFileLists();
         int filecount = 0;
         for (int i = 0; i < list.length; i++) {
             File srcDir = (File) project.resolveFile(list[i]);
             if (!srcDir.exists()) {
                 throw new BuildException("srcdir \"" + srcDir.getPath() +
                                          "\" does not exist!", location);
             }
             DirectoryScanner ds = this.getDirectoryScanner(srcDir);
             String[] files = ds.getIncludedFiles();
             filecount = files.length;
             scanDir(srcDir, dest, mangler, files);
         }

         // compile the source files

         log("compiling " + compileList.size() + " files", Project.MSG_VERBOSE);

         if (compileList.size() > 0) {

             log("Compiling " + compileList.size() +
                 " source file"
                 + (compileList.size() == 1 ? "" : "s")
                 + dest);
             doCompilation(compiler);

         } else {
             if (filecount == 0) {
                 log("there were no files to compile", Project.MSG_INFO);
             } else {
                 log("all files are up to date", Project.MSG_VERBOSE);
             }
         }
     }

     /**
      * calculate where the files will end up:
      * this is destDir or it id destDir + the package name
      */
     private File getActualDestDir() {
         File dest = null;
         if (packageName == null) {
             dest = destDir;
         } else {
             String path = destDir.getPath() + File.separatorChar +
                 packageName.replace('.', File.separatorChar);
             dest = new File(path);
         }
         return dest;
     }

     /**
      * do the compile
      */
     private void doCompilation(JspCompilerAdapter compiler)
             throws BuildException {
         // now we need to populate the compiler adapter
         compiler.setJspc(this);

         // finally, lets execute the compiler!!
         if (!compiler.execute()) {
             if (failOnError) {
                 throw new BuildException(FAIL_MSG, location);
             } else {
                 log(FAIL_MSG, Project.MSG_ERR);
             }
         }
     }

     /* ------------------------------------------------------------ */
     /**
      * Clear the list of files to be compiled and copied..
      */
     protected void resetFileLists() {
         compileList.removeAllElements();
     }

     /* ------------------------------------------------------------ */
     /**
      * Scans the directory looking for source files to be compiled.
      * The results are returned in the class variable compileList
      */
     protected void scanDir(File srcDir, File dest, JspMangler mangler, String files[]) {

         long now = (new Date()).getTime();

         for (int i = 0; i < files.length; i++) {
             String filename = files[i];
             File srcFile = new File(srcDir, filename);
             File javaFile = mapToJavaFile(mangler, srcFile, srcDir, dest);

             if (srcFile.lastModified() > now) {
                 log("Warning: file modified in the future: " + filename,
                         Project.MSG_WARN);
             }
             boolean shouldCompile = false;
             shouldCompile = isCompileNeeded(srcFile, javaFile);
             if (shouldCompile) {
                compileList.addElement(srcFile.getAbsolutePath());
                javaFiles.addElement(javaFile);
             }
         }
     }

     /**
      * Test whether or not compilation is needed. A return value of
      * <code>true<code> means yes, <code>false</code> means
      * our tests do not indicate this, but as the TLDs are
      * not used for dependency checking this is not guaranteed.
      * The current tests are
      * <ol>
      * <li>no dest file
      * <li>dest file out of date w.r.t source
      * <li>dest file zero bytes long
      * </ol>
      * @param srcFile JSP source file
      * @param javaFile JSP dest file
      * @return true if a compile is definately needed.
      *
      */
     private boolean isCompileNeeded(File srcFile, File javaFile) {
         boolean shouldCompile = false;
         if (!javaFile.exists()) {
             shouldCompile = true;
             log("Compiling " + srcFile.getPath()
                 + " because java file " + javaFile.getPath()
                 + " does not exist", Project.MSG_VERBOSE);
             } else {
                 if (srcFile.lastModified() > javaFile.lastModified()) {
                     shouldCompile = true;
                     log("Compiling " + srcFile.getPath()
                         + " because it is out of date with respect to "
                         + javaFile.getPath(),
                         Project.MSG_VERBOSE);
                 } else {
                     if (javaFile.length() == 0) {
                         shouldCompile = true;
                         log("Compiling " + srcFile.getPath()
                             + " because java file " + javaFile.getPath()
                             + " is empty", Project.MSG_VERBOSE);
                     }
                 }
         }
         return shouldCompile;
     }


     /**
      * get a filename from our jsp file
      * @todo support packages and subdirs
      */
     protected File mapToJavaFile(JspMangler mangler, File srcFile, File srcDir, File dest) {
         if (!srcFile.getName().endsWith(".jsp")) {
             return null;
         }
         String javaFileName = mangler.mapJspToJavaName(srcFile);
 //        String srcFileDir=srcFile.getParent();
         String packageNameIn = srcFile.getAbsolutePath();
         return new File(dest, javaFileName);
     }

     /**
      * delete any java output files that are empty
      * this is to get around a little defect in jasper: when it
      * fails, it leaves incomplete files around.
      */
     public void deleteEmptyJavaFiles() {
         if (javaFiles != null) {
             Enumeration enum = javaFiles.elements();
             while (enum.hasMoreElements()) {
                 File file = (File) enum.nextElement();
                 if (file.exists() && file.length() == 0) {
                     log("deleting empty output file " + file);
                     file.delete();
                 }
             }
         }
     }

     /**
      * static inner class used as a parameter element
      */
     public static class WebAppParameter {

         /**
          * the sole option
          */
         private File directory;

         /**
          * query current directory
          */

         public File getDirectory() {
             return directory;
         }

     /**
      * set directory; alternate syntax
      */
         public void setBaseDir(File directory) {
             this.directory = directory;
         }
     //end inner class
     }


 //end class
 }
	/*
	* The Apache Software License, Version 1.1
	*
	* Copyright (c) 2001-2002 The Apache Software Foundation. All rights
	* reserved.
	*
	* Redistribution and use in source and binary forms, with or without
	* modification, are permitted provided that the following conditions
	* are met:
	*
	* 1. Redistributions of source code must retain the above copyright
	* notice, this list of conditions and the following disclaimer.
	*
	* 2. Redistributions in binary form must reproduce the above copyright
	* notice, this list of conditions and the following disclaimer in
	* the documentation and/or other materials provided with the
	* distribution.
	*
	* 3. The end-user documentation included with the redistribution, if
	* any, must include the following acknowlegement:
	* "This product includes software developed by the
	* Apache Software Foundation (http://www.apache.org/)."
	* Alternately, this acknowlegement may appear in the software itself,
	* if and wherever such third-party acknowlegements normally appear.
	*
	* 4. The names "The Jakarta Project", "Ant", and "Apache Software
	* Foundation" must not be used to endorse or promote products derived
	* from this software without prior written permission. For written
	* permission, please contact apache@apache.org.
	*
	* 5. Products derived from this software may not be called "Apache"
	* nor may "Apache" appear in their names without prior written
	* permission of the Apache Group.
	*
	* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
	* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
	* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
	* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
	* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
	* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
	* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
	* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
	* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	* SUCH DAMAGE.
	* ====================================================================
	*
	* This software consists of voluntary contributions made by many
	* individuals on behalf of the Apache Software Foundation. For more
	* information on the Apache Software Foundation, please see
	* <http://www.apache.org/>.
	*/

	package org.apache.tools.ant.taskdefs.optional.jsp;

	import java.io.File;
	import java.util.Date;

	import java.util.Vector;
	import java.util.Enumeration;

	import org.apache.tools.ant.BuildException;
	import org.apache.tools.ant.DirectoryScanner;
	import org.apache.tools.ant.Project;

	import org.apache.tools.ant.taskdefs.MatchingTask;
	import org.apache.tools.ant.taskdefs.optional.jsp.compilers.JspCompilerAdapter;
	import org.apache.tools.ant.taskdefs.optional.jsp.compilers.JspCompilerAdapterFactory;

	import org.apache.tools.ant.types.Path;
	import org.apache.tools.ant.types.Reference;

	/**
	* Runs a JSP compiler.
	*
	* <p> This task takes the given jsp files and compiles them into java
	* files. It is then up to the user to compile the java files into classes.
	*
	* <p> The task requires the srcdir and destdir attributes to be
	* set. This Task is a MatchingTask, so the files to be compiled can be
	* specified using includes/excludes attributes or nested include/exclude
	* elements. Optional attributes are verbose (set the verbosity level passed
	* to jasper), package (name of the destination package for generated java
	* classes and classpath (the classpath to use when running the jsp
	* compiler).
	* <p> This task supports the nested elements classpath (A Path) and
	* classpathref (A Reference) which can be used in preference to the
	* attribute classpath, if the jsp compiler is not already in the ant
	* classpath.
	*
	* <p><h4>Usage</h4>
	* <pre>
	* <jspc srcdir="${basedir}/src/war"
	* destdir="${basedir}/gensrc"
	* package="com.i3sp.jsp"
	* verbose="9">
	* <include name="*\/.jsp" />
	* </jspc>
	* </pre>
	*
	* @author Steve Loughran
	* @author <a href="mailto:mattw@i3sp.com">Matthew Watson</a>
	* <p> Large Amount of cutting and pasting from the Javac task...
	* @author James Davidson <a href="mailto:duncan@x180.com">duncan@x180.com</a>
	* @author Robin Green <a href="mailto:greenrd@hotmail.com">greenrd@hotmail.com</a>
	* @author <a href="mailto:stefan.bodewig@epost.de">Stefan Bodewig</a>
	* @author <a href="mailto:jayglanville@home.com">J D Glanville</a>
	* @since 1.5
	*/
	public class JspC extends MatchingTask {
	/* ------------------------------------------------------------ */
	private Path classpath;
	private Path src;
	private File destDir;
	private String packageName ;
	/** name of the compiler to use */
	private String compilerName = "jasper";

	/**
	* -ieplugin <clsid> Java Plugin classid for Internet Explorer
	*/
	private String iepluginid ;
	private boolean mapped ;
	private int verbose = 0;
	protected Vector compileList = new Vector();
	Vector javaFiles = new Vector();

	/**
	* flag to control action on execution trouble
	*/
	protected boolean failOnError = true;

	/**
	* -uribase <dir> The uri directory compilations should be relative to
	* (Default is "/")
	*/

	private File uribase;

	/**
	* -uriroot <dir> The root directory that uri files should be resolved
	* against,
	*/
	private File uriroot;

	/**
	* -webinc <file> Creates partial servlet mappings for the -webapp option
	*/
	private File webinc;

	/**
	* -webxml <file> Creates a complete web.xml when using the -webapp option.
	*/

	private File webxml;

	/**
	* web apps
	*/
	protected WebAppParameter webApp;



	private static final String FAIL_MSG
	= "Compile failed, messages should have been provided.";
	/* ------------------------------------------------------------ */
	/**
	* Path for source JSP files.
	*/
	public void setSrcdir(Path srcDir) {
	if (src == null) {
	src = srcDir;
	} else {
	src.append(srcDir);
	}
	}
	public Path getSrcDir(){
	return src;
	}
	/* ------------------------------------------------------------ */
	/**
	* Set the destination directory into which the JSP source
	* files should be compiled.
	*/
	public void setDestdir(File destDir) {
	this.destDir = destDir;
	}
	public File getDestdir(){
	return destDir;
	}
	/* ------------------------------------------------------------ */

	/**
	* Set the name of the package the compiled jsp files should be in.
	*/
	public void setPackage(String pkg){
	this.packageName = pkg;
	}

	public String getPackage(){
	return packageName;
	}

	/* ------------------------------------------------------------ */
	/**
	* Set the verbose level of the compiler
	*/
	public void setVerbose(int i){
	verbose = i;
	}
	public int getVerbose(){
	return verbose;
	}

	/* ------------------------------------------------------------ */
	/**
	* should the build halt if compilation fails? default=true
	*/
	public void setFailonerror(boolean fail) {
	failOnError = fail;
	}
	/**
	* Gets the failonerror flag.
	*/
	public boolean getFailonerror() {
	return failOnError;
	}
	/* ------------------------------------------------------------ */
	public String getIeplugin() {
	return iepluginid;
	}
	/**
	* Java Plugin CLASSID for Internet Explorer
	*/
	public void setIeplugin(String iepluginid_) {
	iepluginid = iepluginid_;
	}
	/* ------------------------------------------------------------ */
	public boolean isMapped() {
	return mapped;
	}
	/**
	* If true, generate separate write() calls for each HTML line
	* in the JSP.
	*/
	public void setMapped(boolean mapped_) {
	mapped = mapped_;
	}

	/**
	* The URI context of relative URI references in the JSP pages.
	* If it does not exist then it is derived from the location
	* of the file relative to the declared or derived value of uriroot.
	*
	* @param uribase The new Uribase value
	*/
	public void setUribase(File uribase) {
	this.uribase = uribase;
	}

	public File getUribase() {
	return uriroot;
	}

	/**
	* The root directory that uri files should be resolved
	* against. (Default is the directory jspc is invoked from)
	*
	* @param uriroot The new Uribase value
	*/
	public void setUriroot(File uriroot) {
	this.uriroot = uriroot;
	}

	public File getUriroot() {
	return uriroot;
	}


	/* ------------------------------------------------------------ */
	/**
	* Set the classpath to be used for this compilation.
	*/
	public void setClasspath(Path cp) {
	if (classpath == null) {
	classpath = cp;
	} else {
	classpath.append(cp);
	}
	}

	/**
	* Adds a path to the classpath.
	*/
	public Path createClasspath() {
	if (classpath == null) {
	classpath = new Path(project);
	}
	return classpath.createPath();
	}

	/**
	* Adds a reference to a classpath defined elsewhere
	*/
	public void setClasspathRef(Reference r) {
	createClasspath().setRefid(r);
	}
	public Path getClasspath(){
	return classpath;
	}

	/**
	* Filename for web.xml.
	*
	* @param webxml The new Webxml value
	*/
	public void setWebxml(File webxml) {
	this.webxml = webxml;
	}

	public File getWebxml() {
	return this.webxml;
	}

	/**
	* output filename for the fraction of web.xml that lists
	* servlets.
	* @param webinc The new Webinc value
	*/
	public void setWebinc(File webinc) {
	this.webinc = webinc;
	}

	public File getWebinc() {
	return this.webinc;
	}

	/**
	* Adds a single webapp.
	*
	* @param webappParam add a web app parameter
	*/
	public void addWebApp(WebAppParameter webappParam)
	throws BuildException {
	//demand create vector of filesets
	if (webApp == null) {
	webApp = webappParam;
	} else {
	throw new BuildException("Only one webapp can be specified");
	}
	}

	public WebAppParameter getWebApp() {
	return webApp;
	}

	/**
	* Class name of a JSP compiler adapter.
	*/
	public void setCompiler(String compiler) {
	this.compilerName = compiler;
	}

	/**
	* get the list of files to compile
	*/
	public Vector getCompileList(){
	return compileList;
	}

	/**
	* execute by building up a list of files that
	* have changed and hand them off to a jsp compiler
	*/
	public void execute()
	throws BuildException {
	// first off, make sure that we've got a srcdir
	if (src == null) {
	throw new BuildException("srcdir attribute must be set!",
	location);
	}
	String [] list = src.list();
	if (list.length == 0) {
	throw new BuildException("srcdir attribute must be set!",
	location);
	}

	if (destDir != null && !destDir.isDirectory()) {
	throw new
	BuildException("destination directory \"" + destDir +
	"\" does not exist or is not a directory",
	location);
	}

	File dest = getActualDestDir();

	//bind to a compiler
	JspCompilerAdapter compiler =
	JspCompilerAdapterFactory.getCompiler(compilerName, this);

	// if the compiler does its own dependency stuff, we just call it right now
	if (compiler.implementsOwnDependencyChecking()) {
	doCompilation(compiler);
	return;
	}

	//the remainder of this method is only for compilers that need their dependency work done
	JspMangler mangler = compiler.createMangler();

	// scan source directories and dest directory to build up both copy
	// lists and compile lists
	resetFileLists();
	int filecount = 0;
	for (int i = 0; i < list.length; i++) {
	File srcDir = (File) project.resolveFile(list[i]);
	if (!srcDir.exists()) {
	throw new BuildException("srcdir \"" + srcDir.getPath() +
	"\" does not exist!", location);
	}
	DirectoryScanner ds = this.getDirectoryScanner(srcDir);
	String[] files = ds.getIncludedFiles();
	filecount = files.length;
	scanDir(srcDir, dest, mangler, files);
	}

	// compile the source files

	log("compiling " + compileList.size() + " files", Project.MSG_VERBOSE);

	if (compileList.size() > 0) {

	log("Compiling " + compileList.size() +
	" source file"
	+ (compileList.size() == 1 ? "" : "s")
	+ dest);
	doCompilation(compiler);

	} else {
	if (filecount == 0) {
	log("there were no files to compile", Project.MSG_INFO);
	} else {
	log("all files are up to date", Project.MSG_VERBOSE);
	}
	}
	}

	/**
	* calculate where the files will end up:
	* this is destDir or it id destDir + the package name
	*/
	private File getActualDestDir() {
	File dest = null;
	if (packageName == null) {
	dest = destDir;
	} else {
	String path = destDir.getPath() + File.separatorChar +
	packageName.replace('.', File.separatorChar);
	dest = new File(path);
	}
	return dest;
	}

	/**
	* do the compile
	*/
	private void doCompilation(JspCompilerAdapter compiler)
	throws BuildException {
	// now we need to populate the compiler adapter
	compiler.setJspc(this);

	// finally, lets execute the compiler!!
	if (!compiler.execute()) {
	if (failOnError) {
	throw new BuildException(FAIL_MSG, location);
	} else {
	log(FAIL_MSG, Project.MSG_ERR);
	}
	}
	}

	/* ------------------------------------------------------------ */
	/**
	* Clear the list of files to be compiled and copied..
	*/
	protected void resetFileLists() {
	compileList.removeAllElements();
	}

	/* ------------------------------------------------------------ */
	/**
	* Scans the directory looking for source files to be compiled.
	* The results are returned in the class variable compileList
	*/
	protected void scanDir(File srcDir, File dest, JspMangler mangler, String files[]) {

	long now = (new Date()).getTime();

	for (int i = 0; i < files.length; i++) {
	String filename = files[i];
	File srcFile = new File(srcDir, filename);
	File javaFile = mapToJavaFile(mangler, srcFile, srcDir, dest);

	if (srcFile.lastModified() > now) {
	log("Warning: file modified in the future: " + filename,
	Project.MSG_WARN);
	}
	boolean shouldCompile = false;
	shouldCompile = isCompileNeeded(srcFile, javaFile);
	if (shouldCompile) {
	compileList.addElement(srcFile.getAbsolutePath());
	javaFiles.addElement(javaFile);
	}
	}
	}

	/**
	* Test whether or not compilation is needed. A return value of
	* <code>true<code> means yes, <code>false</code> means
	* our tests do not indicate this, but as the TLDs are
	* not used for dependency checking this is not guaranteed.
	* The current tests are
	* <ol>
	* <li>no dest file
	* <li>dest file out of date w.r.t source
	* <li>dest file zero bytes long
	* </ol>
	* @param srcFile JSP source file
	* @param javaFile JSP dest file
	* @return true if a compile is definately needed.
	*
	*/
	private boolean isCompileNeeded(File srcFile, File javaFile) {
	boolean shouldCompile = false;
	if (!javaFile.exists()) {
	shouldCompile = true;
	log("Compiling " + srcFile.getPath()
	+ " because java file " + javaFile.getPath()
	+ " does not exist", Project.MSG_VERBOSE);
	} else {
	if (srcFile.lastModified() > javaFile.lastModified()) {
	shouldCompile = true;
	log("Compiling " + srcFile.getPath()
	+ " because it is out of date with respect to "
	+ javaFile.getPath(),
	Project.MSG_VERBOSE);
	} else {
	if (javaFile.length() == 0) {
	shouldCompile = true;
	log("Compiling " + srcFile.getPath()
	+ " because java file " + javaFile.getPath()
	+ " is empty", Project.MSG_VERBOSE);
	}
	}
	}
	return shouldCompile;
	}


	/**
	* get a filename from our jsp file
	* @todo support packages and subdirs
	*/
	protected File mapToJavaFile(JspMangler mangler, File srcFile, File srcDir, File dest) {
	if (!srcFile.getName().endsWith(".jsp")) {
	return null;
	}
	String javaFileName = mangler.mapJspToJavaName(srcFile);
	// String srcFileDir=srcFile.getParent();
	String packageNameIn = srcFile.getAbsolutePath();
	return new File(dest, javaFileName);
	}

	/**
	* delete any java output files that are empty
	* this is to get around a little defect in jasper: when it
	* fails, it leaves incomplete files around.
	*/
	public void deleteEmptyJavaFiles() {
	if (javaFiles != null) {
	Enumeration enum = javaFiles.elements();
	while (enum.hasMoreElements()) {
	File file = (File) enum.nextElement();
	if (file.exists() && file.length() == 0) {
	log("deleting empty output file " + file);
	file.delete();
	}
	}
	}
	}

	/**
	* static inner class used as a parameter element
	*/
	public static class WebAppParameter {

	/**
	* the sole option
	*/
	private File directory;

	/**
	* query current directory
	*/

	public File getDirectory() {
	return directory;
	}

	/**
	* set directory; alternate syntax
	*/
	public void setBaseDir(File directory) {
	this.directory = directory;
	}
	//end inner class
	}


	//end class
	}