org.archive.io

Class GenericReplayCharSequence

java.lang.Object

org.archive.io.GenericReplayCharSequence

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.CharSequence, ReplayCharSequence

public class GenericReplayCharSequence
extends java.lang.Object
implements ReplayCharSequence

(Replay)CharSequence view on recorded streams. For small streams, use InMemoryReplayCharSequence.

Call close() on this class when done to clean up resources.

Version:

$Revision$, $Date$

Field Summary

Fields

Modifier and Type	Field and Description
protected java.nio.charset.Charset	charset
protected java.nio.charset.CharacterCodingException	codingException
protected long	decodingExceptions counter of decoding exceptions for report at end
protected int	length Total length of character stream to replay minus the HTTP headers if present.
protected static java.util.logging.Logger	logger
static java.nio.charset.Charset	WRITE_ENCODING Name of the encoding we use writing out concatenated decoded prefix buffer and decoded backing file.

Fields inherited from interface org.archive.io.ReplayCharSequence

FALLBACK_CHARSET

Constructor Summary

Constructors

Constructor and Description
GenericReplayCharSequence(java.io.InputStream contentReplayInputStream, int prefixMax, java.lang.String backingFilename, java.nio.charset.Charset charset) Constructor.

Method Summary

Modifier and Type	Method and Description
char	charAt(int index) Get character at passed absolute position.
void	close() Call this method when done so implementation has chance to clean up resources.
protected void	decode(java.io.InputStream inStream, int prefixMax, java.lang.String backingFilename, java.nio.charset.Charset charset) Converts the first Integer.MAX_VALUE characters from the file backingFilename from encoding encoding to encoding WRITE_ENCODING and saves as this.decodedFile, which is named backingFilename + "." + WRITE_ENCODING.
protected void	finalize()
java.nio.charset.Charset	getCharset() Return the effective Charset used to create this CharSequence from (raw byte) source material.
java.nio.charset.CharacterCodingException	getCodingException() Return the first coding-exception encountered, if the count > 0.
long	getDecodeExceptionCount() Report count of decoder errors silently eaten during ReplayCharSequence use.
boolean	isOpen()
int	length()
java.lang.CharSequence	subSequence(int start, int end)
java.lang.String	substring(int offset, int len) Deprecated. please use subSequence() and then toString() directly
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Field Detail

logger

protected static java.util.logging.Logger logger

WRITE_ENCODING

public static final java.nio.charset.Charset WRITE_ENCODING

Name of the encoding we use writing out concatenated decoded prefix buffer and decoded backing file.

This define is also used as suffix for the file that holds the decodings. The name of the file that holds the decoding is the name of the backing file w/ this encoding for a suffix.

See Encoding.

length

protected int length

Total length of character stream to replay minus the HTTP headers if present. If the backing file is larger than Integer.MAX_VALUE (i.e. 2gb), only the first Integer.MAX_VALUE characters are available through this API. We're overriding java.lang.CharSequence so that we can use java.util.regex directly on the data, and the CharSequence API uses int for the length and index.

decodingExceptions

protected long decodingExceptions

counter of decoding exceptions for report at end

codingException

protected java.nio.charset.CharacterCodingException codingException

charset

protected java.nio.charset.Charset charset

Constructor Detail

GenericReplayCharSequence

public GenericReplayCharSequence(java.io.InputStream contentReplayInputStream,
                                 int prefixMax,
                                 java.lang.String backingFilename,
                                 java.nio.charset.Charset charset)
                          throws java.io.IOException

Constructor.

Parameters:

contentReplayInputStream - inputStream of content

charset - Encoding to use reading the passed prefix buffer and backing file. Must not be null.

backingFilename - Path to backing file with content in excess of whats in buffer.

Throws:

java.io.IOException

Method Detail

decode

protected void decode(java.io.InputStream inStream,
                      int prefixMax,
                      java.lang.String backingFilename,
                      java.nio.charset.Charset charset)
               throws java.io.IOException

Converts the first Integer.MAX_VALUE characters from the file backingFilename from encoding encoding to encoding WRITE_ENCODING and saves as this.decodedFile, which is named backingFilename + "." + WRITE_ENCODING.

Throws:

java.io.IOException

charAt

public char charAt(int index)

Get character at passed absolute position.

Specified by:

charAt in interface java.lang.CharSequence

Parameters:

index - Index into content

Returns:

Character at offset index.

subSequence

public java.lang.CharSequence subSequence(int start,
                                          int end)

Specified by:

subSequence in interface java.lang.CharSequence

isOpen

public boolean isOpen()

Specified by:

isOpen in interface ReplayCharSequence

Returns:

false if ReplayCharSequence.close() has been called

close

public void close()
           throws java.io.IOException

Description copied from interface: ReplayCharSequence

Call this method when done so implementation has chance to clean up resources.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface ReplayCharSequence

Throws:

java.io.IOException - Problem cleaning up file system resources.

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

substring

public java.lang.String substring(int offset,
                                  int len)

Deprecated. please use subSequence() and then toString() directly

Convenience method for getting a substring.

toString

public java.lang.String toString()

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class java.lang.Object

length

public int length()

Specified by:

length in interface java.lang.CharSequence

getDecodeExceptionCount

public long getDecodeExceptionCount()

Description copied from interface: ReplayCharSequence

Report count of decoder errors silently eaten during ReplayCharSequence use. May be less than the number of individual decoding anomalies in underlying content (if decoding method doesn't allow counting individual errors).

Specified by:

getDecodeExceptionCount in interface ReplayCharSequence

getCodingException

public java.nio.charset.CharacterCodingException getCodingException()

Description copied from interface: ReplayCharSequence

Return the first coding-exception encountered, if the count > 0.

Specified by:

getCodingException in interface ReplayCharSequence

Returns:

CharacterCodingException

getCharset

public java.nio.charset.Charset getCharset()

Description copied from interface: ReplayCharSequence

Return the effective Charset used to create this CharSequence from (raw byte) source material.

Specified by:

getCharset in interface ReplayCharSequence