Class JspC
   <taskdef classname="org.apache.jasper.JspC" name="jasper" >
      <classpath>
          <pathelement location="${java.home}/../lib/tools.jar"/>
          <fileset dir="${ENV.CATALINA_HOME}/lib">
              <include name="*.jar"/>
          </fileset>
          <path refid="myjars"/>
       </classpath>
  </taskdef>
  <jasper verbose="0"
           package="my.package"
           uriroot="${webapps.dir}/${webapp.name}"
           webXmlFragment="${build.dir}/generated_web.xml"
           outputDir="${webapp.dir}/${webapp.name}/WEB-INF/src/my/package" />
 - Author:
- Danno Ferrin, Pierre Delisle, Costin Manolache, Yoav Shapira
- 
Field SummaryFieldsModifier and TypeFieldDescriptionprotected booleanprotected static final intprotected intprotected String[]protected booleanprotected final Map<String,TagLibraryInfo> protected booleanprotected booleanprotected Stringprotected booleanprotected Stringprotected Stringprotected Stringprotected JspCServletContextThe servlet context.protected static final intprotected intprotected booleanNeeds better documentation, this data member does.The file extensions to be handled as JSP files.protected booleanprotected booleanThrow an exception if there's a compilation error, or swallow it.protected static final intprotected booleanprotected booleanprotected booleanprotected static final intprotected StringThe java file encoding.protected JspConfigprotected static final Stringprotected booleanprotected ClassLoaderprotected Writerprotected booleanprotected CharArrayWriterprotected static final intThe pages.protected booleanprotected booleanprotected JspRuntimeContextThe runtime context.protected TldScannerprotected Fileprotected CharArrayWriterprotected static final Stringprotected booleanprotected booleanprotected booleanprotected booleanprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected TagPluginManagerprotected Stringprotected Stringprotected intThe number of threads to use; default is one per coreprotected TldCacheCache for the TLD locationsprotected TrimSpacesOptionprotected Stringprotected Stringprotected booleanprotected booleanprotected booleanprotected Stringprotected Stringprotected intprotected booleanFields inherited from class org.apache.tools.ant.Tasktarget, taskName, taskType, wrapperFields inherited from class org.apache.tools.ant.ProjectComponentdescription, location, project
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionprotected voidaddExtension(String extension) Adds the given file extension to the list of extensions handled as JSP files.protected voidvoidexecute()Executes the compilation.voidgenerateWebMapping(String file, JspCompilationContext clctxt) Adds servlet declaration and mapping for the JSP page servlet to the generated web.xml fragment.booleanIndicates whether text strings are to be generated as char arrays.getCache()The web-application wide cache for the TagLibraryInfo tag library descriptors, used ifOptions.isCaching()returnstrue.intIn JspC this always returns0.booleanCompiler to use.booleanIn JspC this always returnsfalse.booleanIn JspC this always returnstrue.booleanReturns true if Jasper issues a compilation error instead of a runtime Instantiation error if the class attribute specified in useBean action is invalid.Returns the list of file extensions that are treated as JSP files.booleanbooleangetFork()The boolean flag to tell Ant whether to fork JSP page compilations.booleanShould the container include the time the file was generated in the comments at the start of a Java file generated from a JSP or tag.Returns the encoding to use for java files.intbooleanIn JspC this always returnstrue.booleanintThe maximum number of loaded jsps per web-application.intIn JspC this always returns0.booleanbooleanIn JspC this always returnsfalse.booleanintThe cache that maps URIs, resource paths and parsed TLD files for the various tag libraries 'exposed' by the web application.protected ClassLoaderInitializes the classloader as/if needed for the given compilation context.protected voidinitServletContext(ClassLoader classLoader) protected voidinitTldScanner(JspCServletContext context, ClassLoader classLoader) protected voidbooleanbooleanbooleanbooleanThis setting is ignored if suppressSmap() istrue.booleanbooleanbooleanbooleanprotected voidFind the WEB-INF dir by looking up in the directory tree.static voidprotected voidInclude the generated web.xml inside the webapp's web.xml.protected TldScannernewTldScanner(JspCServletContext context, boolean namespaceAware, boolean validate, boolean blockExternal) protected StringnextArg()protected StringnextFile()protected voidprocessFile(String file) protected FileResolves the relative or absolute pathname correctly in both Ant and command-line situations.voidLocate all jsp files in the webapp.voidsetAddWebXmlMappings(boolean b) Sets the option to merge generated web.xml fragment into the WEB-INF/web.xml file of the web application that we were processing.voidApply command-line arguments.voidsetBlockExternal(boolean b) voidsetCaching(boolean caching) Sets the option to enable caching.voidsetClassDebugInfo(boolean b) Sets the option to include debug information in compiled class.voidClass name of the generated file ( without package ).voidSets the classpath used while compiling the servlets generated from JSP filesvoidsetCompile(boolean b) Sets the compile flag.voidSets the option to determine what compiler to use.voidSets the compiler source VM.voidSets the compiler target VM.voidsetErrorOnUseBeanInvalidClassAttribute(boolean b) Sets the option to issue a compilation error if the class attribute specified in useBean action is invalid.voidsetFailOnError(boolean b) Sets the option that throws an exception in case of a compilation error.voidsetFork(boolean fork) voidsetGenStringAsCharArray(boolean genStringAsCharArray) Determines whether text strings are to be generated as char arrays, which improves performance in some cases.voidsetJavaEncoding(String encodingName) Sets the encoding to use for java files.voidsetJspFiles(String jspFiles) Parses comma-separated list of JSP files to be processed.voidsetListErrors(boolean b) voidsetMappedFile(boolean b) voidvoidsetPackage(String p) Sets the package name to be used for the generated servlet classes.voidsetPoolingEnabled(boolean poolingEnabled) Sets the option to enable the tag handler pooling.voidsetQuoteAttributeEL(boolean b) voidsetSmapDumped(boolean smapDumped) Sets smapDumped flag.voidsetSmapSuppressed(boolean smapSuppressed) Sets smapSuppressed flag.voidsetStrictQuoteEscaping(boolean b) voidsetThreadCount(String threadCount) voidsetTrimSpaces(boolean trimSpaces) voidsetTrimSpaces(String ts) Sets the option to control handling of template text that consists entirely of whitespace.voidsetTrimSpaces(TrimSpacesOption trimSpaces) voidsetUriroot(String s) Base dir for the webapp.voidsetValidateTld(boolean b) voidsetValidateXml(boolean b) voidsetVerbose(int level) Sets the verbosity level.voidFile where we generate a complete web-fragment.xml with the class definitions.voidFile where we generate a complete web.xml with the class definitions.voidsetWebXmlEncoding(String encoding) Sets the encoding to be used to read and write web.xml files.voidFile where we generate configuration with the class definitions to be included in a web.xml file.voidsetXpoweredBy(boolean xpoweredBy) Sets the option to enable generation of X-Powered-By response header.Methods inherited from class org.apache.tools.ant.TaskbindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskTypeMethods inherited from class org.apache.tools.ant.ProjectComponentclone, getDescription, getLocation, getProject, setDescription, setLocation, setProjectMethods inherited from class java.lang.Objectequals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.apache.jasper.OptionsgetGeneratedJspPackageName, getGeneratedTagFilePackageName, getJspPrecompilationQueryParameter, getJspServletBase, getPoolTagsWithExtends, getServiceMethodName, getServletClasspathAttribute, getStrictGetProperty, getStrictWhitespace, getTempVariableNamePrefix, getUseInstanceManagerForTags, getVariableForExpressionFactory, getVariableForInstanceManager
- 
Field Details- 
SWITCH_VERBOSE- See Also:
 
