com.pedrogomez.renderers

Class RendererBuilder<T>

java.lang.Object

com.pedrogomez.renderers.RendererBuilder<T>

public class RendererBuilder<T>
extends java.lang.Object

Class created to work as builder for Renderer objects. This class provides methods to create a Renderer instances using a fluent API. The library users have to extends RendererBuilder and create a new one with prototypes. The RendererBuilder implementation will have to declare the mapping between objects from the AdapteeCollection and Renderer instances passed to the prototypes collection. This class is not going to implement the view recycling if is used with the RecyclerView widget because RecyclerView class already implements the view recycling for us.

Constructor Summary

Constructors

Constructor and Description
RendererBuilder() Initializes a RendererBuilder with an empty prototypes collection.
RendererBuilder(java.util.Collection<? extends Renderer<? extends T>> prototypes) Initializes a RendererBuilder with a list of prototypes.
RendererBuilder(Renderer<T> renderer) Initializes a RendererBuilder with just one prototype.

Method Summary

Modifier and Type	Method and Description
<G extends T> RendererBuilder<T>	bind(java.lang.Class<G> clazz, java.lang.Class<? extends Renderer<? extends G>> prototypeClass)
<G extends T> RendererBuilder<T>	bind(java.lang.Class<G> clazz, Renderer<? extends G> prototype) Given a class configures the binding between a class and a Renderer class.
protected Renderer	build() Main method of this class related to ListView widget.
protected RendererViewHolder	buildRendererViewHolder() Main method of this class related to RecyclerView widget.
protected java.lang.Class	getPrototypeClass(T content) Method to be implemented by the RendererBuilder subtypes.
java.util.List<Renderer<? extends T>>	getPrototypes() Get access to the prototypes collection used to create one RendererBuilder.
void	setPrototypes(java.util.Collection<? extends Renderer<? extends T>> prototypes) Configure prototypes used as Renderer instances.
protected RendererBuilder	withConvertView(android.view.View convertView)
RendererBuilder<T>	withPrototype(Renderer<? extends T> renderer) Add a Renderer instance as prototype.
RendererBuilder<T>	withPrototypes(java.util.Collection<? extends Renderer<? extends T>> prototypes) Configure prototypes used as Renderer instances.

Methods inherited from class java.lang.Object

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

Constructor Detail

RendererBuilder

public RendererBuilder()

Initializes a RendererBuilder with an empty prototypes collection. Using this constructor some binding configuration is needed.

RendererBuilder

public RendererBuilder(Renderer<T> renderer)

Initializes a RendererBuilder with just one prototype. Using this constructor the prototype used will be always the same and the additional binding configuration wont be needed.

RendererBuilder

public RendererBuilder(java.util.Collection<? extends Renderer<? extends T>> prototypes)

Initializes a RendererBuilder with a list of prototypes. Using this constructor some binding configuration is needed.

Method Detail

getPrototypes

public final java.util.List<Renderer<? extends T>> getPrototypes()

Get access to the prototypes collection used to create one RendererBuilder.

Returns:

prototypes list.

setPrototypes

public final void setPrototypes(java.util.Collection<? extends Renderer<? extends T>> prototypes)

Configure prototypes used as Renderer instances.

Parameters:

prototypes - to use by the builder in order to create Renderer instances.

withPrototypes

public RendererBuilder<T> withPrototypes(java.util.Collection<? extends Renderer<? extends T>> prototypes)

Configure prototypes used as Renderer instances.

Parameters:

prototypes - to use by the builder in order to create Renderer instances.

Returns:

the current RendererBuilder instance.

withPrototype

public RendererBuilder<T> withPrototype(Renderer<? extends T> renderer)

Add a Renderer instance as prototype.

Parameters:

renderer - to use as prototype.

Returns:

the current RendererBuilder instance.

bind

public <G extends T> RendererBuilder<T> bind(java.lang.Class<G> clazz,
                                             Renderer<? extends G> prototype)

Given a class configures the binding between a class and a Renderer class.

Parameters:

clazz - to bind.

prototype - used as Renderer.

Returns:

the current RendererBuilder instance.

bind

public <G extends T> RendererBuilder<T> bind(java.lang.Class<G> clazz,
                                             java.lang.Class<? extends Renderer<? extends G>> prototypeClass)

withConvertView

protected RendererBuilder withConvertView(android.view.View convertView)

build

protected Renderer build()

Main method of this class related to ListView widget. This method is the responsible of recycle or create a new Renderer instance with all the needed information to implement the rendering. This method will validate all the attributes passed in the builder constructor and will check if can recycle or has to create a new Renderer instance. This method is used with ListView because the view recycling mechanism is implemented in this class. RecyclerView widget will use buildRendererViewHolder method.

Returns:

ready to use Renderer instance.

buildRendererViewHolder

protected RendererViewHolder buildRendererViewHolder()

Main method of this class related to RecyclerView widget. This method is the responsible of create a new Renderer instance with all the needed information to implement the rendering. This method will validate all the attributes passed in the builder constructor and will create a RendererViewHolder instance. This method is used with RecyclerView because the view recycling mechanism is implemented out of this class and we only have to return new RendererViewHolder instances.

Returns:

ready to use RendererViewHolder instance.

getPrototypeClass

protected java.lang.Class getPrototypeClass(T content)

Method to be implemented by the RendererBuilder subtypes. In this method the library user will define the mapping between content and renderer class.

Parameters:

content - used to map object to Renderers.

Returns:

the class associated to the renderer.