@@ -, +, @@
* Copyright 1999,2004 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
* CGI-invoking servlet for web applications, used to execute scripts which
* comply to the Common Gateway Interface (CGI) specification and are named
* in the path-info used to invoke this servlet.
*
*
* Note: This code compiles and even works for simple CGI cases.
* Exhaustive testing has not been done. Please consider it beta
* quality. Feedback is appreciated to the author (see below).
*
*
*
* Example:
* If an instance of this servlet was mapped (using
* <web-app>/WEB-INF/web.xml) to:
*
*
*
* <web-app>/cgi-bin/*
*
*
*
* then the following request:
*
*
*
* http://localhost:8080/<web-app>/cgi-bin/dir1/script/pathinfo1
*
*
*
* would result in the execution of the script
*
*
*
* <web-app-root>/WEB-INF/cgi/dir1/script
*
*
*
* with the script's PATH_INFO set to /pathinfo1.
*
*
* Recommendation: House all your CGI scripts under
* <webapp>/WEB-INF/cgi. This will ensure that you do not
* accidentally expose your cgi scripts' code to the outside world and that
* your cgis will be cleanly ensconced underneath the WEB-INF (i.e.,
* non-content) area.
*
*
* The default CGI location is mentioned above. You have the flexibility to
* put CGIs wherever you want, however:
*
*
* The CGI search path will start at
* webAppRootDir + File.separator + cgiPathPrefix
* (or webAppRootDir alone if cgiPathPrefix is
* null).
*
*
* cgiPathPrefix is defined by setting
* this servlet's cgiPathPrefix init parameter
*
*
*
*
* CGI Specification:
derived from
* http://cgi-spec.golux.com.
* A work-in-progress & expired Internet Draft. Note no actual RFC describing
* the CGI specification exists. Where the behavior of this servlet differs
* from the specification cited above, it is either documented here, a bug,
* or an instance where the specification cited differs from Best
* Community Practice (BCP).
* Such instances should be well-documented here. Please email the
* Jakarta Tomcat group [tomcat-dev@jakarta.apache.org]
* with amendments.
*
*
*
*
* Canonical metavariables:
* The CGI specification defines the following canonical metavariables:
*
* [excerpt from CGI specification]
*
* AUTH_TYPE
* CONTENT_LENGTH
* CONTENT_TYPE
* GATEWAY_INTERFACE
* PATH_INFO
* PATH_TRANSLATED
* QUERY_STRING
* REMOTE_ADDR
* REMOTE_HOST
* REMOTE_IDENT
* REMOTE_USER
* REQUEST_METHOD
* SCRIPT_NAME
* SERVER_NAME
* SERVER_PORT
* SERVER_PROTOCOL
* SERVER_SOFTWARE
*
*
* Metavariables with names beginning with the protocol name (e.g.,
* "HTTP_ACCEPT") are also canonical in their description of request header
* fields. The number and meaning of these fields may change independently
* of this specification. (See also section 6.1.5 [of the CGI specification].)
*
* [end excerpt]
*
*
* Implementation notes
*
*
* standard input handling: If your script accepts standard input,
* then the client must start sending input within a certain timeout period,
* otherwise the servlet will assume no input is coming and carry on running
* the script. The script's the standard input will be closed and handling of
* any further input from the client is undefined. Most likely it will be
* ignored. If this behavior becomes undesirable, then this servlet needs
* to be enhanced to handle threading of the spawned process' stdin, stdout,
* and stderr (which should not be too hard).
*
* If you find your cgi scripts are timing out receiving input, you can set
* the init parameter
*
*
* Metavariable Values: According to the CGI specificion,
* implementations may choose to represent both null or missing values in an
* implementation-specific manner, but must define that manner. This
* implementation chooses to always define all required metavariables, but
* set the value to "" for all metavariables whose value is either null or
* undefined. PATH_TRANSLATED is the sole exception to this rule, as per the
* CGI Specification.
*
*
*
*
* NPH -- Non-parsed-header implementation: This implementation does
* not support the CGI NPH concept, whereby server ensures that the data
* supplied to the script are preceisely as supplied by the client and
* unaltered by the server.
*
*
* The function of a servlet container (including Tomcat) is specifically
* designed to parse and possible alter CGI-specific variables, and as
* such makes NPH functionality difficult to support.
*
*
* The CGI specification states that compliant servers MAY support NPH output.
* It does not state servers MUST support NPH output to be unconditionally
* compliant. Thus, this implementation maintains unconditional compliance
* with the specification though NPH support is not present.
*
*
*
* The CGI specification is located at
* http://cgi-spec.golux.com.
*
*
*
*
TODO:
*
* - Support for setting headers (for example, Location headers don't work)
*
- Support for collapsing multiple header lines (per RFC 2616)
*
- Ensure handling of POST method does not interfere with 2.3 Filters
*
- Refactor some debug code out of core
*
- Ensure header handling preserves encoding
*
- Possibly rewrite CGIRunner.run()?
*
- Possibly refactor CGIRunner and CGIEnvironment as non-inner classes?
*
- Document handling of cgi stdin when there is no stdin
*
- Revisit IOException handling in CGIRunner.run()
*
- Better documentation
*
- Confirm use of ServletInputStream.available() in CGIRunner.run() is
* not needed
*
- Make checking for "." and ".." in servlet & cgi PATH_INFO less
* draconian
*
- [add more to this TODO list]
*
*
*
* @author Martin T Dengler [root@martindengler.com]
* @author Amy Roh
* @version $Revision$, $Date$
* @since Tomcat 4.0
*
*/
/* some vars below copied from Craig R. McClanahan's InvokerServlet */
/** the debugging detail level for this servlet. */
private int debug = 0;
/**
* The CGI search path will start at
* webAppRootDir + File.separator + cgiPathPrefix
* (or webAppRootDir alone if cgiPathPrefix is
* null)
*/
private String cgiPathPrefix = null;
/** the executable to use with the script */
private String cgiExecutable = "perl";
/** the encoding to use for parameters */
private String parameterEncoding = System.getProperty("file.encoding",
"UTF-8");
/** object used to ensure multiple threads don't try to expand same file */
static Object expandFileLock = new Object();
/** the shell environment variables to be passed to the CGI script */
static Hashtable shellEnv = new Hashtable();
/**
* Sets instance variables.
*
* Modified from Craig R. McClanahan's InvokerServlet
*
*
* @param config a ServletConfig object
* containing the servlet's
* configuration and initialization
* parameters
*
* @exception ServletException if an exception has occurred that
* interferes with the servlet's normal
* operation
*/
public void init(ServletConfig config) throws ServletException {
super.init(config);
// Verify that we were not accessed using the invoker servlet
String servletName = getServletConfig().getServletName();
if (servletName == null)
servletName = "";
if (servletName.startsWith("org.apache.catalina.INVOKER."))
throw new UnavailableException
("Cannot invoke CGIServlet through the invoker");
boolean passShellEnvironment = false;
// Set our properties from the initialization parameters
String value = null;
try {
value = getServletConfig().getInitParameter("debug");
debug = Integer.parseInt(value);
cgiPathPrefix =
getServletConfig().getInitParameter("cgiPathPrefix");
value = getServletConfig().getInitParameter("passShellEnvironment");
passShellEnvironment = Boolean.valueOf(value).booleanValue();
} catch (Throwable t) {
//NOOP
}
log("init: loglevel set to " + debug);
if (passShellEnvironment) {
try {
shellEnv.putAll(getShellEnvironment());
} catch (IOException ioe) {
ServletException e = new ServletException(
"Unable to read shell environment variables", ioe);
throw e;
}
}
value = getServletConfig().getInitParameter("executable");
if (value != null) {
cgiExecutable = value;
}
value = getServletConfig().getInitParameter("parameterEncoding");
if (value != null) {
parameterEncoding = value;
}
}
/**
* Prints out important Servlet API and container information
*
*
* Copied from SnoopAllServlet by Craig R. McClanahan
*
*
* @param out ServletOutputStream as target of the information
* @param req HttpServletRequest object used as source of information
* @param res HttpServletResponse object currently not used but could
* provide future information
*
* @exception IOException if a write operation exception occurs
*
*/
protected void printServletEnvironment(ServletOutputStream out,
HttpServletRequest req, HttpServletResponse res) throws IOException {
// Document the properties from ServletRequest
out.println("ServletRequest Properties
");
out.println("");
Enumeration attrs = req.getAttributeNames();
while (attrs.hasMoreElements()) {
String attr = (String) attrs.nextElement();
out.println("- attribute " + attr + " = " +
req.getAttribute(attr));
}
out.println("
- characterEncoding = " +
req.getCharacterEncoding());
out.println("
- contentLength = " +
req.getContentLength());
out.println("
- contentType = " +
req.getContentType());
Enumeration locales = req.getLocales();
while (locales.hasMoreElements()) {
Locale locale = (Locale) locales.nextElement();
out.println("
- locale = " + locale);
}
Enumeration params = req.getParameterNames();
while (params.hasMoreElements()) {
String param = (String) params.nextElement();
String values[] = req.getParameterValues(param);
for (int i = 0; i < values.length; i++)
out.println("
- parameter " + param + " = " +
values[i]);
}
out.println("
- protocol = " + req.getProtocol());
out.println("
- remoteAddr = " + req.getRemoteAddr());
out.println("
- remoteHost = " + req.getRemoteHost());
out.println("
- scheme = " + req.getScheme());
out.println("
- secure = " + req.isSecure());
out.println("
- serverName = " + req.getServerName());
out.println("
- serverPort = " + req.getServerPort());
out.println("
");
out.println("
");
// Document the properties from HttpServletRequest
out.println("HttpServletRequest Properties
");
out.println("");
out.println("- authType = " + req.getAuthType());
out.println("
- contextPath = " +
req.getContextPath());
Cookie cookies[] = req.getCookies();
if (cookies!=null) {
for (int i = 0; i < cookies.length; i++)
out.println("
- cookie " + cookies[i].getName() +" = " +cookies[i].getValue());
}
Enumeration headers = req.getHeaderNames();
while (headers.hasMoreElements()) {
String header = (String) headers.nextElement();
out.println("
- header " + header + " = " +
req.getHeader(header));
}
out.println("
- method = " + req.getMethod());
out.println("
- pathInfo = "
+ req.getPathInfo());
out.println("
- pathTranslated = " +
req.getPathTranslated());
out.println("
- queryString = " +
req.getQueryString());
out.println("
- remoteUser = " +
req.getRemoteUser());
out.println("
- requestedSessionId = " +
req.getRequestedSessionId());
out.println("
- requestedSessionIdFromCookie = " +
req.isRequestedSessionIdFromCookie());
out.println("
- requestedSessionIdFromURL = " +
req.isRequestedSessionIdFromURL());
out.println("
- requestedSessionIdValid = " +
req.isRequestedSessionIdValid());
out.println("
- requestURI = " +
req.getRequestURI());
out.println("
- servletPath = " +
req.getServletPath());
out.println("
- userPrincipal = " +
req.getUserPrincipal());
out.println("
");
out.println("
");
// Document the servlet request attributes
out.println("ServletRequest Attributes
");
out.println("");
attrs = req.getAttributeNames();
while (attrs.hasMoreElements()) {
String attr = (String) attrs.nextElement();
out.println("- " + attr + " = " +
req.getAttribute(attr));
}
out.println("
");
out.println("
");
// Process the current session (if there is one)
HttpSession session = req.getSession(false);
if (session != null) {
// Document the session properties
out.println("HttpSession Properties
");
out.println("");
out.println("- id = " +
session.getId());
out.println("
- creationTime = " +
new Date(session.getCreationTime()));
out.println("
- lastAccessedTime = " +
new Date(session.getLastAccessedTime()));
out.println("
- maxInactiveInterval = " +
session.getMaxInactiveInterval());
out.println("
");
out.println("
");
// Document the session attributes
out.println("HttpSession Attributes
");
out.println("");
attrs = session.getAttributeNames();
while (attrs.hasMoreElements()) {
String attr = (String) attrs.nextElement();
out.println("- " + attr + " = " +
session.getAttribute(attr));
}
out.println("
");
out.println("
");
}
// Document the servlet configuration properties
out.println("ServletConfig Properties
");
out.println("");
out.println("- servletName = " +
getServletConfig().getServletName());
out.println("
");
out.println("
");
// Document the servlet configuration initialization parameters
out.println("ServletConfig Initialization Parameters
");
out.println("");
params = getServletConfig().getInitParameterNames();
while (params.hasMoreElements()) {
String param = (String) params.nextElement();
String value = getServletConfig().getInitParameter(param);
out.println("- " + param + " = " + value);
}
out.println("
");
out.println("
");
// Document the servlet context properties
out.println("ServletContext Properties
");
out.println("");
out.println("- majorVersion = " +
getServletContext().getMajorVersion());
out.println("
- minorVersion = " +
getServletContext().getMinorVersion());
out.println("
- realPath('/') = " +
getServletContext().getRealPath("/"));
out.println("
- serverInfo = " +
getServletContext().getServerInfo());
out.println("
");
out.println("
");
// Document the servlet context initialization parameters
out.println("ServletContext Initialization Parameters
");
out.println("");
params = getServletContext().getInitParameterNames();
while (params.hasMoreElements()) {
String param = (String) params.nextElement();
String value = getServletContext().getInitParameter(param);
out.println("- " + param + " = " + value);
}
out.println("
");
out.println("
");
// Document the servlet context attributes
out.println("ServletContext Attributes
");
out.println("");
attrs = getServletContext().getAttributeNames();
while (attrs.hasMoreElements()) {
String attr = (String) attrs.nextElement();
out.println("- " + attr + " = " +
getServletContext().getAttribute(attr));
}
out.println("
");
out.println("
");
}
/**
* Provides CGI Gateway service -- delegates to doGet
*
* @param req HttpServletRequest passed in by servlet container
* @param res HttpServletResponse passed in by servlet container
*
* @exception ServletException if a servlet-specific exception occurs
* @exception IOException if a read/write exception occurs
*
* @see javax.servlet.http.HttpServlet
*
*/
protected void doPost(HttpServletRequest req, HttpServletResponse res)
throws IOException, ServletException {
doGet(req, res);
}
/**
* Provides CGI Gateway service
*
* @param req HttpServletRequest passed in by servlet container
* @param res HttpServletResponse passed in by servlet container
*
* @exception ServletException if a servlet-specific exception occurs
* @exception IOException if a read/write exception occurs
*
* @see javax.servlet.http.HttpServlet
*
*/
protected void doGet(HttpServletRequest req, HttpServletResponse res)
throws ServletException, IOException {
// Verify that we were not accessed using the invoker servlet
if (req.getAttribute(Globals.INVOKED_ATTR) != null)
throw new UnavailableException
("Cannot invoke CGIServlet through the invoker");
CGIEnvironment cgiEnv = new CGIEnvironment(req, getServletContext());
if (cgiEnv.isValid()) {
CGIRunner cgi = new CGIRunner(cgiEnv.getCommand(),
cgiEnv.getEnvironment(),
cgiEnv.getWorkingDirectory(),
cgiEnv.getParameters());
//if POST, we need to cgi.setInput
//REMIND: how does this interact with Servlet API 2.3's Filters?!
if ("POST".equals(req.getMethod())) {
cgi.setInput(req.getInputStream());
}
cgi.setResponse(res);
cgi.run();
}
if (!cgiEnv.isValid()) {
res.setStatus(404);
}
if (debug >= 10) {
try {
ServletOutputStream out = res.getOutputStream();
out.println("$Name$");
out.println("$Header$");
if (cgiEnv.isValid()) {
out.println(cgiEnv.toString());
} else {
out.println("
");
out.println("CGI script not found or not specified.");
out.println("
");
out.println("");
out.println("Check the HttpServletRequest ");
out.println("pathInfo ");
out.println("property to see if it is what you meant ");
out.println("it to be. You must specify an existant ");
out.println("and executable file as part of the ");
out.println("path-info.");
out.println("
");
out.println("");
out.println("For a good discussion of how CGI scripts ");
out.println("work and what their environment variables ");
out.println("mean, please visit the CGI ");
out.println("Specification page.");
out.println("
");
}
printServletEnvironment(out, req, res);
out.println("");
} catch (IOException ignored) {
}
} //debugging
} //doGet
/** For future testing use only; does nothing right now */
public static void main(String[] args) {
System.out.println("$Header$");
}
/**
* Get all shell environment variables. Have to do it this rather ugly way
* as the API to obtain is not available in 1.4 and earlier APIs.
*
* See Read environment
* variables from an application for original source and article.
*/
private Hashtable getShellEnvironment() throws IOException {
Hashtable envVars = new Hashtable();
Process p = null;
Runtime r = Runtime.getRuntime();
String OS = System.getProperty("os.name").toLowerCase();
boolean ignoreCase;
if (OS.indexOf("windows 9") > -1) {
p = r.exec( "command.com /c set" );
ignoreCase = true;
} else if ( (OS.indexOf("nt") > -1)
|| (OS.indexOf("windows 2000") > -1)
|| (OS.indexOf("windows xp") > -1) ) {
// thanks to JuanFran for the xp fix!
p = r.exec( "cmd.exe /c set" );
ignoreCase = true;
} else {
// our last hope, we assume Unix (thanks to H. Ware for the fix)
p = r.exec( "env" );
ignoreCase = false;
}
BufferedReader br = new BufferedReader
( new InputStreamReader( p.getInputStream() ) );
String line;
while( (line = br.readLine()) != null ) {
int idx = line.indexOf( '=' );
String key = line.substring( 0, idx );
String value = line.substring( idx+1 );
if (ignoreCase) {
key = key.toUpperCase();
}
envVars.put(key, value);
}
return envVars;
}
/**
* Encapsulates the CGI environment and rules to derive
* that environment from the servlet container and request information.
*
*
*
*
* @version $Revision$, $Date$
* @since Tomcat 4.0
*
*/
protected class CGIEnvironment {
/** context of the enclosing servlet */
private ServletContext context = null;
/** context path of enclosing servlet */
private String contextPath = null;
/** servlet URI of the enclosing servlet */
private String servletPath = null;
/** pathInfo for the current request */
private String pathInfo = null;
/** real file system directory of the enclosing servlet's web app */
private String webAppRootDir = null;
/** tempdir for context - used to expand scripts in unexpanded wars */
private File tmpDir = null;
/** derived cgi environment */
private Hashtable env = null;
/** cgi command to be invoked */
private String command = null;
/** cgi command's desired working directory */
private File workingDirectory = null;
/** cgi command's query parameters */
private ArrayList queryParameters = new ArrayList();
/** whether or not this object is valid or not */
private boolean valid = false;
/**
* Creates a CGIEnvironment and derives the necessary environment,
* query parameters, working directory, cgi command, etc.
*
* @param req HttpServletRequest for information provided by
* the Servlet API
* @param context ServletContext for information provided by the
* Servlet API
*
*/
protected CGIEnvironment(HttpServletRequest req,
ServletContext context) throws IOException {
setupFromContext(context);
setupFromRequest(req);
Enumeration paramNames = req.getParameterNames();
while (paramNames != null && paramNames.hasMoreElements()) {
String param = paramNames.nextElement().toString();
if (param != null) {
String values[] = req.getParameterValues(param);
for (int i=0; i < values.length; i++) {
String value = URLEncoder.encode(values[i],
parameterEncoding);
NameValuePair nvp = new NameValuePair(param, value);
queryParameters.add(nvp);
}
}
}
this.valid = setCGIEnvironment(req);
if (this.valid) {
workingDirectory = new File(command.substring(0,
command.lastIndexOf(File.separator)));
}
}
/**
* Uses the ServletContext to set some CGI variables
*
* @param context ServletContext for information provided by the
* Servlet API
*/
protected void setupFromContext(ServletContext context) {
this.context = context;
this.webAppRootDir = context.getRealPath("/");
this.tmpDir = (File) context.getAttribute(Globals.WORK_DIR_ATTR);
}
/**
* Uses the HttpServletRequest to set most CGI variables
*
* @param req HttpServletRequest for information provided by
* the Servlet API
*/
protected void setupFromRequest(HttpServletRequest req) {
this.contextPath = req.getContextPath();
this.servletPath = req.getServletPath();
this.pathInfo = req.getPathInfo();
// If getPathInfo() returns null, must be using extension mapping
// In this case, pathInfo should be same as servletPath
if (this.pathInfo == null) {
this.pathInfo = this.servletPath;
}
}
/**
* Resolves core information about the cgi script.
*
*
* Example URI:
*
/servlet/cgigateway/dir1/realCGIscript/pathinfo1
*
* - path = $CATALINA_HOME/mywebapp/dir1/realCGIscript
*
- scriptName = /servlet/cgigateway/dir1/realCGIscript
*
- cgiName = /dir1/realCGIscript
*
- name = realCGIscript
*
*
*
* CGI search algorithm: search the real path below
* <my-webapp-root> and find the first non-directory in
* the getPathTranslated("/"), reading/searching from left-to-right.
*
*
* The CGI search path will start at
* webAppRootDir + File.separator + cgiPathPrefix
* (or webAppRootDir alone if cgiPathPrefix is
* null).
*
*
* cgiPathPrefix is defined by setting
* this servlet's cgiPathPrefix init parameter
*
*
*
* @param pathInfo String from HttpServletRequest.getPathInfo()
* @param webAppRootDir String from context.getRealPath("/")
* @param contextPath String as from
* HttpServletRequest.getContextPath()
* @param servletPath String as from
* HttpServletRequest.getServletPath()
* @param cgiPathPrefix subdirectory of webAppRootDir below which
* the web app's CGIs may be stored; can be null.
* The CGI search path will start at
* webAppRootDir + File.separator + cgiPathPrefix
* (or webAppRootDir alone if cgiPathPrefix is
* null). cgiPathPrefix is defined by setting
* the servlet's cgiPathPrefix init parameter.
*
*
* @return
*
* -
*
path - full file-system path to valid cgi script,
* or null if no cgi was found
* -
*
scriptName -
* CGI variable SCRIPT_NAME; the full URL path
* to valid cgi script or null if no cgi was
* found
* -
*
cgiName - servlet pathInfo fragment corresponding to
* the cgi script itself, or null if not found
* -
*
name - simple name (no directories) of the
* cgi script, or null if no cgi was found
*
*
* @since Tomcat 4.0
*/
protected String[] findCGI(String pathInfo, String webAppRootDir,
String contextPath, String servletPath,
String cgiPathPrefix) {
String path = null;
String name = null;
String scriptname = null;
String cginame = null;
if ((webAppRootDir != null)
&& (webAppRootDir.lastIndexOf(File.separator) ==
(webAppRootDir.length() - 1))) {
//strip the trailing "/" from the webAppRootDir
webAppRootDir =
webAppRootDir.substring(0, (webAppRootDir.length() - 1));
}
if (cgiPathPrefix != null) {
webAppRootDir = webAppRootDir + File.separator
+ cgiPathPrefix;
}
if (debug >= 2) {
log("findCGI: path=" + pathInfo + ", " + webAppRootDir);
}
File currentLocation = new File(webAppRootDir);
StringTokenizer dirWalker =
new StringTokenizer(pathInfo, "/");
if (debug >= 3) {
log("findCGI: currentLoc=" + currentLocation);
}
while (!currentLocation.isFile() && dirWalker.hasMoreElements()) {
if (debug >= 3) {
log("findCGI: currentLoc=" + currentLocation);
}
currentLocation = new File(currentLocation,
(String) dirWalker.nextElement());
}
if (!currentLocation.isFile()) {
return new String[] { null, null, null, null };
} else {
if (debug >= 2) {
log("findCGI: FOUND cgi at " + currentLocation);
}
path = currentLocation.getAbsolutePath();
name = currentLocation.getName();
cginame =
currentLocation.getParent().substring(webAppRootDir.length())
+ File.separator
+ name;
if (".".equals(contextPath)) {
scriptname = servletPath + cginame;
} else {
scriptname = contextPath + servletPath + cginame;
}
}
if (debug >= 1) {
log("findCGI calc: name=" + name + ", path=" + path
+ ", scriptname=" + scriptname + ", cginame=" + cginame);
}
return new String[] { path, scriptname, cginame, name };
}
/**
* Constructs the CGI environment to be supplied to the invoked CGI
* script; relies heavliy on Servlet API methods and findCGI
*
* @param req request associated with the CGI
* invokation
*
* @return true if environment was set OK, false if there
* was a problem and no environment was set
*/
protected boolean setCGIEnvironment(HttpServletRequest req) throws IOException {
/*
* This method is slightly ugly; c'est la vie.
* "You cannot stop [ugliness], you can only hope to contain [it]"
* (apologies to Marv Albert regarding MJ)
*/
Hashtable envp = new Hashtable();
// Add the shell environment variables (if any)
envp.putAll(shellEnv);
// Add the CGI environment variables
String sPathInfoOrig = null;
String sPathTranslatedOrig = null;
String sPathInfoCGI = null;
String sPathTranslatedCGI = null;
String sCGIFullPath = null;
String sCGIScriptName = null;
String sCGIFullName = null;
String sCGIName = null;
String[] sCGINames;
sPathInfoOrig = this.pathInfo;
sPathInfoOrig = sPathInfoOrig == null ? "" : sPathInfoOrig;
sPathTranslatedOrig = req.getPathTranslated();
sPathTranslatedOrig =
sPathTranslatedOrig == null ? "" : sPathTranslatedOrig;
if (webAppRootDir == null ) {
// The app has not been deployed in exploded form
webAppRootDir = tmpDir.toString();
expandCGIScript();
}
sCGINames = findCGI(sPathInfoOrig,
webAppRootDir,
contextPath,
servletPath,
cgiPathPrefix);
sCGIFullPath = sCGINames[0];
sCGIScriptName = sCGINames[1];
sCGIFullName = sCGINames[2];
sCGIName = sCGINames[3];
if (sCGIFullPath == null
|| sCGIScriptName == null
|| sCGIFullName == null
|| sCGIName == null) {
return false;
}
envp.put("SERVER_SOFTWARE", "TOMCAT");
envp.put("SERVER_NAME", nullsToBlanks(req.getServerName()));
envp.put("GATEWAY_INTERFACE", "CGI/1.1");
envp.put("SERVER_PROTOCOL", nullsToBlanks(req.getProtocol()));
int port = req.getServerPort();
Integer iPort = (port == 0 ? new Integer(-1) : new Integer(port));
envp.put("SERVER_PORT", iPort.toString());
envp.put("REQUEST_METHOD", nullsToBlanks(req.getMethod()));
/*-
* PATH_INFO should be determined by using sCGIFullName:
* 1) Let sCGIFullName not end in a "/" (see method findCGI)
* 2) Let sCGIFullName equal the pathInfo fragment which
* corresponds to the actual cgi script.
* 3) Thus, PATH_INFO = request.getPathInfo().substring(
* sCGIFullName.length())
*
* (see method findCGI, where the real work is done)
*
*/
if (pathInfo == null
|| (pathInfo.substring(sCGIFullName.length()).length() <= 0)) {
sPathInfoCGI = "";
} else {
sPathInfoCGI = pathInfo.substring(sCGIFullName.length());
}
envp.put("PATH_INFO", sPathInfoCGI);
/*-
* PATH_TRANSLATED must be determined after PATH_INFO (and the
* implied real cgi-script) has been taken into account.
*
* The following example demonstrates:
*
* servlet info = /servlet/cgigw/dir1/dir2/cgi1/trans1/trans2
* cgifullpath = /servlet/cgigw/dir1/dir2/cgi1
* path_info = /trans1/trans2
* webAppRootDir = servletContext.getRealPath("/")
*
* path_translated = servletContext.getRealPath("/trans1/trans2")
*
* That is, PATH_TRANSLATED = webAppRootDir + sPathInfoCGI
* (unless sPathInfoCGI is null or blank, then the CGI
* specification dictates that the PATH_TRANSLATED metavariable
* SHOULD NOT be defined.
*
*/
if (sPathInfoCGI != null && !("".equals(sPathInfoCGI))) {
sPathTranslatedCGI = context.getRealPath(sPathInfoCGI);
} else {
sPathTranslatedCGI = null;
}
if (sPathTranslatedCGI == null || "".equals(sPathTranslatedCGI)) {
//NOOP
} else {
envp.put("PATH_TRANSLATED", nullsToBlanks(sPathTranslatedCGI));
}
envp.put("SCRIPT_NAME", nullsToBlanks(sCGIScriptName));
envp.put("QUERY_STRING", nullsToBlanks(req.getQueryString()));
envp.put("REMOTE_HOST", nullsToBlanks(req.getRemoteHost()));
envp.put("REMOTE_ADDR", nullsToBlanks(req.getRemoteAddr()));
envp.put("AUTH_TYPE", nullsToBlanks(req.getAuthType()));
envp.put("REMOTE_USER", nullsToBlanks(req.getRemoteUser()));
envp.put("REMOTE_IDENT", ""); //not necessary for full compliance
envp.put("CONTENT_TYPE", nullsToBlanks(req.getContentType()));
/* Note CGI spec says CONTENT_LENGTH must be NULL ("") or undefined
* if there is no content, so we cannot put 0 or -1 in as per the
* Servlet API spec.
*/
int contentLength = req.getContentLength();
String sContentLength = (contentLength <= 0 ? "" :
(new Integer(contentLength)).toString());
envp.put("CONTENT_LENGTH", sContentLength);
Enumeration headers = req.getHeaderNames();
String header = null;
while (headers.hasMoreElements()) {
header = null;
header = ((String) headers.nextElement()).toUpperCase();
//REMIND: rewrite multiple headers as if received as single
//REMIND: change character set
//REMIND: I forgot what the previous REMIND means
if ("AUTHORIZATION".equalsIgnoreCase(header) ||
"PROXY_AUTHORIZATION".equalsIgnoreCase(header)) {
//NOOP per CGI specification section 11.2
} else {
envp.put("HTTP_" + header.replace('-', '_'),
req.getHeader(header));
}
}
File fCGIFullPath = new File(sCGIFullPath);
command = fCGIFullPath.getCanonicalPath();
envp.put("X_TOMCAT_SCRIPT_PATH", command); //for kicks
this.env = envp;
return true;
}
/**
* Extracts requested resource from web app archive to context work
* directory to enable CGI script to be executed.
*/
protected void expandCGIScript() {
StringBuffer srcPath = new StringBuffer();
StringBuffer destPath = new StringBuffer();
InputStream is = null;
// paths depend on mapping
if (cgiPathPrefix == null ) {
srcPath.append(pathInfo);
is = context.getResourceAsStream(srcPath.toString());
destPath.append(tmpDir);
destPath.append(pathInfo);
} else {
// essentially same search algorithm as findCGI()
srcPath.append(cgiPathPrefix);
StringTokenizer pathWalker =
new StringTokenizer (pathInfo, "/");
// start with first element
while (pathWalker.hasMoreElements() && (is == null)) {
srcPath.append("/");
srcPath.append(pathWalker.nextElement());
is = context.getResourceAsStream(srcPath.toString());
}
destPath.append(tmpDir);
destPath.append("/");
destPath.append(srcPath);
}
if (is == null) {
// didn't find anything, give up now
if (debug >= 2) {
log("expandCGIScript: source '" + srcPath + "' not found");
}
return;
}
File f = new File(destPath.toString());
if (f.exists()) {
// Don't need to expand if it already exists
return;
}
// create directories
String dirPath = new String (destPath.toString().substring(
0,destPath.toString().lastIndexOf("/")));
File dir = new File(dirPath);
dir.mkdirs();
try {
synchronized (expandFileLock) {
// make sure file doesn't exist
if (f.exists()) {
return;
}
// create file
if (!f.createNewFile()) {
return;
}
FileOutputStream fos = new FileOutputStream(f);
// copy data
IOTools.flow(is, fos);
is.close();
fos.close();
if (debug >= 2) {
log("expandCGIScript: expanded '" + srcPath + "' to '" + destPath + "'");
}
}
} catch (IOException ioe) {
// delete in case file is corrupted
if (f.exists()) {
f.delete();
}
}
}
/**
* Print important CGI environment information in a easy-to-read HTML
* table
*
* @return HTML string containing CGI environment info
*
*/
public String toString() {
StringBuffer sb = new StringBuffer();
sb.append("");
sb.append("| ");
sb.append("CGIEnvironment Info |
|---|
");
sb.append("| Debug Level | ");
sb.append(debug);
sb.append(" |
");
sb.append("| Validity: | ");
sb.append(isValid());
sb.append(" |
");
if (isValid()) {
Enumeration envk = env.keys();
while (envk.hasMoreElements()) {
String s = (String) envk.nextElement();
sb.append("| ");
sb.append(s);
sb.append(" | ");
sb.append(blanksToString((String) env.get(s),
"[will be set to blank]"));
sb.append(" |
");
}
}
sb.append("
|
");
sb.append("| Derived Command | ");
sb.append(nullsToBlanks(command));
sb.append(" |
");
sb.append("| Working Directory | ");
if (workingDirectory != null) {
sb.append(workingDirectory.toString());
}
sb.append(" |
");
sb.append("| Query Params |
");
for (int i=0; i < queryParameters.size(); i++) {
NameValuePair nvp = (NameValuePair) queryParameters.get(i);
sb.append("| ");
sb.append(nvp.getName());
sb.append(" | ");
sb.append(nvp.getValue());
sb.append(" |
");
}
sb.append("
end.");
return sb.toString();
}
/**
* Gets derived command string
*
* @return command string
*
*/
protected String getCommand() {
return command;
}
/**
* Gets derived CGI working directory
*
* @return working directory
*
*/
protected File getWorkingDirectory() {
return workingDirectory;
}
/**
* Gets derived CGI environment
*
* @return CGI environment
*
*/
protected Hashtable getEnvironment() {
return env;
}
/**
* Gets derived CGI query parameters
*
* @return CGI query parameters
*
*/
protected ArrayList getParameters() {
return queryParameters;
}
/**
* Gets validity status
*
* @return true if this environment is valid, false
* otherwise
*
*/
protected boolean isValid() {
return valid;
}
/**
* Converts null strings to blank strings ("")
*
* @param s string to be converted if necessary
* @return a non-null string, either the original or the empty string
* ("") if the original was null
*/
protected String nullsToBlanks(String s) {
return nullsToString(s, "");
}
/**
* Converts null strings to another string
*
* @param couldBeNull string to be converted if necessary
* @param subForNulls string to return instead of a null string
* @return a non-null string, either the original or the substitute
* string if the original was null
*/
protected String nullsToString(String couldBeNull,
String subForNulls) {
return (couldBeNull == null ? subForNulls : couldBeNull);
}
/**
* Converts blank strings to another string
*
* @param couldBeBlank string to be converted if necessary
* @param subForBlanks string to return instead of a blank string
* @return a non-null string, either the original or the substitute
* string if the original was null or empty ("")
*/
protected String blanksToString(String couldBeBlank,
String subForBlanks) {
return (("".equals(couldBeBlank) || couldBeBlank == null)
? subForBlanks
: couldBeBlank);
}
} //class CGIEnvironment
/**
* Encapsulates the knowledge of how to run a CGI script, given the
* script's desired environment and (optionally) input/output streams
*
*
*
* Exposes a run method used to actually invoke the
* CGI.
*
*
*
*
* The CGI environment and settings are derived from the information
* passed to the constuctor.
*
*
*
*
* The input and output streams can be set by the setInput
* and setResponse methods, respectively.
*
*
* @version $Revision$, $Date$
*/
protected class CGIRunner {
/** script/command to be executed */
private String command = null;
/** environment used when invoking the cgi script */
private Hashtable env = null;
/** working directory used when invoking the cgi script */
private File wd = null;
/** query parameters to be passed to the invoked script */
private ArrayList params = null;
/** stdin to be passed to cgi script */
private InputStream stdin = null;
/** response object used to set headers & get output stream */
private HttpServletResponse response = null;
/** boolean tracking whether this object has enough info to run() */
private boolean readyToRun = false;
/**
* Creates a CGIRunner and initializes its environment, working
* directory, and query parameters.
*
* Input/output streams (optional) are set using the
* setInput and setResponse methods,
* respectively.
*
* @param command string full path to command to be executed
* @param env Hashtable with the desired script environment
* @param wd File with the script's desired working directory
* @param params ArrayList with the script's query parameters as
* NameValuePairs
*/
protected CGIRunner(String command, Hashtable env, File wd,
ArrayList params) {
this.command = command;
this.env = env;
this.wd = wd;
this.params = params;
updateReadyStatus();
}
/**
* Checks & sets ready status
*/
protected void updateReadyStatus() {
if (command != null
&& env != null
&& wd != null
&& params != null
&& response != null) {
readyToRun = true;
} else {
readyToRun = false;
}
}
/**
* Gets ready status
*
* @return false if not ready (run will throw
* an exception), true if ready
*/
protected boolean isReady() {
return readyToRun;
}
/**
* Sets HttpServletResponse object used to set headers and send
* output to
*
* @param response HttpServletResponse to be used
*
*/
protected void setResponse(HttpServletResponse response) {
this.response = response;
updateReadyStatus();
}
/**
* Sets standard input to be passed on to the invoked cgi script
*
* @param stdin InputStream to be used
*
*/
protected void setInput(InputStream stdin) {
this.stdin = stdin;
updateReadyStatus();
}
/**
* Converts a Hashtable to a String array by converting each
* key/value pair in the Hashtable to a String in the form
* "key=value" (hashkey + "=" + hash.get(hashkey).toString())
*
* @param h Hashtable to convert
*
* @return converted string array
*
* @exception NullPointerException if a hash key has a null value
*
*/
protected String[] hashToStringArray(Hashtable h)
throws NullPointerException {
Vector v = new Vector();
Enumeration e = h.keys();
while (e.hasMoreElements()) {
String k = e.nextElement().toString();
v.add(k + "=" + h.get(k));
}
String[] strArr = new String[v.size()];
v.copyInto(strArr);
return strArr;
}
/**
* Executes a CGI script with the desired environment, current working
* directory, and input/output streams
*
*
* This implements the following CGI specification recommedations:
*
* - Servers SHOULD provide the "
query" component of
* the script-URI as command-line arguments to scripts if it
* does not contain any unencoded "=" characters and the
* command-line arguments can be generated in an unambiguous
* manner.
* - Servers SHOULD set the AUTH_TYPE metavariable to the value
* of the "
auth-scheme" token of the
* "Authorization" if it was supplied as part of the
* request header. See getCGIEnvironment method.
* - Where applicable, servers SHOULD set the current working
* directory to the directory in which the script is located
* before invoking it.
*
- Server implementations SHOULD define their behavior for the
* following cases:
*
* - Allowed characters in pathInfo: This implementation
* does not allow ASCII NUL nor any character which cannot
* be URL-encoded according to internet standards;
*
- Allowed characters in path segments: This
* implementation does not allow non-terminal NULL
* segments in the the path -- IOExceptions may be thrown;
*
- "
." and ".." path
* segments:
* This implementation does not allow "." and
* ".." in the the path, and such characters
* will result in an IOException being thrown;
* - Implementation limitations: This implementation
* does not impose any limitations except as documented
* above. This implementation may be limited by the
* servlet container used to house this implementation.
* In particular, all the primary CGI variable values
* are derived either directly or indirectly from the
* container's implementation of the Servlet API methods.
*
*
*
*
* @exception IOException if problems during reading/writing occur
*
* @see java.lang.Runtime#exec(String command, String[] envp,
* File dir)
*/
protected void run() throws IOException {
/*
* REMIND: this method feels too big; should it be re-written?
*/
if (!isReady()) {
throw new IOException(this.getClass().getName()
+ ": not ready to run.");
}
if (debug >= 1 ) {
log("runCGI(envp=[" + env + "], command=" + command + ")");
}
if ((command.indexOf(File.separator + "." + File.separator) >= 0)
|| (command.indexOf(File.separator + "..") >= 0)
|| (command.indexOf(".." + File.separator) >= 0)) {
throw new IOException(this.getClass().getName()
+ "Illegal Character in CGI command "
+ "path ('.' or '..') detected. Not "
+ "running CGI [" + command + "].");
}
/* original content/structure of this section taken from
* http://developer.java.sun.com/developer/
* bugParade/bugs/4216884.html
* with major modifications by Martin Dengler
*/
Runtime rt = null;
BufferedReader commandsStdOut = null;
InputStream cgiOutput = null;
BufferedReader commandsStdErr = null;
BufferedOutputStream commandsStdIn = null;
Process proc = null;
int bufRead = -1;
//create query arguments
StringBuffer cmdAndArgs = new StringBuffer();
if (command.indexOf(" ") < 0) {
cmdAndArgs.append(command);
} else {
// Spaces used as delimiter, so need to use quotes
cmdAndArgs.append("\"");
cmdAndArgs.append(command);
cmdAndArgs.append("\"");
}
for (int i=0; i < params.size(); i++) {
cmdAndArgs.append(" ");
NameValuePair nvp = (NameValuePair) params.get(i);
String k = nvp.getName();
String v = nvp.getValue();
if ((k.indexOf("=") < 0) && (v.indexOf("=") < 0)) {
StringBuffer arg = new StringBuffer(k);
arg.append("=");
arg.append(v);
if (arg.toString().indexOf(" ") < 0) {
cmdAndArgs.append(arg);
} else {
// Spaces used as delimiter, so need to use quotes
cmdAndArgs.append("\"");
cmdAndArgs.append(arg);
cmdAndArgs.append("\"");
}
}
}
StringBuffer command = new StringBuffer(cgiExecutable);
command.append(" ");
command.append(cmdAndArgs.toString());
cmdAndArgs = command;
String sContentLength = (String) env.get("CONTENT_LENGTH");
ByteArrayOutputStream contentStream = null;
if(!"".equals(sContentLength)) {
byte[] content = new byte[Integer.parseInt(sContentLength)];
// Bugzilla 32023
int lenRead = 0;
do {
int partRead = stdin.read(content,lenRead,content.length-lenRead);
lenRead += partRead;
} while (lenRead > 0 && lenRead < content.length);
contentStream = new ByteArrayOutputStream(
Integer.parseInt(sContentLength));
if ("POST".equals(env.get("REQUEST_METHOD"))) {
String paramStr = getPostInput(params);
if (paramStr != null) {
byte[] paramBytes = paramStr.getBytes();
contentStream.write(paramBytes);
int contentLength = paramBytes.length;
if (lenRead > 0) {
String lineSep = System.getProperty("line.separator");
contentStream.write(lineSep.getBytes());
contentLength = lineSep.length() + lenRead;
}
env.put("CONTENT_LENGTH", Integer.toString(contentLength));
}
}
if (lenRead > 0) {
contentStream.write(content, 0, lenRead);
}
contentStream.close();
}
rt = Runtime.getRuntime();
proc = rt.exec(cmdAndArgs.toString(), hashToStringArray(env), wd);
if(contentStream != null) {
commandsStdIn = new BufferedOutputStream(proc.getOutputStream());
commandsStdIn.write(contentStream.toByteArray());
commandsStdIn.flush();
commandsStdIn.close();
}
/* we want to wait for the process to exit, Process.waitFor()
* is useless in our situation; see
* http://developer.java.sun.com/developer/
* bugParade/bugs/4223650.html
*/
boolean isRunning = true;
commandsStdErr = new BufferedReader
(new InputStreamReader(proc.getErrorStream()));
BufferedWriter servletContainerStdout = null;
try {
if (response.getOutputStream() != null) {
servletContainerStdout =
new BufferedWriter(new OutputStreamWriter
(response.getOutputStream()));
}
} catch (IOException ignored) {
//NOOP: no output will be written
}
final BufferedReader stdErrRdr = commandsStdErr ;
new Thread() {
public void run () {
sendToLog(stdErrRdr) ;
} ;
}.start() ;
InputStream cgiHeaderStream =
new HTTPHeaderInputStream(proc.getInputStream());
BufferedReader cgiHeaderReader =
new BufferedReader(new InputStreamReader(cgiHeaderStream));
boolean isBinaryContent = false;
while (isRunning) {
try {
//set headers
String line = null;
while (((line = cgiHeaderReader.readLine()) != null)
&& !("".equals(line))) {
if (debug >= 2) {
log("runCGI: addHeader(\"" + line + "\")");
}
if (line.startsWith("HTTP")) {
//TODO: should set status codes (NPH support)
/*
* response.setStatus(getStatusCode(line));
*/
} else if (line.indexOf(":") >= 0) {
String header =
line.substring(0, line.indexOf(":")).trim();
String value =
line.substring(line.indexOf(":") + 1).trim();
response.addHeader(header , value);
if ((header.toLowerCase().equals("content-type"))
&& (!value.toLowerCase().startsWith("text"))) {
isBinaryContent = true;
}
response.sendRedirect(response.encodeRedirectURL(value));
} else {
log("runCGI: bad header line \"" + line + "\"");
}
}
//write output
if (isBinaryContent) {
byte[] bBuf = new byte[2048];
OutputStream out = response.getOutputStream();
cgiOutput = proc.getInputStream();
while ((bufRead = cgiOutput.read(bBuf)) != -1) {
if (debug >= 4) {
log("runCGI: output " + bufRead +
" bytes of binary data");
}
out.write(bBuf, 0, bufRead);
}
} else {
commandsStdOut = new BufferedReader
(new InputStreamReader(proc.getInputStream()));
char[] cBuf = new char[1024];
try {
while ((bufRead = commandsStdOut.read(cBuf)) != -1) {
if (servletContainerStdout != null) {
if (debug >= 4) {
log("runCGI: write(\"" +
new String(cBuf, 0, bufRead) + "\")");
}
servletContainerStdout.write(cBuf, 0, bufRead);
}
}
} finally {
// Attempt to consume any leftover byte if something bad happens,
// such as a socket disconnect on the servlet side; otherwise, the
// external process could hang
if (bufRead != -1) {
while ((bufRead = commandsStdOut.read(cBuf)) != -1) {}
}
}
if (servletContainerStdout != null) {
servletContainerStdout.flush();
}
}
proc.exitValue(); // Throws exception if alive
isRunning = false;
} catch (IllegalThreadStateException e) {
try {
Thread.sleep(500);
} catch (InterruptedException ignored) {
}
}
} //replacement for Process.waitFor()
// Close the output stream used
if (isBinaryContent) {
cgiOutput.close();
} else {
commandsStdOut.close();
}
}
private void sendToLog(BufferedReader rdr) {
String line = null;
int lineCount = 0 ;
try {
while ((line = rdr.readLine()) != null) {
log("runCGI (stderr):" + line) ;
lineCount++ ;
}
} catch (IOException e) {
log("sendToLog error", e) ;
} finally {
try {
rdr.close() ;
} catch (IOException ce) {
log("sendToLog error", ce) ;
} ;
} ;
if ( lineCount > 0 && debug > 2) {
log("runCGI: " + lineCount + " lines received on stderr") ;
} ;
}
/**
* Gets a string for input to a POST cgi script
*
* @param params ArrayList of query parameters to be passed to
* the CGI script
* @return for use as input to the CGI script
*/
protected String getPostInput(ArrayList params) {
StringBuffer qs = new StringBuffer("");
for (int i=0; i < params.size(); i++) {
NameValuePair nvp = (NameValuePair) this.params.get(i);
String k = nvp.getName();
String v = nvp.getValue();
if ((k.indexOf("=") < 0) && (v.indexOf("=") < 0)) {
qs.append(k);
qs.append("=");
qs.append(v);
qs.append("&");
}
}
if (qs.length() > 0) {
// Remove last "&"
qs.setLength(qs.length() - 1);
return qs.toString();
} else {
return null;
}
}
} //class CGIRunner
/**
* This is a simple class for storing name-value pairs.
*
* TODO: It might be worth moving this to the utils package there is a
* wider requirement for this functionality.
*/
protected class NameValuePair {
private String name;
private String value;
NameValuePair(String name, String value) {
this.name = name;
this.value = value;
}
protected String getName() {
return name;
}
protected String getValue() {
return value;
}
}
/**
* This is an input stream specifically for reading HTTP headers. It reads
* upto and including the two blank lines terminating the headers. It
* allows the content to be read using bytes or characters as appropriate.
*/
protected class HTTPHeaderInputStream extends InputStream {
private static final int STATE_CHARACTER = 0;
private static final int STATE_FIRST_CR = 1;
private static final int STATE_FIRST_LF = 2;
private static final int STATE_SECOND_CR = 3;
private static final int STATE_HEADER_END = 4;
private InputStream input;
private int state;
HTTPHeaderInputStream(InputStream theInput) {
input = theInput;
state = STATE_CHARACTER;
}
/**
* @see java.io.InputStream#read()
*/
public int read() throws IOException {
if (state == STATE_HEADER_END) {
return -1;
}
int i = input.read();
// Update the state
// State machine looks like this
//
// -------->--------
// | (CR) |
// | |
// CR1--->--- |
// | | |
// ^(CR) |(LF) |
// | | |
// CHAR--->--LF1--->--EOH
// (LF) | (LF) |
// |(CR) ^(LF)
// | |
// (CR2)-->---
if (i == 10) {
// LF
switch(state) {
case STATE_CHARACTER:
state = STATE_FIRST_LF;
break;
case STATE_FIRST_CR:
state = STATE_FIRST_LF;
break;
case STATE_FIRST_LF:
case STATE_SECOND_CR:
state = STATE_HEADER_END;
break;
}
} else if (i == 13) {
// CR
switch(state) {
case STATE_CHARACTER:
state = STATE_FIRST_CR;
break;
case STATE_FIRST_CR:
state = STATE_HEADER_END;
break;
case STATE_FIRST_LF:
state = STATE_SECOND_CR;
break;
}
} else {
state = STATE_CHARACTER;
}
return i;
}
} // class HTTPHeaderInputStream