io.earcam.utilitarian.io

Interface SplittableOutputStreamBuilder

All Known Subinterfaces:

SplittableOutputStreamBuilder.SplitOutputStreamBuilder

All Known Implementing Classes:

SplittableOutputStream

public interface SplittableOutputStreamBuilder

Create a SplittableOutputStream with maximum byte size and/or maximum number of records

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	SplittableOutputStreamBuilder.SplitOutputStreamBuilder

Method Summary

Modifier and Type	Method and Description
SplittableOutputStreamBuilder.SplitOutputStreamBuilder	maxCount(long numberOfRecords) Split criteria for maximum number of records.
SplittableOutputStreamBuilder.SplitOutputStreamBuilder	maxSize(long fileSizeBytes) Split criteria for maximum file size.

Method Detail

maxSize

SplittableOutputStreamBuilder.SplitOutputStreamBuilder maxSize(long fileSizeBytes)

Split criteria for maximum file size.

May also be composed with maximum record count criteria.

Parameters:

fileSizeBytes - the maximum file size permitted.

Returns:

the builder for further construction

Throws:

IllegalArgumentException - if fileSizeBytes < head.length + tail.length

See Also:

maxCount(long)

maxCount

SplittableOutputStreamBuilder.SplitOutputStreamBuilder maxCount(long numberOfRecords)

Split criteria for maximum number of records. Where the definition of a record is any bytes written between calls to SplittableOutputStream#start() and SplittableOutputStream#finish()

May also be composed with maximum file size criteria.

Parameters:

numberOfRecords - the maximum permitted number of records per file.

Returns:

the builder for further construction

Throws:

IllegalArgumentException - if numberOfRecords < 0

See Also:

maxSize(long)