import "net/http/cookiejar"
cookiejar包实现了保管在内存中的符合RFC 6265标准的http.CookieJar接口。
type PublicSuffixList interface { // 返回域名的公共后缀。 // TODO:域名的格式化应该由调用者还是接口方法负责还没有确定。 PublicSuffix(domain string) string // 返回公共后缀列表的来源的说明,该说明一般应该包含时间戳和版本号。 String() string }
PublicSuffixList提供域名的公共后缀。例如:
- "example.com"的公共后缀是"com" - "foo1.foo2.foo3.co.uk"的公共后缀是"co.uk" - "bar.pvt.k12.ma.us"的公共后缀是"pvt.k12.ma.us"
PublicSuffixList接口的实现必须是并发安全的。一个总是返回""的实现是合法的,也可以通过测试;但却是不安全的:它允许HTTP服务端跨域名设置cookie。推荐实现:code.google.com/p/go.net/publicsuffix
type Options struct { // PublicSuffixList是公共后缀列表,用于决定HTTP服务端是否能给某域名设置cookie // nil值合法的,也可以通过测试;但却是不安全的:它允许HTTP服务端跨域名设置cookie PublicSuffixList PublicSuffixList }
Options是创建新Jar是的选项。
type Jar struct {
// 内含隐藏或非导出字段
}
Jar类型实现了net/http包的http.CookieJar接口。
func New(o *Options) (*Jar, error)
返回一个新的Jar,nil指针等价于Options零值的指针。
func (j *Jar) Cookies(u *url.URL) (cookies []*http.Cookie)
实现CookieJar接口的Cookies方法,如果URL协议不是HTTP/HTTPS会返回空切片。
func (j *Jar) SetCookies(u *url.URL, cookies []*http.Cookie)
实现CookieJar接口的SetCookies方法,如果URL协议不是HTTP/HTTPS则不会有实际操作。