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

// 定义当前类所在的包路径
package net.micode.notes.gtask.data;
// Android Widget相关类
import android.appwidget.AppWidgetManager;   // 管理应用小部件
// Android内容提供者相关类
import android.content.ContentResolver;     // 内容解析器，用于访问ContentProvider
import android.content.ContentValues;      // 键值对存储，用于数据库操作
import android.content.Context;            // 应用上下文
// Android数据库相关类
import android.database.Cursor;            // 数据库查询结果集
// Android网络相关类
import android.net.Uri;                    // 通用资源标识符
// Android系统相关类
import android.os.Build;                   // 获取Android版本信息
import android.util.Log;                  // 日志工具
// AndroidX注解支持
import androidx.annotation.RequiresApi;    // 版本要求注解
// 笔记应用数据相关类
import net.micode.notes.data.Notes;               // 笔记数据常量
import net.micode.notes.data.Notes.DataColumns;   // 数据表列名常量
import net.micode.notes.data.Notes.NoteColumns;   // 笔记表列名常量
// 异常处理类
import net.micode.notes.gtask.exception.ActionFailureException;   // 同步操作失败异常
// 工具类
import net.micode.notes.tool.GTaskStringUtils;   // Google Task字符串工具
import net.micode.notes.tool.ResourceParser;     // 资源解析工具
// JSON处理相关类
import org.json.JSONArray;    // JSON数组处理
import org.json.JSONException;  // JSON异常
import org.json.JSONObject;   // JSON对象处理
// Java集合类
import java.util.ArrayList;   // 动态数组
import java.util.Objects;     // 对象工具类

// 定义SqlNote类，用于管理笔记数据的数据库操作
public class SqlNote {
    // 日志标签
    private static final String TAG = SqlNote.class.getSimpleName();

    // 无效ID常量
    private static final int INVALID_ID = -99999;

    // 笔记数据查询投影列（指定需要查询的字段）
    public static final String[] PROJECTION_NOTE = new String[] {
            NoteColumns.ID,             // 笔记ID
            NoteColumns.ALERTED_DATE,   // 提醒日期
            NoteColumns.BG_COLOR_ID,    // 背景颜色ID
            NoteColumns.CREATED_DATE,   // 创建日期
            NoteColumns.HAS_ATTACHMENT, // 是否有附件
            NoteColumns.MODIFIED_DATE,  // 修改日期
            NoteColumns.NOTES_COUNT,    // 子笔记数量
            NoteColumns.PARENT_ID,      // 父笔记ID
            NoteColumns.SNIPPET,        // 内容摘要
            NoteColumns.TYPE,           // 笔记类型
            NoteColumns.WIDGET_ID,      // 小部件ID
            NoteColumns.WIDGET_TYPE,    // 小部件类型
            NoteColumns.SYNC_ID,        // 同步ID
            NoteColumns.LOCAL_MODIFIED, // 本地修改标记
            NoteColumns.ORIGIN_PARENT_ID, // 原始父笔记ID
            NoteColumns.GTASK_ID,       // Google任务ID
            NoteColumns.VERSION         // 数据版本
    };

    // 列索引常量定义
    public static final int ID_COLUMN = 0;               // ID列索引
    public static final int ALERTED_DATE_COLUMN = 1;     // 提醒日期列索引
    public static final int BG_COLOR_ID_COLUMN = 2;      // 背景颜色列索引
    public static final int CREATED_DATE_COLUMN = 3;     // 创建日期列索引
    public static final int HAS_ATTACHMENT_COLUMN = 4;  // 附件标记列索引
    public static final int MODIFIED_DATE_COLUMN = 5;    // 修改日期列索引
    public static final int NOTES_COUNT_COLUMN = 6;      // 子笔记数列索引
    public static final int PARENT_ID_COLUMN = 7;        // 父笔记ID列索引
    public static final int SNIPPET_COLUMN = 8;          // 摘要列索引
    public static final int TYPE_COLUMN = 9;              // 类型列索引
    public static final int WIDGET_ID_COLUMN = 10;       // 小部件ID列索引
    public static final int WIDGET_TYPE_COLUMN = 11;     // 小部件类型列索引
    public static final int SYNC_ID_COLUMN = 12;          // 同步ID列索引
    public static final int LOCAL_MODIFIED_COLUMN = 13;    // 本地修改列索引
    public static final int ORIGIN_PARENT_ID_COLUMN = 14;  // 原始父笔记ID列索引
    public static final int GTASK_ID_COLUMN = 15;         // Google任务ID列索引
    public static final int VERSION_COLUMN = 16;          // 版本列索引

