t

upickle.core

BufferingByteParser

trait BufferingByteParser extends AnyRef

Models a growable buffer of Bytes, which are Chars or Bytes. We maintain an Array[Byte] as a buffer, and read Bytes into it using readDataIntoBuffer and drop old Bytes using dropBufferUntil.

In general, BufferingByteParser allows us to keep the fast path fast:

- Reading elem-by-elem from the buffer is a bounds check and direct Array access, without any indirection or polymorphism. - We load Bytes in batches into the buffer, which allows us to take advantage of batching APIs like InputStream.read - We amortize the overhead of the indirect/polymorphic readDataIntoBuffer call over the size of each batch

Note that dropBufferUntil only advances a dropped index and does not actually zero out the dropped Bytes; instead, we wait until we need to call growBuffer, and use that as a chance to copy the remaining un-dropped Bytes to either the start of the current buffer or the start of a newly-allocated bigger buffer (if necessary)

Linear Supertypes
AnyRef, Any
Known Subclasses
BufferingInputStreamParser
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. BufferingByteParser
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Abstract Value Members

  1. abstract def readDataIntoBuffer(buffer: Array[Byte], bufferOffset: Int): (Array[Byte], Boolean, Int)

Concrete Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. def appendBytesToBuilder(elems: ByteBuilder, elemsStart: Int, elemsLength: Int): Unit
  5. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  6. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  7. def dropBufferUntil(i: Int): Unit
  8. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  9. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  10. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  11. def getBufferCopyCount(): Int
  12. def getBufferGrowCount(): Int
  13. def getBufferLength(): Int
  14. def getByteSafe(i: Int): Byte
  15. def getByteUnsafe(i: Int): Byte
  16. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  17. def getLastIdx: Int
  18. def growBuffer(until: Int): Unit

    Copies the non-dropped Bytes in the current buffer to the start of either the current buffer, or a newly-allocated larger buffer if necessary.

  19. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  20. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  21. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  22. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  23. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  24. def requestUntil(until: Int): Boolean

    Used to ensure that elements up to until are available to read; returns whether or not we have read off the end of the input.

    Used to ensure that elements up to until are available to read; returns whether or not we have read off the end of the input.

    In the fast path, when until is less than the lastIdx we have buffered, there is no work to do and we return false.

    In the slow path, when until is more than lastIdx, we then run growBuffer to grow the buffer if necessary, and then readDataIntoBuffer to populate it. readDataIntoBuffer returns a newDone value to indicate whether we have read off the end of the input or not.

    Note that for some subclasses, growBuffer may be a no-op when we already know we have reached the end of input.

    Attributes
    protected
  25. def sliceArr(i: Int, n: Int): (Array[Byte], Int, Int)
  26. def sliceString(i: Int, k: Int): String
  27. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  28. def toString(): String
    Definition Classes
    AnyRef → Any
  29. def unsafeCharSeqForRange(start: Int, length: Int): WrapByteArrayCharSeq
  30. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  31. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  32. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Inherited from AnyRef

Inherited from Any

Ungrouped