io.ktor.http.content

Class LastModifiedVersion

io.ktor.http.content.LastModifiedVersion

All Implemented Interfaces:

Version

public class LastModifiedVersion
implements Version

This version passes the given lastModified date through the client provided http conditional headers If-Modified-Since and If-Unmodified-Since.

Notice the second precision so it may work wrong if there were few changes during the same second.

For better behaviour use etag instead

See https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28 and https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25

Constructor Summary

Constructors

Constructor and Description
LastModifiedVersion(java.time.ZonedDateTime lastModified) This version passes the given lastModified date through the client provided http conditional headers If-Modified-Since and If-Unmodified-Since.
LastModifiedVersion(java.nio.file.attribute.FileTime lastModified)
LastModifiedVersion(java.util.Date lastModified)

Method Summary

Modifier and Type	Method and Description
void	appendHeadersTo(HeadersBuilder builder) Appends relevant headers to the builder
VersionCheckResult	check(Headers requestHeaders)
java.time.ZonedDateTime	component1() of the current content,
LastModifiedVersion	copy(java.time.ZonedDateTime lastModified) This version passes the given lastModified date through the client provided http conditional headers If-Modified-Since and If-Unmodified-Since.
boolean	equals(java.lang.Object p)
java.time.ZonedDateTime	getLastModified() of the current content,
int	hashCode()
java.lang.String	toString()

Methods inherited from interface io.ktor.http.content.Version

appendHeadersTo, check

Constructor Detail

LastModifiedVersion

public LastModifiedVersion(java.time.ZonedDateTime lastModified)

This version passes the given lastModified date through the client provided http conditional headers If-Modified-Since and If-Unmodified-Since.

Notice the second precision so it may work wrong if there were few changes during the same second.

For better behaviour use etag instead

See https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28 and https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25

Parameters:

lastModified - of the current content, for example file's last modified date

lastModified - of the current content, for example file's last modified date

LastModifiedVersion

public LastModifiedVersion(java.nio.file.attribute.FileTime lastModified)

LastModifiedVersion

public LastModifiedVersion(java.util.Date lastModified)

Method Detail

check

public VersionCheckResult check(Headers requestHeaders)

Returns:

VersionCheckResult.OK if all header pass or there was no headers in the request, VersionCheckResult.NOT_MODIFIED for If-Modified-Since, VersionCheckResult.PRECONDITION_FAILED for If-Unmodified*Since

appendHeadersTo

public void appendHeadersTo(HeadersBuilder builder)

Appends relevant headers to the builder

getLastModified

public java.time.ZonedDateTime getLastModified()

of the current content,

for example file's last modified date

component1

public java.time.ZonedDateTime component1()

of the current content,

for example file's last modified date

copy

public LastModifiedVersion copy(java.time.ZonedDateTime lastModified)

This version passes the given lastModified date through the client provided http conditional headers If-Modified-Since and If-Unmodified-Since.

Notice the second precision so it may work wrong if there were few changes during the same second.

For better behaviour use etag instead

See https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28 and https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25

Parameters:

lastModified - of the current content, for example file's last modified date

toString

public java.lang.String toString()

hashCode

public int hashCode()

equals

public boolean equals(java.lang.Object p)