Package org.apache.jasper
Class EmbeddedServletOptions
java.lang.Object
org.apache.jasper.EmbeddedServletOptions
- All Implemented Interfaces:
- Options
A class to hold all init parameters specific to the JSP engine.
- Author:
- Anil K. Vijendran, Hans Bergsten, Pierre Delisle
- 
Field SummaryFields
- 
Constructor SummaryConstructorsConstructorDescriptionEmbeddedServletOptions(ServletConfig config, ServletContext context) Create an EmbeddedServletOptions object using data available from ServletConfig and ServletContext.
- 
Method SummaryModifier and TypeMethodDescriptionbooleanAre Text strings to be generated as char arrays?getCache()The web-application wide cache for the TagLibraryInfo tag library descriptors, used ifOptions.isCaching()returnstrue.intBackground JSP compile thread check intervalbooleanShould class files be compiled with debug information?What classpath should I use while compiling the servlets generated from JSP files?Compiler to use.Java compiler class to use.booleanIs Jasper being used in development mode?booleanShould we include a source fragment in exception messages, which could be displayed to the developer ?booleanReturns true if Jasper issues a compilation error instead of a runtime Instantiation error if the class attribute specified in useBean action is invalid.booleangetFork()The boolean flag to tell Ant whether to fork JSP page compilations.intShould any jsps be unloaded when being idle for this time in seconds?booleanAre we keeping generated code around?booleanAre we supporting HTML mapped servlets?intShould jsps be unloaded if to many are loaded?intModification test interval.booleangetProperty(String name) booleanbooleanRe-compile on failure.What is my scratch dir?_jspService is the name of the method that is called by HttpJspBase.service().booleanbooleanbooleanThe cache that maps URIs, resource paths and parsed TLD files for the various tag libraries 'exposed' by the web application.booleanbooleanbooleanbooleanShould SMAP info for JSR45 debugging be dumped to a file?booleanIs the generation of SMAP info for JSR45 debugging suppressed?booleanIs generation of X-Powered-By response header enabled/disabled?voidsetErrorOnUseBeanInvalidClassAttribute(boolean b) voidsetProperty(String name, String value) voidsetQuoteAttributeEL(boolean b) voidsetTldCache(TldCache tldCache) Methods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.apache.jasper.OptionsgetGeneratedJavaAddTimestamp
- 
Field Details- 
forkpublic boolean forkShould Ant fork its java compiles of JSP pages.
 
- 
- 
Constructor Details- 
EmbeddedServletOptionsCreate an EmbeddedServletOptions object using data available from ServletConfig and ServletContext.- Parameters:
- config- The Servlet config
- context- The Servlet context
 
 
- 
- 
Method Details- 
getProperty
- 
setProperty
- 
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.
 
- 
getKeepGeneratedpublic boolean getKeepGenerated()Are we keeping generated code around?- 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.
 
- 
isPoolingEnabledpublic boolean isPoolingEnabled()- Specified by:
- isPoolingEnabledin interface- Options
- Returns:
- trueif tag handler pooling is enabled,- falseotherwise.
 
- 
getMappedFilepublic boolean getMappedFile()Are we supporting HTML mapped servlets?- Specified by:
- getMappedFilein interface- Options
- Returns:
- trueif HTML mapped Servlets are supported.
 
- 
getClassDebugInfopublic boolean getClassDebugInfo()Should class files be compiled with debug information?- Specified by:
- getClassDebugInfoin interface- Options
- Returns:
- trueif debug information in included in compiled classes.
 
- 
getCheckIntervalpublic int getCheckInterval()Background JSP compile thread check interval- Specified by:
- getCheckIntervalin interface- Options
- Returns:
- background compile thread check interval in seconds
 
- 
getModificationTestIntervalpublic int getModificationTestInterval()Modification test interval.- Specified by:
- getModificationTestIntervalin interface- Options
- Returns:
- modification test interval.
 
- 
getRecompileOnFailpublic boolean getRecompileOnFail()Re-compile on failure.- Specified by:
- getRecompileOnFailin interface- Options
- Returns:
- trueif re-compile will occur on a failure.
 
- 
getDevelopmentpublic boolean getDevelopment()Is Jasper being used in development mode?- Specified by:
- getDevelopmentin interface- Options
- Returns:
- trueif Jasper is in development mode
 
- 
isSmapSuppressedpublic boolean isSmapSuppressed()Is the generation of SMAP info for JSR45 debugging suppressed?- Specified by:
- isSmapSuppressedin interface- Options
- Returns:
- trueto suppress generation of SMAP info for JSR45 debugging.
 
- 
isSmapDumpedpublic boolean isSmapDumped()Should SMAP info for JSR45 debugging be dumped to a file?- Specified by:
- isSmapDumpedin interface- Options
- Returns:
- trueto write SMAP info for JSR45 debugging to a file.
 
- 
genStringAsCharArraypublic boolean genStringAsCharArray()Are Text strings to be generated as char arrays?- Specified by:
- genStringAsCharArrayin interface- Options
- Returns:
- trueif text strings are to be generated as char arrays,- falseotherwise
 
