/*
 * 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;  
// 引入 Context 类，用于访问应用的环境、资源、启动活动等。
import android.database.Cursor;  
// 引入 Cursor 类，表示查询结果集，通常用于访问数据库中的记录。
import android.view.View;  
// 引入 View 类，所有 UI 控件的基类。
import android.view.ViewGroup;  
// 引入 ViewGroup 类，表示可以包含其他视图的容器类。
import android.widget.CursorAdapter; 
 // 引入 CursorAdapter 类，用于绑定数据库查询结果与 UI 元素。
import android.widget.LinearLayout;  
// 引入 LinearLayout 类，线性布局容器，用于按顺序排列视图。
import android.widget.TextView;  
// 引入 TextView 类，用于显示文本。

import net.micode.notes.R;  
// 引入 R 类，自动生成的资源类，访问应用的资源（如字符串、布局、ID 等）。
import net.micode.notes.data.Notes; 
 // 引入 Notes 类，表示笔记相关的数据模型。
import net.micode.notes.data.Notes.NoteColumns; 
 // 引入 NoteColumns 类，表示与笔记相关的数据库字段。

// FoldersListAdapter 类是一个自定义的 CursorAdapter，用于展示文件夹列表。
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;  // 文件夹名称列索引

    // 构造函数，接收 Context 和 Cursor，传递给父类的构造函数。
    public FoldersListAdapter(Context context, Cursor c) {
        super(context, c);  // 调用父类 CursorAdapter 的构造函数
    }

    // newView 方法负责创建新的视图（即每一行的数据项）。
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        return new FolderListItem(context);  
        // 返回一个新的 FolderListItem 视图（表示文件夹项）。
    }

    // bindView 方法负责绑定数据到视图上，通常是处理显示和数据的绑定。
    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        if (view instanceof FolderListItem) {  
            // 确保视图是 FolderListItem 类型
            // 获取文件夹的名称。如果是根文件夹，则显示特定的名称（菜单中的 "父文件夹"），否则显示文件夹名称。
            String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) 
                ? context.getString(R.string.menu_move_parent_folder) 
                : cursor.getString(NAME_COLUMN);
            
            // 将获取的名称绑定到 FolderListItem 中
            ((FolderListItem) view).bind(folderName);
        }
    }

    // getFolderName 方法用于根据位置获取文件夹名称。
    public String getFolderName(Context context, int position) {
        Cursor cursor = (Cursor) getItem(position); 
         // 获取指定位置的 Cursor 数据
        // 根据文件夹的 ID 返回对应的名称
        return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) 
            ? context.getString(R.string.menu_move_parent_folder) 
            : cursor.getString(NAME_COLUMN);
    }

    // FolderListItem 类表示文件夹列表项的视图，它是一个 LinearLayout。
    private class FolderListItem extends LinearLayout {
        private TextView mName;  
        // 用于显示文件夹名称的 TextView 控件。

        // FolderListItem 的构造函数，初始化视图和控件。
        public FolderListItem(Context context) {
            super(context);
            inflate(context, R.layout.folder_list_item, this); 
             // 加载 folder_list_item 布局文件
            mName = (TextView) findViewById(R.id.tv_folder_name); 
             // 获取文件夹名称显示控件
        }

        // bind 方法用于将文件夹名称绑定到 TextView 上。
        public void bind(String name) {
            mName.setText(name);  // 设置文件夹名称
        }
    }
}