/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * 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.
 * 总体分析
这段 Java 代码定义了NotesListAdapter类，它继承自CursorAdapter，主要用于在安卓应用中对笔记相关数据（以Cursor形式体现）进行适配，以便在列表等视图组件中展示相应的笔记信息，并实现了多项与笔记选择、统计相关的功能。例如支持设置选择模式、选中特定项、全选操作，能获取选中项的ID集合、选中的部件相关属性集合、选中的数量等信息，同时在数据内容变化或游标改变时会重新计算笔记数量，整体为处理笔记列表展示及选择操作提供了较为完善的功能支持。
函数分析
构造函数
NotesListAdapter(Context context)：
所属类：NotesListAdapter
功能：
首先调用父类（CursorAdapter）的构造函数并传入Context和null游标，进行基础的初始化。
创建一个HashMap（mSelectedIndex）用于记录每个位置的笔记项是否被选中，将传入的Context赋值给mContext，并初始化笔记数量（mNotesCount）为0，为后续记录和处理笔记相关的选择状态及数量统计等操作做准备。
视图创建相关函数
newView(Context context, Cursor cursor, ViewGroup parent)：
所属类：NotesListAdapter
功能：重写了父类CursorAdapter的newView方法，用于创建一个新的视图对象来展示Cursor中的每一条数据记录。在这个方法中，它创建并返回了一个NotesListItem类的实例，意味着每一条笔记数据记录都会通过这个自定义的视图来展示，后续可以在这个自定义视图中进行具体的数据绑定和展示相关操作。
视图数据绑定函数
bindView(View view, Context context, Cursor cursor)：
所属类：NotesListAdapter
功能：重写了父类CursorAdapter的bindView方法，用于将Cursor中的数据绑定到对应的视图上进行展示。首先判断传入的视图是否是NotesListItem类型，如果是，则创建一个NoteItemData实例（通过传入Context和Cursor）来解析和封装当前笔记数据，然后调用((NotesListItem) view).bind方法，将Context、封装好的笔记数据（itemData）、选择模式（mChoiceMode）以及当前项是否被选中（通过isSelectedItem方法判断）等信息传递进去，在NotesListItem的bind方法中应该会根据这些信息来设置视图的具体显示内容，比如是否显示选中状态等。
选中项设置函数
setCheckedItem(final int position, final boolean checked)：
所属类：NotesListAdapter
功能：接收笔记项的位置和是否选中的布尔值两个参数，将对应位置的选中状态记录到mSelectedIndex这个HashMap中，然后调用notifyDataSetChanged方法通知数据集发生了变化，使得视图能根据新的选中状态进行刷新显示，例如更新列表项的选中外观等。
选择模式相关函数
isInChoiceMode()：
所属类：NotesListAdapter
功能：返回mChoiceMode的值，用于判断当前是否处于选择模式，外部代码可以根据这个返回值来决定是否显示选择相关的操作界面元素（如全选按钮等）。
setChoiceMode(boolean mode)：
所属类：NotesListAdapter
功能：接收一个布尔值参数用于设置选择模式，先清空之前记录的选中项信息（通过mSelectedIndex.clear），然后将传入的布尔值赋值给mChoiceMode，改变整个适配器的选择模式状态，后续的选择操作会依据新的模式进行处理。
 */

package net.micode.notes.ui;

import android.content.Context;
import android.database.Cursor;
import android.util.Log;
import android.view.View;
import android.view.ViewGroup;
import android.widget.CursorAdapter;

import net.micode.notes.data.Notes;

import java.util.Collection;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;


public class NotesListAdapter extends CursorAdapter {
    private static final String TAG = "NotesListAdapter";
    private Context mContext;
    private HashMap<Integer, Boolean> mSelectedIndex;
    private int mNotesCount;
    private boolean mChoiceMode;

    public static class AppWidgetAttribute {
        public int widgetId;
        public int widgetType;
    };

    public NotesListAdapter(Context context) {
        super(context, null);
        mSelectedIndex = new HashMap<Integer, Boolean>();
        mContext = context;
        mNotesCount = 0;
    }

    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        return new NotesListItem(context);
    }

    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        if (view instanceof NotesListItem) {
            NoteItemData itemData = new NoteItemData(context, cursor);
            ((NotesListItem) view).bind(context, itemData, mChoiceMode,
                    isSelectedItem(cursor.getPosition()));
        }
    }

    public void setCheckedItem(final int position, final boolean checked) {
        mSelectedIndex.put(position, checked);
        notifyDataSetChanged();
    }

    public boolean isInChoiceMode() {
        return mChoiceMode;
    }

    public void setChoiceMode(boolean mode) {
        mSelectedIndex.clear();
        mChoiceMode = mode;
    }

    public void selectAll(boolean checked) {
        Cursor cursor = getCursor();
        for (int i = 0; i < getCount(); i++) {
            if (cursor.moveToPosition(i)) {
                if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
                    setCheckedItem(i, checked);
                }
            }
        }
    }

    public HashSet<Long> getSelectedItemIds() {
        HashSet<Long> itemSet = new HashSet<Long>();
        for (Integer position : mSelectedIndex.keySet()) {
            if (mSelectedIndex.get(position) == true) {
                Long id = getItemId(position);
                if (id == Notes.ID_ROOT_FOLDER) {
                    Log.d(TAG, "Wrong item id, should not happen");
                } else {
                    itemSet.add(id);
                }
            }
        }

        return itemSet;
    }

    public HashSet<AppWidgetAttribute> getSelectedWidget() {
        HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
        for (Integer position : mSelectedIndex.keySet()) {
            if (mSelectedIndex.get(position) == true) {
                Cursor c = (Cursor) getItem(position);
                if (c != null) {
                    AppWidgetAttribute widget = new AppWidgetAttribute();
                    NoteItemData item = new NoteItemData(mContext, c);
                    widget.widgetId = item.getWidgetId();
                    widget.widgetType = item.getWidgetType();
                    itemSet.add(widget);
                    /**
                     * Don't close cursor here, only the adapter could close it
                     */
                } else {
                    Log.e(TAG, "Invalid cursor");
                    return null;
                }
            }
        }
        return itemSet;
    }

    public int getSelectedCount() {
        Collection<Boolean> values = mSelectedIndex.values();
        if (null == values) {
            return 0;
        }
        Iterator<Boolean> iter = values.iterator();
        int count = 0;
        while (iter.hasNext()) {
            if (true == iter.next()) {
                count++;
            }
        }
        return count;
    }

    public boolean isAllSelected() {
        int checkedCount = getSelectedCount();
        return (checkedCount != 0 && checkedCount == mNotesCount);
    }

    public boolean isSelectedItem(final int position) {
        if (null == mSelectedIndex.get(position)) {
            return false;
        }
        return mSelectedIndex.get(position);
    }

    @Override
    protected void onContentChanged() {
        super.onContentChanged();
        calcNotesCount();
    }

    @Override
    public void changeCursor(Cursor cursor) {
        super.changeCursor(cursor);
        calcNotesCount();
    }

    private void calcNotesCount() {
        mNotesCount = 0;
        for (int i = 0; i < getCount(); i++) {
            Cursor c = (Cursor) getItem(i);
            if (c != null) {
                if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
                    mNotesCount++;
                }
            } else {
                Log.e(TAG, "Invalid cursor");
                return;
            }
        }
    }
}
