程序包 org.springframework.boot.web.servlet.server

接口 CookieSameSiteSupplier

函数接口:

这是一个函数接口, 因此可用作 lambda 表达式或方法引用的赋值目标。

@FunctionalInterface
public interface CookieSameSiteSupplier

Strategy interface that can be used with ConfigurableServletWebServerFactory implementations in order to supply custom Cookie.SameSite values for specific cookies.

Basic CookieSameSiteSupplier implementations can be constructed using the of... factory methods, typically combined with name matching. For example:

 CookieSameSiteSupplier.ofLax().whenHasName("mycookie");
 

从以下版本开始:

2.6.0

作者:

Phillip Webb

另请参阅:

• ConfigurableServletWebServerFactory.addCookieSameSiteSuppliers(CookieSameSiteSupplier...)

方法概要

修饰符和类型	方法	说明
Cookie.SameSite	getSameSite(Cookie cookie)	Get the Cookie.SameSite values that should be used for the given Cookie.
static CookieSameSiteSupplier	of(Cookie.SameSite sameSite)	Return a new CookieSameSiteSupplier that always returns the given Cookie.SameSite value.
static CookieSameSiteSupplier	ofLax()	Return a new CookieSameSiteSupplier that always returns Cookie.SameSite.LAX.
static CookieSameSiteSupplier	ofNone()	Return a new CookieSameSiteSupplier that always returns Cookie.SameSite.NONE.
static CookieSameSiteSupplier	ofStrict()	Return a new CookieSameSiteSupplier that always returns Cookie.SameSite.STRICT.
default CookieSameSiteSupplier	when(Predicate<Cookie> predicate)	Limit this supplier so that it's only called if the predicate accepts the Cookie.
default CookieSameSiteSupplier	whenHasName(String name)	Limit this supplier so that it's only called if the Cookie has the given name.
default CookieSameSiteSupplier	whenHasName(Supplier<String> nameSupplier)	Limit this supplier so that it's only called if the Cookie has the given name.
default CookieSameSiteSupplier	whenHasNameMatching(String regex)	Limit this supplier so that it's only called if the Cookie name matches the given regex.
default CookieSameSiteSupplier	whenHasNameMatching(Pattern pattern)	Limit this supplier so that it's only called if the Cookie name matches the given Pattern.

方法详细资料

getSameSite

Cookie.SameSite getSameSite(Cookie cookie)

Get the Cookie.SameSite values that should be used for the given Cookie.

参数:

cookie - the cookie to check

返回:

the Cookie.SameSite value to use or null if the next supplier should be checked

whenHasName

default CookieSameSiteSupplier whenHasName(String name)

Limit this supplier so that it's only called if the Cookie has the given name.

参数:

name - the name to check

返回:

a new CookieSameSiteSupplier that only calls this supplier when the name matches

whenHasName

default CookieSameSiteSupplier whenHasName(Supplier<String> nameSupplier)

Limit this supplier so that it's only called if the Cookie has the given name.

参数:

nameSupplier - a supplier providing the name to check

返回:

a new CookieSameSiteSupplier that only calls this supplier when the name matches

whenHasNameMatching

default CookieSameSiteSupplier whenHasNameMatching(String regex)

Limit this supplier so that it's only called if the Cookie name matches the given regex.

参数:

regex - the regex pattern that must match

返回:

a new CookieSameSiteSupplier that only calls this supplier when the name matches the regex

whenHasNameMatching

default CookieSameSiteSupplier whenHasNameMatching(Pattern pattern)

Limit this supplier so that it's only called if the Cookie name matches the given Pattern.

参数:

pattern - the regex pattern that must match

返回:

a new CookieSameSiteSupplier that only calls this supplier when the name matches the pattern

when

default CookieSameSiteSupplier when(Predicate<Cookie> predicate)

Limit this supplier so that it's only called if the predicate accepts the Cookie.

参数:

predicate - the predicate used to match the cookie

返回:

a new CookieSameSiteSupplier that only calls this supplier when the cookie matches the predicate

ofNone

static CookieSameSiteSupplier ofNone()

Return a new CookieSameSiteSupplier that always returns Cookie.SameSite.NONE.

返回:

the supplier instance

ofLax

static CookieSameSiteSupplier ofLax()

Return a new CookieSameSiteSupplier that always returns Cookie.SameSite.LAX.

返回:

the supplier instance

ofStrict

static CookieSameSiteSupplier ofStrict()

Return a new CookieSameSiteSupplier that always returns Cookie.SameSite.STRICT.

返回:

the supplier instance

of

static CookieSameSiteSupplier of(Cookie.SameSite sameSite)

Return a new CookieSameSiteSupplier that always returns the given Cookie.SameSite value.

参数:

sameSite - the value to return

返回:

the supplier instance