/*
 * 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.
 */

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;

/**
 * FoldersListAdapter 类继承自 CursorAdapter，用于将数据库中的文件夹数据绑定到视图上。
 * CursorAdapter 是一个抽象类，用于将 Cursor 中的数据显示在 AdapterView 中。
 */
public class FoldersListAdapter extends CursorAdapter {

    // 定义从数据库中查询所需的列，这里查询了笔记的 ID 和摘要
    public static final String [] PROJECTION = {
        NoteColumns.ID,
        NoteColumns.SNIPPET
    };

    // 定义 PROJECTION 数组中 ID 列的索引
    public static final int ID_COLUMN   = 0;
    // 定义 PROJECTION 数组中名称列的索引
    public static final int NAME_COLUMN = 1;

    /**
     * 构造函数，初始化 FoldersListAdapter。
     * @param context 上下文对象，用于获取资源和服务
     * @param c 包含文件夹数据的 Cursor 对象
     */
    public FoldersListAdapter(Context context, Cursor c) {
        super(context, c);
        // TODO Auto-generated constructor stub
    }

    /**
     * 创建一个新的视图对象，用于显示 Cursor 中的数据。
     * 当 Adapter 需要创建一个新的视图来显示数据时，会调用此方法。
     * @param context 上下文对象
     * @param cursor 包含数据的 Cursor 对象
     * @param parent 新视图的父视图
     * @return 新创建的视图对象
     */
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        // 创建一个新的 FolderListItem 视图
        return new FolderListItem(context);
    }

    /**
     * 将 Cursor 中的数据绑定到已有的视图上。
     * 当 Adapter 需要更新一个已有的视图来显示新的数据时，会调用此方法。
     * @param view 要绑定数据的视图
     * @param context 上下文对象
     * @param cursor 包含数据的 Cursor 对象
     */
    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        // 检查视图是否为 FolderListItem 类型
        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 的 bind 方法，将文件夹名称绑定到视图上
            ((FolderListItem) view).bind(folderName);
        }
    }

    /**
     * 根据位置获取文件夹的名称。
     * @param context 上下文对象
     * @param position 要获取名称的文件夹的位置
     * @return 文件夹的名称
     */
    public String getFolderName(Context context, int position) {
        // 获取指定位置的 Cursor 对象
        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);
    }

    /**
     * FolderListItem 类继承自 LinearLayout，用于显示文件夹的名称。
     * 它是 FoldersListAdapter 中每个列表项的视图。
     */
    private class FolderListItem extends LinearLayout {
        // 用于显示文件夹名称的 TextView
        private TextView mName;

        /**
         * 构造函数，初始化 FolderListItem。
         * @param context 上下文对象
         */
        public FolderListItem(Context context) {
            super(context);
            // 加载布局文件 folder_list_item.xml 到当前视图
            inflate(context, R.layout.folder_list_item, this);
            // 查找布局文件中的 TextView 控件
            mName = (TextView) findViewById(R.id.tv_folder_name);
        }

        /**
         * 将文件夹名称绑定到 TextView 上。
         * @param name 文件夹的名称
         */
        public void bind(String name) {
            // 设置 TextView 的文本为文件夹名称
            mName.setText(name);
        }
    }

}