- 
SWITCH_HELP- See Also:
 
- 
SWITCH_OUTPUT_DIR- See Also:
 
- 
SWITCH_PACKAGE_NAME- See Also:
 
- 
SWITCH_CACHE- See Also:
 
- 
SWITCH_CLASS_NAME- See Also:
 
- 
SWITCH_FULL_STOP- See Also:
 
- 
SWITCH_COMPILE- See Also:
 
- 
SWITCH_FAIL_FAST- See Also:
 
- 
SWITCH_SOURCE- See Also:
 
- 
SWITCH_TARGET- See Also:
 
- 
SWITCH_URI_BASE- See Also:
 
- 
SWITCH_URI_ROOT- See Also:
 
- 
SWITCH_FILE_WEBAPP- See Also:
 
- 
SWITCH_WEBAPP_INC- See Also:
 
- 
SWITCH_WEBAPP_FRG- See Also:
 
- 
SWITCH_WEBAPP_XML- See Also:
 
- 
SWITCH_WEBAPP_XML_ENCODING- See Also:
 
- 
SWITCH_ADD_WEBAPP_XML_MAPPINGS- See Also:
 
- 
SWITCH_MAPPED- See Also:
 
- 
SWITCH_XPOWERED_BY- See Also:
 
- 
SWITCH_TRIM_SPACES- See Also:
 
