net.liftweb.http

Bindings

object Bindings

A collection of types and implicit transformations used to allow composition of page elements based upon the types of rendered objects.

In Lift, a "snippet" is a function from NodeSeq => NodeSeq, where the argument to the function is a template, and the result is a fragment of a page to be rendered. Of course, this is a bit of an abbreviation; the snippet function also has an argument which is the application state made available from S. A DataBinding[T] is very similar in this respect; it is a function from some piece of information of type T to a function from NodeSeq => NodeSeq. Since DataBinding is strongly typed with respect to the type of information being rendered, DataBinding instances are ideal for the rendering of objects that is used to build up snippets. For example:

import net.liftweb.http.Bindings._

case class MyClass(str: String, i: Int, other: MyOtherClass)
case class MyOtherClass(foo: String)

trait MyClassBinding extends DataBinding[MyClass] {
  implicit val otherBinding: DataBinding[MyOtherClass]

  override def apply(entity: MyClass) = (xhtml: NodeSeq) => {
    val otherTemplate = chooseTemplate("myclass", "other", xhtml)
    bind(
      "myclass", xhtml,
      "str" -> Text("#" + entity.str + "#"),
      "i" -> Text(entity.i.toString),
      "other" -> entity.other.bind(otherTemplate)
    )
  }

}

object myOtherClassBinding extends DataBinding[MyOtherClass] {
  override def apply(other: MyOtherClass) = (xhtml: NodeSeq) => {
    bind("other", xhtml, "foo" -> Text("%" + other.foo + "%"))
  }
}

object MyClassConcreteBinding extends MyClassBinding {
  override val otherBinding = myOtherClassBinding
}

In this example, two classes and their associated bindings are constructed; the first binding for MyClass is abstract, needing a specific instance of DataBinding[MyOtherClass] to enable the implicit conversion needed to render the contained MyOtherClass instance. A subtemplate is selected, and the call to other.bind both necessitates the implicit conversion to a Bindings.Binder instance and applies the appropriate formatting. You can see how this usage keeps the concerns of the view and the model nicely separated, while allowing composition over object graphs.

Please see the tests, as well as this blog post for additional details.

Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Bindings
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Type Members

  1. case class Binder(binding: (NodeSeq) ⇒ NodeSeq) extends Product with Serializable

    A decorator for a binding function that allows it to be called as bind() rather than apply().

  2. type Binding = (NodeSeq) ⇒ NodeSeq

  3. type DataBinding[T] = (T) ⇒ (NodeSeq) ⇒ NodeSeq

Value Members

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

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

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

    Definition Classes
    AnyRef
  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  6. object EmptyBinding extends (NodeSeq) ⇒ NodeSeq

    Bind any input value to the empty NodeSeq.

  7. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  8. implicit def binder(binding: (NodeSeq) ⇒ NodeSeq): Binder

    Wrap the specified Binding (a function from NodeSeq => NodeSeq) in a Binder so that it can be applied using Binder's bind methods.

  9. implicit def binder[T](t: T)(implicit binding: (T) ⇒ (NodeSeq) ⇒ NodeSeq): Binder

    Implicitly convert the specified object to a binder for that object if a DataBinding for that object's type is available in implicit scope.

    Implicitly convert the specified object to a binder for that object if a DataBinding for that object's type is available in implicit scope. This essentially adds a bind() method to an object if an appropriate implicit DataBinding is available.

  10. def clone(): AnyRef

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

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

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

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

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

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

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

    Definition Classes
    AnyRef
  18. final def notify(): Unit

    Definition Classes
    AnyRef
  19. final def notifyAll(): Unit

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

    Definition Classes
    AnyRef
  21. def toString(): String

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

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

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

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped