jar.go

     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
View as plain text