/*
 * 版权所有 (c) 2010-2011，MiCode 开源社区 (www.micode.net)
 * 根据 Apache 许可证 2.0 版本（"许可证"）授权；
 * 除非符合许可证的规定，否则不得使用本文件。
 * 您可以从以下网址获取许可证副本：
 * http://www.apache.org/licenses/LICENSE-2.0
 * 除非适用法律要求或书面同意，本软件按"原样"分发，
 * 没有任何明示或暗示的保证或条件。
 * 详见许可证中规定的权限和限制。
 * （注：这是一份标准的Apache许可证2.0版本的开源声明）
 */

// 定义NoteEditActivity所在的包路径
package net.micode.notes.ui;

// 导入各类Android框架类和自定义类
import android.app.Activity;  // Activity基类
import android.app.AlarmManager;  // 闹钟管理服务，用于提醒功能
import android.app.AlertDialog;  // 警告对话框
import android.app.PendingIntent;  // 延时意图
import android.app.SearchManager;  // 搜索服务管理
import android.appwidget.AppWidgetManager;  // 小部件管理
import android.content.ContentUris;  // 内容URI工具
import android.content.Context;  // 应用上下文
import android.content.DialogInterface;  // 对话框接口
import android.content.Intent;  // 意图相关
import android.content.SharedPreferences;  // 共享首选项
import android.graphics.Paint;  // 绘图相关
import android.os.Bundle;  // 保存Activity状态
import android.preference.PreferenceManager;  // 首选项管理
import android.text.Spannable;  // 可样式化文本
import android.text.SpannableString;  // 可样式化字符串
import android.text.TextUtils;  // 文本工具类
import android.text.format.DateUtils;  // 日期时间格式化
import android.text.style.BackgroundColorSpan;  // 文本背景色样式
import android.util.Log;  // 日志工具
import android.view.LayoutInflater;  // 布局加载器
import android.view.Menu;  // 菜单相关
import android.view.MenuItem;  // 菜单项
import android.view.MotionEvent;  // 触摸事件
import android.view.View;  // 视图基类
import android.view.View.OnClickListener;  // 点击监听器
import android.view.WindowManager;  // 窗口管理
import android.widget.CheckBox;  // 复选框控件
import android.widget.CompoundButton;  // 复合按钮
import android.widget.CompoundButton.OnCheckedChangeListener;  // 复选框状态监听
import android.widget.EditText;  // 编辑文本框
import android.widget.ImageView;  // 图片视图
import android.widget.LinearLayout;  // 线性布局
import android.widget.TextView;  // 文本视图
import android.widget.Toast;  // 提示消息

import androidx.annotation.NonNull;  // AndroidX非空注解

// 导入项目自定义类和资源
import net.micode.notes.R;  // 项目资源文件
import net.micode.notes.data.Notes;  // 笔记数据相关
import net.micode.notes.data.Notes.TextNote;  // 文本笔记数据
import net.micode.notes.model.WorkingNote;  // 工作笔记模型
import net.micode.notes.model.WorkingNote.NoteSettingChangedListener;  // 笔记设置变更监听
import net.micode.notes.tool.DataUtils;  // 数据工具类
import net.micode.notes.tool.ResourceParser;  // 资源解析器
import net.micode.notes.tool.ResourceParser.TextAppearanceResources;  // 文本外观资源
import net.micode.notes.ui.DateTimePickerDialog.OnDateTimeSetListener;  // 日期时间选择监听
import net.micode.notes.ui.NoteEditText.OnTextViewChangeListener;  // 文本变更监听
import net.micode.notes.widget.NoteWidgetProvider_2x;  // 2x尺寸小部件
import net.micode.notes.widget.NoteWidgetProvider_4x;  // 4x尺寸小部件

// 导入Java工具类
import java.util.HashMap;  // 哈希映射
import java.util.HashSet;  // 哈希集合
import java.util.Map;  // 映射接口
import java.util.Objects;  // 对象工具
import java.util.regex.Matcher;  // 正则匹配器
import java.util.regex.Pattern;  // 正则表达式

