|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--org.apache.catalina.util.ProcessEnvironment
|
+--org.apache.catalina.util.CGIProcessEnvironment
Encapsulates the CGI Process' environment and rules to derive that environment from the servlet container and request information.
| Fields inherited from class org.apache.catalina.util.ProcessEnvironment |
command,
debug,
env,
pathInfo,
valid,
workingDirectory |
| Constructor Summary | |
CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context)
Creates a ProcessEnvironment and derives the necessary environment, working directory, command, etc. |
|
CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context,
int debug)
Creates a ProcessEnvironment and derives the necessary environment, working directory, command, etc. |
|
CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context,
java.lang.String cgiPathPrefix)
Creates a ProcessEnvironment and derives the necessary environment, working directory, command, etc. |
|
CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context,
java.lang.String cgiPathPrefix,
int debug)
Creates a ProcessEnvironment and derives the necessary environment, working directory, command, etc. |
|
| Method Summary | |
protected boolean |
deriveProcessEnvironment(javax.servlet.http.HttpServletRequest req)
Constructs the CGI environment to be supplied to the invoked CGI script; relies heavliy on Servlet API methods and findCGI |
protected java.lang.String[] |
findCGI(java.lang.String pathInfo,
java.lang.String webAppRootDir,
java.lang.String contextPath,
java.lang.String servletPath,
java.lang.String cgiPathPrefix)
Resolves core information about the cgi script. |
java.util.Hashtable |
getParameters()
Gets process' derived query parameters |
java.lang.String |
toString()
Print important CGI environment information in an easy-to-read HTML table |
| Methods inherited from class org.apache.catalina.util.ProcessEnvironment |
blanksToString,
getCommand,
getContext,
getContextPath,
getEnvironment,
getServletPath,
getWebAppRootDir,
getWorkingDirectory,
isValid,
log,
nullsToBlanks,
nullsToString,
setCommand,
setEnvironment,
setupFromContext,
setupFromRequest |
| Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
| Constructor Detail |
public CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context)
req - HttpServletRequest for information provided by
the Servlet APIcontext - ServletContext for information provided by
the Servlet API
public CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context,
java.lang.String cgiPathPrefix)
req - HttpServletRequest for information provided by
the Servlet APIcontext - ServletContext for information provided by
the Servlet APIcgiPathPrefix - subdirectory of webAppRootDir below which the
web app's CGIs may be stored; can be null or "".
public CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context,
int debug)
req - HttpServletRequest for information provided by
the Servlet APIcontext - ServletContext for information provided by
the Servlet APIdebug - int debug level (0 == none, 6 == lots)
public CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
javax.servlet.ServletContext context,
java.lang.String cgiPathPrefix,
int debug)
req - HttpServletRequest for information provided by
the Servlet APIcontext - ServletContext for information provided by
the Servlet APIcgiPathPrefix - subdirectory of webAppRootDir below which the
web app's CGIs may be stored; can be null or "".debug - int debug level (0 == none, 6 == lots)| Method Detail |
protected boolean deriveProcessEnvironment(javax.servlet.http.HttpServletRequest req)
HttpServletRequest - request associated with the CGI invokation
protected java.lang.String[] findCGI(java.lang.String pathInfo,
java.lang.String webAppRootDir,
java.lang.String contextPath,
java.lang.String servletPath,
java.lang.String cgiPathPrefix)
Example URI:
/servlet/cgigateway/dir1/realCGIscript/pathinfo1
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 usually set by the calling servlet to the servlet's cgiPathPrefix init parameter
pathInfo - String from HttpServletRequest.getPathInfo()webAppRootDir - String from context.getRealPath("/")contextPath - String as from HttpServletRequest.getContextPath()servletPath - String as from HttpServletRequest.getServletPath()cgiPathPrefix - subdirectory of webAppRootDir below which the
web app's CGIs may be stored; can be null.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
public java.lang.String toString()
public java.util.Hashtable getParameters()
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||