Feature/multi selection support + selection handler refacoring

README.md

@@ -45,6 +45,11 @@ You can check new implementations of TableView on the [release page](https://git
     - [1. ISortableModel to your Cell Model](#1-isortablemodel-to-your-cell-model)
     - [2. AbstractSorterViewHolder to your Column Header ViewHolder](#2-abstractsorterviewholder-to-your-column-header-viewholder)
     - [3. Helper methods for sorting process](#3-helper-methods-for-sorting-process)
+  - [Selecting](#selecting)
+    - [1. Implements ISelectable to your Cell Model](#1-implements-iselectable-to-your-cell-model)
+    - [2. Enable selection on the TableView](#2-enable-selection-on-the-tableview)
+    - [3. Multi-selection and Shadows](#3-multi-selection-and-shadows)
+    - [4. Customize selection colors](#4-customize-selection-colors)
   - [Filtering](#filtering)
     - [Steps to implement filtering functionality into TableView](#steps-to-implement-filtering-functionality-into-tableview)
     - [Filtering notes](#filtering-notes)
@@ -833,7 +838,6 @@ As of version **0.8.5.1**, TableView has some helper functions to change desired
 ```java
     changeRowHeaderItemRange(int rowPositionStart, List<YourRowHeaderModel> rowHeaderModelList)
 ``` 
-
 - To **update a cell item**:
 ```java
     changeCellItem(int columnPosition, int rowPosition, YourCellItemModel cellModel)
@@ -851,6 +855,78 @@ As of version **0.8.5.1**, TableView has some helper functions to change desired
 
 *Note:*[TableViewSample 2 app](https://github.com/evrencoskun/TableViewSample2) also shows usage of these helper methods.
 
+
+## Selecting
+
+### 1. Implements ISelectable to your Cell Model
+
+To be able use this feature on your TableView. You have to implement ISelectableModel to your Cell Model. This interface
+wants two methods from your cell model. These are ;
+
+- ```java SelectionState getSelectionState()``` : To get current selection state for this Cell
+- ```java SelectionState setSelectionState()``` : To set current selection state for this Cell
+
+Note:  Make sure you return a default SelectionState value (UNSELECTED) when calling ```getSelectionState()```
+
+As you seen getSelectionState value returns SelectionState. TableView controls the style regarding this state.
+Their are three states;
+
+```java
+    /**
+     * Enumeration value indicating the item is selected.
+     * <code>SELECTED</code>.
+     */
+    SELECTED, 
+
+    /** 
+     * Enumeration value indicating the item is selected.
+     * <code>UNSELECTED</code>.
+     */
+    UNSELECTED,
+
+    /** 
+     * Enumeration value indicating the item is shadowed.
+     * <code>SHADOWED</code>.
+     */ 
+    SHADOWED
+```
+
+### 2. Enable selection on the TableView
+
+To enable selection, you have to enable selection for the TableView
+```java
+mTableView.setSelectable(true);
+```
+
+### 3. Multi-selection and Shadows
+
+You can enable multi-selection thanks to the SelectionHandler:
+```java
+mTableView.getSelectionHandler().setMultiSelectionEnabled(true);
+``` 
+
+You can also enable/disable Shadows thanks to the SelectionHandler:
+
+```java
+mTableView.getSelectionHandler().setShadowEnabled(true);
+```
+
+### 4. Customize selection colors
+
+You can customize selection colors easily in your layout:
+```xml
+
+	<com.evrencoskun.tableview.TableView
+            android:id="@+id/table_view"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+
+            app:selected_color="@color/tableview_selected_background_color"
+            app:shadow_color="@color/tableview_shadow_background_color"
+            app:unselected_color="@color/tableview_unselected_background_color"
+            />
+```
+
 ## Hiding & Showing the Row
 
 With 0.8.5.1 version, hiding and showing any of row is pretty easy for TableView.  For that several helper methods have been inserted on TableView. 
@@ -928,6 +1004,11 @@ With 0.8.5.5 version, hiding and showing any of column is pretty easy for TableV
     tableView.setIgnoreSelectionColors(false);
 ``` 
 
+- To enable selection, the below line can be used. You will need to implement ISelectable in your Cell
+```java
+tableView.setSelectable(true);
+```
+
 - To show or hide separators of the TableView, you can simply use these helper methods.
 
 ```java

app/src/main/java/com/evrencoskun/tableviewsample/MainFragment.java

@@ -97,6 +97,12 @@ public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle
 
         // Create Table view
         mTableView = createTableView();
+        mTableView.setSelectable(true);
+        mTableView.getSelectionHandler().setShadowEnabled(true);
+        mTableView.getSelectionHandler().setMultiSelectionEnabled(true);
+        mTableFilter = new Filter(mTableView); // Create an instance of a Filter and pass the
+        // created TableView.
+
 
         if(paginationEnabled) {
             mTableFilter = new Filter(mTableView); // Create an instance of a Filter and pass the

app/src/main/java/com/evrencoskun/tableviewsample/tableview/model/Cell.java

@@ -17,18 +17,21 @@
 
 package com.evrencoskun.tableviewsample.tableview.model;
 
+import com.evrencoskun.tableview.adapter.recyclerview.holder.AbstractViewHolder;
 import com.evrencoskun.tableview.filter.IFilterableModel;
+import com.evrencoskun.tableview.handler.ISelectableModel;
 import com.evrencoskun.tableview.sort.ISortableModel;
 
 /**
  * Created by evrencoskun on 11/06/2017.
  */
 
-public class Cell implements ISortableModel, IFilterableModel {
+public class Cell implements ISortableModel, IFilterableModel, ISelectableModel {
 
     private String mId;
     private Object mData;
     private String mFilterKeyword;
+    private AbstractViewHolder.SelectionState mSelectionState = AbstractViewHolder.SelectionState.UNSELECTED;
 
     public Cell(String id) {
         this.mId = id;
@@ -83,5 +86,15 @@ public void setFilterKeyword(String filterKeyword) {
     public String getFilterableKeyword() {
         return mFilterKeyword;
     }
+
+    @Override
+    public AbstractViewHolder.SelectionState getSelectionState() {
+        return mSelectionState;
+    }
+
+    @Override
+    public void setSelectionState(AbstractViewHolder.SelectionState selectionState) {
+        mSelectionState = selectionState;
+    }
 }
 

tableview/src/main/java/com/evrencoskun/tableview/ITableView.java

@@ -50,6 +50,10 @@ public interface ITableView {
 
     boolean isSortable();
 
+    boolean isSelectable();
+
+    void setSelectable(boolean selectable);
+
     CellRecyclerView getCellRecyclerView();
 
     CellRecyclerView getColumnHeaderRecyclerView();

tableview/src/main/java/com/evrencoskun/tableview/TableView.java

@@ -101,6 +101,7 @@ public class TableView extends FrameLayout implements ITableView {
     private boolean mShowHorizontalSeparators = true;
     private boolean mShowVerticalSeparators = true;
     private boolean mIsSortable;
+    private boolean mIsSelectable;
 
     public TableView(@NonNull Context context) {
         super(context);
@@ -350,6 +351,16 @@ public boolean isSortable() {
         return mIsSortable;
     }
 
+    @Override
+    public boolean isSelectable() {
+        return mIsSelectable;
+    }
+
+    @Override
+    public void setSelectable(boolean selectable) {
+        mIsSelectable = selectable;
+    }
+
     public void setShowHorizontalSeparators(boolean showSeparators) {
         this.mShowHorizontalSeparators = showSeparators;
     }
@@ -541,42 +552,37 @@ public boolean isRowVisible(int row) {
         return mVisibilityHandler.isRowVisible(row);
     }
 
+
+
+    public void setSelectedRow(int row) {
+        mSelectionHandler.setSelectedRowPosition(row);
+    }
+
     /**
      * Returns the index of the selected row, -1 if no row is selected.
      */
     public int getSelectedRow() {
-        return mSelectionHandler.getSelectedRowPosition();
-    }
-
-    public void setSelectedRow(int row) {
-        // Find the row header view holder which is located on row position.
-        AbstractViewHolder rowViewHolder = (AbstractViewHolder) getRowHeaderRecyclerView()
-                .findViewHolderForAdapterPosition(row);
-
-
-        mSelectionHandler.setSelectedRowPosition(rowViewHolder, row);
+        //TODO: reuse logic in mSelectionHandler.rowHasItemSelected
+        // to return list of selected rows
+        return -1;//mSelectionHandler.getSelectedRowPosition();
     }
 
     /**
      * Returns the index of the selected column, -1 if no column is selected.
      */
     public int getSelectedColumn() {
-        return mSelectionHandler.getSelectedColumnPosition();
+        //TODO: reuse logic in mSelectionHandler.columnHasItemSelected
+        // to return list of selected columns
+        return -1; //mSelectionHandler.getSelectedColumnPosition();
     }
 
     public void setSelectedColumn(int column) {
-        // Find the column view holder which is located on column position .
-        AbstractViewHolder columnViewHolder = (AbstractViewHolder) getColumnHeaderRecyclerView()
-                .findViewHolderForAdapterPosition(column);
-
-        mSelectionHandler.setSelectedColumnPosition(columnViewHolder, column);
+        mSelectionHandler.setSelectedColumnPosition(column);
     }
 
     public void setSelectedCell(int column, int row) {
         // Find the cell view holder which is located on x,y (column,row) position.
-        AbstractViewHolder cellViewHolder = getCellLayoutManager().getCellViewHolder(column, row);
-
-        mSelectionHandler.setSelectedCellPositions(cellViewHolder, column, row);
+        mSelectionHandler.setSelectedCellPositions(row, column);
     }
 
     @Override

tableview/src/main/java/com/evrencoskun/tableview/adapter/AbstractTableAdapter.java

@@ -26,6 +26,7 @@
 import com.evrencoskun.tableview.adapter.recyclerview.CellRecyclerViewAdapter;
 import com.evrencoskun.tableview.adapter.recyclerview.ColumnHeaderRecyclerViewAdapter;
 import com.evrencoskun.tableview.adapter.recyclerview.RowHeaderRecyclerViewAdapter;
+import com.evrencoskun.tableview.adapter.recyclerview.holder.AbstractViewHolder;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -304,4 +305,32 @@ public void addAdapterDataSetChangedListener(AdapterDataSetChangedListener liste
 
         dataSetChangedListeners.add(listener);
     }
+
+    public boolean isSelectable(){
+        return mTableView.isSelectable();
+    }
+
+    public int getColorForSelection(AbstractViewHolder.SelectionState selectionState) {
+        switch (selectionState) {
+            case SELECTED:
+                return mTableView.getSelectedColor();
+            case SHADOWED:
+                return  mTableView.getShadowColor();
+        }
+        return mTableView.getUnSelectedColor();
+    }
+
+    public int getColumnHeaderItemCount() {
+        if( mColumnHeaderItems != null) {
+            return mColumnHeaderItems.size();
+        }
+        return 0;
+    }
+
+    public int getRowHeaderItemCount() {
+        if( mRowHeaderItems != null) {
+            return mRowHeaderItems.size();
+        }
+        return 0;
+    }
 }

tableview/src/main/java/com/evrencoskun/tableview/adapter/ITableAdapter.java

@@ -57,6 +57,8 @@ void onBindRowHeaderViewHolder(AbstractViewHolder holder, Object rowHeaderItemMo
 
     ITableView getTableView();
 
+    int getColorForSelection(AbstractViewHolder.SelectionState selectionState);
+
     /**
      * Sets the listener for changes of data set on the TableView.
      *

tableview/src/main/java/com/evrencoskun/tableview/adapter/recyclerview/CellRecyclerViewAdapter.java

@@ -124,29 +124,6 @@ public void onViewAttachedToWindow(RecyclerView.ViewHolder holder) {
                 .scrollToPositionWithOffset(mHorizontalListener.getScrollPosition(),
                         mHorizontalListener.getScrollPositionOffset());
 
-        SelectionHandler selectionHandler = mTableAdapter.getTableView().getSelectionHandler();
-
-        if (selectionHandler.isAnyColumnSelected()) {
-
-            AbstractViewHolder cellViewHolder = (AbstractViewHolder) ((CellRowViewHolder) holder)
-                    .m_jRecyclerView.findViewHolderForAdapterPosition(selectionHandler
-                            .getSelectedColumnPosition());
-
-            if (cellViewHolder != null) {
-                // Control to ignore selection color
-                if (!mTableAdapter.getTableView().isIgnoreSelectionColors()) {
-                    cellViewHolder.setBackgroundColor(mTableAdapter.getTableView()
-                            .getSelectedColor());
-                }
-                cellViewHolder.setSelected(SelectionState.SELECTED);
-
-            }
-        } else if (selectionHandler.isRowSelected(holder.getAdapterPosition())) {
-
-            viewHolder.m_jRecyclerView.setSelected(SelectionState.SELECTED, mTableAdapter
-                    .getTableView().getSelectedColor(), mTableAdapter.getTableView()
-                    .isIgnoreSelectionColors());
-        }
 
     }
 
@@ -195,6 +172,27 @@ public void notifyCellDataSetChanged() {
     }
 
 
+    public C getItem(int rowPosition, int columnPosition) {
+        if(mItemList.size() > rowPosition) {
+            List<C> row = (List<C>) mItemList.get(rowPosition);
+            if(row.size() > columnPosition) {
+                return row.get(columnPosition);
+            }
+        }
+        return null;
+    }
+
+    /**
+     * This method helps to get cell item model that is located on given row position.
+     *
+     * @param rowPosition
+     */
+    public List<C> getRowItems(int rowPosition) {
+        List<C> cellItems = new ArrayList<>();
+
+        return  (List<C>) mItemList.get(rowPosition);
+    }
+
     /**
      * This method helps to get cell item model that is located on given column position.
      *