- 
SWITCH_CLASSPATH- See Also:
 
- 
SWITCH_DIE- See Also:
 
- 
SWITCH_POOLING- See Also:
 
- 
SWITCH_ENCODING- See Also:
 
- 
SWITCH_SMAP- See Also:
 
- 
SWITCH_DUMP_SMAP- See Also:
 
- 
SWITCH_VALIDATE_TLD- See Also:
 
- 
SWITCH_VALIDATE_XML- See Also:
 
- 
SWITCH_NO_BLOCK_EXTERNAL- See Also:
 
- 
SWITCH_NO_STRICT_QUOTE_ESCAPING- See Also:
 
- 
SWITCH_QUOTE_ATTRIBUTE_EL- See Also:
 
- 
SWITCH_NO_QUOTE_ATTRIBUTE_EL- See Also:
 
- 
SWITCH_THREAD_COUNT- See Also:
 
- 
SHOW_SUCCESS- See Also:
 
- 
LIST_ERRORS- See Also:
 
- 
INC_WEBXMLprotected static final int INC_WEBXML- See Also:
 
- 
FRG_WEBXMLprotected static final int FRG_WEBXML- See Also:
 
- 
ALL_WEBXMLprotected static final int ALL_WEBXML- See Also:
 
- 
DEFAULT_DIE_LEVELprotected static final int DEFAULT_DIE_LEVEL- See Also:
 
- 
NO_DIE_LEVELprotected static final int NO_DIE_LEVEL- See Also:
 
- 
insertBefore
- 
classPath
- 
loader
- 
trimSpaces
- 
genStringAsCharArrayprotected boolean genStringAsCharArray
- 
validateTldprotected boolean validateTld
- 
validateXmlprotected boolean validateXml
- 
blockExternalprotected boolean blockExternal
- 
strictQuoteEscapingprotected boolean strictQuoteEscaping
- 
quoteAttributeELprotected boolean quoteAttributeEL
- 
xpoweredByprotected boolean xpoweredBy
- 
mappedFileprotected boolean mappedFile
- 
poolingEnabledprotected boolean poolingEnabled
- 
scratchDir
- 
targetPackage
- 
targetClassName
- 
uriBase
- 
uriRoot
- 
dieLevelprotected int dieLevel
- 
helpNeededprotected boolean helpNeeded
- 
compileprotected boolean compile
- 
failFastprotected boolean failFast
- 
smapSuppressedprotected boolean smapSuppressed
- 
smapDumpedprotected boolean smapDumped
- 
cachingprotected boolean caching
- 
cache
- 
compiler
- 
compilerTargetVM
- 
compilerSourceVM
- 
classDebugInfoprotected boolean classDebugInfo
- 
failOnErrorprotected boolean failOnErrorThrow an exception if there's a compilation error, or swallow it. Default is true to preserve old behavior.
- 
extensionsThe file extensions to be handled as JSP files. Default list is .jsp and .jspx.
- 
pagesThe pages.
- 
errorOnUseBeanInvalidClassAttributeprotected boolean errorOnUseBeanInvalidClassAttributeNeeds better documentation, this data member does. True by default.
- 
javaEncodingThe java file encoding. Default is UTF-8. Added per bugzilla 19622.
- 
threadCountprotected int threadCountThe number of threads to use; default is one per core
- 
webxmlFile
- 
webxmlLevelprotected int webxmlLevel
- 
webxmlEncoding
- 
addWebXmlMappingsprotected boolean addWebXmlMappings
- 
mapout
- 
servletout
- 
mappingout
- 
contextThe servlet context.
- 
rctxtThe runtime context. Maintain a dummy JspRuntimeContext for compiling tag files.
- 
tldCacheCache for the TLD locations
- 
jspConfig
- 
tagPluginManager
- 
scanner
- 
verboseprotected boolean verbose
- 
listErrorsprotected boolean listErrors
- 
showSuccessprotected boolean showSuccess
- 
argPosprotected int argPos
- 
fullstopprotected boolean fullstop
- 
args
 
