brotli.go 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193
  1. package fasthttp
  2. import (
  3. "bytes"
  4. "fmt"
  5. "io"
  6. "sync"
  7. "github.com/andybalholm/brotli"
  8. "github.com/valyala/bytebufferpool"
  9. "github.com/valyala/fasthttp/stackless"
  10. )
  11. // Supported compression levels.
  12. const (
  13. CompressBrotliNoCompression = 0
  14. CompressBrotliBestSpeed = brotli.BestSpeed
  15. CompressBrotliBestCompression = brotli.BestCompression
  16. // Choose a default brotli compression level comparable to
  17. // CompressDefaultCompression (gzip 6)
  18. // See: https://github.com/valyala/fasthttp/issues/798#issuecomment-626293806
  19. CompressBrotliDefaultCompression = 4
  20. )
  21. func acquireBrotliReader(r io.Reader) (*brotli.Reader, error) {
  22. v := brotliReaderPool.Get()
  23. if v == nil {
  24. return brotli.NewReader(r), nil
  25. }
  26. zr := v.(*brotli.Reader)
  27. if err := zr.Reset(r); err != nil {
  28. return nil, err
  29. }
  30. return zr, nil
  31. }
  32. func releaseBrotliReader(zr *brotli.Reader) {
  33. brotliReaderPool.Put(zr)
  34. }
  35. var brotliReaderPool sync.Pool
  36. func acquireStacklessBrotliWriter(w io.Writer, level int) stackless.Writer {
  37. nLevel := normalizeBrotliCompressLevel(level)
  38. p := stacklessBrotliWriterPoolMap[nLevel]
  39. v := p.Get()
  40. if v == nil {
  41. return stackless.NewWriter(w, func(w io.Writer) stackless.Writer {
  42. return acquireRealBrotliWriter(w, level)
  43. })
  44. }
  45. sw := v.(stackless.Writer)
  46. sw.Reset(w)
  47. return sw
  48. }
  49. func releaseStacklessBrotliWriter(sw stackless.Writer, level int) {
  50. sw.Close()
  51. nLevel := normalizeBrotliCompressLevel(level)
  52. p := stacklessBrotliWriterPoolMap[nLevel]
  53. p.Put(sw)
  54. }
  55. func acquireRealBrotliWriter(w io.Writer, level int) *brotli.Writer {
  56. nLevel := normalizeBrotliCompressLevel(level)
  57. p := realBrotliWriterPoolMap[nLevel]
  58. v := p.Get()
  59. if v == nil {
  60. zw := brotli.NewWriterLevel(w, level)
  61. return zw
  62. }
  63. zw := v.(*brotli.Writer)
  64. zw.Reset(w)
  65. return zw
  66. }
  67. func releaseRealBrotliWriter(zw *brotli.Writer, level int) {
  68. zw.Close()
  69. nLevel := normalizeBrotliCompressLevel(level)
  70. p := realBrotliWriterPoolMap[nLevel]
  71. p.Put(zw)
  72. }
  73. var (
  74. stacklessBrotliWriterPoolMap = newCompressWriterPoolMap()
  75. realBrotliWriterPoolMap = newCompressWriterPoolMap()
  76. )
  77. // AppendBrotliBytesLevel appends brotlied src to dst using the given
  78. // compression level and returns the resulting dst.
  79. //
  80. // Supported compression levels are:
  81. //
  82. // - CompressBrotliNoCompression
  83. // - CompressBrotliBestSpeed
  84. // - CompressBrotliBestCompression
  85. // - CompressBrotliDefaultCompression
  86. func AppendBrotliBytesLevel(dst, src []byte, level int) []byte {
  87. w := &byteSliceWriter{dst}
  88. WriteBrotliLevel(w, src, level) //nolint:errcheck
  89. return w.b
  90. }
  91. // WriteBrotliLevel writes brotlied p to w using the given compression level
  92. // and returns the number of compressed bytes written to w.
  93. //
  94. // Supported compression levels are:
  95. //
  96. // - CompressBrotliNoCompression
  97. // - CompressBrotliBestSpeed
  98. // - CompressBrotliBestCompression
  99. // - CompressBrotliDefaultCompression
  100. func WriteBrotliLevel(w io.Writer, p []byte, level int) (int, error) {
  101. switch w.(type) {
  102. case *byteSliceWriter,
  103. *bytes.Buffer,
  104. *bytebufferpool.ByteBuffer:
  105. // These writers don't block, so we can just use stacklessWriteBrotli
  106. ctx := &compressCtx{
  107. w: w,
  108. p: p,
  109. level: level,
  110. }
  111. stacklessWriteBrotli(ctx)
  112. return len(p), nil
  113. default:
  114. zw := acquireStacklessBrotliWriter(w, level)
  115. n, err := zw.Write(p)
  116. releaseStacklessBrotliWriter(zw, level)
  117. return n, err
  118. }
  119. }
  120. var stacklessWriteBrotli = stackless.NewFunc(nonblockingWriteBrotli)
  121. func nonblockingWriteBrotli(ctxv interface{}) {
  122. ctx := ctxv.(*compressCtx)
  123. zw := acquireRealBrotliWriter(ctx.w, ctx.level)
  124. _, err := zw.Write(ctx.p)
  125. if err != nil {
  126. panic(fmt.Sprintf("BUG: brotli.Writer.Write for len(p)=%d returned unexpected error: %v", len(ctx.p), err))
  127. }
  128. releaseRealBrotliWriter(zw, ctx.level)
  129. }
  130. // WriteBrotli writes brotlied p to w and returns the number of compressed
  131. // bytes written to w.
  132. func WriteBrotli(w io.Writer, p []byte) (int, error) {
  133. return WriteBrotliLevel(w, p, CompressBrotliDefaultCompression)
  134. }
  135. // AppendBrotliBytes appends brotlied src to dst and returns the resulting dst.
  136. func AppendBrotliBytes(dst, src []byte) []byte {
  137. return AppendBrotliBytesLevel(dst, src, CompressBrotliDefaultCompression)
  138. }
  139. // WriteUnbrotli writes unbrotlied p to w and returns the number of uncompressed
  140. // bytes written to w.
  141. func WriteUnbrotli(w io.Writer, p []byte) (int, error) {
  142. r := &byteSliceReader{p}
  143. zr, err := acquireBrotliReader(r)
  144. if err != nil {
  145. return 0, err
  146. }
  147. n, err := copyZeroAlloc(w, zr)
  148. releaseBrotliReader(zr)
  149. nn := int(n)
  150. if int64(nn) != n {
  151. return 0, fmt.Errorf("too much data unbrotlied: %d", n)
  152. }
  153. return nn, err
  154. }
  155. // AppendUnbrotliBytes appends unbrotlied src to dst and returns the resulting dst.
  156. func AppendUnbrotliBytes(dst, src []byte) ([]byte, error) {
  157. w := &byteSliceWriter{dst}
  158. _, err := WriteUnbrotli(w, src)
  159. return w.b, err
  160. }
  161. // normalizes compression level into [0..11], so it could be used as an index
  162. // in *PoolMap.
  163. func normalizeBrotliCompressLevel(level int) int {
  164. // -2 is the lowest compression level - CompressHuffmanOnly
  165. // 9 is the highest compression level - CompressBestCompression
  166. if level < 0 || level > 11 {
  167. level = CompressBrotliDefaultCompression
  168. }
  169. return level
  170. }