19.3 HTTP Server Functions
This section describes the server functions that are used to to manage requests (UDRs) from the HTTPD collector agent.
httpGetRequestCookie
This function searches for a cookie name in the httpdUDR and returns the contents.
string httpGetRequestCookie ( any httpdUDR , string cookieName )
Parameter | Description |
---|---|
| The request |
| A cookie is made up of a key:value data object, where cookieName is the key. Note! The value can be "null". |
Returns | The contents (value) of the cookie. |
httpGetRequestCookieNames
This function retrieves a list of cookie names (keys) from the request (UDR).
list <string> httpGetRequestCookieNames ( any httpdUDR )
Parameter | Description |
---|---|
| The request |
Returns | A list of cookie names |
httpSetResponseCookie
This function sets the response cookie (UDR) fields.
void httpSetResponseCookie ( any httpdUDR, string name, string value, boolean discard, string domain, long maxAge, string path, boolean secure )
Parameter | Description |
---|---|
| The response |
| The name of the cookie (the key in the key:value cookie object) |
| The contents of the cookie (the value in the key:value cookie object) |
| Set to "true" to discard the cookie at browser close, or "false", to keep it. |
| The domain to which the cookie should be sent |
| The life-length of the cookie in seconds |
| The path within the domain that triggers the cookie |
| Set to "true" for sending the cookie only to secure sites, or "false", for sending the cookie to any site within the domain. |
Returns | Nothing |