/*
 * 版权所有 (c) 2010-2011，The MiCode 开源社区 (www.micode.net)
 *
 * 本软件根据 Apache 许可证 2.0 版（"许可证"）发布；
 * 除非符合许可证，否则不得使用此文件。
 * 您可以在以下网址获取许可证副本：
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * 除非法律要求或书面同意，软件
 * 根据许可证分发的内容按"原样"提供，
 * 不附带任何明示或暗示的保证或条件。
 * 请参阅许可证，了解有关权限和限制的具体语言。
 */

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;

/**
 * 笔记列表适配器（继承自CursorAdapter）
 * 功能：管理笔记列表的数据展示，支持多选模式、数据过滤和Widget相关操作
 * 职责：
 * 1. 将Cursor数据转换为NotesListItem视图
 * 2. 处理多选模式下的选中状态管理
 * 3. 统计可操作的笔记数量（非文件夹项）
 * 4. 提供批量操作相关接口（全选、获取选中项等）
 */
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;             // 是否为多选模式

    // 内部类：用于封装Widget相关属性（ID和类型）
    public static class AppWidgetAttribute {
        public int widgetId;   // Widget ID
        public int widgetType; // Widget类型
    }

    /**
     * 构造方法
     * @param context 上下文
     */
    public NotesListAdapter(Context context) {
        super(context, null); // 调用父类构造方法（传入空Cursor，后续通过changeCursor设置）
        mSelectedIndex = new HashMap<Integer, Boolean>(); // 初始化选中状态集合
        mContext = context;
        mNotesCount = 0; // 初始化可操作笔记数量
    }

    /**
     * 创建新视图：返回NotesListItem实例
     * @param context   上下文
     * @param cursor    数据Cursor
     * @param parent    父视图组
     * @return 列表项视图
     */
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        return new NotesListItem(context); // 使用自定义列表项视图
    }

    /**
     * 绑定视图：将Cursor数据填充到NotesListItem中
     * @param view      列表项视图
     * @param context   上下文
     * @param cursor    数据Cursor
     */
    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        if (view instanceof NotesListItem) {
            // 从Cursor创建数据对象
            NoteItemData itemData = new NoteItemData(context, cursor);
            // 绑定数据到视图，传入多选模式状态和选中状态
            ((NotesListItem) view).bind(context, itemData, mChoiceMode,
                    isSelectedItem(cursor.getPosition())); // 根据位置判断是否选中
        }
    }

    /**
     * 设置指定位置的选中状态
     * @param position  列表位置
     * @param checked   是否选中
     */
    public void setCheckedItem(final int position, final boolean checked) {
        mSelectedIndex.put(position, checked); // 存储选中状态
        notifyDataSetChanged(); // 通知数据集变化，更新视图
    }

    /**
     * 判断是否处于多选模式
     * @return true=多选模式，false=普通模式
     */
    public boolean isInChoiceMode() {
        return mChoiceMode;
    }

    /**
     * 设置多选模式状态（同时清空选中状态）
     * @param mode 多选模式开关
     */
    public void setChoiceMode(boolean mode) {
        mSelectedIndex.clear(); // 清空所有选中状态
        mChoiceMode = mode;
    }

    /**
     * 全选/全不选操作
     * @param checked 是否全选
     */
    public void selectAll(boolean checked) {
        Cursor cursor = getCursor(); // 获取当前Cursor
        if (cursor == null) return;

        for (int i = 0; i < getCount(); i++) {
            if (cursor.moveToPosition(i)) { // 移动到指定位置
                // 仅处理笔记类型（非文件夹）
                if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
                    setCheckedItem(i, checked); // 设置选中状态
                }
            }
        }
    }

    /**
     * 获取所有选中项的ID集合（仅笔记和通话记录项，排除根文件夹）
     * @return 选中项ID集合
     */
    public HashSet<Long> getSelectedItemIds() {
        HashSet<Long> itemSet = new HashSet<Long>();
        for (Integer position : mSelectedIndex.keySet()) {
            if (mSelectedIndex.get(position)) { // 仅处理选中的位置
                Long id = getItemId(position); // 获取项ID（来自Cursor的_id字段）
                if (id == Notes.ID_ROOT_FOLDER) {
                    // 根文件夹ID为特殊值，忽略（防止误操作）
                    Log.d(TAG, "Wrong item id, should not happen");
                } else {
                    itemSet.add(id);
                }
            }
        }
        return itemSet;
    }

    /**
     * 获取所有选中项的Widget属性集合（用于桌面小部件操作）
     * @return Widget属性集合
     */
    public HashSet<AppWidgetAttribute> getSelectedWidget() {
        HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
        for (Integer position : mSelectedIndex.keySet()) {
            if (mSelectedIndex.get(position)) { // 仅处理选中的位置
                Cursor c = (Cursor) getItem(position); // 获取对应Cursor
                if (c != null) {
                    AppWidgetAttribute widget = new AppWidgetAttribute();
                    NoteItemData item = new NoteItemData(mContext, c);
                    widget.widgetId = item.getWidgetId(); // 获取Widget ID
                    widget.widgetType = item.getWidgetType(); // 获取Widget类型
                    itemSet.add(widget);
                } else {
                    Log.e(TAG, "Invalid cursor");
                    return null; // 无效Cursor时返回null
                }
            }
        }
        return itemSet;
    }

    /**
     * 获取选中项数量
     * @return 选中项数量
     */
    public int getSelectedCount() {
        Collection<Boolean> values = mSelectedIndex.values();
        if (values == null) return 0;

        int count = 0;
        Iterator<Boolean> iter = values.iterator();
        while (iter.hasNext()) {
            if (iter.next()) count++; // 统计值为true的数量
        }
        return count;
    }

    /**
     * 判断是否全选（选中数量等于可操作笔记数量）
     * @return true=全选，false=未全选
     */
    public boolean isAllSelected() {
        int checkedCount = getSelectedCount();
        return (checkedCount != 0 && checkedCount == mNotesCount); // 非零且等于可操作数量
    }

    /**
     * 判断指定位置是否选中
     * @param position 列表位置
     * @return true=选中，false=未选中
     */
    public boolean isSelectedItem(final int position) {
        // 默认返回false，若集合中无该位置则视为未选中
        return mSelectedIndex.get(position) != null && mSelectedIndex.get(position);
    }

    /**
     * 内容变化时的回调（当数据更新时触发）
     */
    @Override
    protected void onContentChanged() {
        super.onContentChanged();
        calcNotesCount(); // 重新计算可操作笔记数量
    }

    /**
     * 更换Cursor时的回调（如数据刷新或查询条件变更）
     * @param cursor 新的Cursor
     */
    @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); // 获取第i项的Cursor
            if (c != null) {
                // 判断是否为笔记类型（TYPE_NOTE）
                if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
                    mNotesCount++; // 累计数量
                }
            } else {
                Log.e(TAG, "Invalid cursor");
                return;
            }
        }
    }
}