1 // Copyright 2011 The Go Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style 3 // license that can be found in the LICENSE file. 4 5 package http 6 7 import ( 8 "net/url" 9 ) 10 11 // A CookieJar manages storage and use of cookies in HTTP requests. 12 // 13 // Implementations of CookieJar must be safe for concurrent use by multiple 14 // goroutines. 15 // 16 // The net/http/cookiejar package provides a CookieJar implementation. 17 type CookieJar interface { 18 // SetCookies handles the receipt of the cookies in a reply for the 19 // given URL. It may or may not choose to save the cookies, depending 20 // on the jar's policy and implementation. 21 SetCookies(u *url.URL, cookies []*Cookie) 22 23 // Cookies returns the cookies to send in a request for the given URL. 24 // It is up to the implementation to honor the standard cookie use 25 // restrictions such as in RFC 6265. 26 Cookies(u *url.URL) []*Cookie 27 } 28