/*
 * 版权声明：2010-2011年，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，负责将数据库中的便签数据绑定到ListView上
 * 支持多选模式、数据筛选和小部件关联信息获取
 */
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;   // 小部件ID
        public int widgetType; // 小部件类型
    };

    /**
     * 构造函数
     * 初始化适配器，创建选中项索引映射表
     */
    public NotesListAdapter(Context context) {
        super(context, null);
        mSelectedIndex = new HashMap<Integer, Boolean>();
        mContext = context;
        mNotesCount = 0;
    }

    /**
     * 创建新视图
     * 当ListView需要创建新的便签项视图时调用
     */
    @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();
    }

    /**
     * 判断是否处于选择模式
     * @return 处于选择模式返回true，否则返回false
     */
    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);
                }
            }
        }
    }

    /**
     * 获取选中项的ID集合
     * @return 包含所有选中项ID的HashSet
     */
    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;
    }

    /**
     * 获取选中项关联的桌面小部件
     * @return 包含所有选中项关联小部件属性的HashSet
     */
    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);
                    /**
                     * 注意：不要在这里关闭cursor，只有适配器才能关闭它
                     */
                } else {
                    Log.e(TAG, "Invalid cursor");
                    return null;
                }
            }
        }
        return itemSet;
    }

    /**
     * 获取选中项数量
     * 统计选中项索引映射表中值为true的项数
     */
    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);
    }

    /**
     * 判断指定位置的项是否被选中
     * @return 选中返回true，否则返回false
     */
    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;
            }
        }
    }
}