    // 上下文对象
    private final Context mContext;
    // 内容解析器
    private final ContentResolver mContentResolver;
    // 是否为新建笔记标记
    private boolean mIsCreate;

    // 笔记字段
    private long mId;                  // 笔记ID
    private long mAlertDate;          // 提醒时间
    private int mBgColorId;           // 背景颜色ID
    private long mCreatedDate;        // 创建时间
    private int mHasAttachment;      // 是否有附件(0/1)
    private long mModifiedDate;      // 最后修改时间
    private long mParentId;          // 父笔记ID
    private String mSnippet;         // 内容摘要
    private int mType;               // 笔记类型
    private int mWidgetId;           // 关联小部件ID
    private int mWidgetType;        // 小部件类型
    private long mOriginParent;      // 原始父笔记ID
    private long mVersion;          // 数据版本

    // 存储变动的笔记值
    private final ContentValues mDiffNoteValues;
    // 笔记关联的数据列表
    private final ArrayList<SqlData> mDataList;

    /**
     * 构造函数（用于创建新笔记）
     * @param context 应用上下文
     */
    public SqlNote(Context context) {
        mContext = context;
        mContentResolver = context.getContentResolver();
        mIsCreate = true;  // 标记为新创建
        // 初始化默认值
        mId = INVALID_ID;
        mAlertDate = 0;
        mBgColorId = ResourceParser.getDefaultBgId(context);  // 获取默认背景
        mCreatedDate = System.currentTimeMillis();  // 当前时间为创建时间
        mHasAttachment = 0;
        mModifiedDate = System.currentTimeMillis();  // 当前时间为修改时间
        mParentId = 0;
        mSnippet = "";
        mType = Notes.TYPE_NOTE; // 默认为普通笔记类型
        mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID; // 无效小部件ID
        mWidgetType = Notes.TYPE_WIDGET_INVALIDE; // 无效小部件类型
        mOriginParent = 0;
        mVersion = 0;
        mDiffNoteValues = new ContentValues(); // 初始化变更值容器
        mDataList = new ArrayList<>(); // 初始化数据列表
    }

    /**
     * 构造函数（基于Cursor加载已有笔记）
     * @param context 应用上下文
     * @param c 数据库Cursor
     */
    public SqlNote(Context context, Cursor c) {
        mContext = context;
        mContentResolver = context.getContentResolver();
        mIsCreate = false; // 标记为已有笔记
        loadFromCursor(c); // 从Cursor加载数据
        mDataList = new ArrayList<>();
        // 如果是普通笔记类型，加载关联数据
        if (mType == Notes.TYPE_NOTE)
            loadDataContent();
        mDiffNoteValues = new ContentValues();
    }

    /**
     * 构造函数（基于笔记ID加载）
     * @param context 应用上下文
     * @param id 笔记ID
     */
    public SqlNote(Context context, long id) {
        mContext = context;
        mContentResolver = context.getContentResolver();
        mIsCreate = false; // 标记为已有笔记
        loadFromCursor(id); // 通过ID加载笔记
        mDataList = new ArrayList<>();
        // 如果是普通笔记类型，加载关联数据
        if (mType == Notes.TYPE_NOTE)
            loadDataContent();
        mDiffNoteValues = new ContentValues();
    }

