# package cookiejar `import "net/http/cookiejar"` cookiejar包實現了保管在內存中的符合[RFC 6265標準的](http://tools.ietf.org/html/rfc6265)http.CookieJar接口。 ## Index * [type PublicSuffixList](#PublicSuffixList) * [type Options](#Options) * [type Jar](#Jar) * [func New(o \*Options) (\*Jar, error)](#New) * [func (j \*Jar) Cookies(u \*url.URL) (cookies []\*http.Cookie)](#Jar.Cookies) * [func (j \*Jar) SetCookies(u \*url.URL, cookies []\*http.Cookie)](#Jar.SetCookies) ## type [PublicSuffixList](http://code.google.com/p/go/source/browse/src/pkg/net/http/cookiejar/jar.go?name=release#34 "View Source") ``` 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](http://godoc.org/code.google.com/p/go.net/publicsuffix) ## type [Options](http://code.google.com/p/go/source/browse/src/pkg/net/http/cookiejar/jar.go?name=release#49 "View Source") ``` type Options struct { // PublicSuffixList是公共后綴列表，用于決定HTTP服務端是否能給某域名設置cookie // nil值合法的，也可以通過測試；但卻是不安全的：它允許HTTP服務端跨域名設置cookie PublicSuffixList PublicSuffixList } ``` Options是創建新Jar是的選項。 ## type [Jar](http://code.google.com/p/go/source/browse/src/pkg/net/http/cookiejar/jar.go?name=release#60 "View Source") ``` type Jar struct { // 內含隱藏或非導出字段 } ``` Jar類型實現了net/http包的http.CookieJar接口。 ### func [New](http://code.google.com/p/go/source/browse/src/pkg/net/http/cookiejar/jar.go?name=release#77 "View Source") ``` func New(o *Options) (*Jar, error) ``` 返回一個新的Jar，nil指針等價于Options零值的指針。 ### func (\*Jar) [Cookies](http://code.google.com/p/go/source/browse/src/pkg/net/http/cookiejar/jar.go?name=release#171 "View Source") ``` func (j *Jar) Cookies(u *url.URL) (cookies []*http.Cookie) ``` 實現CookieJar接口的Cookies方法，如果URL協議不是HTTP/HTTPS會返回空切片。 ### func (\*Jar) [SetCookies](http://code.google.com/p/go/source/browse/src/pkg/net/http/cookiejar/jar.go?name=release#235 "View Source") ``` func (j *Jar) SetCookies(u *url.URL, cookies []*http.Cookie) ``` 實現CookieJar接口的SetCookies方法，如果URL協議不是HTTP/HTTPS則不會有實際操作。