Home | History | Annotate | Download | only in http
      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