- 
- 
Constructor Details- 
JspCpublic JspC()
 
- 
- 
Method Details- 
main
- 
setArgsApply command-line arguments.- Parameters:
- arg- The arguments
- Throws:
- JasperException- JSPC error
 
- 
getKeepGeneratedpublic boolean getKeepGenerated()In JspC this always returnstrue.- Specified by:
- getKeepGeneratedin interface- Options
- Returns:
- trueto keep the generated source
 
- 
getTrimSpaces- Specified by:
- getTrimSpacesin interface- Options
- Returns:
- TrimSpacesOption.TRUEto remove template text that consists only of whitespace from the output completely,- TrimSpacesOption.SINGLEto replace such template text with a single space,- TrimSpacesOption.FALSEto leave such template text unchanged or- TrimSpacesOption.EXTENDEDto remove template text that consists only of whitespace and to replace any sequence of whitespace and new lines within template text with a single new line.
 
- 
setTrimSpaces
- 
setTrimSpacesSets the option to control handling of template text that consists entirely of whitespace.- Parameters:
- ts- New value
 
- 
setTrimSpacespublic void setTrimSpaces(boolean trimSpaces) 
- 
isPoolingEnabledpublic boolean isPoolingEnabled()- Specified by:
- isPoolingEnabledin interface- Options
- Returns:
- trueif tag handler pooling is enabled,- falseotherwise.
 
- 
setPoolingEnabledpublic void setPoolingEnabled(boolean poolingEnabled) Sets the option to enable the tag handler pooling.- Parameters:
- poolingEnabled- New value
 
- 
isXpoweredBypublic boolean isXpoweredBy()- Specified by:
- isXpoweredByin interface- Options
- Returns:
- trueto generate a X-Powered-By response header.
 
- 
setXpoweredBypublic void setXpoweredBy(boolean xpoweredBy) Sets the option to enable generation of X-Powered-By response header.- Parameters:
- xpoweredBy- New value
 
- 
getDisplaySourceFragmentpublic boolean getDisplaySourceFragment()In JspC this always returnstrue.- Specified by:
- getDisplaySourceFragmentin interface- Options
- Returns:
- trueto include a source fragment in exception messages.
 
- 
getMaxLoadedJspspublic int getMaxLoadedJsps()Description copied from interface:OptionsThe maximum number of loaded jsps per web-application. If there are more jsps loaded, they will be unloaded. If unset or less than 0, no jsps are unloaded.- Specified by:
- getMaxLoadedJspsin interface- Options
- Returns:
- The JSP count
 
- 
getJspIdleTimeoutpublic int getJspIdleTimeout()- Specified by:
- getJspIdleTimeoutin interface- Options
- Returns:
- the idle time in seconds after which a JSP is unloaded. If unset or less or equal than 0, no jsps are unloaded.
 
- 
getErrorOnUseBeanInvalidClassAttributepublic boolean getErrorOnUseBeanInvalidClassAttribute()Description copied from interface:OptionsReturns true if Jasper issues a compilation error instead of a runtime Instantiation error if the class attribute specified in useBean action is invalid.- Specified by:
- getErrorOnUseBeanInvalidClassAttributein interface- Options
- Returns:
- trueto get an error
 
- 
setErrorOnUseBeanInvalidClassAttributepublic void setErrorOnUseBeanInvalidClassAttribute(boolean b) Sets the option to issue a compilation error if the class attribute specified in useBean action is invalid.- Parameters:
- b- New value
 
