github.com/chain5j/chain5j-pkg@v1.0.7/codec/rlp/encbuffer.go (about)

     1  // Copyright 2022 The go-ethereum Authors
     2  // This file is part of the go-ethereum library.
     3  //
     4  // The go-ethereum library is free software: you can redistribute it and/or modify
     5  // it under the terms of the GNU Lesser General Public License as published by
     6  // the Free Software Foundation, either version 3 of the License, or
     7  // (at your option) any later version.
     8  //
     9  // The go-ethereum library is distributed in the hope that it will be useful,
    10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    12  // GNU Lesser General Public License for more details.
    13  //
    14  // You should have received a copy of the GNU Lesser General Public License
    15  // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  package rlp
    18  
    19  import (
    20  	"io"
    21  	"math/big"
    22  	"reflect"
    23  	"sync"
    24  )
    25  
    26  type encBuffer struct {
    27  	str     []byte     // string data, contains everything except list headers
    28  	lheads  []listhead // all list headers
    29  	lhsize  int        // sum of sizes of all encoded list headers
    30  	sizebuf [9]byte    // auxiliary buffer for uint encoding
    31  }
    32  
    33  // The global encBuffer pool.
    34  var encBufferPool = sync.Pool{
    35  	New: func() interface{} { return new(encBuffer) },
    36  }
    37  
    38  func getEncBuffer() *encBuffer {
    39  	buf := encBufferPool.Get().(*encBuffer)
    40  	buf.reset()
    41  	return buf
    42  }
    43  
    44  func (buf *encBuffer) reset() {
    45  	buf.lhsize = 0
    46  	buf.str = buf.str[:0]
    47  	buf.lheads = buf.lheads[:0]
    48  }
    49  
    50  // size returns the length of the encoded data.
    51  func (buf *encBuffer) size() int {
    52  	return len(buf.str) + buf.lhsize
    53  }
    54  
    55  // makeBytes creates the encoder output.
    56  func (w *encBuffer) makeBytes() []byte {
    57  	out := make([]byte, w.size())
    58  	w.copyTo(out)
    59  	return out
    60  }
    61  
    62  func (w *encBuffer) copyTo(dst []byte) {
    63  	strpos := 0
    64  	pos := 0
    65  	for _, head := range w.lheads {
    66  		// write string data before header
    67  		n := copy(dst[pos:], w.str[strpos:head.offset])
    68  		pos += n
    69  		strpos += n
    70  		// write the header
    71  		enc := head.encode(dst[pos:])
    72  		pos += len(enc)
    73  	}
    74  	// copy string data after the last list header
    75  	copy(dst[pos:], w.str[strpos:])
    76  }
    77  
    78  // writeTo writes the encoder output to w.
    79  func (buf *encBuffer) writeTo(w io.Writer) (err error) {
    80  	strpos := 0
    81  	for _, head := range buf.lheads {
    82  		// write string data before header
    83  		if head.offset-strpos > 0 {
    84  			n, err := w.Write(buf.str[strpos:head.offset])
    85  			strpos += n
    86  			if err != nil {
    87  				return err
    88  			}
    89  		}
    90  		// write the header
    91  		enc := head.encode(buf.sizebuf[:])
    92  		if _, err = w.Write(enc); err != nil {
    93  			return err
    94  		}
    95  	}
    96  	if strpos < len(buf.str) {
    97  		// write string data after the last list header
    98  		_, err = w.Write(buf.str[strpos:])
    99  	}
   100  	return err
   101  }
   102  
   103  // Write implements io.Writer and appends b directly to the output.
   104  func (buf *encBuffer) Write(b []byte) (int, error) {
   105  	buf.str = append(buf.str, b...)
   106  	return len(b), nil
   107  }
   108  
   109  // writeBool writes b as the integer 0 (false) or 1 (true).
   110  func (buf *encBuffer) writeBool(b bool) {
   111  	if b {
   112  		buf.str = append(buf.str, 0x01)
   113  	} else {
   114  		buf.str = append(buf.str, 0x80)
   115  	}
   116  }
   117  
   118  func (buf *encBuffer) writeUint64(i uint64) {
   119  	if i == 0 {
   120  		buf.str = append(buf.str, 0x80)
   121  	} else if i < 128 {
   122  		// fits single byte
   123  		buf.str = append(buf.str, byte(i))
   124  	} else {
   125  		s := putint(buf.sizebuf[1:], i)
   126  		buf.sizebuf[0] = 0x80 + byte(s)
   127  		buf.str = append(buf.str, buf.sizebuf[:s+1]...)
   128  	}
   129  }
   130  
   131  func (buf *encBuffer) writeBytes(b []byte) {
   132  	if len(b) == 1 && b[0] <= 0x7F {
   133  		// fits single byte, no string header
   134  		buf.str = append(buf.str, b[0])
   135  	} else {
   136  		buf.encodeStringHeader(len(b))
   137  		buf.str = append(buf.str, b...)
   138  	}
   139  }
   140  
   141  func (buf *encBuffer) writeString(s string) {
   142  	buf.writeBytes([]byte(s))
   143  }
   144  
   145  // wordBytes is the number of bytes in a big.Word
   146  const wordBytes = (32 << (uint64(^big.Word(0)) >> 63)) / 8
   147  
   148  // writeBigInt writes i as an integer.
   149  func (w *encBuffer) writeBigInt(i *big.Int) {
   150  	bitlen := i.BitLen()
   151  	if bitlen <= 64 {
   152  		w.writeUint64(i.Uint64())
   153  		return
   154  	}
   155  	// Integer is larger than 64 bits, encode from i.Bits().
   156  	// The minimal byte length is bitlen rounded up to the next
   157  	// multiple of 8, divided by 8.
   158  	length := ((bitlen + 7) & -8) >> 3
   159  	w.encodeStringHeader(length)
   160  	w.str = append(w.str, make([]byte, length)...)
   161  	index := length
   162  	buf := w.str[len(w.str)-length:]
   163  	for _, d := range i.Bits() {
   164  		for j := 0; j < wordBytes && index > 0; j++ {
   165  			index--
   166  			buf[index] = byte(d)
   167  			d >>= 8
   168  		}
   169  	}
   170  }
   171  
   172  // list adds a new list header to the header stack. It returns the index of the header.
   173  // Call listEnd with this index after encoding the content of the list.
   174  func (buf *encBuffer) list() int {
   175  	buf.lheads = append(buf.lheads, listhead{offset: len(buf.str), size: buf.lhsize})
   176  	return len(buf.lheads) - 1
   177  }
   178  
   179  func (buf *encBuffer) listEnd(index int) {
   180  	lh := &buf.lheads[index]
   181  	lh.size = buf.size() - lh.offset - lh.size
   182  	if lh.size < 56 {
   183  		buf.lhsize++ // length encoded into kind tag
   184  	} else {
   185  		buf.lhsize += 1 + intsize(uint64(lh.size))
   186  	}
   187  }
   188  
   189  func (buf *encBuffer) encode(val interface{}) error {
   190  	rval := reflect.ValueOf(val)
   191  	writer, err := cachedWriter(rval.Type())
   192  	if err != nil {
   193  		return err
   194  	}
   195  	return writer(rval, buf)
   196  }
   197  
   198  func (buf *encBuffer) encodeStringHeader(size int) {
   199  	if size < 56 {
   200  		buf.str = append(buf.str, 0x80+byte(size))
   201  	} else {
   202  		sizesize := putint(buf.sizebuf[1:], uint64(size))
   203  		buf.sizebuf[0] = 0xB7 + byte(sizesize)
   204  		buf.str = append(buf.str, buf.sizebuf[:sizesize+1]...)
   205  	}
   206  }
   207  
   208  // encReader is the io.Reader returned by EncodeToReader.
   209  // It releases its encbuf at EOF.
   210  type encReader struct {
   211  	buf    *encBuffer // the buffer we're reading from. this is nil when we're at EOF.
   212  	lhpos  int        // index of list header that we're reading
   213  	strpos int        // current position in string buffer
   214  	piece  []byte     // next piece to be read
   215  }
   216  
   217  func (r *encReader) Read(b []byte) (n int, err error) {
   218  	for {
   219  		if r.piece = r.next(); r.piece == nil {
   220  			// Put the encode buffer back into the pool at EOF when it
   221  			// is first encountered. Subsequent calls still return EOF
   222  			// as the error but the buffer is no longer valid.
   223  			if r.buf != nil {
   224  				encBufferPool.Put(r.buf)
   225  				r.buf = nil
   226  			}
   227  			return n, io.EOF
   228  		}
   229  		nn := copy(b[n:], r.piece)
   230  		n += nn
   231  		if nn < len(r.piece) {
   232  			// piece didn't fit, see you next time.
   233  			r.piece = r.piece[nn:]
   234  			return n, nil
   235  		}
   236  		r.piece = nil
   237  	}
   238  }
   239  
   240  // next returns the next piece of data to be read.
   241  // it returns nil at EOF.
   242  func (r *encReader) next() []byte {
   243  	switch {
   244  	case r.buf == nil:
   245  		return nil
   246  
   247  	case r.piece != nil:
   248  		// There is still data available for reading.
   249  		return r.piece
   250  
   251  	case r.lhpos < len(r.buf.lheads):
   252  		// We're before the last list header.
   253  		head := r.buf.lheads[r.lhpos]
   254  		sizebefore := head.offset - r.strpos
   255  		if sizebefore > 0 {
   256  			// String data before header.
   257  			p := r.buf.str[r.strpos:head.offset]
   258  			r.strpos += sizebefore
   259  			return p
   260  		}
   261  		r.lhpos++
   262  		return head.encode(r.buf.sizebuf[:])
   263  
   264  	case r.strpos < len(r.buf.str):
   265  		// String data at the end, after all list headers.
   266  		p := r.buf.str[r.strpos:]
   267  		r.strpos = len(r.buf.str)
   268  		return p
   269  
   270  	default:
   271  		return nil
   272  	}
   273  }
   274  
   275  func encBufferFromWriter(w io.Writer) *encBuffer {
   276  	switch w := w.(type) {
   277  	case EncoderBuffer:
   278  		return w.buf
   279  	case *EncoderBuffer:
   280  		return w.buf
   281  	case *encBuffer:
   282  		return w
   283  	default:
   284  		return nil
   285  	}
   286  }
   287  
   288  // EncoderBuffer is a buffer for incremental encoding.
   289  //
   290  // The zero value is NOT ready for use. To get a usable buffer,
   291  // create it using NewEncoderBuffer or call Reset.
   292  type EncoderBuffer struct {
   293  	buf *encBuffer
   294  	dst io.Writer
   295  
   296  	ownBuffer bool
   297  }
   298  
   299  // NewEncoderBuffer creates an encoder buffer.
   300  func NewEncoderBuffer(dst io.Writer) EncoderBuffer {
   301  	var w EncoderBuffer
   302  	w.Reset(dst)
   303  	return w
   304  }
   305  
   306  // Reset truncates the buffer and sets the output destination.
   307  func (w *EncoderBuffer) Reset(dst io.Writer) {
   308  	if w.buf != nil && !w.ownBuffer {
   309  		panic("can't Reset derived EncoderBuffer")
   310  	}
   311  
   312  	// If the destination writer has an *encBuffer, use it.
   313  	// Note that w.ownBuffer is left false here.
   314  	if dst != nil {
   315  		if outer := encBufferFromWriter(dst); outer != nil {
   316  			*w = EncoderBuffer{outer, nil, false}
   317  			return
   318  		}
   319  	}
   320  
   321  	// Get a fresh buffer.
   322  	if w.buf == nil {
   323  		w.buf = encBufferPool.Get().(*encBuffer)
   324  		w.ownBuffer = true
   325  	}
   326  	w.buf.reset()
   327  	w.dst = dst
   328  }
   329  
   330  // Flush writes encoded RLP data to the output writer. This can only be called once.
   331  // If you want to re-use the buffer after Flush, you must call Reset.
   332  func (w *EncoderBuffer) Flush() error {
   333  	var err error
   334  	if w.dst != nil {
   335  		err = w.buf.writeTo(w.dst)
   336  	}
   337  	// Release the internal buffer.
   338  	if w.ownBuffer {
   339  		encBufferPool.Put(w.buf)
   340  	}
   341  	*w = EncoderBuffer{}
   342  	return err
   343  }
   344  
   345  // ToBytes returns the encoded bytes.
   346  func (w *EncoderBuffer) ToBytes() []byte {
   347  	return w.buf.makeBytes()
   348  }
   349  
   350  // AppendToBytes appends the encoded bytes to dst.
   351  func (w *EncoderBuffer) AppendToBytes(dst []byte) []byte {
   352  	size := w.buf.size()
   353  	out := append(dst, make([]byte, size)...)
   354  	w.buf.copyTo(out[len(dst):])
   355  	return out
   356  }
   357  
   358  // Write appends b directly to the encoder output.
   359  func (w EncoderBuffer) Write(b []byte) (int, error) {
   360  	return w.buf.Write(b)
   361  }
   362  
   363  // WriteBool writes b as the integer 0 (false) or 1 (true).
   364  func (w EncoderBuffer) WriteBool(b bool) {
   365  	w.buf.writeBool(b)
   366  }
   367  
   368  // WriteUint64 encodes an unsigned integer.
   369  func (w EncoderBuffer) WriteUint64(i uint64) {
   370  	w.buf.writeUint64(i)
   371  }
   372  
   373  // WriteBigInt encodes a big.Int as an RLP string.
   374  // Note: Unlike with Encode, the sign of i is ignored.
   375  func (w EncoderBuffer) WriteBigInt(i *big.Int) {
   376  	w.buf.writeBigInt(i)
   377  }
   378  
   379  // WriteBytes encodes b as an RLP string.
   380  func (w EncoderBuffer) WriteBytes(b []byte) {
   381  	w.buf.writeBytes(b)
   382  }
   383  
   384  // WriteBytes encodes s as an RLP string.
   385  func (w EncoderBuffer) WriteString(s string) {
   386  	w.buf.writeString(s)
   387  }
   388  
   389  // List starts a list. It returns an internal index. Call EndList with
   390  // this index after encoding the content to finish the list.
   391  func (w EncoderBuffer) List() int {
   392  	return w.buf.list()
   393  }
   394  
   395  // ListEnd finishes the given list.
   396  func (w EncoderBuffer) ListEnd(index int) {
   397  	w.buf.listEnd(index)
   398  }