# package cookiejar

`import "net/http/cookiejar"`

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

## 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则不会有实际操作。