Package com.github.luben.zstd

Class ZstdOutputStreamNoFinalizer

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

com.github.luben.zstd.ZstdOutputStreamNoFinalizer

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

public class ZstdOutputStreamNoFinalizer
extends java.io.FilterOutputStream

OutputStream filter that compresses the data using Zstd compression.

Field Summary

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

Constructors

Constructor	Description
ZstdOutputStreamNoFinalizer(@NotNull java.io.OutputStream outStream)	create a new compressing OutputStream
ZstdOutputStreamNoFinalizer(@NotNull java.io.OutputStream outStream, int level)	create a new compressing OutputStream
ZstdOutputStreamNoFinalizer(@NotNull java.io.OutputStream outStream, @NotNull BufferPool bufferPool)	create a new compressing OutputStream
ZstdOutputStreamNoFinalizer(@NotNull java.io.OutputStream outStream, @NotNull BufferPool bufferPool, int level)	create a new compressing OutputStream

Method Summary

Modifier and Type	Method	Description
void	close()
void	closeWithoutClosingParentStream()
void	flush()	Flushes the output
static long	recommendedCOutSize()
@NotNull ZstdOutputStreamNoFinalizer	setChainLog(int chainLog)	Advanced Compression Option: Set the maximum number of bits for the secondary search structure.
@NotNull ZstdOutputStreamNoFinalizer	setChecksum(boolean useChecksums)	Enable checksums for the compressed stream.
@NotNull ZstdOutputStreamNoFinalizer	setCloseFrameOnFlush(boolean closeOnFlush)	Enable closing the frame on flush.
@NotNull ZstdOutputStreamNoFinalizer	setDict(byte @NotNull [] dict)
@NotNull ZstdOutputStreamNoFinalizer	setDict(@NotNull ZstdDictCompress dict)
@NotNull ZstdOutputStreamNoFinalizer	setHashLog(int hashLog)	Advanced Compression Option: Set the maximum number of bits for a hash table.
@NotNull ZstdOutputStreamNoFinalizer	setJobSize(int jobSize)	Advanced Compression Option: Set the size of each compression job.
@NotNull ZstdOutputStreamNoFinalizer	setLevel(int level)	Set the compression level.
@NotNull ZstdOutputStreamNoFinalizer	setLong(int windowLog)	Enable Long Distance Matching and set the Window size Log.
@NotNull ZstdOutputStreamNoFinalizer	setMinMatch(int minMatch)	Advanced Compression Option: Set the minimum match length.
@NotNull ZstdOutputStreamNoFinalizer	setOverlapLog(int overlapLog)	Advanced Compression Option: Set the amount of data reloaded from the previous job.
@NotNull ZstdOutputStreamNoFinalizer	setSearchLog(int searchLog)	Advanced Compression Option: Set the maximum number of searches in a hash chain or a binary tree using logarithmic scale.
@NotNull ZstdOutputStreamNoFinalizer	setStrategy(int strategy)	Advanced Compression Option: Set the strategy used by a match finder.
@NotNull ZstdOutputStreamNoFinalizer	setTargetLength(int targetLength)	Advanced Compression Option: Set the target match length.
@NotNull ZstdOutputStreamNoFinalizer	setWindowLog(int windowLog)	Advanced Compression Option: Set the maximum number of bits for a match distance.
@NotNull ZstdOutputStreamNoFinalizer	setWorkers(int n)	Enable use of worker threads for parallel compression.
void	write(byte @NotNull [] src, int offset, int len)
void	write(int i)

Methods inherited from class java.io.FilterOutputStream

write

Methods inherited from class java.io.OutputStream

nullOutputStream

Methods inherited from class java.lang.Object

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

Constructor Detail

ZstdOutputStreamNoFinalizer

public ZstdOutputStreamNoFinalizer(@NotNull
                                   @NotNull java.io.OutputStream outStream,
                                   int level)
                            throws java.io.IOException

create a new compressing OutputStream

Parameters:

outStream - the stream to wrap

level - the compression level

Throws:

java.io.IOException

ZstdOutputStreamNoFinalizer

public ZstdOutputStreamNoFinalizer(@NotNull
                                   @NotNull java.io.OutputStream outStream)
                            throws java.io.IOException

create a new compressing OutputStream

Parameters:

outStream - the stream to wrap

Throws:

java.io.IOException

ZstdOutputStreamNoFinalizer

