Trait

scala.pickling

PReader

Related Doc: package pickling

Permalink

trait PReader extends Hintable

A reader of pickled content. This is a mutable API, intended to be called in certain specific ways.

Here are a few static rules that all picklers must follow when using this interface.

1. There will be one endEntry() for every beginEntry() call. 2. There will be one endCollection() for every beginCollection() call. 3. Every beginCollection()/endCollection() pair will be inside a beginEntry()/endEntry() pair. 4. Every readLength() call will be immediately after a beginCollection() call. 5. Every readElement() call must happen within a beginCollection()/endCollection() block, and after a readLength(). 6. Every readField() call must happen within a beginEntry()/endEntry() block. 7. If readLength() returns 0, there will be no called to readElement(). 8. readField() will only be called where atObject would return true 9. readPrimitive will only be called when atPrimitive would return true 10. The order of readField calls in any pickler will be the exact same ordering when pickling,

Here is a list of all types the auto-generated Picklers considers "primitives" and must be directly supported by any PReader "readPrimitive" operation:

Linear Supertypes
Known Subclasses
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. PReader
  2. Hintable
  3. AnyRef
  4. Any
  1. Hide All
  2. Show all
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def atObject: Boolean

    Permalink

    returns true if the reader is currently looking at a pickled object/structure.

  2. abstract def atPrimitive: Boolean

    Permalink

    returns true if the reader is currently looking at a pickled primitive.

  3. abstract def beginCollection(): PReader

    Permalink

    Denotes we'd like to read the current entry as a collection.

    Denotes we'd like to read the current entry as a collection. Note: Must be called after a beginEntry* call.

  4. abstract def beginEntry(): String

    Permalink

    Start reading a pickled value.

    Start reading a pickled value. This will return any serialized type tag key string. This string can be used to reconstitute a FastTypeTag w/ a mirror, but is intended for use as fast string-matching.

  5. abstract def endCollection(): Unit

    Permalink

    Denote that we are done reading a collection.

  6. abstract def endEntry(): Unit

    Permalink

    Denotes that we're done reading an entry in the pickle.

  7. abstract def hintElidedType(tag: FastTypeTag[_]): PReader.this.type

    Permalink

    Hints to the pickle format that we KNOW the type of this field, so it can elide any type hints from the final pickle.

    Hints to the pickle format that we KNOW the type of this field, so it can elide any type hints from the final pickle. During unpickling, this informs the format that it shouldn't look for any type hints in the pickle, but instead use this tag as the unpickle tag key.

    Definition Classes
    Hintable
  8. abstract def hintKnownSize(knownSize: Int): PReader.this.type

    Permalink

    Hints at the expected (byte) size of the entry we're about to write..

    Hints at the expected (byte) size of the entry we're about to write..

    Definition Classes
    Hintable
  9. abstract def hintOid(id: Int): PReader.this.type

    Permalink

    Hints the object id of the next beginEntry/endEntry calls.

    Hints the object id of the next beginEntry/endEntry calls. If this oid is -1, it implies that the next entry has not been registered in any sharing cache, and should be pickled fully. If the oid != -1, then the pickle format is free to elide the fields of the entry in favor of pickling a scala.pickling.refs.Ref.

    Hint: This is only used during pickling.

    Definition Classes
    Hintable
  10. abstract def pinHints(): PReader.this.type

    Permalink

    Locks the hints down to what we've specified, so if you drop into another pickler it retains our information.

    Locks the hints down to what we've specified, so if you drop into another pickler it retains our information.

    Definition Classes
    Hintable
  11. abstract def popHints(): PReader.this.type

    Permalink

    Pops to the previously saved set of hints.

    Pops to the previously saved set of hints.

    Definition Classes
    Hintable
  12. abstract def pushHints(): PReader.this.type

    Permalink

    Creates a new fresh set of hints, preserving what was hinted before.

    Creates a new fresh set of hints, preserving what was hinted before.

    Definition Classes
    Hintable
  13. abstract def readElement(): PReader

    Permalink

    Returns a new Reader that can be used to read the next element in a collection.

  14. abstract def readField(name: String): PReader

    Permalink

    Returns a reader which can read a field of a complex structure in the pickle.

    Returns a reader which can read a field of a complex structure in the pickle.

    name

    The name of the field

    returns

    A reader which can read the structure's field.

  15. abstract def readLength(): Int

    Permalink

    Reads the length of a serialized collection.

    Reads the length of a serialized collection. Must be called directly after beginCollection and before readElement.

    returns

    The length of a serialized collection.

  16. abstract def readPrimitive(): Any

    Permalink

    Reads one of the supported primitive types from the pickler.

  17. abstract def unpinHints(): PReader.this.type

    Permalink

    Unlocks the hints.

    Unlocks the hints.

    Definition Classes
    Hintable

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  5. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  6. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  7. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  8. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  9. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  10. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  11. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  12. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  13. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  14. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  15. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  16. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  17. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  18. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  19. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from Hintable

Inherited from AnyRef

Inherited from Any

Ungrouped