org.apache.jasper
public class JspC extends Object implements Options
<taskdef classname="org.apache.jasper.JspC" name="jasper2" > <classpath> <pathelement location="${java.home}/../lib/tools.jar"/> <fileset dir="${ENV.CATALINA_HOME}/server/lib"> <include name="*.jar"/> </fileset> <fileset dir="${ENV.CATALINA_HOME}/common/lib"> <include name="*.jar"/> </fileset> <path refid="myjars"/> </classpath> </taskdef> <jasper2 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" />
Field Summary | |
---|---|
protected static int | ALL_WEBXML |
protected boolean | addWebXmlMappings |
protected int | argPos |
protected String[] | args |
protected Map | cache |
protected boolean | caching |
protected boolean | classDebugInfo |
protected String | classPath |
protected boolean | compile |
protected String | compiler |
protected String | compilerSourceVM |
protected String | compilerTargetVM |
protected JspCServletContext | context
The servlet context. |
protected static int | die |
protected int | dieLevel |
protected static int | DEFAULT_DIE_LEVEL |
static String | DEFAULT_IE_CLASS_ID |
protected boolean | errorOnUseBeanInvalidClassAttribute
Needs better documentation, this data member does.
|
protected List | extensions
The file extensions to be handled as JSP files.
|
protected boolean | failOnError
Throw an exception if there's a compilation error, or swallow it.
|
protected boolean | fullstop |
protected boolean | genStringAsCharArray |
protected boolean | helpNeeded |
protected String | ieClassId |
protected static String[] | insertBefore |
protected static int | INC_WEBXML |
protected String | javaEncoding
The java file encoding. |
protected JspConfig | jspConfig |
protected boolean | listErrors |
protected URLClassLoader | loader |
protected static Log | log |
protected static String | LIST_ERRORS |
protected Writer | mapout |
protected boolean | mappedFile |
protected CharArrayWriter | mappingout |
protected static int | NO_DIE_LEVEL |
protected List | pages
The pages. |
protected boolean | poolingEnabled |
protected Project | project |
protected JspRuntimeContext | rctxt
The runtime context.
|
protected File | scratchDir |
protected CharArrayWriter | servletout |
protected boolean | showSuccess |
protected boolean | smapDumped |
protected boolean | smapSuppressed |
protected static String | SHOW_SUCCESS |
protected static String | SWITCH_CACHE |
protected static String | SWITCH_CLASSPATH |
protected static String | SWITCH_CLASS_NAME |
protected static String | SWITCH_COMPILE |
protected static String | SWITCH_DIE |
protected static String | SWITCH_DUMP_SMAP |
protected static String | SWITCH_ENCODING |
protected static String | SWITCH_FILE_WEBAPP |
protected static String | SWITCH_FULL_STOP |
protected static String | SWITCH_HELP |
protected static String | SWITCH_MAPPED |
protected static String | SWITCH_OUTPUT_DIR |
protected static String | SWITCH_PACKAGE_NAME |
protected static String | SWITCH_POOLING |
protected static String | SWITCH_SMAP |
protected static String | SWITCH_SOURCE |
protected static String | SWITCH_TARGET |
protected static String | SWITCH_TRIM_SPACES |
protected static String | SWITCH_URI_BASE |
protected static String | SWITCH_URI_ROOT |
protected static String | SWITCH_VERBOSE |
protected static String | SWITCH_WEBAPP_INC |
protected static String | SWITCH_WEBAPP_XML |
protected static String | SWITCH_XPOWERED_BY |
protected TagPluginManager | tagPluginManager |
protected String | targetClassName |
protected String | targetPackage |
protected TldLocationsCache | tldLocationsCache
Cache for the TLD locations |
protected boolean | trimSpaces |
protected String | uriBase |
protected String | uriRoot |
protected boolean | verbose |
protected String | webxmlFile |
protected int | webxmlLevel |
protected boolean | xpoweredBy |
Method Summary | |
---|---|
protected void | addExtension(String extension)
Adds the given file extension to the
list of extensions handled as JSP files.
|
protected void | completeWebXml() |
void | execute()
Executes the compilation.
|
void | generateWebMapping(String file, JspCompilationContext clctxt) |
boolean | genStringAsCharArray()
Indicates whether text strings are to be generated as char arrays.
|
Map | getCache() |
int | getCheckInterval()
Background compilation check intervals in seconds |
boolean | getClassDebugInfo() |
String | getClassPath() |
String | getCompiler()
Compiler to use. |
String | getCompilerClassName()
Compiler class name to use. |
String | getCompilerSourceVM() |
String | getCompilerTargetVM() |
boolean | getDevelopment()
Is Jasper being used in development mode? |
boolean | getDisplaySourceFragment() |
boolean | getErrorOnUseBeanInvalidClassAttribute() |
List | getExtensions()
Returns the list of file extensions
that are treated as JSP files.
|
boolean | getFailOnError() |
boolean | getFork() |
String | getIeClassId()
Gets the class-id value that is sent to Internet Explorer when using
|
String | getJavaEncoding()
Returns the encoding to use for
java files. |
String | getJspCompilerPath() |
Class | getJspCompilerPlugin() |
JspConfig | getJspConfig()
Obtain JSP configuration informantion specified in web.xml. |
boolean | getKeepGenerated() |
boolean | getMappedFile()
Are we supporting HTML mapped servlets? |
int | getModificationTestInterval()
Modification test interval. |
Project | getProject()
Returns the project: may be null if not running
inside an Ant project.
|
Object | getProtectionDomain() |
File | getScratchDir() |
TagPluginManager | getTagPluginManager() |
int | getTagPoolSize() |
TldLocationsCache | getTldLocationsCache() |
boolean | getTrimSpaces() |
protected void | initClassLoader(JspCompilationContext clctxt)
Initializes the classloader as/if needed for the given
compilation context.
|
protected void | initServletContext() |
protected void | initWebXml() |
boolean | isCaching() |
boolean | isPoolingEnabled() |
boolean | isSmapDumped()
Should SMAP info for JSR45 debugging be dumped to a file? |
boolean | isSmapSuppressed()
Is the generation of SMAP info for JSR45 debuggin suppressed? |
boolean | isXpoweredBy() |
protected void | locateUriRoot(File f)
Find the WEB-INF dir by looking up in the directory tree.
|
static void | main(String[] arg) |
protected void | mergeIntoWebXml()
Include the generated web.xml inside the webapp's web.xml. |
protected String | nextArg() |
protected String | nextFile() |
protected void | processFile(String file) |
protected File | resolveFile(String s)
Resolves the relative or absolute pathname correctly
in both Ant and command-line situations. |
void | scanFiles(File base)
Locate all jsp files in the webapp. |
void | setAddWebXmlMappings(boolean b) |
void | setArgs(String[] arg) |
void | setCaching(boolean caching) |
void | setClassDebugInfo(boolean b) |
void | setClassName(String p)
Class name of the generated file ( without package ).
|
void | setClassPath(String s) |
void | setCompile(boolean b)
Sets the compile flag.
|
void | setCompiler(String c) |
void | setCompilerSourceVM(String vm) |
void | setCompilerTargetVM(String vm) |
void | setErrorOnUseBeanInvalidClassAttribute(boolean b) |
void | setFailOnError(boolean b)
Set the option that throws an exception in case of a compilation error. |
void | setGenStringAsCharArray(boolean genStringAsCharArray)
Determines whether text strings are to be generated as char arrays,
which improves performance in some cases.
|
void | setIeClassId(String ieClassId)
Sets the class-id value to be sent to Internet Explorer when using
|
void | setJavaEncoding(String encodingName)
Sets the encoding to use for
java files.
|
void | setJspFiles(String jspFiles)
Parses comma-separated list of JSP files to be processed. |
void | setListErrors(boolean b) |
void | setOutputDir(String s) |
void | setPackage(String p) |
void | setPoolingEnabled(boolean poolingEnabled) |
void | setProject(Project theProject)
Sets the project.
|
void | setSmapDumped(boolean smapDumped)
Set smapSuppressed flag. |
void | setSmapSuppressed(boolean smapSuppressed)
Set smapSuppressed flag. |
void | setTrimSpaces(boolean ts) |
void | setUriroot(String s)
Base dir for the webapp. |
void | setValidateXml(boolean b) |
void | setVerbose(int level)
Sets the verbosity level. |
void | setWebXml(String s)
File where we generate a complete web.xml with the class definitions. |
void | setWebXmlFragment(String s)
File where we generate a web.xml fragment with the class definitions. |
void | setXpoweredBy(boolean xpoweredBy) |
Parameters: extension The extension to add, e.g. "myjsp"
Throws: JasperException If an error occurs
Returns: true if text strings are to be generated as char arrays, false otherwise
See Also: getCache
See Also: getCompilerSourceVM
See Also: Options
Returns: The list of extensions
Returns: Class-id value
Returns: String The encoding
Returns: The project
Parameters: clctxt The compilation context
Throws: IOException If an error occurs
See Also: isCaching
Parameters: s The file
Returns: The file resolved
See Also: isCaching
Parameters: b Flag value
See Also: getCompilerSourceVM
Parameters: genStringAsCharArray true if text strings are to be generated as char arrays, false otherwise
Parameters: ieClassId Class-id value
Parameters: encodingName The name, e.g. "UTF-8"
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
Parameters: theProject The project
Parameters: level Positive means verbose