SET_COOKIE_SUPPORT Procedure

This procedure sets:

• Whether or not future HTTP requests will support HTTP cookies

• The maximum number of cookies maintained in the current database user session

If cookie support is enabled for an HTTP request, all cookies saved in the current session and applicable to the request are returned to the Web server in the request, in accordance with HTTP cookie specification standards. Cookies that are set in response to the request are saved in the current session for return to the Web server in subsequent requests, if cookie support is enabled for those requests. If cookie support is disabled for an HTTP request, no cookies will be returned to the Web server in the request and the cookies set in the response to the request are not saved in the current session, although the Set-Cookie HTTP headers can still be retrieved from the response.

Cookie support is enabled by default for all HTTP requests in a database user session. The default setting of the cookie support (enabled vs. disabled) affects only the future requests and has no effect on the existing ones. After your request is created, the cookie support setting may be changed by using the other set_cookie_support procedure that operates on a request.

The default maximum number of cookies saved in the current session is 20 per site and 300 total.

Syntax

UTL_HTTP.set_cookie_support (

   enable  IN BOOLEAN,
   max_cookies  IN PLS_INTEGER DEFAULT 300,
   max_cookies_per_site  IN PLS_INTEGER DEFAULT 20);

Parameters

Table 78-11 shows the parameters for the SET_COOKIE_SUPPORT procedure.

Table 78-11 SET_COOKIE SUPPORT Procedure Parameters

Parameter	Description
enable (IN)	Sets whether future HTTP requests should support HTTP cookies (TRUE) or not (FALSE)
max_cookies (IN)	Sets the maximum total number of cookies maintained in the current session
max_cookies_per_site (IN)	Sets the maximum number of cookies maintained in the current session per each Web site

Usage Notes

If you lower the maximum total number of cookies or the maximum number of cookies per each Web site, the oldest cookies will be purged first to reduce the number of cookies to the lowered maximum. HTTP cookies saved in the current session last for the duration of the database session only; there is no persistent storage for the cookies. Cookies saved in the current session are not cleared if you disable cookie support.

See "UTL_HTTP Examples" for how to use get_cookies and add_cookies to retrieve, save, and restore cookies.