org.netpreserve.jwarc

Class WarcRevisit

java.lang.Object

org.netpreserve.jwarc.Message

org.netpreserve.jwarc.WarcRecord

org.netpreserve.jwarc.WarcTargetRecord

org.netpreserve.jwarc.WarcCaptureRecord

org.netpreserve.jwarc.WarcRevisit

public class WarcRevisit
extends WarcCaptureRecord

A WARC record describing a subsequent visitation of content previously archived. Typically used to indicate the content had not changed and therefore a duplicate copy of it was not recorded.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WarcRevisit.Builder

Nested classes/interfaces inherited from class org.netpreserve.jwarc.WarcCaptureRecord

WarcCaptureRecord.AbstractBuilder<R extends WarcCaptureRecord,B extends WarcCaptureRecord.AbstractBuilder<R,B>>

Nested classes/interfaces inherited from class org.netpreserve.jwarc.WarcRecord

WarcRecord.Constructor<R extends WarcRecord>

Field Summary

Fields

Modifier and Type	Field and Description
static URI	IDENTICAL_PAYLOAD_DIGEST_1_0 WARC 1.0 revisit profile for when the payload content was the same as determined by a strong digest function.
static URI	IDENTICAL_PAYLOAD_DIGEST_1_1 WARC 1.1 revisit profile for when the payload content was the same as determined by a strong digest function.
static URI	SERVER_NOT_MODIFIED_1_0 WARC 1.0 revisit profile for when the server said the content had not changed.
static URI	SERVER_NOT_MODIFIED_1_1 WARC 1.1 revisit profile for when the server said the content had not changed.

Method Summary

Modifier and Type	Method and Description
HttpResponse	http() Parses the HTTP response captured by this record.
Optional<WarcPayload>	payload() Always returns Optional.empty().
URI	profile() The revisit profile explaining why this capture was written as a revisit record.
Optional<URI>	refersTo() The record id of the original response or resource that was revisited.
Optional<java.time.Instant>	refersToDate() The date of the record this record is a revisit of.
Optional<URI>	refersToTargetURI() The target URI of the record this record is a revisit of.

Methods inherited from class org.netpreserve.jwarc.WarcCaptureRecord

concurrentTo, ipAddress, payloadType

Methods inherited from class org.netpreserve.jwarc.WarcTargetRecord

identifiedPayloadType, payloadDigest, target, targetURI, toString, warcinfoID

Methods inherited from class org.netpreserve.jwarc.WarcRecord

blockDigest, calculatedBlockDigest, date, id, segmentNumber, truncated, type

Methods inherited from class org.netpreserve.jwarc.Message

body, contentType, headers, serializeHeader, version

Methods inherited from class java.lang.Object

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

Field Detail

IDENTICAL_PAYLOAD_DIGEST_1_0

public static final URI IDENTICAL_PAYLOAD_DIGEST_1_0

WARC 1.0 revisit profile for when the payload content was the same as determined by a strong digest function.

IDENTICAL_PAYLOAD_DIGEST_1_1

public static final URI IDENTICAL_PAYLOAD_DIGEST_1_1

WARC 1.1 revisit profile for when the payload content was the same as determined by a strong digest function.

SERVER_NOT_MODIFIED_1_0

public static final URI SERVER_NOT_MODIFIED_1_0

WARC 1.0 revisit profile for when the server said the content had not changed.

SERVER_NOT_MODIFIED_1_1

public static final URI SERVER_NOT_MODIFIED_1_1

WARC 1.1 revisit profile for when the server said the content had not changed.

Method Detail

http

public HttpResponse http()
                  throws IOException

Parses the HTTP response captured by this record.

This is a convenience method for HttpResponse.parse(revisit.body())).

Note: Revisit records do not have a payload and therefore revisit.http().body() cannot be used.

Throws:

IOException

payload

public Optional<WarcPayload> payload()
                              throws IOException

Always returns Optional.empty().

Overrides:

payload in class WarcTargetRecord

Throws:

IOException

refersToTargetURI

public Optional<URI> refersToTargetURI()

The target URI of the record this record is a revisit of.

refersToDate

public Optional<java.time.Instant> refersToDate()

The date of the record this record is a revisit of.

profile

public URI profile()

The revisit profile explaining why this capture was written as a revisit record. The standard profiles are IDENTICAL_PAYLOAD_DIGEST_1_0, IDENTICAL_PAYLOAD_DIGEST_1_1, SERVER_NOT_MODIFIED_1_0 and SERVER_NOT_MODIFIED_1_1.

refersTo

public Optional<URI> refersTo()

The record id of the original response or resource that was revisited.