org.apache.http.impl.cookie

## Class RFC2109Spec

- java.lang.Object
- - org.apache.http.impl.cookie.AbstractCookieSpec
  - - org.apache.http.impl.cookie.CookieSpecBase
    - - org.apache.http.impl.cookie.RFC2109Spec

- All Implemented Interfaces:
    CookieSpec
  已知直接子类：
    RFC2965Spec

      @Obsolete
      @Contract(threading=SAFE)
      public class RFC2109Spec
      extends CookieSpecBase

  RFC 2109符合`CookieSpec`实现。

  渲染由`RFC6265StrictSpec`过时。

  从以下版本开始：
    4
  另请参见：
    `RFC6265StrictSpec`

- - ### 构造方法摘要

    构造方法
    Modifier | Constructor and Description
    --- | ---
    `` | `RFC2109Spec()` 默认构造函数
    `protected` | `RFC2109Spec(boolean oneHeader, CommonCookieAttributeHandler... handlers)`
    `` | `RFC2109Spec(String[] datepatterns, boolean oneHeader)` 默认构造函数

  - ### 方法摘要

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `protected void` | `formatCookieAsVer(CharArrayBuffer buffer, Cookie cookie, int version)` 返回一个适用于发送的字符串，符合RFC 2109中定义的 `"Cookie"`标头，以反向兼容cookie版本0
    `List<Header>` | `formatCookies(List<Cookie> cookies)` 为Cookie数组创建 `"Cookie"`标题。
    `protected void` | `formatParamAsVer(CharArrayBuffer buffer, String name, String value, int version)` 返回一个适用于发送在RFC 2109中定义的 `"Cookie"`标头的名称/值字符串，以便与cookie版本0的向后兼容
    `int` | `getVersion()` 返回该cookie规范符合的状态管理版本。
    `Header` | `getVersionHeader()` 返回一个标识什么版本的状态管理规范被理解的请求头。
    `List<Cookie>` | `parse(Header header, CookieOrigin origin)` 将 `"Set-Cookie"`标题解析成一个Cookie数组。
    `String` | `toString()`
    `void` | `validate(Cookie cookie, CookieOrigin origin)` 根据cookie规范定义的验证规则验证cookie。

    - ### Methods inherited from class org.apache.http.impl.cookie.CookieSpecBase

      `getDefaultDomain, getDefaultPath, match, parse`

    - ### Methods inherited from class org.apache.http.impl.cookie.AbstractCookieSpec

      `findAttribHandler, getAttribHandler, getAttribHandlers, registerAttribHandler`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### 构造方法详细信息

    - #### RFC2109Spec

          public RFC2109Spec(String[] datepatterns,
                     boolean oneHeader)

      默认构造函数

    - #### RFC2109Spec

          public RFC2109Spec()

      默认构造函数

    - #### RFC2109Spec

          protected RFC2109Spec(boolean oneHeader,
                     CommonCookieAttributeHandler... handlers)

  - ### 方法详细信息

    - #### parse

          public List<Cookie> parse(Header header,
                           CookieOrigin origin)
                             throws MalformedCookieException

      说明从界面： `CookieSpec`复制
      将`"Set-Cookie"`标题解析成一组Cookie。

      该方法将不会对所得的`Cookie`进行验证

      参数
        `header` - 从服务器收到的 `Set-Cookie`
        `origin` - cookie起源的细节
      结果
        从标题中解析出 `Cookie`的数组
      异常
        `MalformedCookieException` - 解析过程中是否发生异常
      另请参见：
        `CookieSpec.validate(org.apache.http.cookie.Cookie, org.apache.http.cookie.CookieOrigin)`

    - #### validate

          public void validate(Cookie cookie,
                      CookieOrigin origin)
                        throws MalformedCookieException

      说明从界面： `CookieSpec`复制
      根据cookie规范定义的验证规则验证cookie。
      Specified by:
        `validate`在界面 `CookieSpec`
      重写：
        `validate`在 `CookieSpecBase`
      参数
        `cookie` - 要验证的Cookie
        `origin` - 饼干起源的细节
      异常
        `MalformedCookieException` - 如果cookie无效

    - #### formatCookies

          public List<Header> formatCookies(List<Cookie> cookies)

      说明从界面： `CookieSpec`复制
      为一组Cookie创建 `"Cookie"`标题。
      参数
        `cookies` - 将Cookie格式转换成Cookie标题
      结果
        给定Cookie的标题。

    - #### formatParamAsVer

          protected void formatParamAsVer(CharArrayBuffer buffer,
                              String name,
                              String value,
                              int version)

      返回适用于发送在RFC 2109中定义的 `"Cookie"`头中的名称/值字符串，以便与cookie版本0向后兼容
      参数
        `buffer` - 用于输出的char数组缓冲区
        `name` - cookie名称
        `value` - Cookie值
        `version` - cookie版本

    - #### formatCookieAsVer

          protected void formatCookieAsVer(CharArrayBuffer buffer,
                               Cookie cookie,
                               int version)

      返回一个适合发送的字符串，符合RFC 2109中定义的 `"Cookie"`标头，用于向后兼容cookie版本0
      参数
        `buffer` - 用于输出的char数组缓冲区
        `cookie` - `Cookie`要格式化为字符串
        `version` - 要使用的版本。

    - #### getVersion

          public int getVersion()

      说明从界面： `CookieSpec`复制
      返回该cookie规范符合的状态管理版本。
      结果
        版本的状态管理规范

    - #### getVersionHeader

          public Header getVersionHeader()

      说明从界面： `CookieSpec`复制
      返回一个标识什么版本的状态管理规范被理解的请求头。 如果cookie规范不支持`Cookie2`标题，可以是`null` 。

    - #### toString

          public String toString()

      重写：
        `toString` in class `Object`

Copyright © 1999–2017 The Apache Software Foundation. All rights reserved.

本帮助文档是使用 《谷歌翻译》翻译，请与英文版配合使用 by--QQ:654638585