Class/Object

net.liftweb.util

RestoringWeakReference

Related Docs: object RestoringWeakReference | package util

Permalink

class RestoringWeakReference[T <: AnyRef] extends AnyRef

RestoringWeakReference contains a scala.ref.WeakReference that, after it has been nulled out, uses a restorer function to restore the value. This can be used for data that can afford to be evicted by the garbage collector, but will be needed later. One good example is Lift form callbacks, which may need the value of an object, but where you don't necessarily want to be retaining the object indefinitely while someone is on a page in the face of GC contention.

You can use RestoringWeakReference in a couple of basic ways:

val ref = RestoringWeakReference(() => User.find(id))

In this situation, the RestoringWeakReference will immediately call the passed function to provide the starting value for the reference, and then the same function will be used if the reference is evicted.

val ref = RestoringWeakReference(starter, () => User.find(id))

Here, starter is an Option[User] and User.find returns an Option[User]. The first parameter will be used to initialize the weak reference, while the function will be used to restore the value if the reference is evicted.

val baseRef = new WeakReference(starter)
val ref = new RestoringWeakReference(baseRef, () => User.find(id))

If you already have a WeakReference instance, you can instantiate RestoringWeakReference directly and pass that reference as the starting value, as well.

In all these cases, you use ref.value to get a hold of the value. That function will return the value if it is available, and, if not, it will restore the WeakReference and then return the value.

Linear Supertypes
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. RestoringWeakReference
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Visibility
  1. Public
  2. All

Instance Constructors

  1. new RestoringWeakReference(reference: WeakReference[T], restorer: () ⇒ T)

    Permalink

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. def apply(): T

    Permalink
  5. final def asInstanceOf[T0]: T0

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Inherited from AnyRef

Inherited from Any

Ungrouped