// 笔记编辑Activity，继承Activity并实现多个接口
public class NoteEditActivity extends Activity implements OnClickListener,
        NoteSettingChangedListener, OnTextViewChangeListener {
    // 头部视图Holder静态内部类
    private static class HeadViewHolder {
        public TextView tvModified;    // 修改时间显示文本
        public ImageView ivAlertIcon;  // 提醒图标
        public TextView tvAlertDate;   // 提醒日期文本
        public ImageView ibSetBgColor; // 设置背景色按钮
    }

    // 背景颜色选择按钮映射表(按钮ID->颜色值)
    private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<>();
    static {  // 静态初始化块
        sBgSelectorBtnsMap.put(R.id.iv_bg_yellow,  ResourceParser.YELLOW);
        sBgSelectorBtnsMap.put(R.id.iv_bg_red,  ResourceParser.RED);
        sBgSelectorBtnsMap.put(R.id.iv_bg_blue,  ResourceParser.BLUE);
        sBgSelectorBtnsMap.put(R.id.iv_bg_green,  ResourceParser.GREEN);
        sBgSelectorBtnsMap.put(R.id.iv_bg_white,  ResourceParser.WHITE);
    }

    // 背景颜色选择状态映射表(颜色值->选中状态视图ID)
    private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<>();
    static {
        sBgSelectorSelectionMap.put(ResourceParser.YELLOW,  R.id.iv_bg_yellow_select);
        sBgSelectorSelectionMap.put(ResourceParser.RED,  R.id.iv_bg_red_select);
        sBgSelectorSelectionMap.put(ResourceParser.BLUE,  R.id.iv_bg_blue_select);
        sBgSelectorSelectionMap.put(ResourceParser.GREEN,  R.id.iv_bg_green_select);
        sBgSelectorSelectionMap.put(ResourceParser.WHITE,  R.id.iv_bg_white_select);
    }

    // 字体大小选择按钮映射表(布局ID->字体大小值)
    private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<>();
    static {
        sFontSizeBtnsMap.put(R.id.ll_font_large,  ResourceParser.TEXT_LARGE);
        sFontSizeBtnsMap.put(R.id.ll_font_small,  ResourceParser.TEXT_SMALL);
        sFontSizeBtnsMap.put(R.id.ll_font_normal,  ResourceParser.TEXT_MEDIUM);
        sFontSizeBtnsMap.put(R.id.ll_font_super,  ResourceParser.TEXT_SUPER);
    }

    // 字体大小选择状态映射表(字体大小值->选中状态视图ID)
    private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<>();
    static {
        sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE,  R.id.iv_large_select);
        sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL,  R.id.iv_small_select);
        sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM,  R.id.iv_medium_select);
        sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER,  R.id.iv_super_select);
    }

    private static final String TAG = "NoteEditActivity";  // 日志标签

    // 视图成员变量
    private HeadViewHolder mNoteHeaderHolder;  // 头部视图Holder实例
    private View mHeadViewPanel;               // 头部面板视图
    private View mNoteBgColorSelector;         // 背景颜色选择器
    private View mFontSizeSelector;            // 字体大小选择器
    private EditText mNoteEditor;              // 笔记内容编辑器
    private View mNoteEditorPanel;             // 编辑器面板
    private WorkingNote mWorkingNote;          // 当前工作笔记对象

    // 偏好设置相关
    private SharedPreferences mSharedPrefs;    // 共享偏好设置
    private int mFontSizeId;                   // 当前字体大小ID
    private static final String PREFERENCE_FONT_SIZE = "pref_font_size";  // 字体大小偏好键名

    // 快捷方式相关常量
    private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;  // 快捷方式标题最大长度

    // 复选框标记常量
    public static final String TAG_CHECKED = String.valueOf('√');    // 选中标记
    public static final String TAG_UNCHECKED = String.valueOf('□');  // 未选中标记

    // 其他成员变量
    private LinearLayout mEditTextList;        // 编辑文本列表布局
    private String mUserQuery;                // 用户搜索查询词

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        this.setContentView(R.layout.note_edit);   // 设置布局

        // 初始化Activity状态，如果没有有效状态则结束Activity
        if (savedInstanceState == null && !initActivityState(getIntent())) {
            finish();
            return;
        }
        initResources();  // 初始化资源
    }

    /**
     * 当内存不足时Activity可能被杀死，恢复时需要重建状态
     */
    @Override
    protected void onRestoreInstanceState(@NonNull Bundle savedInstanceState) {
        super.onRestoreInstanceState(savedInstanceState);
        // 从保存状态恢复笔记ID
        if (savedInstanceState.containsKey(Intent.EXTRA_UID))  {
            Intent intent = new Intent(Intent.ACTION_VIEW);
            intent.putExtra(Intent.EXTRA_UID,  savedInstanceState.getLong(Intent.EXTRA_UID));
            if (!initActivityState(intent)) {
                finish();
                return;
            }
            Log.d(TAG, "Restoring from killed activity");
        }
    }

    /**
     * 初始化Activity状态
     * @param intent 传入的Intent
     * @return 是否初始化成功
     */
    private boolean initActivityState(Intent intent) {
        mWorkingNote = null;
        // 处理查看笔记的Intent
        if (TextUtils.equals(Intent.ACTION_VIEW,  intent.getAction()))  {
            long noteId = intent.getLongExtra(Intent.EXTRA_UID,  0);
            mUserQuery = "";

            // 处理来自搜索的结果
            if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY))  {
                noteId = Long.parseLong(Objects.requireNonNull(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)));
                mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);
            }

            // 检查笔记是否存在
            if (!DataUtils.visibleInNoteDatabase(getContentResolver(),  noteId, Notes.TYPE_NOTE)) {
                Intent jump = new Intent(this, NotesListActivity.class);
                startActivity(jump);
                showToast(R.string.error_note_not_exist);
                finish();
                return false;
            } else {
                // 加载笔记
                mWorkingNote = WorkingNote.load(this,  noteId);
                if (mWorkingNote == null) {
                    Log.e(TAG, "load note failed with note id" + noteId);
                    finish();
                    return false;
                }
            }
            // 设置软键盘模式
            getWindow().setSoftInputMode(
                    WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN
                            | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
        }
        // 处理新建或编辑笔记的Intent
        else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT,  intent.getAction()))  {
            // 获取参数
            long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID,  0);
            int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID,
                    AppWidgetManager.INVALID_APPWIDGET_ID);
            int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE,
                    Notes.TYPE_WIDGET_INVALIDE);
            int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID,
                    ResourceParser.getDefaultBgId(this));

            // 处理通话记录笔记
            String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);
            long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE,  0);
            if (callDate != 0 && phoneNumber != null) {
                if (TextUtils.isEmpty(phoneNumber))  {
                    Log.w(TAG, "The call record number is null");
                }
                long noteId = 0;
                // 查找是否已存在对应通话记录
                if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(),
                        phoneNumber, callDate)) > 0) {
                    mWorkingNote = WorkingNote.load(this,  noteId);
                    if (mWorkingNote == null) {
                        Log.e(TAG, "load call note failed with note id" + noteId);
                        finish();
                        return false;
                    }
                } else {
                    // 新建通话记录笔记
                    mWorkingNote = WorkingNote.createEmptyNote(this,  folderId, widgetId,
                            widgetType, bgResId);
                    mWorkingNote.convertToCallNote(phoneNumber,  callDate);
                }
            } else {
                // 创建普通空笔记
                mWorkingNote = WorkingNote.createEmptyNote(this,  folderId, widgetId, widgetType,
                        bgResId);
            }

            // 设置软键盘模式
            getWindow().setSoftInputMode(
                    WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE
                            | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE);
        } else {
            Log.e(TAG, "Intent not specified action, should not support");
            finish();
            return false;
        }
        // 设置笔记变更监听器
        mWorkingNote.setOnSettingStatusChangedListener(this);
        return true;
    }

    @Override
    protected void onResume() {
        super.onResume();
        initNoteScreen();  // 初始化笔记显示
    }

    /**
     * 初始化笔记显示界面
     */
    private void initNoteScreen() {
        // 设置编辑器字体大小
        mNoteEditor.setTextAppearance(this,  TextAppearanceResources
                .getTexAppearanceResource(mFontSizeId));

        // 根据笔记模式设置内容
        if (mWorkingNote.getCheckListMode()  == TextNote.MODE_CHECK_LIST) {
            switchToListMode(mWorkingNote.getContent());   // 列表模式
        } else {
            // 普通模式，高亮显示搜索词
            mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(),  mUserQuery));
            mNoteEditor.setSelection(mNoteEditor.getText().length());   // 光标移至末尾
        }

        // 初始化背景选择器状态
        for (Integer id : sBgSelectorSelectionMap.keySet())  {
            findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE);
        }

        // 设置背景和标题样式
        mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
        mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());

        // 设置修改时间显示
        mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this,
                mWorkingNote.getModifiedDate(),  DateUtils.FORMAT_SHOW_DATE
                        | DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME
                        | DateUtils.FORMAT_SHOW_YEAR));

        // 显示提醒头部(如果有设置提醒)
        showAlertHeader();
    }

    /**
     * 显示提醒头部信息
     */
    private void showAlertHeader() {
        if (mWorkingNote.hasClockAlert())  {
            long time = System.currentTimeMillis();
            // 判断提醒是否过期
            if (time > mWorkingNote.getAlertDate())  {
                mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
            } else {
                // 显示相对时间
                mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString(
                        mWorkingNote.getAlertDate(),  time, DateUtils.MINUTE_IN_MILLIS));
            }
            mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);
            mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);
        } else {
            // 没有提醒时隐藏相关视图
            mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE);
            mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE);
        }
    }

    // 处理新的Intent到来（例如从最近任务重新打开）
    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);   // 调用父类方法
        initActivityState(intent);  // 用新intent重新初始化Activity状态
    }

    // 保存Activity状态（例如屏幕旋转时）
    @Override
    protected void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);   // 调用父类方法

        /**
         * 对于尚未保存的新笔记，需要先保存以生成ID
         * 如果笔记不值得保存，则不会有ID等同于创建新笔记
         */
        if (!mWorkingNote.existInDatabase())  {
            saveNote();  // 保存笔记到数据库
        }

        // 将当前笔记ID保存到Bundle中
        outState.putLong(Intent.EXTRA_UID,  mWorkingNote.getNoteId());
        Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId()  + " onSaveInstanceState");
    }

    // 处理触摸事件分发
    @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        // 如果背景颜色选择器可见且触摸在区域外，则隐藏它
        if (mNoteBgColorSelector.getVisibility()  == View.VISIBLE
                && !inRangeOfView(mNoteBgColorSelector, ev)) {
            mNoteBgColorSelector.setVisibility(View.GONE);
            return true;  // 事件已消费
        }

        // 如果字体大小选择器可见且触摸在区域外，则隐藏它
        if (mFontSizeSelector.getVisibility()  == View.VISIBLE
                && !inRangeOfView(mFontSizeSelector, ev)) {
            mFontSizeSelector.setVisibility(View.GONE);
            return true;  // 事件已消费
        }

        return super.dispatchTouchEvent(ev);   // 其他情况交由父类处理
    }

    // 检查触摸事件是否在视图范围内
    private boolean inRangeOfView(View view, MotionEvent ev) {
        int []location = new int[2];  // 存储视图坐标的数组
        view.getLocationOnScreen(location);   // 获取视图在屏幕上的坐标
        int x = location[0];  // 视图左上角x坐标
        int y = location[1];  // 视图左上角y坐标

        // 判断触摸点是否在视图范围外
        if (ev.getX()  < x
                || ev.getX()  > (x + view.getWidth())
                || ev.getY()  < y
                || ev.getY()  > (y + view.getHeight()))  {
            return false;  // 不在范围内
        }
        return true;  // 在范围内
    }

    // 初始化视图资源和数据
    private void initResources() {
        // 初始化头部视图
        mHeadViewPanel = findViewById(R.id.note_title);
        mNoteHeaderHolder = new HeadViewHolder();

        // 绑定头部视图控件
        mNoteHeaderHolder.tvModified  = (TextView) findViewById(R.id.tv_modified_date);
        mNoteHeaderHolder.ivAlertIcon  = (ImageView) findViewById(R.id.iv_alert_icon);
        mNoteHeaderHolder.tvAlertDate  = (TextView) findViewById(R.id.tv_alert_date);
        mNoteHeaderHolder.ibSetBgColor  = (ImageView) findViewById(R.id.btn_set_bg_color);
        mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this);   // 设置背景颜色按钮点击监听

        // 初始化编辑器相关视图
        mNoteEditor = (EditText) findViewById(R.id.note_edit_view);
        mNoteEditorPanel = findViewById(R.id.sv_note_edit);

        // 初始化背景颜色选择器
        mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);
        // 为所有背景颜色按钮设置点击监听
        for (int id : sBgSelectorBtnsMap.keySet())  {
            ImageView iv = (ImageView) findViewById(id);
            iv.setOnClickListener(this);
        }

        // 初始化字体大小选择器
        mFontSizeSelector = findViewById(R.id.font_size_selector);
        // 为所有字体大小选项设置点击监听
        for (int id : sFontSizeBtnsMap.keySet())  {
            View view = findViewById(id);
            view.setOnClickListener(this);
        };

        // 初始化偏好设置
        mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this);
        // 获取保存的字体大小设置，默认为默认字体大小
        mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE,  ResourceParser.BG_DEFAULT_FONT_SIZE);

        /**
         * HACKME: 修复在shared preference中存储资源id的bug。
         * id可能大于资源数量，这种情况返回默认字体大小
         */
        if(mFontSizeId >= TextAppearanceResources.getResourcesSize())  {
            mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE;
        }

        // 初始化编辑文本列表布局
        mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);
    }

    // Activity暂停时调用
    @Override
    protected void onPause() {
        super.onPause();
        // 保存笔记并记录日志
        if(saveNote()) {
            Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length());
        }
        clearSettingState();  // 清除设置状态（如隐藏选择器）
    }

    // 更新关联的小部件
    private void updateWidget() {
        Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);

        // 根据小部件类型设置不同的Provider
        if (mWorkingNote.getWidgetType()  == Notes.TYPE_WIDGET_2X) {
            intent.setClass(this,  NoteWidgetProvider_2x.class);
        } else if (mWorkingNote.getWidgetType()  == Notes.TYPE_WIDGET_4X) {
            intent.setClass(this,  NoteWidgetProvider_4x.class);
        } else {
            Log.e(TAG, "Unspported widget type");
            return;
        }

        // 设置要更新的小部件ID
        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS,  new int[] {
                mWorkingNote.getWidgetId()
        });

        sendBroadcast(intent);  // 发送广播更新小部件
        setResult(RESULT_OK, intent);  // 设置结果
    }

    // 点击事件处理
    public void onClick(View v) {
        int id = v.getId();

        // 背景颜色设置按钮点击
        if (id == R.id.btn_set_bg_color)  {
            mNoteBgColorSelector.setVisibility(View.VISIBLE);   // 显示背景选择器
            // 显示当前选中背景的标记
            findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(View.VISIBLE);
        }
        // 背景颜色选项点击
        else if (sBgSelectorBtnsMap.containsKey(id))  {
            // 隐藏之前选中的背景标记
            findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(View.GONE);
            // 设置新背景颜色
            mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id));
            mNoteBgColorSelector.setVisibility(View.GONE);   // 隐藏背景选择器
        }
        // 字体大小选项点击
        else if (sFontSizeBtnsMap.containsKey(id))  {
            // 隐藏之前选中的字体大小标记
            findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE);
            // 设置新字体大小
            mFontSizeId = sFontSizeBtnsMap.get(id);
            // 保存到偏好设置
            mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE,  mFontSizeId).commit();
            // 显示新选中的字体大小标记
            findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);

            // 根据当前模式应用字体设置
            if (mWorkingNote.getCheckListMode()  == TextNote.MODE_CHECK_LIST) {
                getWorkingText();
                switchToListMode(mWorkingNote.getContent());
            } else {
                // 设置编辑器文本外观
                mNoteEditor.setTextAppearance(this,
                        TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
            }
            mFontSizeSelector.setVisibility(View.GONE);   // 隐藏字体大小选择器
        }
    }

    // 返回键处理
    @Override
    public void onBackPressed() {
        if(clearSettingState()) {  // 如果有设置面板显示，先关闭它们
            return;
        }

        saveNote();  // 保存笔记
        super.onBackPressed();   // 执行默认返回操作
    }

    // 清除设置状态（隐藏所有选择器）
    private boolean clearSettingState() {
        if (mNoteBgColorSelector.getVisibility()  == View.VISIBLE) {
            mNoteBgColorSelector.setVisibility(View.GONE);
            return true;
        } else if (mFontSizeSelector.getVisibility()  == View.VISIBLE) {
            mFontSizeSelector.setVisibility(View.GONE);
            return true;
        }
        return false;
    }

    // 背景颜色变化回调
    public void onBackgroundColorChanged() {
        // 更新背景选择标记
        findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(View.VISIBLE);
        // 应用新背景颜色
        mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
        mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
    }

    // 准备选项菜单
    @Override
    public boolean onPrepareOptionsMenu(Menu menu) {
        if (isFinishing()) {  // 如果Activity正在结束，不处理菜单
            return true;
        }

        clearSettingState();  // 清除设置状态
        menu.clear();   // 清除原有菜单项

        // 根据笔记类型加载不同菜单
        if (mWorkingNote.getFolderId()  == Notes.ID_CALL_RECORD_FOLDER) {
            getMenuInflater().inflate(R.menu.call_note_edit,  menu);
        } else {
            getMenuInflater().inflate(R.menu.note_edit,  menu);
        }

        // 设置列表模式/普通模式菜单项标题
        if (mWorkingNote.getCheckListMode()  == TextNote.MODE_CHECK_LIST) {
            menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode);
        } else {
            menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_list_mode);
        }

        // 根据是否有提醒设置显示不同的菜单项
        if (mWorkingNote.hasClockAlert())  {
            menu.findItem(R.id.menu_alert).setVisible(false);   // 隐藏设置提醒
            menu.findItem(R.id.menu_delete_remind).setVisible(true);   // 显示删除提醒
        } else {
            menu.findItem(R.id.menu_alert).setVisible(true);   // 显示设置提醒
            menu.findItem(R.id.menu_delete_remind).setVisible(false);   // 隐藏删除提醒
        }
        return true;
    }

    // 菜单项选择处理
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        switch (item.getItemId())  {
            case R.id.menu_new_note:   // 新建笔记
                createNewNote();
                break;
            case R.id.menu_delete:   // 删除笔记
                showDeleteNoteDialog();
                break;
            case R.id.menu_font_size:   // 字体大小设置
                mFontSizeSelector.setVisibility(View.VISIBLE);
                findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
                break;
            case R.id.menu_list_mode:   // 切换列表模式/普通模式
                toggleListMode();
                break;
            case R.id.menu_share:   // 分享笔记内容
                shareNoteContent();
                break;
            case R.id.menu_send_to_desktop:   // 发送到桌面
                sendToDesktop();
                break;
            case R.id.menu_alert:   // 设置提醒
                setReminder();
                break;
            case R.id.menu_delete_remind:   // 删除提醒
                mWorkingNote.setAlertDate(0,  false);
                break;
            default:
                break;
        }
        return true;
    }

    // 显示删除笔记确认对话框
    private void showDeleteNoteDialog() {
        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_note));
        builder.setPositiveButton(android.R.string.ok,
                new DialogInterface.OnClickListener() {
                    public void onClick(DialogInterface dialog, int which) {
                        deleteCurrentNote();  // 删除当前笔记
                        finish();  // 结束Activity
                    }
                });
        builder.setNegativeButton(android.R.string.cancel,  null);
        builder.show();
    }

    // 切换列表模式/普通模式
    private void toggleListMode() {
        int newMode = mWorkingNote.getCheckListMode()  == 0 ? TextNote.MODE_CHECK_LIST : 0;
        mWorkingNote.setCheckListMode(newMode);
    }

    // 分享笔记内容
    private void shareNoteContent() {
        getWorkingText();
        sendTo(this, mWorkingNote.getContent());
    }

    // 设置笔记提醒时间
    private void setReminder() {
        // 创建日期时间选择对话框，传入当前时间作为初始值
        DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());

        // 设置日期时间选择监听器
        d.setOnDateTimeSetListener(new  OnDateTimeSetListener() {
            public void OnDateTimeSet(AlertDialog dialog, long date) {
                // 设置笔记的提醒时间
                mWorkingNote.setAlertDate(date,  true);
            }
        });
        d.show();   // 显示对话框
    }

    /**
     * 分享笔记内容到支持分享功能的应用
     * @param context 上下文对象
     * @param info 要分享的文本内容
     */
    private void sendTo(Context context, String info) {
        // 创建分享意图
        Intent intent = new Intent(Intent.ACTION_SEND);
        // 添加要分享的文本内容
        intent.putExtra(Intent.EXTRA_TEXT,  info);
        // 设置分享类型为纯文本
        intent.setType("text/plain");
        // 启动分享活动
        context.startActivity(intent);
    }

    // 创建新笔记
    private void createNewNote() {
        // 首先保存当前正在编辑的笔记
        saveNote();

        // 结束当前Activity，确保安全性
        finish();

        // 创建启动新笔记编辑Activity的意图
        Intent intent = new Intent(this, NoteEditActivity.class);
        // 设置操作为插入或编辑
        intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
        // 传递当前文件夹ID
        intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID,  mWorkingNote.getFolderId());
        // 启动新的笔记编辑Activity
        startActivity(intent);
    }

    // 删除当前笔记
    private void deleteCurrentNote() {
        // 检查笔记是否存在于数据库中
        if (mWorkingNote.existInDatabase())  {
            // 创建笔记ID集合
            HashSet<Long> ids = new HashSet<>();
            long id = mWorkingNote.getNoteId();

            // 检查笔记ID是否有效
            if (id != Notes.ID_ROOT_FOLDER) {
                ids.add(id);   // 添加要删除的笔记ID
            } else {
                Log.d(TAG, "Wrong note id, should not happen");
            }

            // 根据同步模式选择删除方式
            if (!isSyncMode()) {
                // 直接批量删除笔记
                if (!DataUtils.batchDeleteNotes(getContentResolver(),  ids)) {
                    Log.e(TAG, "Delete Note error");
                }
            } else {
                // 同步模式下将笔记移动到回收站
                if (!DataUtils.batchMoveToFolder(getContentResolver(),  ids, Notes.ID_TRASH_FOLER)) {
                    Log.e(TAG, "Move notes to trash folder error, should not happens");
                }
            }
        }
        // 标记笔记为已删除状态
        mWorkingNote.markDeleted(true);
    }

    // 检查是否处于同步模式
    private boolean isSyncMode() {
        // 通过偏好设置获取同步账号名称，长度大于0表示处于同步模式
        return NotesPreferenceActivity.getSyncAccountName(this).trim().length()  > 0;
    }

    // 当提醒时间发生变化时调用
    public void onClockAlertChanged(long date, boolean set) {
        /**
         * 用户可以为未保存的笔记设置提醒，因此在设置提醒前需要先保存笔记
         */
        if (!mWorkingNote.existInDatabase())  {
            saveNote();  // 保存笔记到数据库
        }

        // 检查笔记ID是否有效
        if (mWorkingNote.getNoteId()  > 0) {
            // 创建闹钟接收器意图
            Intent intent = new Intent(this, AlarmReceiver.class);
            // 设置笔记URI
            intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,  mWorkingNote.getNoteId()));
            // 创建待定意图
            PendingIntent pendingIntent = PendingIntent.getBroadcast(this,  0, intent, 0);
            // 获取闹钟管理器服务
            AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));

            // 更新提醒头部显示
            showAlertHeader();

            // 根据设置状态取消或设置闹钟
            if(!set) {
                alarmManager.cancel(pendingIntent);   // 取消闹钟
            } else {
                alarmManager.set(AlarmManager.RTC_WAKEUP,  date, pendingIntent);  // 设置闹钟
            }
        } else {
            /**
             * 用户未输入任何内容(笔记不值得保存)，我们没有笔记ID，
             * 提醒用户需要输入内容
             */
            Log.e(TAG, "Clock alert setting error");
            showToast(R.string.error_note_empty_for_clock);
        }
    }

    // 当关联的小部件发生变化时调用
    public void onWidgetChanged() {
        updateWidget();  // 更新小部件显示
    }

    // 当编辑文本被删除时调用
    public void onEditTextDelete(int index, String text) {
        int childCount = mEditTextList.getChildCount();
        if (childCount == 1) {
            return;  // 只有一个子项时不处理
        }

        // 更新后续子项的索引
        for (int i = index + 1; i < childCount; i++) {
            ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
                    .setIndex(i - 1);
        }

        // 移除指定位置的视图
        mEditTextList.removeViewAt(index);

        // 获取要处理焦点的编辑框
        NoteEditText edit = null;
        if(index == 0) {
            edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById(R.id.et_edit_text);
        } else {
            edit = (NoteEditText) mEditTextList.getChildAt(index  - 1).findViewById(R.id.et_edit_text);
        }

        // 处理被删除的文本
        int length = edit.length();
        edit.append(text);   // 追加文本
        edit.requestFocus();   // 获取焦点
        edit.setSelection(length);   // 设置光标位置
    }

    // 当在编辑文本中按下回车时调用
    public void onEditTextEnter(int index, String text) {
        /**
         * 不应发生的情况，用于调试检查
         */
        if(index > mEditTextList.getChildCount())  {
            Log.e(TAG, "Index out of mEditTextList boundrary, should not happen");
        }

        // 创建新列表项并添加到指定位置
        View view = getListItem(text, index);
        mEditTextList.addView(view,  index);

        // 设置新添加的编辑框获取焦点
        NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
        edit.requestFocus();
        edit.setSelection(0);

        // 更新后续子项的索引
        for (int i = index + 1; i < mEditTextList.getChildCount();  i++) {
            ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
                    .setIndex(i);
        }
    }

    // 切换到列表模式
    private void switchToListMode(String text) {
        // 清除现有所有子视图
        mEditTextList.removeAllViews();

        // 按换行符拆分文本
        String[] items = text.split("\n");
        int index = 0;

        // 为每个非空行创建列表项
        for (String item : items) {
            if(!TextUtils.isEmpty(item))  {
                mEditTextList.addView(getListItem(item,  index));
                index++;
            }
        }

        // 添加一个空列表项用于输入新内容
        mEditTextList.addView(getListItem("",  index));
        mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();

        // 切换视图显示状态
        mNoteEditor.setVisibility(View.GONE);
        mEditTextList.setVisibility(View.VISIBLE);
    }

    // 获取高亮显示查询结果的文本
    private Spannable getHighlightQueryResult(String fullText, String userQuery) {
        // 创建可样式化的字符串
        SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);

        // 如果用户查询词不为空，则处理高亮
        if (!TextUtils.isEmpty(userQuery))  {
            // 创建匹配用户查询词的正则表达式
            var mPattern = Pattern.compile(userQuery);
            Matcher m = mPattern.matcher(fullText);
            int start = 0;

            // 查找所有匹配项并设置背景色高亮
            while (m.find(start))  {
                spannable.setSpan(
                        new BackgroundColorSpan(this.getResources().getColor(
                                R.color.user_query_highlight)),  m.start(),  m.end(),
                        Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
                start = m.end();
            }
        }
        return spannable;
    }

    // 获取列表项视图
    private View getListItem(String item, int index) {
        // 加载列表项布局
        View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item,  null);
        final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);

        // 设置编辑框文本外观
        edit.setTextAppearance(this,  TextAppearanceResources.getTexAppearanceResource(mFontSizeId));

        // 设置复选框状态变化监听器
        CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item));
        cb.setOnCheckedChangeListener(new  OnCheckedChangeListener() {
            public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
                // 根据复选框状态设置文本删除线
                if (isChecked) {
                    edit.setPaintFlags(edit.getPaintFlags()  | Paint.STRIKE_THRU_TEXT_FLAG);
                } else {
                    edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG  | Paint.DEV_KERN_TEXT_FLAG);
                }
            }
        });

        // 处理复选框初始状态
        if (item.startsWith(TAG_CHECKED))  {
            cb.setChecked(true);   // 设置为选中状态
            edit.setPaintFlags(edit.getPaintFlags()  | Paint.STRIKE_THRU_TEXT_FLAG);  // 添加删除线
            item = item.substring(TAG_CHECKED.length(),  item.length()).trim();   // 去除标记前缀
        } else if (item.startsWith(TAG_UNCHECKED))  {
            cb.setChecked(false);   // 设置为未选中状态
            edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG  | Paint.DEV_KERN_TEXT_FLAG);  // 清除删除线
            item = item.substring(TAG_UNCHECKED.length(),  item.length()).trim();   // 去除标记前缀
        }

        // 设置编辑框变化监听器和索引
        edit.setOnTextViewChangeListener(this);
        edit.setIndex(index);
        // 设置编辑框文本（处理高亮查询结果）
        edit.setText(getHighlightQueryResult(item,  mUserQuery));
        return view;
    }

    // 当文本内容发生变化时调用
    public void onTextChange(int index, boolean hasText) {
        // 检查索引是否有效
        if (index >= mEditTextList.getChildCount())  {
            Log.e(TAG, "Wrong index, should not happen");
            return;
        }

        // 根据是否有文本设置复选框可见性
        if(hasText) {
            mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE);
        } else {
            mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE);
        }
    }

    // 当笔记的列表模式发生变化时调用
    public void onCheckListModeChanged(int oldMode, int newMode) {
        // 切换到列表模式
        if (newMode == TextNote.MODE_CHECK_LIST) {
            switchToListMode(mNoteEditor.getText().toString());
        } else {
            // 切换回普通模式
            if (!getWorkingText()) {
                // 去除未选中标记
                mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED  + " ", ""));
            }
            // 设置编辑器文本（处理高亮查询结果）
            mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(),  mUserQuery));
            // 切换视图显示状态
            mEditTextList.setVisibility(View.GONE);
            mNoteEditor.setVisibility(View.VISIBLE);
        }
    }

    // 获取当前工作文本
    private boolean getWorkingText() {
        boolean hasChecked = false;
        // 如果是列表模式，处理所有列表项
        if (mWorkingNote.getCheckListMode()  == TextNote.MODE_CHECK_LIST) {
            StringBuilder sb = new StringBuilder();
            // 遍历所有列表项
            for (int i = 0; i < mEditTextList.getChildCount();  i++) {
                View view = mEditTextList.getChildAt(i);
                NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
                // 如果编辑框有文本内容
                if (!TextUtils.isEmpty(edit.getText()))  {
                    // 根据复选框状态添加相应标记
                    if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked())  {
                        sb.append(TAG_CHECKED).append("  ").append(edit.getText()).append("\n");
                        hasChecked = true;
                    } else {
                        sb.append(TAG_UNCHECKED).append("  ").append(edit.getText()).append("\n");
                    }
                }
            }
            // 设置工作文本
            mWorkingNote.setWorkingText(sb.toString());
        } else {
            // 普通模式直接获取编辑框文本
            mWorkingNote.setWorkingText(mNoteEditor.getText().toString());
        }
        return hasChecked;  // 返回是否有选中的项
    }

    // 保存笔记
    private boolean saveNote() {
        getWorkingText();  // 获取当前工作文本
        boolean saved = mWorkingNote.saveNote();   // 保存笔记
        if (saved) {
            /**
             * 从列表视图到编辑视图有两种模式：打开一个笔记，创建/编辑一个笔记。
             * 打开笔记需要返回时保持原来的列表位置，而创建新笔记需要返回列表顶部。
             * 这里的RESULT_OK用于标识创建/编辑状态
             */
            setResult(RESULT_OK);  // 设置结果码
        }
        return saved;  // 返回保存结果
    }

    // 发送笔记到桌面（创建快捷方式）
    private void sendToDesktop() {
        /**
         * 在发送消息到桌面之前，应确保当前编辑的笔记已存在于数据库中。
         * 因此，对于新笔记，首先需要保存它
         */
        if (!mWorkingNote.existInDatabase())  {
            saveNote();  // 保存笔记到数据库
        }

        // 检查笔记ID是否有效
        if (mWorkingNote.getNoteId()  > 0) {
            Intent sender = new Intent();
            // 创建快捷方式点击时启动的意图
            Intent shortcutIntent = new Intent(this, NoteEditActivity.class);
            shortcutIntent.setAction(Intent.ACTION_VIEW);
            shortcutIntent.putExtra(Intent.EXTRA_UID,  mWorkingNote.getNoteId());

            // 设置快捷方式参数
            sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT,  shortcutIntent);
            // 设置快捷方式名称（使用笔记内容前10个字符）
            sender.putExtra(Intent.EXTRA_SHORTCUT_NAME,
                    makeShortcutIconTitle(mWorkingNote.getContent()));
            // 设置快捷方式图标
            sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
                    Intent.ShortcutIconResource.fromContext(this,  R.drawable.icon_app));
            sender.putExtra("duplicate",  true);  // 允许重复创建
            sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT");   // 设置安装快捷方式动作

            showToast(R.string.info_note_enter_desktop);   // 显示提示消息
            sendBroadcast(sender);  // 发送广播创建快捷方式
        } else {
            /**
             * 用户未输入任何内容(笔记不值得保存)，我们没有笔记ID，
             * 提醒用户需要输入内容
             */
            Log.e(TAG, "Send to desktop error");
            showToast(R.string.error_note_empty_for_send_to_desktop);
        }
    }

    // 生成快捷方式标题
    private String makeShortcutIconTitle(String content) {
        // 去除复选框标记
        content = content.replace(TAG_CHECKED,  "");
        content = content.replace(TAG_UNCHECKED,  "");
        // 截取前10个字符作为标题
        return content.length()  > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0,
                SHORTCUT_ICON_TITLE_MAX_LEN) : content;
    }

    // 显示短时Toast提示
    private void showToast(int resId) {
        showToast(resId, Toast.LENGTH_SHORT);  // 默认显示短时Toast
    }

    // 显示Toast提示
    private void showToast(int resId, int duration) {
        Toast.makeText(this,  resId, duration).show();  // 创建并显示Toast
    }
}
