RecyclerViewRenderers

Creating adapters each time you want to use a RecyclerView is boring. Everybody knows it. Also, creating an adapter that accepts different types of data, with its corresponding views, and manage them generates adapters with lines and lines of code that are difficult to maintain.

RecyclerViewRenderers is a library whose main objective is to reduce the time you spend fighting against RecyclerView .

It has been designed to help you have your code separated and decoupled.

Thanks to Sefford for his great library Brender, that has inspired me to write this one.

##Usage First, we have to declare a RecyclerView in the layout:

<android.support.v7.widget.RecyclerView
	android:id="@+id/recyclerView"
	android:layout_width="match_parent"
	android:layout_height="match_parent" />

Then, in the Activity or Fragment:

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerView);

//If we are going to have different items, we have to indicate it
recyclerView.setHasFixedSize(false);

//LayoutManager
LinearLayoutManager layoutManager = new LinearLayoutManager(this);
layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
recyclerView.setLayoutManager(layoutManager);

//Adapter (Where magic happens!)
RendererAdapter adapter = new RendererAdapter(items, new RendererBuilder(new Factory()));
recyclerView.setAdapter(adapter);

####Renderables This classes should contain the data and must implement Renderable. The method getRenderableId returns the ID of the layout that will display the data.

public class ItemBender implements Renderable {

    private String title;

    private String summary;

    public ItemBender(String title, String summary) {
        this.title = title;
        this.summary = summary;
    }

    public String getTitle() {
        return title;
    }

    public String getSummary() {
        return summary;
    }

    @Override
    public int getRenderableId() {
        return R.layout.item_bender;
    }
}

####ViewHolder

The ViewHolder pattern was used in ListViews to recycle the views and reduce the usage of findViewById. In the new RecyclerView the ViewHolder is used to indicate the Adapter how to set the data to the views. You can also use ButterKnife!

public class ViewHolderBender extends RenderViewHolder<ItemBender> {

    @InjectView(R.id.title)
    TextView title;
    @InjectView(R.id.summary)
    TextView summary;

    public ViewHolderBender(View itemView) {
        super(itemView);
        ButterKnife.inject(this, itemView);
    }

    @Override
    public void onBindView(ItemBender renderable) {
        title.setText(renderable.getTitle());
        summary.setText(renderable.getSummary());
    }
}

####Renderer The Renderer is the class responsible for creating the ViewHolder of each Renderable. The method onCreateViewHolder should return the ViewHolder. You can also indicate here the action that should be performed when this item is clicked in the RecyclerView.

public class ItemBenderRenderer extends Renderer implements View.OnClickListener {


    public ItemBenderRenderer(int id) {
        super(id);
    }

    @Override
    public RenderViewHolder onCreateViewHolder(ViewGroup viewGroup, int id) {
        View itemView = LayoutInflater.from(viewGroup.getContext())
                .inflate(id, viewGroup, false);
        itemView.setOnClickListener(this);
        return new ViewHolderBender(itemView);
    }

    @Override
    public void onClick(View v) {
        v.getContext().startActivity(new Intent(v.getContext(), DetailActivity.class));
    }
}

####Factory You have to create a class that implements RendererFactory. The method getRenderer will be implemented. It will receive as parameter the id of the layout returned by getRenderableId in your Renderable.

public class Factory implements RendererFactory {

    @Override
    public Renderer getRenderer(int id) {
        switch (id) {
            case R.layout.item_bender:
                return new ItemBenderRenderer(id);
            case R.layout.item_zoidberg:
                return new ItemZoidbergRenderer(id);
            case R.layout.item_fry:
                return new ItemFryRenderer(id);
        }
        return null;
    }
}

####TODO

• Test
• Upload to Maven Central

License

Copyright (C) 2014 Alejandro Rodriguez Salamanca.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.