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

MemberDescription

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.GetReferer()

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()

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

This method returns the Query String and individual pieces of it. The method supports both numeric,positional parameters and named parameters. Positional parameters are great for grabbing request information:

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

See also:

Class wwRequest | The Server Status Form | wwProcess::oRequest | wwServer::Process

© West Wind Technologies, 1996-2019 • Updated: 03/28/16
Comment or report problem with topic