- 
getScratchDirWhat is my scratch dir?- Specified by:
- getScratchDirin interface- Options
- Returns:
- the work folder
 
- 
getClassPathWhat classpath should I use while compiling the servlets generated from JSP files?- Specified by:
- getClassPathin interface- Options
- Returns:
- the classpath used to compile generated Servlets
 
- 
isXpoweredBypublic boolean isXpoweredBy()Is generation of X-Powered-By response header enabled/disabled?- Specified by:
- isXpoweredByin interface- Options
- Returns:
- trueto generate a X-Powered-By response header.
 
- 
getCompilerCompiler to use.- Specified by:
- getCompilerin interface- Options
- Returns:
- the compiler name
 
- 
getCompilerTargetVM- Specified by:
- getCompilerTargetVMin interface- Options
- Returns:
- the compiler target VM, e.g. 1.8.
- See Also:
 
- 
getCompilerSourceVM- Specified by:
- getCompilerSourceVMin interface- Options
- Returns:
- the compiler source VM, e.g. 1.8.
- See Also:
 
- 
getCompilerClassNameJava compiler class to use.- Specified by:
- getCompilerClassNamein interface- Options
- Returns:
- Jasper Java compiler class to use.
 
- 
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) 
- 
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.
 
- 
setTldCache
- 
getJavaEncoding- Specified by:
- getJavaEncodingin interface- Options
- Returns:
- Java platform encoding to generate the JSP page servlet.
 
- 
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).
- 
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
 
- 
isCachingpublic boolean isCaching()
- 
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). 
- 
getDisplaySourceFragmentpublic boolean getDisplaySourceFragment()Should we include a source fragment in exception messages, which could be displayed to the developer ?- Specified by:
- getDisplaySourceFragmentin interface- Options
- Returns:
- trueto include a source fragment in exception messages.
 
- 
getMaxLoadedJspspublic int getMaxLoadedJsps()Should jsps be unloaded if to many are loaded? If set to a value greater than 0 eviction of jsps is started. Default: -1- Specified by:
- getMaxLoadedJspsin interface- Options
- Returns:
- The JSP count
 
- 
getJspIdleTimeoutpublic int getJspIdleTimeout()Should any jsps be unloaded when being idle for this time in seconds? If set to a value greater than 0 eviction of jsps is started. Default: -1- 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.
 
- 
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.
 
- 
getVariableForExpressionFactory- Specified by:
- getVariableForExpressionFactoryin interface- Options
- Returns:
- the name of the variable that will be used in the generated JSP code for the expression factory
 
- 
getVariableForInstanceManager- Specified by:
- getVariableForInstanceManagerin interface- Options
- Returns:
- the name of the variable that will be used in the generated JSP code for the instance manager
 
- 
getPoolTagsWithExtendspublic boolean getPoolTagsWithExtends()- Specified by:
- getPoolTagsWithExtendsin interface- Options
- Returns:
- trueif tag pooling is disabled with page that uses extends.
 
- 
getStrictGetPropertypublic boolean getStrictGetProperty()- Specified by:
- getStrictGetPropertyin interface- Options
- Returns:
- trueif the requirement to have the object used in jsp:getProperty action to be previously "introduced" to the JSP processor (see JSP.5.3) is enforced.
 
- 
getStrictWhitespacepublic boolean getStrictWhitespace()- Specified by:
- getStrictWhitespacein interface- Options
- Returns:
- trueif the strict white space rules are applied.
 
- 
getJspServletBase- Specified by:
- getJspServletBasein interface- Options
- Returns:
- the default base class for generated JSP Servlets
 
- 
getServiceMethodNameDescription copied from interface:Options_jspService is the name of the method that is called by HttpJspBase.service(). This is where most of the code generated from JSPs go.- Specified by:
- getServiceMethodNamein interface- Options
- Returns:
- the method name
 
- 
getServletClasspathAttribute- Specified by:
- getServletClasspathAttributein interface- Options
- Returns:
- ServletContext attribute for classpath. This is tomcat specific. Other servlet engines may choose to support this attribute if they want to have this JSP engine running on them.
 
- 
getJspPrecompilationQueryParameter- Specified by:
- getJspPrecompilationQueryParameterin interface- Options
- Returns:
- The query parameter that causes the JSP engine to just pregenerated the servlet but not invoke it.
 
- 
getGeneratedJspPackageName- Specified by:
- getGeneratedJspPackageNamein interface- Options
- Returns:
- The default package name for compiled jsp pages.
 
- 
getGeneratedTagFilePackageName- Specified by:
- getGeneratedTagFilePackageNamein interface- Options
- Returns:
- The default package name for tag handlers generated from tag files.
 
- 
getTempVariableNamePrefix- Specified by:
- getTempVariableNamePrefixin interface- Options
- Returns:
- Prefix to use for generated temporary variable names
 
- 
getUseInstanceManagerForTagspublic boolean getUseInstanceManagerForTags()- Specified by:
- getUseInstanceManagerForTagsin interface- Options
- Returns:
- trueif the container instance manager will be used to create the bean instances
 
 
-