The Plan

Android library with basic adapters to get to up-to-speed in displaying lists

Features

ViewableListAdapter
ViewModel

Installation

Add the ff. maven repository and library to your project via gradle

repositories {
    maven { url 'https://dl.bintray.com/indiehortelano/maven/' }
}

// bunch of stuff

dependencies {
    compile 'com.keeboi.theplan:theplan:0.0.1-BETA@aar'
}

Usage

(NOTE: Please read about convert view before proceeding)

Given that I have an object as follows:

public class User {
    
    private String name;
    
    private String occupation;

    public String getName();
    
    public String getOccupation();
    
    // setters ...

}

I can simply wrap it around a ViewModel class and implement it's methods

public class UserViewModel extends ViewModel<User> {

    public UserViewModel (User model) {
        super(model); // lol
    }

    //override getView since ViewModel implements Viewable
    public View getView(int position, LayoutInflater inflater, View convertView, ViewGroup parent) {
        View view = null // The view of each row
        
        // We check the convertView if it's null, this is basically a view already inflated and is just being recycled
        if(convertView == null) {
            view = inflater.inflate(R.layout.layout_user_row, null, false);
        } else {
            view = convertView;
        }
    
        ((TextView) view.findViewById(R.id.name)).setText(getObject.getName());
        ((TextView) view.findViewById(R.id.occupation)).setText(getObject.getOccupation());
    
        return view;
    }
}

Afterwards, I can initialize a ViewableListAdapter (this refers to an Activity)

adapter = new ViewableListAdapter<>(this); // creates an empty adapter
adapter = new ViewableListAdapter<>(this, myListOfUsers); // you can also pass a reference to your own list

Now I can set it as my list adapter and I'm done!

listView.setAdapter(adapter);

If ever I have changes to the data set, I can simply let the adapter know

adapter.notifyDataSetChanged();

Notice

License

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.

akiwarheit / the-plan