- 
getMappedFilepublic boolean getMappedFile()- Specified by:
- getMappedFilein interface- Options
- Returns:
- trueif HTML mapped Servlets are supported.
 
- 
setMappedFilepublic void setMappedFile(boolean b) 
- 
setClassDebugInfopublic void setClassDebugInfo(boolean b) Sets the option to include debug information in compiled class.- Parameters:
- b- New value
 
- 
getClassDebugInfopublic boolean getClassDebugInfo()- Specified by:
- getClassDebugInfoin interface- Options
- Returns:
- trueif debug information in included in compiled classes.
 
- 
isCachingpublic boolean isCaching()
- 
setCachingpublic void setCaching(boolean caching) Sets the option to enable caching.- Parameters:
- caching- New value
- See Also:
 
- 
getCacheDescription copied from interface:OptionsThe web-application wide cache for the TagLibraryInfo tag library descriptors, used ifOptions.isCaching()returnstrue.Using this cache avoids the cost of repeating the parsing of a tag library descriptor XML file (performed by TagLibraryInfoImpl.parseTLD). 
- 
getCheckIntervalpublic int getCheckInterval()In JspC this always returns0.- Specified by:
- getCheckIntervalin interface- Options
- Returns:
- background compile thread check interval in seconds
 
- 
getModificationTestIntervalpublic int getModificationTestInterval()In JspC this always returns0.- Specified by:
- getModificationTestIntervalin interface- Options
- Returns:
- modification test interval.
 
- 
getRecompileOnFailpublic boolean getRecompileOnFail()In JspC this always returnsfalse.- Specified by:
- getRecompileOnFailin interface- Options
- Returns:
- trueif re-compile will occur on a failure.
 
- 
getDevelopmentpublic boolean getDevelopment()In JspC this always returnsfalse. Main development flag, which enables detailed error reports with sources, as well automatic recompilation of JSPs and tag files. This setting should usually befalsewhen running in production.- Specified by:
- getDevelopmentin interface- Options
- Returns:
- trueif Jasper is in development mode
 
- 
isSmapSuppressedpublic boolean isSmapSuppressed()- Specified by:
- isSmapSuppressedin interface- Options
- Returns:
- trueto suppress generation of SMAP info for JSR45 debugging.
 
- 
setSmapSuppressedpublic void setSmapSuppressed(boolean smapSuppressed) Sets smapSuppressed flag.- Parameters:
- smapSuppressed- New value
 
- 
isSmapDumpedpublic boolean isSmapDumped()Description copied from interface:OptionsThis setting is ignored if suppressSmap() istrue.- Specified by:
- isSmapDumpedin interface- Options
- Returns:
- trueto write SMAP info for JSR45 debugging to a file.
 
- 
setSmapDumpedpublic void setSmapDumped(boolean smapDumped) Sets smapDumped flag.- Parameters:
- smapDumped- New value
- See Also:
 
- 
setGenStringAsCharArraypublic void setGenStringAsCharArray(boolean genStringAsCharArray) Determines whether text strings are to be generated as char arrays, which improves performance in some cases.- Parameters:
- genStringAsCharArray- true if text strings are to be generated as char arrays, false otherwise
 
- 
genStringAsCharArraypublic boolean genStringAsCharArray()Description copied from interface:OptionsIndicates whether text strings are to be generated as char arrays.- Specified by:
- genStringAsCharArrayin interface- Options
- Returns:
- trueif text strings are to be generated as char arrays,- falseotherwise
 
- 
getScratchDir- Specified by:
- getScratchDirin interface- Options
- Returns:
- the work folder
 
- 
getCompilerDescription copied from interface:OptionsCompiler to use.If null(the default), the java compiler from Eclipse JDT project, bundled with Tomcat, will be used. Otherwise, thejavactask from Apache Ant will be used to call an external java compiler and the value of this option will be passed to it. See Apache Ant documentation for the possible values.- Specified by:
- getCompilerin interface- Options
- Returns:
- the compiler name
 
- 
setCompilerSets the option to determine what compiler to use.- Parameters:
- c- New value
- See Also:
 
