/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (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.view.View;
import android.view.ViewGroup;
import android.widget.CursorAdapter;
import android.widget.LinearLayout;
import android.widget.TextView;

import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;

/**
 * 文件夹列表适配器
 * 功能：将数据库中的文件夹数据绑定到ListView/RecyclerView中
 * 特点：支持自定义文件夹名称显示，特别是对根文件夹的特殊处理
 */
public class FoldersListAdapter extends CursorAdapter {
    // 数据库查询投影：指定要查询的列
    public static final String [] PROJECTION = {
        NoteColumns.ID,       // 文件夹ID
        NoteColumns.SNIPPET   // 文件夹名称(片段)
    };

    // 列索引常量，方便代码引用
    public static final int ID_COLUMN   = 0;    // ID列索引
    public static final int NAME_COLUMN = 1;    // 名称列索引

    /**
     * 构造函数
     * @param context 上下文对象
     * @param c 数据库游标，包含文件夹数据
     */
    public FoldersListAdapter(Context context, Cursor c) {
        super(context, c);
        // TODO Auto-generated constructor stub
    }

    /**
     * 创建新的列表项视图
     * @param context 上下文对象
     * @param cursor 当前数据游标
     * @param parent 父视图容器
     * @return 新创建的FolderListItem视图
     */
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        return new FolderListItem(context);
    }

    /**
     * 将数据绑定到已创建的视图
     * @param view 要绑定数据的视图
     * @param context 上下文对象
     * @param cursor 当前数据游标
     */
    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        if (view instanceof FolderListItem) {
            // 获取文件夹名称，特殊处理根文件夹
            String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? 
                    context.getString(R.string.menu_move_parent_folder) : // 根文件夹显示特定文本
                    cursor.getString(NAME_COLUMN);                        // 普通文件夹显示数据库名称
            
            // 绑定数据到视图
            ((FolderListItem) view).bind(folderName);
        }
    }

    /**
     * 获取指定位置的文件夹名称
     * @param context 上下文对象
     * @param position 列表位置
     * @return 文件夹名称
     */
    public String getFolderName(Context context, int position) {
        Cursor cursor = (Cursor) getItem(position);
        // 同样特殊处理根文件夹
        return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? 
                context.getString(R.string.menu_move_parent_folder) : 
                cursor.getString(NAME_COLUMN);
    }

    /**
     * 文件夹列表项内部类
     * 功能：定义单个文件夹项的UI布局和数据绑定逻辑
     */
    private class FolderListItem extends LinearLayout {
        // 文件夹名称显示文本视图
        private TextView mName;

        /**
         * 构造函数
         * @param context 上下文对象
         */
        public FolderListItem(Context context) {
            super(context);
            // 加载布局 文件
            inflate(context, R.layout.folder_list_item, this);
            // 获取并保存名称文本视图引用
            mName = (TextView) findViewById(R.id.tv_folder_name);
        }

        /**
         * 绑定文件夹名称到视图
         * @param name 文件夹名称
         */
        public void bind(String name) {
            mName.setText(name);
        }
    }
}