Class wwRequest - West Wind Web Connection

Class wwRequest

The wwRequest class' purpose is to allow your programs to receive information from the web server and the HTML page that generated a Web request. It retrieves Form and QueryString variables, Cookies and ServerVariables - it basically acts as your input source for a request.

Class Members

Member		Description
	Form	o.Form(lcPostKey,llNullIfNotFound)
	FormChecked	o.FormChecked(lcFormKey, lcValue, lcModelValue)
	FormDate	Returns a date from a form variable by trying to convert the string date input to a date time value. Supports ISO date conversion for native `type="date"` and `type="datetime-local"` inputs as well as default locale parsing using `CTOT()`. o.FormDate(lcFormKey, llNullIfNotFound)
	FormDateOrValue	Returns a form variable as a date on post back operations or returns the specified value on a non-POST operation or if the value is not part of the POST buffer. o.FormDateOrValue(lcFormKey, ltValue)
	FormOrValue	o.FormOrValue(lcFormKey, lvValue)
	FormSelected	o.FormSelected(lcFormKey, lcValue, lcModelValue)
	FormVarsToObject	o.FormVarsToObject(loObject,lcPrefix,lcExcludedProperties)
	GetApplicationPath	Returns the physical OS path of the virtual directory of this Web Server application. In short it maps the virtual directory defined in IIS to a physical path. Can be used as a 'base url' for Web applications to base relative URls on. o.GetApplicationPath()
	GetAuthenticatedUser	Returns the name of a user if he has been authenticated by the Web server. This variable gets set and stays set once a user has entered a valid username into the browser dialog box when prompted. The username is valid for a given Web server path and down and once set cannot be unset until the browser is shut down or another authentication request is made for the same user. o.getauthenticateduser(lnMode)
	GetBrowser	Returns the client's browser display name. o.getbrowser()
	getclientcertificate	Returns the contents of a client Certificate's Subject key. This information contains the info about the client. The following information is provided: o.getclientcertificate(lcSubKey)
	GetCookie	Returns an HTTP Cookie that was previously set. HTTP cookies allow keeping state by keeping a persistent variable on the user's browser. Cookies are sent along in each HTTP request and appear as a server variable in the incoming request data. o.getcookie(lcCookie)
	GetCurrentUrl	Returns the current URL. o.getcurrenturl(llHTTPS)
	GetExecutablePath	Returns the logical, Web relative path to the DLL or script. o.getexecutablepath()
	GetExtraHeader	o.GetExtraHeader(lcHeader)
	GetFormMultiple	This method retrieves multiselect HTML form variables from the CGI content file into an array. Multiselect variables can be returned when using scrolling HTML lists with the SELECT MULTIPE option or multiple radio buttons and checkboxes using the same variable name. o.getformmultiple(@taVars,tcVarname)
	GetFormMultipleCollection	This method retrieves multiselect Request form variables into a collection of string values. Multi-select values can come from Multi-select lists, drop downs or from radio buttons. o.GetFormMultipleCollection(tcVarname)
	GetFormVarCollection	Retrieves a collection of all the form variables keys and values in the Request.Form() collection so you can iterate the variables. The collection contains an object that has `Key` and `Value` properties. o.GetFormVarCollection(tcPrefix)
	GetHttpVerb	Returns the HTTP verb of the request. o.GetHttpVerb()
	GetIPAddress	Returns the client's IP Address. o.getipaddress()
	GetLocale	Returns the currently active language in the browser if available. o.GetLocale(@laLanguages)
	GetLogicalPath	o.getlogicalpath(llProxiedPaths)
	GetMultipartFile	o.GetMultipartFile(lcKey, @lcFileName)
	GetMultipartFiles	o.GetMultipartFiles(lcKey)
	GetMultipartFormVar	Retrieves a multipart form variable from the request buffer. Multipart form variables are submitted on the client side by specifiying an encoding type of "multipart/form-data". o.GetMultipartFormVar(lcKey)
	GetPhysicalPath	Returns the physical path to a script mapped page or an executable DLL file. The physical path is a great tool for capturing the system specific path of script mapped pages, so you can capture the location of the page for further parsing. o.getphysicalpath()
	GetPreviousUrl	Returns the referring URL for the page when available. Essentially this returns the previous URL that was clicked or navigated to bring you to the current page. o.GetReferrer()
	GetQueryStringMultipleCollection	o.GetQueryStringMultipleCollection(lvKey)
	GetRawFormData	Returns all of the form data in raw form. o.GetRawFormData()
	GetRelativeSecureLink	This method allows you to easily create a secure link simply by specifying a relative link like any other link. o.GetRelativeSecureLink(lcLink,llNonSecure)
	GetRequestId	Returns the unique Request ID for the currently executing request. o.GetRequestId()
	GetRoutingInfo	o.GetRoutingInfo()
	GetServerName	Returns the server's domain or IP address. Note that this value returns only the server portion of the current URL. o.GetServerName()
	GetServerSoftware	Returns the software that's running the Web server. o.getserversoftware()
	GetUrlEncodedKeyCollection	o.GetUrlEncodedKeyCollection(lcVars, lcPrefix)
	GetVirtualPath	Retrieves the virtual path of the current request. The value is provided with leading and trailing forward slashes. o.GetVirtualPath()
	GetWCIniValue	Retrieves a value from the Web Connection ISAPI/CGI configuration file. Most useful for retrieving the AdminUser value. o.getwcinivalue(lcKey, lcSection)
	InitializeRequest	This method is responsible for setting up the Request object on each hit by passing in the POST data in some format and making it available to the specific Get methods. This method is fired on every Web request hit and deals with clearing out values from previous requests and then reassigning new values. o.initializerequest(lcPostData, lcTempPath)
	IsChecked	Determines whether a checkbox or radio button has been checked. o.wwrequest.IsChecked(lcFormVar)
	IsFormVar	Checks to see if a form variable exists in the request POST buffer. This method returns .T. if the key exists even if the value is blank. It will only return .F. if the key doesn't exist at all. If you need to check for blank you can simply read the key with wwRequest::Form(). o.IsFormVar(lcKey)
	islinksecure	Checks to see if the user is coming in over the SSL port. o.IsLinkSecure(lcSecurePort)
	IsPostback	Determines whether the current request is being sent via an HTTP POST operation. Useful when checking for first time display or submit handling of requests. o.IsPostback()
	Params	Returns a value by checking FormVars, QueryString, Session and ViewState (in that order) for a matching key and returning the value. o.Params(lcKey)
	QueryString	o.QueryString(lvKey)
	ServerVariables	Retrieves a server variable from the request data. Server variables provide information about the current request including info about the client application (browser, IP Address), the current request (server name, querystring), authentication (username, port accessing this app) and status information (Cookies, type of request) etc. o.servervariables(lcKey)
	SetKey	o.setkey(lcKey, lcValue)
	UnbindFormVars	o.UnbindFormVars(loObject, lcPrefix, lcExcludedProperties)
	cFormVars	This property holds the raw POST buffer that the HTTP client submitted.
	cpathoverride	Actual location of the Temporary path. This path is used to override any 'physical' paths to point to the network path instead.
	cServerVars	This property holds the raw Server variables returned from the Web Connection DLL. This data is URLEncoded and was created by Web Connection on the fly. Every call to ServerVariables accesses this data directly to extract the appropriate server variable value.
	lusexmlformvars	If .T. Request.Form retrieves variables from an XML document contained in the form buffer rather than regular post variables.
	lUtf8Encoding	If .T. causes Request.Form() and Request.QueryString() to UTF-8 decode the returned values.
	nPostMode	Request property that gets set by InitializeRequest and determines what kind of Form submission is occurring.
	oapi	Internal wwAPI object. The object is not protected to allow persistent access to an API object through the Request.oAPI member.
	oxml	Internal reference to a wwXML object. This object is not protected and can be treated as a 'global' reference to a wwXML object accessible through wwRequest.oXML.

Requirements

Assembly: wwRequest.prg

Class Members

Requirements

See also: