org.apache.http.impl.cookie

Class PublicSuffixDomainFilter

java.lang.Object

org.apache.http.impl.cookie.PublicSuffixDomainFilter

All Implemented Interfaces:

CommonCookieAttributeHandler ， CookieAttributeHandler

@Contract(threading=IMMUTABLE_CONDITIONAL)
public class PublicSuffixDomainFilter
extends Object
implements CommonCookieAttributeHandler

包装一个CookieAttributeHandler并利用其匹配方法从不匹配从黑名单的后缀。 可用于为跨站点攻击类型提供额外的安全性，方法是阻止来自明显的域不可公开的Cookie。

从以下版本开始：

4.4

另请参见：

PublicSuffixList ， PublicSuffixMatcher

构造方法摘要

构造方法

Constructor and Description
PublicSuffixDomainFilter(CommonCookieAttributeHandler handler, PublicSuffixList suffixList)
PublicSuffixDomainFilter(CommonCookieAttributeHandler handler, PublicSuffixMatcher publicSuffixMatcher)

方法摘要

Methods

Modifier and Type	Method and Description
static CommonCookieAttributeHandler	decorate(CommonCookieAttributeHandler handler, PublicSuffixMatcher publicSuffixMatcher)
String	getAttributeName()
boolean	match(Cookie cookie, CookieOrigin origin) 如果cookie的域名来自黑名单，则不要匹配。
void	parse(SetCookie cookie, String value) 解析给定的cookie属性值并更新相应的Cookie属性。
void	validate(Cookie cookie, CookieOrigin origin) 对给定的属性值进行Peforms cookie验证。

Methods inherited from class java.lang.Object

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

构造方法详细信息

PublicSuffixDomainFilter

public PublicSuffixDomainFilter(CommonCookieAttributeHandler handler,
                        PublicSuffixMatcher publicSuffixMatcher)

PublicSuffixDomainFilter

public PublicSuffixDomainFilter(CommonCookieAttributeHandler handler,
                        PublicSuffixList suffixList)

方法详细信息

match

public boolean match(Cookie cookie,
            CookieOrigin origin)

如果cookie的域名来自黑名单，则不要匹配。

Specified by:

match在接口 CookieAttributeHandler

参数

cookie - Cookie匹配

origin - 与Cookie匹配的Cookie来源

结果

true如果比赛成功; false否则

parse

public void parse(SetCookie cookie,
         String value)
           throws MalformedCookieException

描述从接口CookieAttributeHandler复制

解析给定的cookie属性值并更新相应的Cookie属性。

Specified by:

parse在接口 CookieAttributeHandler

参数

cookie - Cookie待更新

value - 来自cookie响应头的cookie属性值

异常

MalformedCookieException

validate

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

描述从接口CookieAttributeHandler复制

对给定的属性值进行Peforms cookie验证。

Specified by:

validate在界面 CookieAttributeHandler

参数

cookie - Cookie验证

origin - 要验证的Cookie来源

异常

MalformedCookieException - 如果cookie验证失败此属性

getAttributeName

public String getAttributeName()

Specified by:

getAttributeName in interface CommonCookieAttributeHandler

decorate

public static CommonCookieAttributeHandler decorate(CommonCookieAttributeHandler handler,
                                    PublicSuffixMatcher publicSuffixMatcher)