- 
getCompilerClassName- Specified by:
- getCompilerClassNamein interface- Options
- Returns:
- Jasper Java compiler class to use.
 
- 
getCompilerTargetVM- Specified by:
- getCompilerTargetVMin interface- Options
- Returns:
- the compiler target VM, e.g. 1.8.
 
- 
setCompilerTargetVMSets the compiler target VM.- Parameters:
- vm- New value
- See Also:
 
- 
getCompilerSourceVM- Specified by:
- getCompilerSourceVMin interface- Options
- Returns:
- the compiler source VM, e.g. 1.8.
 
- 
setCompilerSourceVMSets the compiler source VM.- Parameters:
- vm- New value
- See Also:
 
- 
getTldCacheDescription copied from interface:OptionsThe cache that maps URIs, resource paths and parsed TLD files for the various tag libraries 'exposed' by the web application. A tag library is 'exposed' either explicitly in web.xml or implicitly via the uri tag in the TLD of a taglib deployed in a jar file (WEB-INF/lib).- Specified by:
- getTldCachein interface- Options
- Returns:
- the instance of the TldLocationsCache for the web-application.
 
- 
getJavaEncodingReturns the encoding to use for java files. The default is UTF-8.- Specified by:
- getJavaEncodingin interface- Options
- Returns:
- String The encoding
 
- 
setJavaEncodingSets the encoding to use for java files.- Parameters:
- encodingName- The name, e.g. "UTF-8"
 
- 
getForkpublic boolean getFork()Description copied from interface:OptionsThe boolean flag to tell Ant whether to fork JSP page compilations.Is used only when Jasper uses an external java compiler (wrapped through a javacApache Ant task).
- 
setForkpublic void setFork(boolean fork) 
- 
getClassPath- Specified by:
- getClassPathin interface- Options
- Returns:
- the classpath used to compile generated Servlets
 
- 
setClassPathSets the classpath used while compiling the servlets generated from JSP files- Parameters:
- s- New value
 
- 
getExtensionsReturns the list of file extensions that are treated as JSP files.- Returns:
- The list of extensions
 
- 
addExtensionAdds the given file extension to the list of extensions handled as JSP files.- Parameters:
- extension- The extension to add, e.g. "myjsp"
 
- 
setUrirootBase dir for the webapp. Used to generate class names and resolve includes.- Parameters:
- s- New value
 
- 
setJspFilesParses comma-separated list of JSP files to be processed. If the argument is null, nothing is done.Each file is interpreted relative to uriroot, unless it is absolute, in which case it must start with uriroot. - Parameters:
- jspFiles- Comma-separated list of JSP files to be processed
 
- 
setCompilepublic void setCompile(boolean b) Sets the compile flag.- Parameters:
- b- Flag value
 
- 
setVerbosepublic void setVerbose(int level) Sets the verbosity level. The actual number doesn't matter: if it's greater than zero, the verbose flag will be true.- Parameters:
- level- Positive means verbose
 
- 
setValidateTldpublic void setValidateTld(boolean b) 
- 
isValidateTldpublic boolean isValidateTld()
- 
setValidateXmlpublic void setValidateXml(boolean b) 
- 
isValidateXmlpublic boolean isValidateXml()
- 
setBlockExternalpublic void setBlockExternal(boolean b) 
- 
isBlockExternalpublic boolean isBlockExternal()
- 
setStrictQuoteEscapingpublic void setStrictQuoteEscaping(boolean b) 
- 
getStrictQuoteEscapingpublic boolean getStrictQuoteEscaping()- Specified by:
- getStrictQuoteEscapingin interface- Options
- Returns:
- trueif the quote escaping required by section JSP.1.6 of the JSP specification should be applied to scriplet expression.
 
- 
setQuoteAttributeELpublic void setQuoteAttributeEL(boolean b) 
- 
getQuoteAttributeELpublic boolean getQuoteAttributeEL()- Specified by:
- getQuoteAttributeELin interface- Options
- Returns:
- trueif EL expressions used within attributes should have the quoting rules in JSP.1.6 applied to the expression.
 