    /**
     * 通过笔记ID从数据库加载数据
     * @param id 笔记ID
     */
    private void loadFromCursor(long id) {
        // 使用try-with-resources确保Cursor自动关闭
        try (Cursor c = mContentResolver.query(
                Notes.CONTENT_NOTE_URI, // 笔记内容URI
                PROJECTION_NOTE,       // 查询列
                "(_id=?)",             // 查询条件
                new String[]{ String.valueOf(id)  }, // 参数
                null)) {               // 排序
            if (c != null) {
                c.moveToNext();  // 移动到第一行
                loadFromCursor(c); // 从Cursor加载数据
            } else {
                Log.w(TAG, "loadFromCursor: cursor = null");
            }
        }
    }

    /**
     * 从Cursor加载笔记数据
     * @param c 数据库Cursor
     */
    private void loadFromCursor(Cursor c) {
        mId = c.getLong(ID_COLUMN);
        mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
        mBgColorId = c.getInt(BG_COLOR_ID_COLUMN);
        mCreatedDate = c.getLong(CREATED_DATE_COLUMN);
        mHasAttachment = c.getInt(HAS_ATTACHMENT_COLUMN);
        mModifiedDate = c.getLong(MODIFIED_DATE_COLUMN);
        mParentId = c.getLong(PARENT_ID_COLUMN);
        mSnippet = c.getString(SNIPPET_COLUMN);
        mType = c.getInt(TYPE_COLUMN);
        mWidgetId = c.getInt(WIDGET_ID_COLUMN);
        mWidgetType = c.getInt(WIDGET_TYPE_COLUMN);
        mVersion = c.getLong(VERSION_COLUMN);
    }

    /**
     * 加载笔记关联的数据内容
     */
    private void loadDataContent() {
        mDataList.clear();  // 清空现有数据
        // 查询关联数据
        try (Cursor c = mContentResolver.query(
                Notes.CONTENT_DATA_URI,  // 数据内容URI
                SqlData.PROJECTION_DATA, // 数据表查询列
                "(note_id=?)",           // 查询条件
                new String[]{ String.valueOf(mId)  }, // 参数
                null)) {                 // 排序
            if (c != null) {
                if (c.getCount()  == 0) {
                    Log.w(TAG, "it seems that the note has not data");
                    return;
                }
                // 遍历所有数据行
                while (c.moveToNext())  {
                    SqlData data = new SqlData(mContext, c); // 创建数据对象
                    mDataList.add(data);  // 添加到列表
                }
            } else {
                Log.w(TAG, "loadDataContent: cursor = null");
            }
        }
    }

    /**
     * 从JSON设置笔记内容
     * @param js 包含笔记数据的JSON对象
     * @return 是否设置成功
     */
    public boolean setContent(JSONObject js) {
        try {
            // 获取笔记数据
            JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);

            // 检查笔记类型
            if (note.getInt(NoteColumns.TYPE)  == Notes.TYPE_SYSTEM) {
                Log.w(TAG, "cannot set system folder");
            }
            // 处理文件夹类型
            else if (note.getInt(NoteColumns.TYPE)  == Notes.TYPE_FOLDER) {
                // 只能更新摘要和类型
                String snippet = note.has(NoteColumns.SNIPPET)  ?
                        note.getString(NoteColumns.SNIPPET)  : "";
                if (mIsCreate || !mSnippet.equals(snippet))  {
                    mDiffNoteValues.put(NoteColumns.SNIPPET,  snippet);
                }
                mSnippet = snippet;

                int type = note.has(NoteColumns.TYPE)  ?
                        note.getInt(NoteColumns.TYPE)  : Notes.TYPE_NOTE;
                if (mIsCreate || mType != type) {
                    mDiffNoteValues.put(NoteColumns.TYPE,  type);
                }
                mType = type;
            }
            // 处理普通笔记类型
            else if (note.getInt(NoteColumns.TYPE)  == Notes.TYPE_NOTE) {
                // 获取关联数据数组
                JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);

                // 处理笔记ID
                long id = note.has(NoteColumns.ID)  ? note.getLong(NoteColumns.ID)  : INVALID_ID;
                if (mIsCreate || mId != id) {
                    mDiffNoteValues.put(NoteColumns.ID,  id);
                }
                mId = id;

                // 处理提醒日期
                long alertDate = note.has(NoteColumns.ALERTED_DATE)  ?
                        note.getLong(NoteColumns.ALERTED_DATE)  : 0;
                if (mIsCreate || mAlertDate != alertDate) {
                    mDiffNoteValues.put(NoteColumns.ALERTED_DATE,  alertDate);
                }
                mAlertDate = alertDate;

                // 处理背景颜色
                int bgColorId = note.has(NoteColumns.BG_COLOR_ID)  ?
                        note.getInt(NoteColumns.BG_COLOR_ID)  : ResourceParser.getDefaultBgId(mContext);
                if (mIsCreate || mBgColorId != bgColorId) {
                    mDiffNoteValues.put(NoteColumns.BG_COLOR_ID,  bgColorId);
                }
                mBgColorId = bgColorId;

                // 处理创建日期
                long createDate = note.has(NoteColumns.CREATED_DATE)  ?
                        note.getLong(NoteColumns.CREATED_DATE)  : System.currentTimeMillis();
                if (mIsCreate || mCreatedDate != createDate) {
                    mDiffNoteValues.put(NoteColumns.CREATED_DATE,  createDate);
                }
                mCreatedDate = createDate;

                // 处理附件标记
                int hasAttachment = note.has(NoteColumns.HAS_ATTACHMENT)  ?
                        note.getInt(NoteColumns.HAS_ATTACHMENT)  : 0;
                if (mIsCreate || mHasAttachment != hasAttachment) {
                    mDiffNoteValues.put(NoteColumns.HAS_ATTACHMENT,  hasAttachment);
                }
                mHasAttachment = hasAttachment;

                // 处理修改日期
                long modifiedDate = note.has(NoteColumns.MODIFIED_DATE)  ?
                        note.getLong(NoteColumns.MODIFIED_DATE)  : System.currentTimeMillis();
                if (mIsCreate || mModifiedDate != modifiedDate) {
                    mDiffNoteValues.put(NoteColumns.MODIFIED_DATE,  modifiedDate);
                }
                mModifiedDate = modifiedDate;

                // 处理父笔记ID
                long parentId = note.has(NoteColumns.PARENT_ID)  ?
                        note.getLong(NoteColumns.PARENT_ID)  : 0;
                if (mIsCreate || mParentId != parentId) {
                    mDiffNoteValues.put(NoteColumns.PARENT_ID,  parentId);
                }
                mParentId = parentId;

                // 处理内容摘要
                String snippet = note.has(NoteColumns.SNIPPET)  ?
                        note.getString(NoteColumns.SNIPPET)  : "";
                if (mIsCreate || !mSnippet.equals(snippet))  {
                    mDiffNoteValues.put(NoteColumns.SNIPPET,  snippet);
                }
                mSnippet = snippet;

                // 处理笔记类型
                int type = note.has(NoteColumns.TYPE)  ?
                        note.getInt(NoteColumns.TYPE)  : Notes.TYPE_NOTE;
                if (mIsCreate || mType != type) {
                    mDiffNoteValues.put(NoteColumns.TYPE,  type);
                }
                mType = type;

                // 处理小部件ID
                int widgetId = note.has(NoteColumns.WIDGET_ID)  ?
                        note.getInt(NoteColumns.WIDGET_ID)  : AppWidgetManager.INVALID_APPWIDGET_ID;
                if (mIsCreate || mWidgetId != widgetId) {
                    mDiffNoteValues.put(NoteColumns.WIDGET_ID,  widgetId);
                }
                mWidgetId = widgetId;

                // 处理小部件类型
                int widgetType = note.has(NoteColumns.WIDGET_TYPE)  ?
                        note.getInt(NoteColumns.WIDGET_TYPE)  : Notes.TYPE_WIDGET_INVALIDE;
                if (mIsCreate || mWidgetType != widgetType) {
                    mDiffNoteValues.put(NoteColumns.WIDGET_TYPE,  widgetType);
                }
                mWidgetType = widgetType;

                // 处理原始父笔记ID
                long originParent = note.has(NoteColumns.ORIGIN_PARENT_ID)  ?
                        note.getLong(NoteColumns.ORIGIN_PARENT_ID)  : 0;
                if (mIsCreate || mOriginParent != originParent) {
                    mDiffNoteValues.put(NoteColumns.ORIGIN_PARENT_ID,  originParent);
                }
                mOriginParent = originParent;

                // 处理关联数据
                for (int i = 0; i < dataArray.length();  i++) {
                    JSONObject data = dataArray.getJSONObject(i);
                    SqlData sqlData = null;

                    // 查找已有数据
                    if (data.has(DataColumns.ID))  {
                        long dataId = data.getLong(DataColumns.ID);
                        for (SqlData temp : mDataList) {
                            if (dataId == temp.getId())  {
                                sqlData = temp;
                                break;
                            }
                        }
                    }

                    // 如果不存在则创建新数据
                    if (sqlData == null) {
                        sqlData = new SqlData(mContext);
                        mDataList.add(sqlData);
                    }

                    // 设置数据内容
                    sqlData.setContent(data);
                }
            }
        } catch (JSONException e) {
            Log.e(TAG, e.toString());
            e.printStackTrace();
            return false;
        }
        return true;
    }

    /**
     * 获取笔记内容的JSON表示
     * @return JSON对象，包含笔记数据
     */
    public JSONObject getContent() {
        try {
            JSONObject js = new JSONObject();

            // 检查是否已创建
            if (mIsCreate) {
                Log.e(TAG, "it seems that we haven't created this in database yet");
                return null;
            }

            JSONObject note = new JSONObject();
            // 处理普通笔记类型
            if (mType == Notes.TYPE_NOTE) {
                // 添加所有笔记字段
                note.put(NoteColumns.ID,  mId);
                note.put(NoteColumns.ALERTED_DATE,  mAlertDate);
                note.put(NoteColumns.BG_COLOR_ID,  mBgColorId);
                note.put(NoteColumns.CREATED_DATE,  mCreatedDate);
                note.put(NoteColumns.HAS_ATTACHMENT,  mHasAttachment);
                note.put(NoteColumns.MODIFIED_DATE,  mModifiedDate);
                note.put(NoteColumns.PARENT_ID,  mParentId);
                note.put(NoteColumns.SNIPPET,  mSnippet);
                note.put(NoteColumns.TYPE,  mType);
                note.put(NoteColumns.WIDGET_ID,  mWidgetId);
                note.put(NoteColumns.WIDGET_TYPE,  mWidgetType);
                note.put(NoteColumns.ORIGIN_PARENT_ID,  mOriginParent);
                js.put(GTaskStringUtils.META_HEAD_NOTE,  note);

                // 处理关联数据
                JSONArray dataArray = new JSONArray();
                for (SqlData sqlData : mDataList) {
                    JSONObject data = sqlData.getContent();
                    if (data != null) {
                        dataArray.put(data);
                    }
                }
                js.put(GTaskStringUtils.META_HEAD_DATA,  dataArray);
            }
            // 处理文件夹和系统类型
            else if (mType == Notes.TYPE_FOLDER || mType == Notes.TYPE_SYSTEM) {
                // 只包含必要字段
                note.put(NoteColumns.ID,  mId);
                note.put(NoteColumns.TYPE,  mType);
                note.put(NoteColumns.SNIPPET,  mSnippet);
                js.put(GTaskStringUtils.META_HEAD_NOTE,  note);
            }

            return js;
        } catch (JSONException e) {
            Log.e(TAG, e.toString());
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 设置父笔记ID
     * @param id 父笔记ID
     */
    public void setParentId(long id) {
        mParentId = id;
        mDiffNoteValues.put(NoteColumns.PARENT_ID,  id);
    }

    /**
     * 设置Google任务ID
     * @param gid Google任务ID
     */
    public void setGtaskId(String gid) {
        mDiffNoteValues.put(NoteColumns.GTASK_ID,  gid);
    }

    /**
     * 设置同步ID
     * @param syncId 同步ID
     */
    public void setSyncId(long syncId) {
        mDiffNoteValues.put(NoteColumns.SYNC_ID,  syncId);
    }

    /**
     * 重置本地修改标记
     */
    public void resetLocalModified() {
        mDiffNoteValues.put(NoteColumns.LOCAL_MODIFIED,  0);
    }

    /**
     * 获取笔记ID
     * @return 笔记ID
     */
    public long getId() {
        return mId;
    }

    /**
     * 获取父笔记ID
     * @return 父笔记ID
     */
    public long getParentId() {
        return mParentId;
    }

    /**
     * 获取内容摘要
     * @return 内容摘要
     */
    public String getSnippet() {
        return mSnippet;
    }

    /**
     * 检查是否为普通笔记类型
     * @return 如果是普通笔记返回true
     */
    public boolean isNoteType() {
        return mType == Notes.TYPE_NOTE;
    }

    /**
     * 提交笔记数据到数据库
     * @param validateVersion 是否验证版本
     */
    @RequiresApi(api = Build.VERSION_CODES.R)
    public void commit(boolean validateVersion) {
        // 处理新建笔记
        if (mIsCreate) {
            // 如果ID无效且有ID变更，移除无效ID
            if (mId == INVALID_ID && mDiffNoteValues.containsKey(NoteColumns.ID))  {
                mDiffNoteValues.remove(NoteColumns.ID);
            }

            // 插入新笔记
            Uri uri = mContentResolver.insert(Notes.CONTENT_NOTE_URI,  mDiffNoteValues);
            try {
                // 从返回的URI中解析出新笔记ID
                mId = Long.parseLong(Objects.requireNonNull(uri).getPathSegments().get(1));
            } catch (NumberFormatException e) {
                Log.e(TAG, "Get note id error :" + e.toString());
                throw new ActionFailureException("create note failed");
            }

            // 检查是否创建成功
            if (mId == 0) {
                throw new IllegalStateException("Create thread id failed");
            }

            // 如果是普通笔记，提交关联数据
            if (mType == Notes.TYPE_NOTE) {
                for (SqlData sqlData : mDataList) {
                    sqlData.commit(mId,  false, -1);
                }
            }
        }
        // 处理已有笔记更新
        else {
            // 检查笔记ID有效性
            if (mId <= 0 && mId != Notes.ID_ROOT_FOLDER && mId != Notes.ID_CALL_RECORD_FOLDER) {
                Log.e(TAG, "No such note");
                throw new IllegalStateException("Try to update note with invalid id");
            }

            // 如果有变更值
            if (!mDiffNoteValues.isEmpty())  {
                mVersion++; // 版本号递增
                int result = 0;

                // 根据是否验证版本执行不同的更新
                if (!validateVersion) {
                    // 普通更新
                    result = mContentResolver.update(
                            Notes.CONTENT_NOTE_URI,
                            mDiffNoteValues,
                            "(" + NoteColumns.ID + "=?)",
                            new String[]{ String.valueOf(mId)  }
                    );
                } else {
                    // 带版本验证的更新
                    result = mContentResolver.update(
                            Notes.CONTENT_NOTE_URI,
                            mDiffNoteValues,
                            "(" + NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)",
                            new String[]{ String.valueOf(mId),  String.valueOf(mVersion)  }
                    );
                }

                // 检查更新结果
                if (result == 0) {
                    Log.w(TAG, "there is no update. maybe user updates note when syncing");
                }
            }

            // 如果是普通笔记，提交关联数据
            if (mType == Notes.TYPE_NOTE) {
                for (SqlData sqlData : mDataList) {
                    sqlData.commit(mId,  validateVersion, mVersion);
                }
            }
        }

        // 刷新本地数据
        loadFromCursor(mId);
        if (mType == Notes.TYPE_NOTE)
            loadDataContent();

        // 重置状态
        mDiffNoteValues.clear();
        mIsCreate = false;
    }
}
