001: /*
002: * Copyright 1999,2004 The Apache Software Foundation.
003: *
004: * Licensed under the Apache License, Version 2.0 (the "License");
005: * you may not use this file except in compliance with the License.
006: * You may obtain a copy of the License at
007: *
008: * http://www.apache.org/licenses/LICENSE-2.0
009: *
010: * Unless required by applicable law or agreed to in writing, software
011: * distributed under the License is distributed on an "AS IS" BASIS,
012: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013: * See the License for the specific language governing permissions and
014: * limitations under the License.
015: */
016:
017: package org.apache.jasper;
018:
019: import java.io.File;
020:
021: import org.apache.jasper.compiler.JspConfig;
022: import org.apache.jasper.compiler.TagPluginManager;
023: import org.apache.jasper.compiler.TldLocationsCache;
024:
025: /**
026: * A class to hold all init parameters specific to the JSP engine.
027: *
028: * @author Anil K. Vijendran
029: * @author Hans Bergsten
030: * @author Pierre Delisle
031: */
032: public interface Options {
033:
034: /**
035: * Returns true if Jasper issues a compilation error instead of a runtime
036: * Instantiation error if the class attribute specified in useBean action
037: * is invalid.
038: */
039: public boolean getErrorOnUseBeanInvalidClassAttribute();
040:
041: /**
042: * Are we keeping generated code around?
043: */
044: public boolean getKeepGenerated();
045:
046: /**
047: * Returns true if tag handler pooling is enabled, false otherwise.
048: */
049: public boolean isPoolingEnabled();
050:
051: /**
052: * Are we supporting HTML mapped servlets?
053: */
054: public boolean getMappedFile();
055:
056: /**
057: * Should errors be sent to client or thrown into stderr?
058: */
059: public boolean getSendErrorToClient();
060:
061: /**
062: * Should we include debug information in compiled class?
063: */
064: public boolean getClassDebugInfo();
065:
066: /**
067: * Background compile thread check interval in seconds
068: */
069: public int getCheckInterval();
070:
071: /**
072: * Is Jasper being used in development mode?
073: */
074: public boolean getDevelopment();
075:
076: /**
077: * JSP reloading check ?
078: */
079: public boolean getReloading();
080:
081: /**
082: * Is the generation of SMAP info for JSR45 debugging suppressed?
083: */
084: public boolean isSmapSuppressed();
085:
086: /**
087: * Indicates whether SMAP info for JSR45 debugging should be dumped to a
088: * file.
089: * Ignored is suppressSmap() is true
090: */
091: public boolean isSmapDumped();
092:
093: /**
094: * Should white spaces between directives or actions be trimmed?
095: */
096: public boolean getTrimSpaces();
097:
098: /**
099: * Class ID for use in the plugin tag when the browser is IE.
100: */
101: public String getIeClassId();
102:
103: /**
104: * What is my scratch dir?
105: */
106: public File getScratchDir();
107:
108: /**
109: * What classpath should I use while compiling the servlets
110: * generated from JSP files?
111: */
112: public String getClassPath();
113:
114: /**
115: * Compiler to use.
116: */
117: public String getCompiler();
118:
119: /**
120: * The cache for the location of the TLD's
121: * for the various tag libraries 'exposed'
122: * by the web application.
123: * A tag library is 'exposed' either explicitely in
124: * web.xml or implicitely via the uri tag in the TLD
125: * of a taglib deployed in a jar file (WEB-INF/lib).
126: *
127: * @return the instance of the TldLocationsCache
128: * for the web-application.
129: */
130: public TldLocationsCache getTldLocationsCache();
131:
132: /**
133: * Java platform encoding to generate the JSP
134: * page servlet.
135: */
136: public String getJavaEncoding();
137:
138: /**
139: * boolean flag to tell Ant whether to fork JSP page compilations.
140: */
141: public boolean getFork();
142:
143: /**
144: * Obtain JSP configuration informantion specified in web.xml.
145: */
146: public JspConfig getJspConfig();
147:
148: /**
149: * Is generation of X-Powered-By response header enabled/disabled?
150: */
151: public boolean isXpoweredBy();
152:
153: /**
154: * Obtain a Tag Plugin Manager
155: */
156: public TagPluginManager getTagPluginManager();
157:
158: /**
159: * Are Text strings to be generated as char arrays?
160: */
161: public boolean genStringAsCharArray();
162: }
|