目录搜索
archivearchive/tararchive/zipbufiobufio(缓存)builtinbuiltin(内置包)bytesbytes(包字节)compresscompress/bzip2(压缩/bzip2)compress/flate(压缩/flate)compress/gzip(压缩/gzip)compress/lzw(压缩/lzw)compress/zlib(压缩/zlib)containercontainer/heap(容器数据结构heap)container/list(容器数据结构list)container/ring(容器数据结构ring)contextcontext(上下文)cryptocrypto(加密)crypto/aes(加密/aes)crypto/cipher(加密/cipher)crypto/des(加密/des)crypto/dsa(加密/dsa)crypto/ecdsa(加密/ecdsa)crypto/elliptic(加密/elliptic)crypto/hmac(加密/hmac)crypto/md5(加密/md5)crypto/rand(加密/rand)crypto/rc4(加密/rc4)crypto/rsa(加密/rsa)crypto/sha1(加密/sha1)crypto/sha256(加密/sha256)crypto/sha512(加密/sha512)crypto/subtle(加密/subtle)crypto/tls(加密/tls)crypto/x509(加密/x509)crypto/x509/pkix(加密/x509/pkix)databasedatabase/sql(数据库/sql)database/sql/driver(数据库/sql/driver)debugdebug/dwarf(调试/dwarf)debug/elf(调试/elf)debug/gosym(调试/gosym)debug/macho(调试/macho)debug/pe(调试/pe)debug/plan9obj(调试/plan9obj)encodingencoding(编码)encoding/ascii85(编码/ascii85)encoding/asn1(编码/asn1)encoding/base32(编码/base32)encoding/base64(编码/base64)encoding/binary(编码/binary)encoding/csv(编码/csv)encoding/gob(编码/gob)encoding/hex(编码/hex)encoding/json(编码/json)encoding/pem(编码/pem)encoding/xml(编码/xml)errorserrors(错误)expvarexpvarflagflag(命令行参数解析flag包)fmtfmtgogo/ast(抽象语法树)go/buildgo/constant(常量)go/doc(文档)go/format(格式)go/importergo/parsergo/printergo/scanner(扫描仪)go/token(令牌)go/types(类型)hashhash(散列)hash/adler32hash/crc32hash/crc64hash/fnvhtmlhtmlhtml/template(模板)imageimage(图像)image/color(颜色)image/color/palette(调色板)image/draw(绘图)image/gifimage/jpegimage/pngindexindex/suffixarrayioioio/ioutillogloglog/syslog(日志系统)mathmathmath/bigmath/bigmath/bitsmath/bitsmath/cmplxmath/cmplxmath/randmath/randmimemimemime/multipart(多部分)mime/quotedprintablenetnetnet/httpnet/httpnet/http/cginet/http/cookiejarnet/http/fcginet/http/httptestnet/http/httptracenet/http/httputilnet/http/internalnet/http/pprofnet/mailnet/mailnet/rpcnet/rpcnet/rpc/jsonrpcnet/smtpnet/smtpnet/textprotonet/textprotonet/urlnet/urlososos/execos/signalos/userpathpathpath/filepath(文件路径)pluginplugin(插件)reflectreflect(反射)regexpregexp(正则表达式)regexp/syntaxruntimeruntime(运行时)runtime/debug(调试)runtime/internal/sysruntime/pprofruntime/race(竞争)runtime/trace(执行追踪器)sortsort(排序算法)strconvstrconv(转换)stringsstrings(字符串)syncsync(同步)sync/atomic(原子操作)syscallsyscall(系统调用)testingtesting(测试)testing/iotesttesting/quicktexttext/scanner(扫描文本)text/tabwritertext/template(定义模板)text/template/parsetimetime(时间戳)unicodeunicodeunicode/utf16unicode/utf8unsafeunsafe
文字

  • import "net/http/cookiejar"

  • 概述

  • 索引

  • 示例

概述

Cookiejar包实现了符合内存RFC 6265的http.CookieJar。

索引

  • type Jar

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

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

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

  • type Options

  • type PublicSuffixList

文件包

jar.go punycode.go

type Jar

Jar从net/http包实现http.CookieJar接口。

type Jar struct {        // contains filtered or unexported fields}

func New

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

New返回一个新的cookie jar。无*选项相当于零选项。

示例

代码:

// Start a server to give us cookies.ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {        if cookie, err := r.Cookie("Flavor"); err != nil {
                http.SetCookie(w, &http.Cookie{Name: "Flavor", Value: "Chocolate Chip"})        } else {
                cookie.Value = "Oatmeal Raisin"
                http.SetCookie(w, cookie)        }}))defer ts.Close()u, err := url.Parse(ts.URL)if err != nil {
        log.Fatal(err)}// All users of cookiejar should import "golang.org/x/net/publicsuffix"jar, err := cookiejar.New(&cookiejar.Options{PublicSuffixList: publicsuffix.List})if err != nil {
        log.Fatal(err)}client := &http.Client{
        Jar: jar,}if _, err = client.Get(u.String()); err != nil {
        log.Fatal(err)}fmt.Println("After 1st request:")for _, cookie := range jar.Cookies(u) {
        fmt.Printf("  %s: %s\n", cookie.Name, cookie.Value)}if _, err = client.Get(u.String()); err != nil {
        log.Fatal(err)}fmt.Println("After 2nd request:")for _, cookie := range jar.Cookies(u) {
        fmt.Printf("  %s: %s\n", cookie.Name, cookie.Value)}

输出:

After 1st request:
  Flavor: Chocolate Chip
After 2nd request:
  Flavor: Oatmeal Raisin

func (*Jar) Cookies

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

Cookies实现http.CookieJar界面的Cookies方法。

如果URL的方案不是HTTP或HTTPS,它将返回空片。

func (*Jar) SetCookies

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

SetCookies实现了http.CookieJar接口的SetCookies方法。

如果URL的方案不是HTTP或HTTPS,它什么也不做。

type Options

选项是创建新Jar的选项。

type Options struct {        // PublicSuffixList is the public suffix list that determines whether        // an HTTP server can set a cookie for a domain.        //        // A nil value is valid and may be useful for testing but it is not        // secure: it means that the HTTP server for foo.co.uk can set a cookie        // for bar.co.uk.
        PublicSuffixList PublicSuffixList}

type PublicSuffixList

PublicSuffixList提供域的公共后缀。例如:

- the public suffix of "example.com" is "com",- the public suffix of "foo1.foo2.foo3.co.uk" is "co.uk", and- the public suffix of "bar.pvt.k12.ma.us" is "pvt.k12.ma.us".

PublicSuffixList的实现必须安全,以供多个goroutine并发使用。

总是返回“”的实现是有效的,对于测试可能有用,但它不安全:这意味着foo.com的HTTP服务器可以为bar.com设置cookie。

公共后缀列表实现位于golang.org/x/net/publicsuffix包中。

type PublicSuffixList interface {        // PublicSuffix returns the public suffix of domain.        //        // TODO: specify which of the caller and callee is responsible for IP        // addresses, for leading and trailing dots, for case sensitivity, and        // for IDN/Punycode.        PublicSuffix(domain string) string        // String returns a description of the source of this public suffix        // list. The description will typically contain something like a time        // stamp or version number.        String() string}
上一篇:下一篇: