Trait

com.rayrobdod.json.builder

Builder

Related Doc: package builder

Permalink

trait Builder[-Key, -Value, +Failure, +Result] extends AnyRef

An object which takes a series of key-value pairs and combines them into an object using a series of fold-left style method calls.

Key

the type of keys used by the Parser that this Builder will be used by

Value

the type of primitive value types used by the Parser that this Builder will be used by

Failure

possible ways this builder can fail

Result

the type of object built by this Builder

Source
Builder.scala
Version

4.0

See also

com.rayrobdod.json.parser.Parser

Linear Supertypes
Known Subclasses
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Builder
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. abstract type Middle

    Permalink

    The type of object while folding.

    The type of object while folding. If Builder weren't so whitebox, this would be a hidden implementation detail.

    Since

    4.0

Abstract Value Members

  1. abstract def apply[Input, ParserFailure, BuilderFailureExtra](folding: Middle, key: Key, input: Input, parser: Parser[Key, Value, ParserFailure, BuilderFailureExtra, Input], bfe: BuilderFailureExtra): ParserRetVal[Middle, Nothing, ParserFailure, Failure, BuilderFailureExtra]

    Permalink

    Add a key-value pair to folding

    Add a key-value pair to folding

    The key is key, and the value is the result of com.rayrobdod.json.parser.Parser.parse on the provided input.

    folding

    the object to be added to. Must be either the return value of init or the return value of apply

    key

    the key of a key-value pair

    input

    the input to a parser

    parser

    a parser for turning input into a value

    bfe

    extra data that this parser provides to Builder Failures

    returns

    either a built value or an error value

  2. abstract def finish[BuilderFailureExtra](bfe: BuilderFailureExtra)(folding: Middle): ParserRetVal[Result, Nothing, Nothing, Failure, BuilderFailureExtra]

    Permalink

    A function to be called after the folding to produce a result

    A function to be called after the folding to produce a result

    Taking advantage of this method might be useful if either Middle is mutable for performance reasons and Result should be immutable or if the builder needs to use multiple key-value pairs fromt the source to produce some value in the domain object.

    If there is no need to take advantage of this, the implementation of this method can be

    override def finish[BFE](bfe:BFE)(x:Middle) = ParserRetVal.Complex(x)
    folding

    the object to be converted. Must be either the return value of init or the return value of apply

    returns

    either a built value or an error value

    Since

    4.0

  3. abstract def init: Middle

    Permalink

    An 'empty' object.

    An 'empty' object. Can be thought of as either the value used at the start of a fold-left operation, or as an object filled with default values.

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 flatMapKey[K2, Err](fun: (K2) ⇒ Either[Err, Key]): Builder[K2, Value, Either[Err, Failure], Result]

    Permalink

    Change the type of key that this builder requires, with the option of indicating an error condition

    Change the type of key that this builder requires, with the option of indicating an error condition

    fun

    a conversion function from the new key to this's key

    Since

    3.1

  10. final def flatMapResult[R2, Err](fun: (Result) ⇒ Either[Err, R2]): Builder[Key, Value, Either[Err, Failure], R2]

    Permalink

    Change the type of result produced by this builder, with the option of indicating an error condition

    Change the type of result produced by this builder, with the option of indicating an error condition

    Since

    4.0

  11. final def flatMapValue[V2, Err](fun: (V2) ⇒ Either[Err, Value]): Builder[Key, V2, Either[Err, Failure], Result]

    Permalink

    Change the type of value that this builder requires, with the option of indicating an error condition

    Change the type of value that this builder requires, with the option of indicating an error condition

    Since

    3.0

  12. final def getClass(): Class[_]

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

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

    Permalink
    Definition Classes
    Any
  15. final def mapFailure[F2](implicit fun: (Failure) ⇒ F2): Builder[Key, Value, F2, Result]

    Permalink

    Change the type of failure produced by this builder

    Change the type of failure produced by this builder

    Since

    4.0

  16. final def mapKey[K2](implicit fun: (K2) ⇒ Key): Builder[K2, Value, Failure, Result]

    Permalink

    Change the type of key that this builder requires

    Change the type of key that this builder requires

    fun

    a conversion function from the new key to this's key

    Since

    3.0

  17. final def mapResult[R2](implicit fun: (Result) ⇒ R2): Builder[Key, Value, Failure, R2]

    Permalink

    Change the type of result produced by this builder

    Change the type of result produced by this builder

    Since

    4.0

  18. final def mapValue[V2](implicit fun: (V2) ⇒ Value): Builder[Key, V2, Failure, Result]

    Permalink

    Change the type of value that this builder requires

    Change the type of value that this builder requires

    fun

    a conversion function from the new value to this's value

    Since

    3.0

  19. final def ne(arg0: AnyRef): Boolean

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

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

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

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

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

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

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  27. final def zip[K2, V2, F2, R2](that: Builder[K2, V2, F2, R2])(implicit evk: <:<[K2, Key], evv: <:<[V2, Value], evf: <:<[Failure, F2]): Builder[K2, V2, F2, (Result, R2)]

    Permalink

    Create a Builder which builds two items from the same input.

    Create a Builder which builds two items from the same input. The first item built being the one that this would build, and the second item built being the one that that would build.

    Most useful if the Parser input is neither stable nor resendable - say a network stream.

    that

    the other builder

    Since

    3.1

Inherited from AnyRef

Inherited from Any

Ungrouped