/*
 * 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.app.Activity;
import android.app.AlertDialog;
import android.app.Dialog;
import android.appwidget.AppWidgetManager;
import android.content.AsyncQueryHandler;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.content.Context;
import android.content.DialogInterface;
import android.content.Intent;
import android.content.SharedPreferences;
import android.database.Cursor;
import android.os.AsyncTask;
import android.os.Bundle;
import android.preference.PreferenceManager;
import android.text.Editable;
import android.text.TextUtils;
import android.text.TextWatcher;
import android.util.Log;
import android.view.ActionMode;
import android.view.ContextMenu;
import android.view.ContextMenu.ContextMenuInfo;
import android.view.Display;
import android.view.HapticFeedbackConstants;
import android.view.LayoutInflater;
import android.view.Menu;
import android.view.MenuItem;
import android.view.MenuItem.OnMenuItemClickListener;
import android.view.MotionEvent;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.View.OnCreateContextMenuListener;
import android.view.View.OnTouchListener;
import android.view.inputmethod.InputMethodManager;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.AdapterView.OnItemLongClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ListView;
import android.widget.PopupMenu;
import android.widget.TextView;
import android.widget.Toast;

import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.gtask.remote.GTaskSyncService;
import net.micode.notes.model.WorkingNote;
import net.micode.notes.tool.BackupUtils;
import net.micode.notes.tool.DataUtils;
import net.micode.notes.tool.ResourceParser;
import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
import net.micode.notes.widget.NoteWidgetProvider_2x;
import net.micode.notes.widget.NoteWidgetProvider_4x;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.HashSet;

/**
 * 笔记列表活动类，负责展示笔记和文件夹列表，处理用户交互（如新建、删除、移动笔记等）
 * 实现了列表项点击、长按等事件处理接口
 */
