Implements a container for Cookie class instances.

TIdCookies = class(TOwnedCollection)

TIdCookies is a TOwnedCollection descendant that implements a container for Cookie class instances. TIdCookies provides methods that allow creation of both TIdCookieRFC2109 and TIdCookieRFC2965 Cookie class instances. TIdCookies also provides methods that provide access to Cookie class instances using Cookie name, Cookie name and Domain, and an integer position in the Cookie collection.

TIdCookies is the type used by TIdCookieManager to represent the Cookie collection maintained by a TIdHTTP client.

Provides access to Cookie collection items using name and domain values.

property Cookie [const AName, ADomain: string]: TIdCookieRFC2109;

TIdCookieRFC2109 - Cookie with the specified name and domain, or Nil.

Cookie is a read-only TIdCookieRFC2109 property that provides access to Cookies in the collection using the name and domain specified in AName and ADomain. TIdCookies calls GetCookieIndex, when using the read access specifier for Cookie, to determine the position of the Cookie having the specified CookieName and Domain. Cookie can return Nil when a Cookie cannot be located in the collection having the specified name and domain values.

Use CookieListByDomain to limit access to Cookie collection items having a specified Domain value. Use Items to access Cookie collection items by their integer position in the container.

Provides access to Cookie collection items by position in the container.

property Items [Index: Integer]: TIdCookieRFC2109;

Position in the container to be accessed.

TIdCookieRFC2109 - Cookie at the specified position in the collection.

Items is a TIdCookieRFC2109 property that provides access to Cookie class instances in the collection using the Integer position specified in Index. Items is the default property used when accessing the collection.

Items is used when accessing or updating Cookie collection items in the GetCookie, GetCookieIndex, and Delete methods.

Creates a Cookie class instance to be added to the Cookie collection.

function Add: TIdCookieRFC2109;

TIdCookieRFC2109 - Cookie class instance added to the collection.

Add is a TIdCookieRFC2109 function that creates a new instance of TIdCookieRFC2109 to be added to the Cookie collection. Add creates the Cookie class instance using the TIdCookies object instance as the owner of the collection item.

Add is called from the TIdCookieManager.AddCookie method when a CookieName and Domain are added to an HTTP client as an TIdCookieRFC2109 class instance.

Creates a Cookie class instance to be added to the Cookie collection.

function Add2: TIdCookieRFC2965;

TIdCookieRFC2965 - Cookie class instance added to the collection.

Add2 is a TIdCookieRFC2965 function that creates a new instance of TIdCookieRFC2965 to be added to the Cookie collection. Add creates the Cookie class instance using the TIdCookies object instance as the owner of the collection item.

Add2 is called from the TIdCookieManager.AddCookie2 method when a CookieName and Domain are added to an HTTP client as an TIdCookieRFC2965 class instance.

Adds or updates a Cookie instance in the collection.

procedure AddCookie(ACookie: TIdCookieRFC2109);

Cookie class instance to be added or updated in the collection.

AddCookie is a procedure that adds a TIdCookieRFC2109 class instance specified in ACookie to the Cookie collection. AddCookie uses an instance of TIdCookieList to maintain a list of Cookies for the Domain specified in ACookie. AddCookie also uses CookieListByDomain to create or maintain Cookie class instances using the value of CookieName specified in ACookie.

If a Cookie having the Domain and CookieName specified in ACookie already exists in the collection, the Cookie value is assigned to the existing TIdCookieRFC2109 object instance and ACookie is freed. Otherwise, ACookie is added to the Cookie list for the specified Domain and CookieName.

AddCookie is called by TIdCookieManager when a Cookie is added to the collection maintained by an HTTP client.

Creates a new Cookie collection item using the textual Cookie data.

procedure AddSrcCookie(const sCookie: string);

Textual representation of the Cookie.

AddSrcCookie is a procedure used to create a new Cookie class instance in the collection using the textual representation of Cookie specified in sCookie. AddSrcCookie calls Add to create the Cookie class instance added to the collection. AddSrcCookie sets the name, value, and attributes for the Cookie by updating CookieText to reflect the data specified in sCookie.

Constructor for the object instance.

constructor Create(AOwner: TPersistent);

