|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.jasper.JspC
public class JspC
Shell for the jspc compiler. Handles all options associated with the command line and creates compilation contexts which it then compiles according to the specified options. This version can process files from a _single_ webapp at once, i.e. a single docbase can be specified. It can be used as an Ant task using:
<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 | |
|---|---|
static String |
DEFAULT_IE_CLASS_ID
|
| Constructor Summary | |
|---|---|
JspC()
|
|
| Method Summary | |
|---|---|
void |
execute()
|
void |
generateWebMapping(String file,
JspCompilationContext clctxt)
|
boolean |
genStringAsByteArray()
Are text strings to be generated as byte arrays, if the page is unbuffered? |
boolean |
genStringAsCharArray()
Indicates whether text strings are to be generated as char arrays. |
int |
getCheckInterval()
Background compilation check intervals in seconds |
boolean |
getClassDebugInfo()
Should we include debug information in compiled class? |
String |
getClassPath()
What classpath should I use while compiling the servlets generated from JSP files? |
String |
getCompiler()
Compiler to use. |
String |
getCompilerSourceVM()
Compiler source VM, e.g. |
String |
getCompilerTargetVM()
The compiler target VM, e.g. |
boolean |
getDevelopment()
Is Jasper being used in development mode? |
int |
getDieLevel()
|
boolean |
getErrorOnUseBeanInvalidClassAttribute()
Returns true if Jasper issues a compilation error instead of a runtime Instantiation error if the class attribute specified in useBean action is invalid. |
boolean |
getFailOnError()
|
boolean |
getFork()
boolean flag to tell Ant whether to fork JSP page compilations. |
String |
getIeClassId()
Gets the class-id value that is sent to Internet Explorer when using |
int |
getInitialCapacity()
Gets initial capacity of HashMap which maps JSPs to their corresponding servlets. |
String |
getJavaEncoding()
Returns the encoding to use for java files. |
List<JasperException> |
getJSPCompilationErrors()
Gets the list of JSP compilation errors caught during the most recent invocation of this instance's execute method when
failOnError has been set to FALSE. |
String |
getJspCompilerPath()
|
Class |
getJspCompilerPlugin()
|
JspConfig |
getJspConfig()
Obtain JSP configuration informantion specified in web.xml. |
boolean |
getKeepGenerated()
Are we keeping generated code around? |
boolean |
getMappedFile()
Are we supporting HTML mapped servlets? |
int |
getModificationTestInterval()
Modification test interval. |
Object |
getProtectionDomain()
|
boolean |
getSaveBytecode()
If class files are generated as byte arrays, should they be saved to disk at the end of compilations? |
File |
getScratchDir()
What is my scratch dir? |
boolean |
getSendErrorToClient()
Should errors be sent to client or thrown into stderr? |
String |
getSystemClassPath()
Gets the system class path. |
TagPluginManager |
getTagPluginManager()
Obtain a Tag Plugin Manager |
int |
getTagPoolSize()
|
TldLocationsCache |
getTldLocationsCache()
The cache for the location of the TLD's for the various tag libraries 'exposed' by the web application. |
boolean |
getTrimSpaces()
Should white spaces between directives or actions be trimmed? |
boolean |
getUsePrecompiled()
Returns the value of the usePrecompiled (or use-precompiled) init param. |
boolean |
isDefaultBufferNone()
If the buffer attribute for the page directive is not specified, is the default "none"? |
boolean |
isPoolingEnabled()
Returns true if tag handler pooling is enabled, false otherwise. |
boolean |
isSmapDumped()
Should SMAP info for JSR45 debugging be dumped to a file? |
boolean |
isSmapSuppressed()
Is the generation of SMAP info for JSR45 debugging suppressed? |
boolean |
isValidationEnabled()
|
boolean |
isXpoweredBy()
Is generation of X-Powered-By response header enabled/disabled? |
static void |
main(String[] arg)
|
protected void |
mergeIntoWebXml()
Include the generated web.xml inside the webapp's web.xml. |
void |
scanFiles(File base)
Locate all jsp files in the webapp. |
void |
setAddWebXmlMappings(boolean b)
|
void |
setArgs(String[] arg)
|
void |
setClassDebugInfo(boolean b)
|
void |
setClassName(String p)
Class name of the generated file ( without package ). |
void |
setClassPath(String s)
|
void |
setCompile(boolean b)
|
void |
setCompiler(String c)
|
void |
setCompilerSourceVM(String vm)
|
void |
setCompilerTargetVM(String vm)
|
void |
setDefaultBufferNone()
|
static void |
setDtdResourcePrefix(String prefix)
Sets the path prefix for .dtd resources |
void |
setErrorOnUseBeanInvalidClassAttribute(boolean b)
|
void |
setFailOnError(boolean b)
Set the option that throws an exception in case of a compilation error. |
void |
setGenStringAsByteArray(boolean genStringAsCharArray)
|
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 |
setIgnoreJspFragmentErrors(boolean ignore)
|
void |
setIsValidationEnabled(boolean b)
|
void |
setJavaEncoding(String encodingName)
Sets the encoding to use for java files. |
void |
setJspFiles(String jspFiles)
|
void |
setListErrors(boolean b)
|
void |
setOutputDir(String s)
|
void |
setPackage(String p)
|
void |
setPoolingEnabled(boolean poolingEnabled)
|
static void |
setSchemaResourcePrefix(String prefix)
Sets the path prefix for .xsd resources |
void |
setSmapDumped(boolean smapDumped)
Set smapSuppressed flag. |
void |
setSmapSuppressed(boolean smapSuppressed)
Set smapSuppressed flag. |
void |
setSystemClassPath(String s)
Sets the system class path. |
void |
setTrimSpaces(boolean ts)
|
void |
setUriroot(String s)
Base dir for the webapp. |
void |
setValidateXml(boolean b)
|
void |
setVerbose(int 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)
|
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
public static final String DEFAULT_IE_CLASS_ID
| Constructor Detail |
|---|
public JspC()
| Method Detail |
|---|
public static void main(String[] arg)
public void setArgs(String[] arg)
throws JasperException
JasperExceptionpublic int getDieLevel()
public boolean getKeepGenerated()
Options
getKeepGenerated in interface Optionspublic boolean getSaveBytecode()
Options
getSaveBytecode in interface Optionspublic boolean getTrimSpaces()
Options
getTrimSpaces in interface Optionspublic void setTrimSpaces(boolean ts)
public boolean isPoolingEnabled()
Options
isPoolingEnabled in interface Optionspublic void setPoolingEnabled(boolean poolingEnabled)
public boolean isXpoweredBy()
Options
isXpoweredBy in interface Optionspublic void setXpoweredBy(boolean xpoweredBy)
public boolean getErrorOnUseBeanInvalidClassAttribute()
Options
getErrorOnUseBeanInvalidClassAttribute in interface Optionspublic void setErrorOnUseBeanInvalidClassAttribute(boolean b)
public int getTagPoolSize()
public int getInitialCapacity()
getInitialCapacity in interface Optionspublic boolean getMappedFile()
getMappedFile in interface Optionspublic Object getProtectionDomain()
public boolean getSendErrorToClient()
Options
getSendErrorToClient in interface Optionspublic void setClassDebugInfo(boolean b)
public boolean getClassDebugInfo()
Options
getClassDebugInfo in interface Optionspublic int getCheckInterval()
getCheckInterval in interface Optionspublic int getModificationTestInterval()
getModificationTestInterval in interface Optionspublic boolean getDevelopment()
getDevelopment in interface Optionspublic boolean getUsePrecompiled()
Options
getUsePrecompiled in interface Optionspublic boolean isSmapSuppressed()
isSmapSuppressed in interface Optionspublic void setSmapSuppressed(boolean smapSuppressed)
public boolean isSmapDumped()
isSmapDumped in interface Optionspublic void setSmapDumped(boolean smapDumped)
public void setGenStringAsCharArray(boolean genStringAsCharArray)
genStringAsCharArray - true if text strings are to be generated as
char arrays, false otherwisepublic boolean genStringAsCharArray()
genStringAsCharArray in interface Optionspublic void setGenStringAsByteArray(boolean genStringAsCharArray)
public boolean genStringAsByteArray()
Options
genStringAsByteArray in interface Optionspublic boolean isDefaultBufferNone()
Options
isDefaultBufferNone in interface Optionspublic void setDefaultBufferNone()
public void setIeClassId(String ieClassId)
ieClassId - Class-id valuepublic String getIeClassId()
getIeClassId in interface Optionspublic File getScratchDir()
Options
getScratchDir in interface Optionspublic Class getJspCompilerPlugin()
public String getJspCompilerPath()
public String getCompiler()
getCompiler in interface Optionspublic void setCompiler(String c)
public String getCompilerTargetVM()
Options
getCompilerTargetVM in interface OptionsOptions.getCompilerTargetVM()public void setCompilerTargetVM(String vm)
public String getCompilerSourceVM()
Options
getCompilerSourceVM in interface OptionsOptions#getCompilerSourceVM.public void setCompilerSourceVM(String vm)
Options#getCompilerSourceVM.public TldLocationsCache getTldLocationsCache()
Options
getTldLocationsCache in interface Optionspublic String getJavaEncoding()
getJavaEncoding in interface Optionspublic void setJavaEncoding(String encodingName)
encodingName - The name, e.g. "UTF-8"public boolean getFork()
Options
getFork in interface Optionspublic String getClassPath()
Options
getClassPath in interface Optionspublic void setClassPath(String s)
public String getSystemClassPath()
getSystemClassPath in interface Optionspublic void setSystemClassPath(String s)
s - The system class path to usepublic void setUriroot(String s)
public static void setSchemaResourcePrefix(String prefix)
public static void setDtdResourcePrefix(String prefix)
public void setJspFiles(String jspFiles)
public void setCompile(boolean b)
public void setVerbose(int level)
public void setValidateXml(boolean b)
public void setIsValidationEnabled(boolean b)
public boolean isValidationEnabled()
isValidationEnabled in interface Optionspublic void setListErrors(boolean b)
public void setOutputDir(String s)
public void setPackage(String p)
public void setClassName(String p)
public void setWebXmlFragment(String s)
public void setWebXml(String s)
public void setAddWebXmlMappings(boolean b)
public void setFailOnError(boolean b)
public boolean getFailOnError()
public void setIgnoreJspFragmentErrors(boolean ignore)
public JspConfig getJspConfig()
getJspConfig in interface Optionspublic TagPluginManager getTagPluginManager()
Options
getTagPluginManager in interface Options
public void generateWebMapping(String file,
JspCompilationContext clctxt)
throws IOException
IOExceptionpublic List<JasperException> getJSPCompilationErrors()
execute method when
failOnError has been set to FALSE.
Each error error in the list is represented by an instance of
org.apache.jasper.JasperException.
execute method, or an empty
list if no errors were encountered or this instance's failOnError
property was set to TRUE
protected void mergeIntoWebXml()
throws IOException
IOException
public void scanFiles(File base)
throws JasperException
JasperException
public void execute()
throws JasperException
JasperException
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||