org.apache.catalina.util
クラス CGIProcessEnvironment

java.lang.Object
  |
  +--org.apache.catalina.util.ProcessEnvironment
        |
        +--org.apache.catalina.util.CGIProcessEnvironment

public class CGIProcessEnvironment
extends ProcessEnvironment

Encapsulates the CGI Process' environment and rules to derive that environment from the servlet container and request information.

導入されたバージョン:
Tomcat 4.0
バージョン:
$Revision: 1.3 $, $Date: 2001/08/14 18:50:10 $
作成者:
Martin Dengler [root@martindengler.com]

クラス org.apache.catalina.util.ProcessEnvironment から継承したフィールド
command, debug, env, pathInfo, valid, workingDirectory
 
コンストラクタの概要
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.
 
メソッドの概要
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
 
クラス org.apache.catalina.util.ProcessEnvironment から継承したメソッド
blanksToString, getCommand, getContext, getContextPath, getEnvironment, getServletPath, getWebAppRootDir, getWorkingDirectory, isValid, log, nullsToBlanks, nullsToString, setCommand, setEnvironment, setupFromContext, setupFromRequest
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

CGIProcessEnvironment

public CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
                             javax.servlet.ServletContext context)
Creates a ProcessEnvironment and derives the necessary environment, working directory, command, etc. The cgi path prefix is initialized to "" (the empty string).
パラメータ:
req - HttpServletRequest for information provided by the Servlet API
context - ServletContext for information provided by the Servlet API

CGIProcessEnvironment

public 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.
パラメータ:
req - HttpServletRequest for information provided by the Servlet API
context - ServletContext for information provided by the Servlet API
cgiPathPrefix - subdirectory of webAppRootDir below which the web app's CGIs may be stored; can be null or "".

CGIProcessEnvironment

public CGIProcessEnvironment(javax.servlet.http.HttpServletRequest req,
                             javax.servlet.ServletContext context,
                             int debug)
Creates a ProcessEnvironment and derives the necessary environment, working directory, command, etc.
パラメータ:
req - HttpServletRequest for information provided by the Servlet API
context - ServletContext for information provided by the Servlet API
debug - int debug level (0 == none, 6 == lots)

CGIProcessEnvironment

public 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.
パラメータ:
req - HttpServletRequest for information provided by the Servlet API
context - ServletContext for information provided by the Servlet API
cgiPathPrefix - 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)
メソッドの詳細

deriveProcessEnvironment

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
オーバーライド:
クラス ProcessEnvironment 内の deriveProcessEnvironment
パラメータ:
HttpServletRequest - request associated with the CGI invokation
戻り値:
true if environment was set OK, false if there was a problem and no environment was set

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.

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
導入されたバージョン:
Tomcat 4.0

toString

public java.lang.String toString()
Print important CGI environment information in an easy-to-read HTML table
オーバーライド:
クラス ProcessEnvironment 内の toString
戻り値:
HTML string containing CGI environment info

getParameters

public java.util.Hashtable getParameters()
Gets process' derived query parameters
戻り値:
process' query parameters


Copyright ? 2000-2001 Apache Software Foundation. All Rights Reserved.