Owner of the collection.

Create is the constructor for the object instance. Create calls the inherited Create method using AOwner as the owner of the collection, and TIdCookieRFC2109 as the ItemClass maintained in the collection.

Create initializes the TIdCookieList used by the CookieListByDomain property, and sets Sorted to False in the object property. Create also allocates an internal TMultiReadExclusiveWriteSynchronizer instance that is used to protect access to the collection in a multi-threaded application.

Removes a Cookie from the collection.

procedure Delete(Index: Integer);

Position of the Cookie in the container.

Delete is a procedure that allows freeing of a Cookie class instance in the collection by the Integer position in the container specified in Index. Delete accesses the collection using the Items property and the specified Index position to call the Free method for the collection item.

Frees the object instance.

destructor Destroy; override;

Destroy is the destructor for the object instance. Destroy calls Clear to insure that Cookies are removed from the collection. Destroy frees resources allocated in the Create constructor, including the CookieListByDomain property and the internal protection mechanism used to access the collection. Destroy calls the inherited Destroy method prior to exiting.

Indicates the index position of a Cookie containing specified values.

function GetCookieIndex(FirstIndex: integer; const AName: string): Integer; overload;
function GetCookieIndex(FirstIndex: integer; const AName: string; const ADomain: string): Integer; overload;

Initial position to be examined in the collection.

Cookie name to be matched.

Domain attribute to be matched.

Integer - Position of the matched Cookie in the collection, or -1 when not found.

GetCookieIndex is an overloaded Integer function that accesses Cookie class instances in the collection to determine the position of the collection item matching the specified search criteria. GetCookieIndex will return the value -1 when a Cookie cannot be located in the collection that matches the specified search criteria.

FirstIndex specifies the initial position in the container to be used when comparing values in the AName and/or ADomain parameters.

AName is the CookieName value desired in a Cookie collection item.

ADomain is the Domain value desired in a Cookie collection item.

GetCookieIndex is called from the GetCookie method to locate one of the Items in the collection that match a specified Name and Domain.

Indicates the index position of a Cookie containing specified values.

function GetCookieIndex(FirstIndex: integer; const AName: string): Integer; overload;
function GetCookieIndex(FirstIndex: integer; const AName: string; const ADomain: string): Integer; overload;

Initial position to be examined in the collection.

Cookie name to be matched.

Domain attribute to be matched.

Integer - Position of the matched Cookie in the collection, or -1 when not found.

GetCookieIndex is an overloaded Integer function that accesses Cookie class instances in the collection to determine the position of the collection item matching the specified search criteria. GetCookieIndex will return the value -1 when a Cookie cannot be located in the collection that matches the specified search criteria.

FirstIndex specifies the initial position in the container to be used when comparing values in the AName and/or ADomain parameters.

AName is the CookieName value desired in a Cookie collection item.

ADomain is the Domain value desired in a Cookie collection item.

GetCookieIndex is called from the GetCookie method to locate one of the Items in the collection that match a specified Name and Domain.

Provides resource protection for write access to Cookies in the Cookie collection.

function LockCookieListByDomain(AAccessType: TIdCookieAccess): TIdCookieList;

Access requested for the resource protection block.

TIdCookieList - List of Cookies for the specified Domain.

LockCookieListByDomain is a TIdCookieList function that protects write access to resources in the Cookie collection for the using a TMultiReadExclusiveWriteSynchronizer. AAccessType is a TIdCookieAccess value that indicates the access type that should be recorded using the resource protection lock.

The return value for LockCookieListByDomain is the values returned by the CookieListByDomain method call.

LockCookieListByDomain is used by method that create or free items in the Cookie collection, like Add and Delete.

Releases resource protection for accessing Cookies in the Cookie collection.

procedure UnlockCookieListByDomain(AAccessType: TIdCookieAccess);

Access requested for the resource protection block.

UnlockCookieListByDomain is a procedure that releases the resource protection block for the Cookie collection created using LockCookieListByDomain. AAccessType is a TIdCookieAccess value that indicates the access type that should be released for the resource protection block.

UnlockCookieListByDomain is used by methods that create or free items in the Cookie collection, like Add and Delete.