Oracle9i Application Server PL/SQL Web Toolkit Reference Release 1.0.2.2 Part Number A90101-01 |
|
The owa_cookie package contains subprograms that send and retrieve HTTP cookies from the client's browser. Cookies are opaque strings sent to the browser to maintain state between HTTP calls. State can be maintained throughout the client's sessions, or longer if an expiration date is included. Your system date is calculated with reference to the information specified in the owa_custom package.
owa_cookie.cookie data type - data type to contain cookie name-value pairs.
owa_cookie.get function - gets the value of the specified cookie.
owa_cookie.get_all procedure - gets all cookie name-value pairs.
owa_cookie.remove procedure - removes the specified cookie.
owa_cookie.send procedure - generates a ""Set-Cookie" line in the HTTP header.
Since the HTTP standard allows cookie names to be overloaded (that is, multiple values can be associated with the same cookie name), this is a PL/SQL RECORD holding all values associated with a given cookie name.
Type vc_arr is table of varchar2(4000) index by binary_integer.
Properties | Definitions |
---|---|
Syntax: |
type cookie is RECORD ( name varchar2(4000), vals vc_arr, num_vals integer); |
Returns: |
Not applicable. |
This function returns the values associated with the specified cookie. The values are returned in a owa_cookie.cookie data type.
Properties | Definitions |
---|---|
Syntax: |
owa_cookie.get(name in varchar2) return cookie; |
Parameter: |
name - the name of the cookie. |
Returns: |
This procedure returns all cookie names and their values from the client's browser. The values appear in the order in which they were sent from the browser.
This procedure forces a cookie to expire immediately by setting the "expires" field of a Set-Cookie line in the HTTP header to "01-Jan-1990". This procedure must be called within the context of an HTTP header.
This procedure generates a Set-Cookie line, which transmits a cookie to the client. This procedure must occur in the context of an HTTP header.
|
Copyright © 2001 Oracle Corporation. All Rights Reserved. |
|