Changeset 22133 in project


Ignore:
Timestamp:
12/26/10 22:06:59 (9 years ago)
Author:
sjamaan
Message:

Document new cookie behaviour (which is still horrible)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/eggref/4/http-client

    r22121 r22133  
    173173put in a {{cookie}} header.
    174174
    175 <procedure>(store-cookie! cookie)</procedure>
    176 
    177 Store the given {{cookie}} object in the cookiejar.  This overwrites
    178 any cookie that is equal to this cookie, as defined by RFC 2965,
    179 section 3.3.3.  Practically, this means that when the cookie's name,
    180 domain and path are equal to an existant one, it will be overwritten
    181 by the new one.
    182 
    183 <procedure>(delete-cookie! cookie)</procedure>
     175<procedure>(store-cookie! cookie-info set-cookie)</procedure>
     176
     177Store a cookie in the cookiejar corresponding to the Set-Cookie header
     178given by {{set-cookie}}.  This overwrites any cookie that is equal to
     179this cookie, as defined by RFC 2965, section 3.3.3.  Practically, this
     180means that when the cookie's name, domain and path are equal to an
     181existant one, it will be overwritten by the new one.  These attributes
     182are taken from the {{cookie-info}} alist and expected to be there.
     183
     184Generally, attributes should be taken from {{set-cookie}}, but if
     185missing they ought to be taken from the request URI that responded
     186with the {{set-cookie}}.
     187
     188<procedure>(delete-cookie! cookie-name cookie-info)</procedure>
    184189
    185190Removes any cookie from the cookiejar that is equal to the given
    186 {{cookie}} (again, in the sense of RFC 2965, section 3.3.3).
     191cookie (again, in the sense of RFC 2965, section 3.3.3).
     192The {{cookie-name}} must match and the {{path}} and {{domain}} values for
     193the {{cookie-info}} alist must match.
    187194
    188195==== Authentication support
     
    264271=== Changelog
    265272
    266 * trunk Fixed handling of missing Path parameters in set-cookie headers. Reported by Hugo Arregui.
     273* 0.3 Fixed handling of missing Path parameters in set-cookie headers. Reported by Hugo Arregui. Improve set-cookie handling by only passing Path and Domain when matching Set-Cookie header included those parameters.
    267274* 0.2 Added proxy support and many many bugfixes
    268275* 0.1 Initial version
Note: See TracChangeset for help on using the changeset viewer.