Class GenerationFileHandler

java.lang.Object

java.util.logging.Handler

java.util.logging.StreamHandler

java.util.logging.FileHandler

org.archive.io.GenerationFileHandler

public class GenerationFileHandler
extends FileHandler

FileHandler with support for rotating the current file to an archival name with a specified integer suffix, and provision of a new replacement FileHandler with the current filename.

Author:

gojomo

Constructor Summary

Constructors

Constructor	Description
GenerationFileHandler(String pattern, boolean append, boolean shouldManifest)	Constructor.
GenerationFileHandler(LinkedList<String> filenameSeries, boolean shouldManifest)

Method Summary

Modifier and Type	Method	Description
List<String>	getFilenameSeries()
static GenerationFileHandler	makeNew(String filename, boolean append, boolean shouldManifest)	Constructor-helper that rather than clobbering any existing file, moves it aside with a timestamp suffix.
void	publish(LogRecord record)
GenerationFileHandler	rotate(String storeSuffix, String activeSuffix)	Move the current file to a new filename with the storeSuffix in place of the activeSuffix; continuing logging to a new file under the original filename.
GenerationFileHandler	rotate(String storeSuffix, String activeSuffix, boolean mergeOld)
boolean	shouldManifest()

Methods inherited from class java.util.logging.FileHandler

close

Methods inherited from class java.util.logging.StreamHandler

flush, isLoggable, setEncoding, setOutputStream

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

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

Constructor Details

GenerationFileHandler

public GenerationFileHandler(String pattern,
 boolean append,
 boolean shouldManifest)
                      throws IOException,
SecurityException

Constructor.

Parameters:

pattern -

append -

shouldManifest -

Throws:

IOException

SecurityException

GenerationFileHandler

public GenerationFileHandler(LinkedList<String> filenameSeries,
 boolean shouldManifest)
                      throws IOException

Parameters:

filenameSeries -

shouldManifest -

Throws:

IOException

Method Details

getFilenameSeries

public List<String> getFilenameSeries()

Returns:

Returns the filenameSeries.

rotate

public GenerationFileHandler rotate(String storeSuffix,
 String activeSuffix)
                             throws IOException

Move the current file to a new filename with the storeSuffix in place of the activeSuffix; continuing logging to a new file under the original filename.

Parameters:

storeSuffix - Suffix to put in place of activeSuffix

activeSuffix - Suffix to replace with storeSuffix.

Returns:

GenerationFileHandler instance.

Throws:

IOException

rotate

public GenerationFileHandler rotate(String storeSuffix,
 String activeSuffix,
 boolean mergeOld)
                             throws IOException

Throws:

IOException

shouldManifest

public boolean shouldManifest()

Returns:

True if should manifest.

makeNew

public static GenerationFileHandler makeNew(String filename,
 boolean append,
 boolean shouldManifest)
                                     throws SecurityException,
IOException

Constructor-helper that rather than clobbering any existing file, moves it aside with a timestamp suffix.

Parameters:

filename -

append -

shouldManifest -

Returns:

Throws:

SecurityException

IOException

publish

public void publish(LogRecord record)

Overrides:

publish in class FileHandler