- 
getThreadCountpublic int getThreadCount()
- 
setThreadCount
- 
setListErrorspublic void setListErrors(boolean b) 
- 
setOutputDir
- 
setPackageSets the package name to be used for the generated servlet classes.- Parameters:
- p- New value
 
- 
setClassNameClass name of the generated file ( without package ). Can only be used if a single file is converted. XXX Do we need this feature ?- Parameters:
- p- New value
 
- 
setWebXmlIncludeFile where we generate configuration with the class definitions to be included in a web.xml file.- Parameters:
- s- New value
 
- 
setWebFragmentXmlFile where we generate a complete web-fragment.xml with the class definitions.- Parameters:
- s- New value
 
- 
setWebXmlFile where we generate a complete web.xml with the class definitions.- Parameters:
- s- New value
 
- 
setWebXmlEncodingSets the encoding to be used to read and write web.xml files.If not specified, defaults to UTF-8. - Parameters:
- encoding- Encoding, e.g. "UTF-8".
 
- 
setAddWebXmlMappingspublic void setAddWebXmlMappings(boolean b) Sets the option to merge generated web.xml fragment into the WEB-INF/web.xml file of the web application that we were processing.- Parameters:
- b-- trueto merge the fragment into the existing web.xml file of the processed web application ({uriroot}/WEB-INF/web.xml),- falseto keep the generated web.xml fragment
 
- 
setFailOnErrorpublic void setFailOnError(boolean b) Sets the option that throws an exception in case of a compilation error.- Parameters:
- b- New value
 
- 
getFailOnErrorpublic boolean getFailOnError()- Returns:
- trueif an exception will be thrown in case of a compilation error.
 
- 
getJspConfig- Specified by:
- getJspConfigin interface- Options
- Returns:
- JSP configuration information specified in web.xml.
 
- 
getTagPluginManager- Specified by:
- getTagPluginManagerin interface- Options
- Returns:
- a Tag Plugin Manager
 
- 
getGeneratedJavaAddTimestamppublic boolean getGeneratedJavaAddTimestamp()Should the container include the time the file was generated in the comments at the start of a Java file generated from a JSP or tag. Defaults totrue.Hard-coded to falsefor pre-compiled code to enable repeatable builds.- Specified by:
- getGeneratedJavaAddTimestampin interface- Options
- Returns:
- trueto include the timestamp, otherwise don't include it
 
- 
generateWebMappingAdds servlet declaration and mapping for the JSP page servlet to the generated web.xml fragment.- Parameters:
- file- Context-relative path to the JSP file, e.g.- /index.jsp
- clctxt- Compilation context of the servlet
- Throws:
- IOException- An IO error occurred
 
- 
mergeIntoWebXmlInclude the generated web.xml inside the webapp's web.xml.- Throws:
- IOException- An IO error occurred
 
- 
processFile- Throws:
- JasperException
 
- 
scanFilespublic void scanFiles()Locate all jsp files in the webapp. Used if no explicit jsps are specified. Scan is performed via the ServletContext and will include any JSPs located in resource JARs.
- 
executepublic void execute()Executes the compilation.- Overrides:
- executein class- org.apache.tools.ant.Task
 
- 
nextArg
- 
nextFile
- 
initWebXml- Throws:
- JasperException
 
- 
completeWebXmlprotected void completeWebXml()
- 
initTldScanner
- 
newTldScannerprotected TldScanner newTldScanner(JspCServletContext context, boolean namespaceAware, boolean validate, boolean blockExternal) 
- 
initServletContext- Throws:
- IOException
- JasperException
 
- 
initClassLoaderInitializes the classloader as/if needed for the given compilation context.- Returns:
- the classloader that will be used
- Throws:
- IOException- If an error occurs
 
- 
locateUriRootFind the WEB-INF dir by looking up in the directory tree. This is used if no explicit docbase is set, but only files.- Parameters:
- f- The path from which it will start looking
 
- 
resolveFileResolves the relative or absolute pathname correctly in both Ant and command-line situations. If Ant launched us, we should use the basedir of the current project to resolve relative paths. See Bugzilla 35571.- Parameters:
- s- The file
- Returns:
- The file resolved
 
 
-