public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
    private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;  // 文件夹笔记列表查询标记
    private static final int FOLDER_LIST_QUERY_TOKEN      = 1;  // 文件夹列表查询标记
    private static final int MENU_FOLDER_DELETE = 0;       // 文件夹删除菜单项ID
    private static final int MENU_FOLDER_VIEW = 1;         // 文件夹查看菜单项ID
    private static final int MENU_FOLDER_CHANGE_NAME = 2;  // 文件夹重命名菜单项ID
    private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction"; // 首次使用引导标记的SharedPreferences键

    /**
     * 列表编辑状态枚举：
     * NOTE_LIST - 根笔记列表状态
     * SUB_FOLDER - 子文件夹状态
     * CALL_RECORD_FOLDER - 通话记录文件夹状态
     */
    private enum ListEditState {
        NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER
    };

    private ListEditState mState; // 当前列表编辑状态
    private BackgroundQueryHandler mBackgroundQueryHandler; // 后台查询处理器，用于异步数据库查询
    private NotesListAdapter mNotesListAdapter; // 笔记列表适配器
    private ListView mNotesListView; // 笔记列表视图
    private Button mAddNewNote; // 新建笔记按钮
    private boolean mDispatch; // 触摸事件分发标记
    private int mOriginY; // 触摸事件原始Y坐标
    private int mDispatchY; // 分发事件的Y坐标
    private TextView mTitleBar; // 标题栏文本视图
    private long mCurrentFolderId; // 当前文件夹ID，默认根文件夹
    private ContentResolver mContentResolver; // 内容解析器，用于操作数据提供者
    private ModeCallback mModeCallBack; // 多选模式回调处理器
    private static final String TAG = "NotesListActivity"; // 日志标签
    public static final int NOTES_LISTVIEW_SCROLL_RATE = 30; // 列表滚动速率
    private NoteItemData mFocusNoteDataItem; // 当前聚焦的笔记/文件夹数据项

    // 查询条件常量
    private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?"; // 普通查询：子项属于某个父文件夹
    private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>"
            + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR ("
            + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND "
            + NoteColumns.NOTES_COUNT + ">0)"; // 根文件夹查询：排除系统类型或包含有内容的通话记录文件夹

    private final static int REQUEST_CODE_OPEN_NODE = 102; // 打开节点（笔记/文件夹）请求码
    private final static int REQUEST_CODE_NEW_NODE  = 103; // 新建节点请求码

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.note_list); // 加载笔记列表布局
        initResources(); // 初始化资源和视图组件

        /**
         * 首次使用应用时插入引导笔记
         */
        setAppInfoFromRawRes(); // 从原始资源读取引导内容并保存为笔记
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        // 处理子活动返回结果，刷新列表数据
        if (resultCode == RESULT_OK
                && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {
            mNotesListAdapter.changeCursor(null); // 刷新适配器数据
        } else {
            super.onActivityResult(requestCode, resultCode, data);
        }
    }

    /**
     * 从原始资源文件读取引导内容并保存为笔记
     */
    private void setAppInfoFromRawRes() {
        SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
        // 检查是否已显示过引导
        if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
            StringBuilder sb = new StringBuilder();
            InputStream in = null;
            try {
                // 打开引导内容资源文件
                in = getResources().openRawResource(R.raw.introduction);
                if (in != null) {
                    // 读取文本内容
                    InputStreamReader isr = new InputStreamReader(in);
                    BufferedReader br = new BufferedReader(isr);
                    char [] buf = new char[1024];
                    int len = 0;
                    while ((len = br.read(buf)) > 0) {
                        sb.append(buf, 0, len);
                    }
                } else {
                    Log.e(TAG, "Read introduction file error");
                    return;
                }
            } catch (IOException e) {
                e.printStackTrace();
                return;
            } finally {
                // 关闭输入流
                if(in != null) {
                    try {
                        in.close();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
            }

            // 创建引导笔记并保存
            WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER,
                    AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE,
                    ResourceParser.RED);
            note.setWorkingText(sb.toString());
            if (note.saveNote()) {
                // 标记已显示引导
                sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit();
            } else {
                Log.e(TAG, "Save introduction note error");
                return;
            }
        }
    }

    @Override
    protected void onStart() {
        super.onStart();
        startAsyncNotesListQuery(); // 启动异步查询加载笔记列表数据
    }

    /**
     * 初始化资源和视图组件
     */
    private void initResources() {
        mContentResolver = this.getContentResolver(); // 获取内容解析器
        mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver()); // 创建后台查询处理器
        mCurrentFolderId = Notes.ID_ROOT_FOLDER; // 默认显示根文件夹
        mNotesListView = (ListView) findViewById(R.id.notes_list); // 获取列表视图
        // 添加列表页脚视图
        mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null),
                null, false);
        // 设置列表项点击监听器
        mNotesListView.setOnItemClickListener(new OnListItemClickListener());
        // 设置列表项长按监听器（当前活动自身处理）
        mNotesListView.setOnItemLongClickListener(this);
        mNotesListAdapter = new NotesListAdapter(this); // 创建列表适配器
        mNotesListView.setAdapter(mNotesListAdapter); // 设置适配器
        mAddNewNote = (Button) findViewById(R.id.btn_new_note); // 获取新建笔记按钮
        mAddNewNote.setOnClickListener(this); // 设置点击监听器
        mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener()); // 设置触摸事件监听器，处理透明区域点击分发
        mDispatch = false; // 初始化事件分发标记
        mDispatchY = 0;
        mOriginY = 0;
        mTitleBar = (TextView) findViewById(R.id.tv_title_bar); // 获取标题栏视图
        mState = ListEditState.NOTE_LIST; // 初始状态为根笔记列表
        mModeCallBack = new ModeCallback(); // 创建多选模式回调对象
    }

    /**
     * 多选模式回调处理类，实现ListView.MultiChoiceModeListener和菜单项点击处理
     */
    private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {
        private DropdownMenu mDropDownMenu; // 下拉菜单组件
        private ActionMode mActionMode; // 多选模式操作栏

        /**
         * 创建多选模式操作栏时调用，加载菜单布局并设置菜单项点击监听器
         */
        public boolean onCreateActionMode(ActionMode mode, Menu menu) {
            getMenuInflater().inflate(R.menu.note_list_options, menu); // 加载操作栏菜单布局
            menu.findItem(R.id.delete).setOnMenuItemClickListener(this); // 设置删除菜单项点击监听器
            mMoveMenu = menu.findItem(R.id.move); // 获取移动菜单项

            // 根据当前文件夹类型和用户文件夹数量判断移动菜单项是否可见
            if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER
                    || DataUtils.getUserFolderCount(mContentResolver) == 0) {
                mMoveMenu.setVisible(false);
            } else {
                mMoveMenu.setVisible(true);
                mMoveMenu.setOnMenuItemClickListener(this); // 设置移动菜单项点击监听器
            }

            mActionMode = mode; // 保存操作栏实例
            mNotesListAdapter.setChoiceMode(true); // 启用列表项多选模式
            mNotesListView.setLongClickable(false); // 禁用长按事件（避免与多选模式冲突）
            mAddNewNote.setVisibility(View.GONE); // 隐藏新建笔记按钮

            // 设置操作栏自定义视图（下拉菜单）
            View customView = LayoutInflater.from(NotesListActivity.this).inflate(
                    R.layout.note_list_dropdown_menu, null);
            mode.setCustomView(customView);
            mDropDownMenu = new DropdownMenu(NotesListActivity.this,
                    (Button) customView.findViewById(R.id.selection_menu),
                    R.menu.note_list_dropdown);
            // 设置下拉菜单点击监听器（全选/反选）
            mDropDownMenu.setOnDropdownMenuItemClickListener(new PopupMenu.OnMenuItemClickListener(){
                public boolean onMenuItemClick(MenuItem item) {
                    mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected()); // 切换全选状态
                    updateMenu(); // 更新菜单显示
                    return true;
                }
            });
            return true;
        }

        /**
         * 更新菜单显示状态（选中项数量、全选/反选文本）
         */
        private void updateMenu() {
            int selectedCount = mNotesListAdapter.getSelectedCount(); // 获取选中项数量
            // 更新下拉菜单标题
            String format = getResources().getString(R.string.menu_select_title, selectedCount);
            mDropDownMenu.setTitle(format);
            // 更新全选菜单项状态
            MenuItem item = mDropDownMenu.findItem(R.id.action_select_all);
            if (item != null) {
                if (mNotesListAdapter.isAllSelected()) {
                    item.setChecked(true);
                    item.setTitle(R.string.menu_deselect_all); // 显示反选文本
                } else {
                    item.setChecked(false);
                    item.setTitle(R.string.menu_select_all); // 显示全选文本
                }
            }
        }

        // 以下为ListView.MultiChoiceModeListener接口的默认实现（未使用的方法）
        public boolean onPrepareActionMode(ActionMode mode, Menu menu) { return false; }
        public boolean onActionItemClicked(ActionMode mode, MenuItem item) { return false; }
        public void onDestroyActionMode(ActionMode mode) {
            // 销毁操作栏时恢复列表状态
            mNotesListAdapter.setChoiceMode(false); // 禁用多选模式
            mNotesListView.setLongClickable(true); // 重新启用长按事件
            mAddNewNote.setVisibility(View.VISIBLE); // 显示新建笔记按钮
        }
        public void finishActionMode() { mActionMode.finish(); } // 结束操作栏

        /**
         * 列表项选中状态变化时调用，更新选中状态和菜单显示
         */
        public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked) {
            mNotesListAdapter.setCheckedItem(position, checked); // 更新适配器中的选中状态
            updateMenu(); // 更新菜单显示
        }

        /**
         * 处理操作栏菜单项点击事件（删除、移动）
         */
        public boolean onMenuItemClick(MenuItem item) {
            if (mNotesListAdapter.getSelectedCount() == 0) {
                // 无选中项时提示用户
                Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
                        Toast.LENGTH_SHORT).show();
                return true;
            }

            switch (item.getItemId()) {
                case R.id.delete: // 删除菜单项
                    // 显示删除确认对话框
                    AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
                    builder.setTitle(getString(R.string.alert_title_delete));
                    builder.setIcon(android.R.drawable.ic_dialog_alert);
                    builder.setMessage(getString(R.string.alert_message_delete_notes,
                            mNotesListAdapter.getSelectedCount())); // 显示删除数量提示
                    builder.setPositiveButton(android.R.string.ok,
                            new DialogInterface.OnClickListener() {
                                public void onClick(DialogInterface dialog, int which) {
                                    batchDelete(); // 执行批量删除操作
                                }
                            });
                    builder.setNegativeButton(android.R.string.cancel, null);
                    builder.show();
                    break;
                case R.id.move: // 移动菜单项
                    startQueryDestinationFolders(); // 启动目标文件夹查询
                    break;
                default:
                    return false;
            }
            return true;
        }
    }

    /**
     * 新建笔记按钮触摸事件监听器，处理透明区域的事件分发
     */
    private class NewNoteOnTouchListener implements OnTouchListener {

        public boolean onTouch(View v, MotionEvent event) {
            switch (event.getAction()) {
                case MotionEvent.ACTION_DOWN: { // 按下事件
                    Display display = getWindowManager().getDefaultDisplay();
                    int screenHeight = display.getHeight();
                    int newNoteViewHeight = mAddNewNote.getHeight();
                    int start = screenHeight - newNoteViewHeight; // 按钮底部Y坐标
                    int eventY = start + (int) event.getY(); // 事件在屏幕中的Y坐标

                    // 根据当前状态调整坐标（子文件夹状态需减去标题栏高度）
                    if (mState == ListEditState.SUB_FOLDER) {
                        eventY -= mTitleBar.getHeight();
                        start -= mTitleBar.getHeight();
                    }

                    /**
                     * 处理按钮透明区域的点击事件分发：
                     * 透明区域由公式 y = -0.12x + 94（基于按钮左顶点的坐标系统）和按钮顶部边界定义
                     * 当点击位置在透明区域内时，将事件分发到列表视图以触发滚动或点击操作
                     */
                    if (event.getY() < (event.getX() * (-0.12) + 94)) {
                        View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1
                                - mNotesListView.getFooterViewsCount()); // 获取最后一个可见列表项
                        if (view != null && view.getBottom() > start && (view.getTop() < (start + 94))) {
                            // 保存原始坐标并调整事件坐标，触发列表视图的事件分发
                            mOriginY = (int) event.getY();
                            mDispatchY = eventY;
                            event.setLocation(event.getX(), mDispatchY);
                            mDispatch = true;
                            return mNotesListView.dispatchTouchEvent(event);
                        }
                    }
                    break;
                }
                case MotionEvent.ACTION_MOVE: { // 移动事件，继续分发
                    if (mDispatch) {
                        mDispatchY += (int) event.getY() - mOriginY; // 更新分发坐标
                        event.setLocation(event.getX(), mDispatchY);
                        return mNotesListView.dispatchTouchEvent(event);
                    }
                    break;
                }
                default: { // 其他事件（抬起、取消等），结束分发
                    if (mDispatch) {
                        event.setLocation(event.getX(), mDispatchY);
                        mDispatch = false;
                        return mNotesListView.dispatchTouchEvent(event);
                    }
                    break;
                }
            }
            return false;
        }

    };

    /**
     * 启动异步查询加载笔记列表数据
     */
    private void startAsyncNotesListQuery() {
        // 根据当前文件夹ID构建查询条件
        String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION
                : NORMAL_SELECTION;
        // 执行异步查询（背景线程处理数据库操作）
        mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null,
                Notes.CONTENT_NOTE_URI, NoteItemData.PROJECTION, selection, new String[] {
                        String.valueOf(mCurrentFolderId)
                }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC"); // 按类型降序、修改时间降序排序
    }

    /**
     * 后台查询处理器，处理查询结果回调
     */
    private final class BackgroundQueryHandler extends AsyncQueryHandler {
        public BackgroundQueryHandler(ContentResolver contentResolver) {
            super(contentResolver);
        }

        @Override
        protected void onQueryComplete(int token, Object cookie, Cursor cursor) {
            switch (token) {
                case FOLDER_NOTE_LIST_QUERY_TOKEN: // 笔记列表查询结果
                    mNotesListAdapter.changeCursor(cursor); // 更新适配器数据
                    break;
                case FOLDER_LIST_QUERY_TOKEN: // 文件夹列表查询结果
                    if (cursor != null && cursor.getCount() > 0) {
                        showFolderListMenu(cursor); // 显示目标文件夹选择菜单
                    } else {
                        Log.e(TAG, "Query folder failed");
                    }
                    break;
                default:
                    return;
            }
        }
    }

    /**
     * 显示目标文件夹选择菜单，用于移动笔记操作
     */
    private void showFolderListMenu(Cursor cursor) {
        AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
        builder.setTitle(R.string.menu_title_select_folder); // 设置对话框标题
        final FoldersListAdapter adapter = new FoldersListAdapter(this, cursor); // 创建文件夹列表适配器
        // 设置列表项点击监听器（执行移动操作）
        builder.setAdapter(adapter, new DialogInterface.OnClickListener() {
            public void onClick(DialogInterface dialog, int which) {
                // 批量移动选中笔记到目标文件夹
                DataUtils.batchMoveToFolder(mContentResolver,
                        mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which));
                // 显示成功提示
                Toast.makeText(
                        NotesListActivity.this,
                        getString(R.string.format_move_notes_to_folder,
                                mNotesListAdapter.getSelectedCount(),
                                adapter.getFolderName(NotesListActivity.this, which)),
                        Toast.LENGTH_SHORT).show();
                mModeCallBack.finishActionMode(); // 结束多选模式
            }
        });
        builder.show(); // 显示对话框
    }

    /**
     * 创建新笔记，启动笔记编辑活动
     */
    private void createNewNote() {
        Intent intent = new Intent(this, NoteEditActivity.class);
        intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 操作类型：插入或编辑
        intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mCurrentFolderId); // 传递当前文件夹ID
        this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE); // 启动活动并等待结果
    }

    /**
     * 批量删除选中的笔记或文件夹（异步任务处理）
     */
    private void batchDelete() {
        new AsyncTask<Void, Void, HashSet<AppWidgetAttribute>>() {
            /**
             * 后台执行删除操作，返回关联的桌面小部件信息
             */
            protected HashSet<AppWidgetAttribute> doInBackground(Void... unused) {
                HashSet<AppWidgetAttribute> widgets = mNotesListAdapter.getSelectedWidget(); // 获取选中项关联的小部件

                if (!isSyncMode()) {
                    // 非同步模式：直接删除
                    if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter
                            .getSelectedItemIds())) {
                    } else {
                        Log.e(TAG, "Delete notes error, should not happens");
                    }
                } else {
                    // 同步模式：移动到回收站文件夹
                    if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter
                            .getSelectedItemIds(), Notes.ID_TRASH_FOLER)) {
                        Log.e(TAG, "Move notes to trash folder error, should not happens");
                    }
                }
                return widgets;
            }

            /**
             * 处理删除后的操作（更新小部件）
             */
            @Override
            protected void onPostExecute(HashSet<AppWidgetAttribute> widgets) {
                if (widgets != null) {
                    // 遍历更新所有关联的桌面小部件
                    for (AppWidgetAttribute widget : widgets) {
                        if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                                && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
                            updateWidget(widget.widgetId, widget.widgetType); // 更新小部件显示
                        }
                    }
                }
                mModeCallBack.finishActionMode(); // 结束多选模式
            }
        }.execute();
    }

    /**
     * 删除指定文件夹（包括其下所有内容）
     */
    private void deleteFolder(long folderId) {
        if (folderId == Notes.ID_ROOT_FOLDER) {
            // 不能删除根文件夹
            Log.e(TAG, "Wrong folder id, should not happen " + folderId);
            return;
        }

        HashSet<Long> ids = new HashSet<Long>();
        ids.add(folderId); // 添加要删除的文件夹ID
        // 获取文件夹内笔记关联的小部件
        HashSet<AppWidgetAttribute> widgets = DataUtils.getFolderNoteWidget(mContentResolver,
                folderId);

        if (!isSyncMode()) {
            // 非同步模式：直接删除
            DataUtils.batchDeleteNotes(mContentResolver, ids);
        } else {
            // 同步模式：移动到回收站
            DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER);
        }

        if (widgets != null) {
            // 更新关联的小部件
            for (AppWidgetAttribute widget : widgets) {
                if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                        && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
                    updateWidget(widget.widgetId, widget.widgetType);
                }
            }
        }
    }

    /**
     * 打开笔记节点（查看或编辑笔记）
     */
    private void openNode(NoteItemData data) {
        Intent intent = new Intent(this, NoteEditActivity.class);
        intent.setAction(Intent.ACTION_VIEW); // 操作类型：查看
        intent.putExtra(Intent.EXTRA_UID, data.getId()); // 传递笔记ID
        this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE); // 启动活动并等待结果
    }

    /**
     * 打开文件夹，切换到子文件夹视图
     */
    private void openFolder(NoteItemData data) {
        mCurrentFolderId = data.getId(); // 更新当前文件夹ID
        startAsyncNotesListQuery(); // 加载子文件夹内容

        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
            mState = ListEditState.CALL_RECORD_FOLDER; // 设置为通话记录文件夹状态
            mAddNewNote.setVisibility(View.GONE); // 隐藏新建笔记按钮
        } else {
            mState = ListEditState.SUB_FOLDER; // 设置为子文件夹状态
        }

        // 更新标题栏显示
        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
            mTitleBar.setText(R.string.call_record_folder_name); // 通话记录文件夹标题
        } else {
            mTitleBar.setText(data.getSnippet()); // 显示文件夹名称
        }
        mTitleBar.setVisibility(View.VISIBLE); // 显示标题栏
    }

    /**
     * 视图点击事件处理（主要处理新建笔记按钮点击）
     */
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_new_note: // 新建笔记按钮
                createNewNote(); // 调用新建笔记方法
                break;
            default:
                break;
        }
    }

    /**
     * 显示软键盘
     */
    private void showSoftInput() {
        InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
        if (inputMethodManager != null) {
            inputMethodManager.toggleSoftInput(InputMethodManager.SHOW_FORCED, 0); // 强制显示软键盘
        }
    }

    /**
     * 隐藏软键盘
     */
    private void hideSoftInput(View view) {
        InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
        inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0); // 隐藏指定视图的软键盘
    }

    /**
     * 显示创建或修改文件夹对话框
     * @param create 是否为创建模式（true=创建新文件夹，false=修改现有文件夹）
     */
    private void showCreateOrModifyFolderDialog(final boolean create) {
        final AlertDialog.Builder builder = new AlertDialog.Builder(this);
        View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null); // 加载输入对话框布局
        final EditText etName = (EditText) view.findViewById(R.id.et_foler_name); // 获取名称输入框
        showSoftInput(); // 显示软键盘

        if (!create) {
            // 修改模式：填充现有文件夹名称
            if (mFocusNoteDataItem != null) {
                etName.setText(mFocusNoteDataItem.getSnippet());
                builder.setTitle(getString(R.string.menu_folder_change_name)); // 设置标题为"重命名"
            } else {
                Log.e(TAG, "The long click data item is null");
                return;
            }
        } else {
            // 创建模式：清空输入框
            etName.setText("");
            builder.setTitle(this.getString(R.string.menu_create_folder)); // 设置标题为"新建文件夹"
        }

        builder.setPositiveButton(android.R.string.ok, null); // 初始时不设置点击监听器，防止空值提交
        builder.setNegativeButton(android.R.string.cancel, new DialogInterface.OnClickListener() {
            public void onClick(DialogInterface dialog, int which) {
                hideSoftInput(etName); // 隐藏软键盘
            }
        });

        final Dialog dialog = builder.setView(view).show(); // 显示对话框
        final Button positive = (Button)dialog.findViewById(android.R.id.button1); // 获取确定按钮

        // 确定按钮点击监听器（处理名称验证和保存）
        positive.setOnClickListener(new OnClickListener() {
            public void onClick(View v) {
                hideSoftInput(etName); // 隐藏软键盘
                String name = etName.getText().toString(); // 获取输入的名称

                // 检查文件夹名称是否已存在
                if (DataUtils.checkVisibleFolderName(mContentResolver, name)) {
                    Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name),
                            Toast.LENGTH_LONG).show();
                    etName.setSelection(0, etName.length()); // 选中全部文本以便修改
                    return;
                }

                if (!create) {
                    // 修改模式：更新文件夹名称
                    if (!TextUtils.isEmpty(name)) {
                        ContentValues values = new ContentValues();
                        values.put(NoteColumns.SNIPPET, name); // 设置新名称
                        values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER); // 类型为文件夹
                        values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记本地修改
                        mContentResolver.update(Notes.CONTENT_NOTE_URI, values, NoteColumns.ID
                                + "=?", new String[] {
                                String.valueOf(mFocusNoteDataItem.getId())
                        });
                    }
                } else if (!TextUtils.isEmpty(name)) {
                    // 创建模式：插入新文件夹
                    ContentValues values = new ContentValues();
                    values.put(NoteColumns.SNIPPET, name);
                    values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
                    mContentResolver.insert(Notes.CONTENT_NOTE_URI, values); // 插入到内容提供者
                }
                dialog.dismiss(); // 关闭对话框
            }
        });

        // 输入框内容变化监听器（控制确定按钮是否可用）
        if (TextUtils.isEmpty(etName.getText())) {
            positive.setEnabled(false);
        }
        etName.addTextChangedListener(new TextWatcher() {
            public void beforeTextChanged(CharSequence s, int start, int count, int after) {}

            public void onTextChanged(CharSequence s, int start, int before, int count) {
                positive.setEnabled(!TextUtils.isEmpty(etName.getText())); // 非空时启用按钮
            }

            public void afterTextChanged(Editable s) {}
        });
    }

    @Override
    public void onBackPressed() {
        // 处理返回键逻辑，根据当前状态切换视图
        switch (mState) {
            case SUB_FOLDER: // 子文件夹状态：返回根目录
                mCurrentFolderId = Notes.ID_ROOT_FOLDER;
                mState = ListEditState.NOTE_LIST;
                startAsyncNotesListQuery(); // 重新加载根目录内容
                mTitleBar.setVisibility(View.GONE); // 隐藏标题栏
                break;
            case CALL_RECORD_FOLDER: // 通话记录文件夹状态：返回根目录
                mCurrentFolderId = Notes.ID_ROOT_FOLDER;
                mState = ListEditState.NOTE_LIST;
                mAddNewNote.setVisibility(View.VISIBLE); // 显示新建按钮
                mTitleBar.setVisibility(View.GONE);
                startAsyncNotesListQuery();
                break;
            case NOTE_LIST: // 根目录状态：调用系统返回逻辑
                super.onBackPressed();
                break;
            default:
                break;
        }
    }

    /**
     * 更新桌面小部件显示
     * @param appWidgetId 小部件ID
     * @param appWidgetType 小部件类型（2x或4x）
     */
    private void updateWidget(int appWidgetId, int appWidgetType) {
        Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); // 小部件更新意图

        // 根据类型设置目标组件
        if (appWidgetType == Notes.TYPE_WIDGET_2X) {
            intent.setClass(this, NoteWidgetProvider_2x.class);
        } else if (appWidgetType == Notes.TYPE_WIDGET_4X) {
            intent.setClass(this, NoteWidgetProvider_4x.class);
        } else {
            Log.e(TAG, "Unspported widget type");
            return;
        }

        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] { appWidgetId }); // 传递小部件ID
        sendBroadcast(intent); // 发送广播更新小部件
        setResult(RESULT_OK, intent); // 设置活动结果
    }

    /**
     * 文件夹长按上下文菜单创建监听器
     */
    private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() {
        public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
            if (mFocusNoteDataItem != null) {
                // 设置菜单标题为文件夹名称
                menu.setHeaderTitle(mFocusNoteDataItem.getSnippet());
                // 添加查看、删除、重命名菜单项
                menu.add(0, MENU_FOLDER_VIEW, 0, R.string.menu_folder_view);
                menu.add(0, MENU_FOLDER_DELETE, 0, R.string.menu_folder_delete);
                menu.add(0, MENU_FOLDER_CHANGE_NAME, 0, R.string.menu_folder_change_name);
            }
        }
    };

    @Override
    public void onContextMenuClosed(Menu menu) {
        if (mNotesListView != null) {
            mNotesListView.setOnCreateContextMenuListener(null); // 清除上下文菜单监听器
        }
        super.onContextMenuClosed(menu);
    }

    @Override
    public boolean onContextItemSelected(MenuItem item) {
        if (mFocusNoteDataItem == null) {
            Log.e(TAG, "The long click data item is null");
            return false;
        }
        // 处理上下文菜单项点击事件（查看、删除、重命名文件夹）
        switch (item.getItemId()) {
            case MENU_FOLDER_VIEW: // 查看文件夹
                openFolder(mFocusNoteDataItem);
                break;
            case MENU_FOLDER_DELETE: // 删除文件夹
                // 显示删除确认对话框
                AlertDialog.Builder builder = new AlertDialog.Builder(this);
                builder.setTitle(getString(R.string.alert_title_delete));
                builder.setIcon(android.R.drawable.ic_dialog_alert);
                builder.setMessage(getString(R.string.alert_message_delete_folder)); // 删除文件夹提示
                builder.setPositiveButton(android.R.string.ok,
                        new DialogInterface.OnClickListener() {
                            public void onClick(DialogInterface dialog, int which) {
                                deleteFolder(mFocusNoteDataItem.getId()); // 执行删除操作
                            }
                        });
                builder.setNegativeButton(android.R.string.cancel, null);
                builder.show();
                break;
            case MENU_FOLDER_CHANGE_NAME: // 重命名文件夹
                showCreateOrModifyFolderDialog(false); // 显示修改对话框
                break;
            default:
                break;
        }
        return true;
    }

    @Override
    public boolean onPrepareOptionsMenu(Menu menu) {
        menu.clear(); // 清空菜单
        // 根据当前状态加载不同的菜单布局
        if (mState == ListEditState.NOTE_LIST) {
            getMenuInflater().inflate(R.menu.note_list, menu); // 根目录菜单
            // 更新同步菜单项文本（显示"同步"或"取消同步"）
            menu.findItem(R.id.menu_sync).setTitle(
                    GTaskSyncService.isSyncing() ? R.string.menu_sync_cancel : R.string.menu_sync);
        } else if (mState == ListEditState.SUB_FOLDER) {
            getMenuInflater().inflate(R.menu.sub_folder, menu); // 子文件夹菜单
        } else if (mState == ListEditState.CALL_RECORD_FOLDER) {
            getMenuInflater().inflate(R.menu.call_record_folder, menu); // 通话记录文件夹菜单
        } else {
            Log.e(TAG, "Wrong state:" + mState);
        }
        return true;
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        // 处理选项菜单点击事件
        switch (item.getItemId()) {
            case R.id.menu_new_folder: { // 新建文件夹
                showCreateOrModifyFolderDialog(true); // 显示创建对话框
                break;
            }
            case R.id.menu_export_text: { // 导出笔记为文本
                exportNoteToText(); // 执行导出操作
                break;
            }
            case R.id.menu_sync: { // 同步操作
                if (isSyncMode()) {
                    // 根据当前同步状态切换操作（开始/取消同步）
                    if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {
                        GTaskSyncService.startSync(this);
                    } else {
                        GTaskSyncService.cancelSync(this);
                    }
                } else {
                    startPreferenceActivity(); // 启动设置活动配置同步账户
                }
                break;
            }
            case R.id.menu_setting: { // 打开设置
                startPreferenceActivity();
                break;
            }
            case R.id.menu_new_note: { // 新建笔记（选项菜单中的入口）
                createNewNote();
                break;
            }
            case R.id.menu_search: // 搜索笔记
                onSearchRequested();
                break;
            default:
                break;
        }
        return true;
    }

    @Override
    public boolean onSearchRequested() {
        startSearch(null, false, null /* appData */, false); // 启动系统搜索功能
        return true;
    }

    /**
     * 导出笔记为文本文件（异步任务处理）
     */
    private void exportNoteToText() {
        final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this); // 获取备份工具实例
        new AsyncTask<Void, Void, Integer>() {

            @Override
            protected Integer doInBackground(Void... unused) {
                return backup.exportToText(); // 执行导出操作并返回状态码
            }

            @Override
            protected void onPostExecute(Integer result) {
                // 根据导出结果显示相应提示对话框
                if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {
                    showExportResultDialog(R.string.failed_sdcard_export, R.string.error_sdcard_unmounted);
                } else if (result == BackupUtils.STATE_SUCCESS) {
                    showExportResultDialog(R.string.success_sdcard_export,
                            getString(R.string.format_exported_file_location, backup
                                    .getExportedTextFileName(), backup.getExportedTextFileDir()));
                } else if (result == BackupUtils.STATE_SYSTEM_ERROR) {
                    showExportResultDialog(R.string.failed_sdcard_export, R.string.error_sdcard_export);
                }
            }

            /**
             * 显示导出结果提示对话框的辅助方法
             */
            private void showExportResultDialog(int titleResId, int messageResId) {
                AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
                builder.setTitle(titleResId);
                builder.setMessage(messageResId);
                builder.setPositiveButton(android.R.string.ok, null);
                builder.show();
            }
        }.execute();
    }

    /**
     * 判断是否处于同步模式（已配置同步账户）
     */
    private boolean isSyncMode() {
        return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
    }

    /**
     * 启动设置活动（偏好设置）
     */
    private void startPreferenceActivity() {
        Activity from = getParent() != null ? getParent() : this;
        Intent intent = new Intent(from, NotesPreferenceActivity.class);
        from.startActivityIfNeeded(intent, -1); // 启动活动（如需）
    }

    /**
     * 列表项点击事件监听器（处理普通点击事件）
     */
    private class OnListItemClickListener implements OnItemClickListener {

        public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
            if (view instanceof NotesListItem) {
                NoteItemData item = ((NotesListItem) view).getItemData(); // 获取点击的列表项数据

                if (mNotesListAdapter.isInChoiceMode()) {
                    // 多选模式下处理选中状态切换（仅针对笔记项）
                    if (item.getType() == Notes.TYPE_NOTE) {
                        position = position - mNotesListView.getHeaderViewsCount(); // 计算适配器中的真实位置
                        mModeCallBack.onItemCheckedStateChanged(null, position, id,
                                !mNotesListAdapter.isSelectedItem(position)); // 更新选中状态
                    }
                    return;
                }

                // 根据当前状态处理不同类型的列表项点击
                switch (mState) {
                    case NOTE_LIST: // 根目录状态
                        if (item.getType() == Notes.TYPE_FOLDER || item.getType() == Notes.TYPE_SYSTEM) {
                            openFolder(item); // 打开文件夹
                        } else if (item.getType() == Notes.TYPE_NOTE) {
                            openNode(item); // 打开笔记
                        } else {
                            Log.e(TAG, "Wrong note type in NOTE_LIST");
                        }
                        break;
                    case SUB_FOLDER: // 子文件夹状态
                    case CALL_RECORD_FOLDER: // 通话记录文件夹状态
                        if (item.getType() == Notes.TYPE_NOTE) {
                            openNode(item); // 打开笔记
                        } else {
                            Log.e(TAG, "Wrong note type in SUB_FOLDER");
                        }
                        break;
                    default:
                        break;
                }
            }
        }

    }

    /**
     * 启动目标文件夹查询（用于移动笔记时选择目标文件夹）
     */
    private void startQueryDestinationFolders() {
        // 构建查询条件：类型为文件夹，非回收站，非当前文件夹（根据当前状态可能包含根目录）
        String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";
        selection = (mState == ListEditState.NOTE_LIST) ? selection :
                "(" + selection + ") OR (" + NoteColumns.ID + "=" + Notes.ID_ROOT_FOLDER + ")";

        // 执行异步查询获取目标文件夹列表
        mBackgroundQueryHandler.startQuery(FOLDER_LIST_QUERY_TOKEN,
                null,
                Notes.CONTENT_NOTE_URI,
                FoldersListAdapter.PROJECTION,
                selection,
                new String[] {
                        String.valueOf(Notes.TYPE_FOLDER),
                        String.valueOf(Notes.ID_TRASH_FOLER),
                        String.valueOf(mCurrentFolderId)
                },
                NoteColumns.MODIFIED_DATE + " DESC"); // 按修改时间降序排序
    }

    /**
     * 列表项长按事件处理（启动多选模式或显示上下文菜单）
     */
    public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
        if (view instanceof NotesListItem) {
            mFocusNoteDataItem = ((NotesListItem) view).getItemData(); // 获取长按的列表项数据

            if (mFocusNoteDataItem.getType() == Notes.TYPE_NOTE && !mNotesListAdapter.isInChoiceMode()) {
                // 长按笔记项且非多选模式时启动多选操作栏
                if (mNotesListView.startActionMode(mModeCallBack) != null) {
                    mModeCallBack.onItemCheckedStateChanged(null, position, id, true); // 标记为选中
                    mNotesListView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS); // 触发长按震动反馈
                } else {
                    Log.e(TAG, "startActionMode fails");
                }
            } else if (mFocusNoteDataItem.getType() == Notes.TYPE_FOLDER) {
                // 长按文件夹时显示上下文菜单
                mNotesListView.setOnCreateContextMenuListener(mFolderOnCreateContextMenuListener);
            }
        }
        return false;
    }
}