Class CompressionSettings.Gzip

Field Details

• COMPRESSION_LEVEL

  public static volatile int COMPRESSION_LEVEL

  Deflate compression level.

  Possible values:

  • 0 -- Deflater.NO_COMPRESSION: store, no compression
  • 1 -- Deflater.BEST_SPEED: fastest, lowest ratio
  • 2..8 -- intermediate levels
  • 9 -- Deflater.BEST_COMPRESSION: slowest, best ratio
  • -1 -- Deflater.DEFAULT_COMPRESSION: equivalent to level 6

  Default: 9 (Deflater.BEST_COMPRESSION).

• STRATEGY

  public static volatile int STRATEGY

  Deflate compression strategy.

  Possible values:

  • Deflater.DEFAULT_STRATEGY (0): general-purpose data
  • Deflater.FILTERED (1): biased for filtered data (PNG-style predictors)
  • Deflater.HUFFMAN_ONLY (2): Huffman coding only, no LZ77 matching

  Default: Deflater.DEFAULT_STRATEGY (best for general text/HTML/JS/CSS).

• SYNC_FLUSH

  public static volatile boolean SYNC_FLUSH

  Whether the encoder uses Deflater.SYNC_FLUSH when flushing.

  When true, output is forced to a byte boundary after each write, allowing immediate decoding by the receiver at the cost of a small compression-ratio penalty. Useful for live streaming, harmful for static assets.

  Possible values: false, true.

  Default: false (better ratio).

• BUFFER_SIZE

  public static volatile int BUFFER_SIZE

  Encoder buffer size in bytes.

  Possible values: any positive int; practical range 4096..262144. Larger buffers slightly improve compression and reduce syscall overhead but use proportionally more memory per active encoding stream.

  Default: 32768 (32 KiB).

• DEFLATER_POOL_CAPACITY

  public static volatile int DEFLATER_POOL_CAPACITY

  Capacity of the DeflaterPool holding reusable Deflater instances for outbound compression.

  The pool grows on demand up to this cap; deflaters released beyond the cap are closed rather than pooled. A larger cap reduces native- resource churn under high concurrency at the cost of resident memory.

  Possible values:

  • 0 -- no pooling, create a fresh deflater per request (slow, GC churn)
  • positive int -- pool cap (typical: 64..1024)

  Default: 256.

• INFLATER_POOL_CAPACITY

  public static volatile int INFLATER_POOL_CAPACITY

  Capacity of the InflaterPool holding reusable Inflater instances for inbound decompression (gzipped request bodies).

  Possible values: see DEFLATER_POOL_CAPACITY.

  Default: 128 (lower than deflater cap -- inbound gzipped bodies are rarer than outbound gzip responses for an iiziServer workload).