com.facebook.rendercore

Class RenderUnit<MOUNT_CONTENT>

java.lang.Object

com.facebook.rendercore.RenderUnit<MOUNT_CONTENT>

All Implemented Interfaces:

Copyable, Cloneable

Direct Known Subclasses:

LithoRenderUnit

public abstract class RenderUnit<MOUNT_CONTENT>
extends Object
implements Copyable

A RenderUnit represents a single rendering primitive for RenderCore. Every RenderUnit has to define at least a createContent method to allocate the RenderUnit content (View or Drawable). RenderUnits will be automatically recycled by RenderCore based on their concrete type. A RenderUnit should in most cases declare how it intends to bind data returning Binders from its mountUnmountFunctions callback or from the attachDetachFunctions callback.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	RenderUnit.Binder<RENDER_UNIT,CONTENT> Represents a single bind function.
static class	RenderUnit.RenderType

Constructor Summary

Constructors

Constructor and Description
RenderUnit(RenderUnit.RenderType renderType)
RenderUnit(RenderUnit.RenderType renderType, List<? extends RenderUnit.Binder<? extends RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> mountUnmountFunctions)
RenderUnit(RenderUnit.RenderType renderType, List<? extends RenderUnit.Binder<? extends RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> mountUnmountFunctions, List<? extends RenderUnit.Binder<? extends RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> attachDetachFunctions)

Method Summary

Modifier and Type	Method and Description
void	addMountUnmountExtension(RenderUnit.Binder binder) Adds an extension function that will be invoked with the other mount/unmount binders.
List<RenderUnit.Binder<RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>>	attachDetachFunctions()
abstract MOUNT_CONTENT	createContent(Context c)
abstract long	getId()
Object	getRenderContentType()
RenderUnit.RenderType	getRenderType()
RenderUnit	makeCopy()
List<RenderUnit.Binder<RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>>	mountUnmountFunctions()
void	removeMountUnmountExtension(RenderUnit.Binder binder) removes an extension function previously added with addMountUnmountExtension

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RenderUnit

public RenderUnit(RenderUnit.RenderType renderType)

RenderUnit

public RenderUnit(RenderUnit.RenderType renderType,
                  List<? extends RenderUnit.Binder<? extends RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> mountUnmountFunctions)

RenderUnit

public RenderUnit(RenderUnit.RenderType renderType,
                  List<? extends RenderUnit.Binder<? extends RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> mountUnmountFunctions,
                  List<? extends RenderUnit.Binder<? extends RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> attachDetachFunctions)

Method Detail

getRenderType

public RenderUnit.RenderType getRenderType()

createContent

public abstract MOUNT_CONTENT createContent(Context c)

mountUnmountFunctions

public final List<RenderUnit.Binder<RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> mountUnmountFunctions()

Returns:

a list of binding functions that will be invoked during the mount process.

attachDetachFunctions

public final List<RenderUnit.Binder<RenderUnit<MOUNT_CONTENT>,MOUNT_CONTENT>> attachDetachFunctions()

Returns:

a list of binding functions that will be invoked whenever the shouldUpdate method in them returns true or the RenderUnit gets attached/detached from the hierarchy. If both shouldUpdate returns true and this RenderUnit was attached the bind function will still be guaranteed to be called once.

getId

public abstract long getId()

Returns:

a unique id identifying this RenderUnit in the tree of Node it is part of.

getRenderContentType

public Object getRenderContentType()

makeCopy

public RenderUnit makeCopy()

Specified by:

makeCopy in interface Copyable

addMountUnmountExtension

public void addMountUnmountExtension(RenderUnit.Binder binder)

Adds an extension function that will be invoked with the other mount/unmount binders. Can be used to add generic functionality (e.g. accessibility) to a RenderUnit.

removeMountUnmountExtension

public void removeMountUnmountExtension(RenderUnit.Binder binder)

removes an extension function previously added with addMountUnmountExtension