package cookiejar

import "net/http/cookiejar"

cookiejar包实现了保管在内存中的符合RFC 6265标准的http.CookieJar接口。

Index

返回首页


  • type PublicSuffixList
  • type Options
  • type Jar
  • type PublicSuffixList

    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

    type Options struct {
        // PublicSuffixList是公共后缀列表,用于决定HTTP服务端是否能给某域名设置cookie
        // nil值合法的,也可以通过测试;但却是不安全的:它允许HTTP服务端跨域名设置cookie
        PublicSuffixList PublicSuffixList
    }

    Options是创建新Jar是的选项。

    type Jar

    type Jar struct {
        // 内含隐藏或非导出字段
    }

    Jar类型实现了net/http包的http.CookieJar接口。

    func New

    func New(o *Options) (*Jar, error)

    返回一个新的Jar,nil指针等价于Options零值的指针。

    func (*Jar) Cookies

    func (j *Jar) Cookies(u *url.URL) (cookies []*http.Cookie)

    实现CookieJar接口的Cookies方法,如果URL协议不是HTTP/HTTPS会返回空切片。

    func (*Jar) SetCookies

    func (j *Jar) SetCookies(u *url.URL, cookies []*http.Cookie)

    实现CookieJar接口的SetCookies方法,如果URL协议不是HTTP/HTTPS则不会有实际操作。