Interface SetCookie

All Superinterfaces:

Cookie

All Known Implementing Classes:

BasicClientCookie

public interface SetCookie
extends Cookie

This interface represents a Set-Cookie response header sent by the origin server to the HTTP agent in order to maintain a conversational state.

Since:

4.0

Field Summary

Fields inherited from interface Cookie

DOMAIN_ATTR, EXPIRES_ATTR, HTTP_ONLY_ATTR, MAX_AGE_ATTR, PATH_ATTR, SECURE_ATTR

Method Summary

Modifier and Type	Method	Description
void	setDomain(String domain)	Sets the domain attribute.
default void	setExpiryDate(Instant expiryDate)	Sets expiration date.
void	setExpiryDate(Date expiryDate)	Deprecated. Use {setExpiryDate(Instant)}
default void	setHttpOnly(boolean httpOnly)	Marks or unmarks this Cookie as httpOnly.
void	setPath(String path)	Sets the path attribute.
void	setSecure(boolean secure)	Sets the secure attribute of the cookie.
void	setValue(String value)

Methods inherited from interface Cookie

containsAttribute, getAttribute, getCreationDate, getCreationInstant, getDomain, getExpiryDate, getExpiryInstant, getName, getPath, getValue, isExpired, isExpired, isHttpOnly, isPersistent, isSecure

Method Details

setValue

void setValue(String value)

setExpiryDate

@Deprecated
void setExpiryDate(Date expiryDate)

Deprecated.

Use {setExpiryDate(Instant)}

Sets expiration date.

Note: the object returned by this method is considered immutable. Changing it (e.g. using setTime()) could result in undefined behaviour. Do so at your peril.

Parameters:

expiryDate - the Date after which this cookie is no longer valid.

See Also:

• Cookie.getExpiryDate()

setExpiryDate

default void setExpiryDate(Instant expiryDate)

Sets expiration date.

Note: the object returned by this method is considered immutable. Changing it (e.g. using setTime()) could result in undefined behaviour. Do so at your peril.

Parameters:

expiryDate - the Instant after which this cookie is no longer valid.

Since:

5.2

See Also:

• Cookie.getExpiryInstant()

setDomain

void setDomain(String domain)

Sets the domain attribute.

Parameters:

domain - The value of the domain attribute

See Also:

• Cookie.getDomain()

setPath

void setPath(String path)

Sets the path attribute.

Parameters:

path - The value of the path attribute

See Also:

• Cookie.getPath()

setSecure

void setSecure(boolean secure)

Sets the secure attribute of the cookie.

When true the cookie should only be sent using a secure protocol (https). This should only be set when the cookie's originating server used a secure protocol to set the cookie's value.

Parameters:

secure - The value of the secure attribute

See Also:

• Cookie.isSecure()

setHttpOnly

default void setHttpOnly(boolean httpOnly)

Marks or unmarks this Cookie as httpOnly.

Parameters:

httpOnly - true if this cookie is to be marked as httpOnly, false otherwise

Since:

5.2