public ZstdOutputStreamNoFinalizer(@NotNull
                                   @NotNull java.io.OutputStream outStream,
                                   @NotNull
                                   @NotNull BufferPool bufferPool,
                                   int level)
                            throws java.io.IOException

create a new compressing OutputStream

Parameters:

outStream - the stream to wrap

bufferPool - the pool to fetch and return buffers

Throws:

java.io.IOException

ZstdOutputStreamNoFinalizer

public ZstdOutputStreamNoFinalizer(@NotNull
                                   @NotNull java.io.OutputStream outStream,
                                   @NotNull
                                   @NotNull BufferPool bufferPool)
                            throws java.io.IOException

create a new compressing OutputStream

Parameters:

outStream - the stream to wrap

bufferPool - the pool to fetch and return buffers

Throws:

java.io.IOException

Method Detail

recommendedCOutSize

public static long recommendedCOutSize()

setChecksum

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setChecksum(boolean useChecksums)
                                                 throws java.io.IOException

Enable checksums for the compressed stream. Default: false

Throws:

java.io.IOException

setLevel

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setLevel(int level)
                                              throws java.io.IOException

Set the compression level. Default: Zstd.defaultCompressionLevel()

Throws:

java.io.IOException

setLong

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setLong(int windowLog)
                                             throws java.io.IOException

Enable Long Distance Matching and set the Window size Log. Values for windowLog outside the range 10-27 will disable and reset LDM

Throws:

java.io.IOException

setWorkers

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setWorkers(int n)
                                                throws java.io.IOException

Enable use of worker threads for parallel compression. Default: no worker threads.

Throws:

java.io.IOException

setOverlapLog

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setOverlapLog(int overlapLog)
                                                   throws java.io.IOException

Advanced Compression Option: Set the amount of data reloaded from the previous job. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setJobSize

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setJobSize(int jobSize)
                                                throws java.io.IOException

Advanced Compression Option: Set the size of each compression job. Only applies when multi threaded compression is enabled. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setTargetLength

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setTargetLength(int targetLength)
                                                     throws java.io.IOException

Advanced Compression Option: Set the target match length. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setMinMatch

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setMinMatch(int minMatch)
                                                 throws java.io.IOException

Advanced Compression Option: Set the minimum match length. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setSearchLog

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setSearchLog(int searchLog)
                                                  throws java.io.IOException

Advanced Compression Option: Set the maximum number of searches in a hash chain or a binary tree using logarithmic scale. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setChainLog

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setChainLog(int chainLog)
                                                 throws java.io.IOException

Advanced Compression Option: Set the maximum number of bits for the secondary search structure. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setHashLog

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setHashLog(int hashLog)
                                                throws java.io.IOException

Advanced Compression Option: Set the maximum number of bits for a hash table. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setWindowLog

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setWindowLog(int windowLog)
                                                  throws java.io.IOException

Advanced Compression Option: Set the maximum number of bits for a match distance. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setStrategy

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setStrategy(int strategy)
                                                 throws java.io.IOException

Advanced Compression Option: Set the strategy used by a match finder. See https://facebook.github.io/zstd/zstd_manual.html#Chapter5 for more information.

Throws:

java.io.IOException

setCloseFrameOnFlush

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setCloseFrameOnFlush(boolean closeOnFlush)

Enable closing the frame on flush. This will guarantee that it can be ready fully if the process crashes before closing the stream. On the downside it will negatively affect the compression ratio. Default: false.

setDict

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setDict(byte @NotNull [] dict)
                                             throws java.io.IOException

Throws:

java.io.IOException

setDict

@NotNull
public @NotNull ZstdOutputStreamNoFinalizer setDict(@NotNull
                                                    @NotNull ZstdDictCompress dict)
                                             throws java.io.IOException

Throws:

java.io.IOException

write

public void write(byte @NotNull [] src,
                  int offset,
                  int len)
           throws java.io.IOException

Overrides:

write in class java.io.FilterOutputStream

Throws:

java.io.IOException

write

public void write(int i)
           throws java.io.IOException

Overrides:

write in class java.io.FilterOutputStream

Throws:

java.io.IOException

flush

public void flush()
           throws java.io.IOException

Flushes the output

Specified by:

flush in interface java.io.Flushable

Overrides:

flush in class java.io.FilterOutputStream

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Overrides:

close in class java.io.FilterOutputStream

Throws:

java.io.IOException

closeWithoutClosingParentStream

public void closeWithoutClosingParentStream()
                                     throws java.io.IOException

Throws:

java.io.IOException