5MI/Note.java

// 包声明，定义了该类所在的包名
package net.micode.notes.model;

// 导入所需的Android类库
import android.content.ContentProviderOperation;
import android.content.ContentProviderResult;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.Context;
import android.content.OperationApplicationException;
import android.net.Uri;
import android.os.RemoteException;
import android.util.Log;

// 导入项目中定义的数据表和列名
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.CallNote;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.Notes.TextNote;

import java.util.ArrayList;

// 定义Note类，用于表示一个便签
public class Note {
    // 用于存储便签数据的ContentValues对象
    private ContentValues mNoteDiffValues;
    // 用于存储便签数据的NoteData对象
    private NoteData mNoteData;
    // 定义日志标签
    private static final String TAG = "Note";

    /**
     * 创建一个新的便签ID，用于将新的便签添加到数据库中
     */
    public static synchronized long getNewNoteId(Context context, long folderId) {
        // 创建一个新的便签记录
        ContentValues values = new ContentValues();
        long createdTime = System.currentTimeMillis();
        values.put(NoteColumns.CREATED_DATE, createdTime); // 设置创建时间
        values.put(NoteColumns.MODIFIED_DATE, createdTime); // 设置修改时间
        values.put(NoteColumns.TYPE, Notes.TYPE_NOTE); // 设置便签类型
        values.put(NoteColumns.LOCAL_MODIFIED, 1); // 设置本地修改标志
        values.put(NoteColumns.PARENT_ID, folderId); // 设置父ID，即文件夹ID
        Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values); // 插入便签记录

        long noteId = 0;
        try {
            noteId = Long.valueOf(uri.getPathSegments().get(1)); // 获取新创建的便签ID
        } catch (NumberFormatException e) {
            Log.e(TAG, "Get note id error :" + e.toString()); // 捕获异常并记录日志
            noteId = 0;
        }
        if (noteId == -1) {
            throw new IllegalStateException("Wrong note id:" + noteId); // 抛出异常
        }
        return noteId;
    }

    // Note类的构造函数
    public Note() {
        mNoteDiffValues = new ContentValues(); // 初始化ContentValues对象
        mNoteData = new NoteData(); // 初始化NoteData对象
    }

    // 设置便签的值
    public void setNoteValue(String key, String value) {
        mNoteDiffValues.put(key, value); // 将键值对放入ContentValues
        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1); // 设置本地修改标志
        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 设置修改时间
    }

    // 设置文本数据
    public void setTextData(String key, String value) {
        mNoteData.setTextData(key, value); // 调用NoteData的方法设置文本数据
    }

    // 设置文本数据ID
    public void setTextDataId(long id) {
        mNoteData.setTextDataId(id); // 调用NoteData的方法设置文本数据ID
    }

    // 获取文本数据ID
    public long getTextDataId() {
        return mNoteData.mTextDataId; // 返回文本数据ID
    }

    // 设置通话数据ID
    public void setCallDataId(long id) {
        mNoteData.setCallDataId(id); // 调用NoteData的方法设置通话数据ID
    }

    // 设置通话数据
    public void setCallData(String key, String value) {
        mNoteData.setCallData(key, value); // 调用NoteData的方法设置通话数据
    }

    // 判断便签是否本地修改过
    public boolean isLocalModified() {
        return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified(); // 返回是否修改过
    }

    // 同步便签数据
    public boolean syncNote(Context context, long noteId) {
        if (noteId <= 0) {
            throw new IllegalArgumentException("Wrong note id:" + noteId); // 抛出异常
        }

        if (!isLocalModified()) {
            return true; // 如果没有修改过，直接返回true
        }

        // 理论上，一旦数据发生变化，便签的LOCAL_MODIFIED和MODIFIED_DATE都应该更新
        if (context.getContentResolver().update(
                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
                null) == 0) {
            Log.e(TAG, "Update note error, should not happen"); // 记录日志
            // Do not return, fall through
        }
        mNoteDiffValues.clear(); // 清空ContentValues

        if (mNoteData.isLocalModified()
                && (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
            return false; // 如果NoteData同步失败，返回false
        }

        return true; // 同步成功，返回true
    }

    // 定义NoteData内部类，用于存储便签的文本数据和通话数据
    private class NoteData {
        private long mTextDataId; // 文本数据ID
        private ContentValues mTextDataValues; // 文本数据的ContentValues对象
        private long mCallDataId; // 通话数据ID
        private ContentValues mCallDataValues; // 通话数据的ContentValues对象
        private static final String TAG = "NoteData"; // 日志标签

        public NoteData() {
            mTextDataValues = new ContentValues(); // 初始化文本数据的ContentValues对象
            mCallDataValues = new ContentValues(); // 初始化通话数据的ContentValues对象
            mTextDataId = 0; // 初始化文本数据ID
            mCallDataId = 0; // 初始化通话数据ID
        }

        // 判断NoteData是否本地修改过
        boolean isLocalModified() {
            return mTextDataValues.size() > 0 || mCallDataValues.size() > 0; // 返回是否修改过
        }

        // 设置文本数据ID
        void setTextDataId(long id) {
            if(id <= 0) {
                throw new IllegalArgumentException("Text data id should larger than 0"); // 抛出异常
            }
            mTextDataId = id; // 设置文本数据ID
        }

        // 设置通话数据ID
        void setCallDataId(long id) {
            if (id <= 0) {
                throw new IllegalArgumentException("Call data id should larger than 0"); // 抛出异常
            }
            mCallDataId = id; // 设置通话数据ID
        }

        // 设置通话数据
        void setCallData(String key, String value) {
            mCallDataValues.put(key, value); // 将键值对放入通话数据的ContentValues
            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1); // 设置本地修改标志
            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 设置修改时间
        }

        // 设置文本数据
        void setTextData(String key, String value) {
            mTextDataValues.put(key, value); // 将键值对放入文本数据的ContentValues
            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1); // 设置本地修改标志
            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 设置修改时间
        }

        // 将NoteData的数据推送到ContentResolver
        Uri pushIntoContentResolver(Context context, long noteId) {
            if (noteId <= 0) {
                throw new IllegalArgumentException("Wrong note id:" + noteId); // 抛出异常
            }

            ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>(); // 操作列表
            ContentProviderOperation.Builder builder = null;

            if(mTextDataValues.size() > 0) {
                mTextDataValues.put(DataColumns.NOTE_ID, noteId); // 设置便签ID
                if (mTextDataId == 0) {
                    mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE); // 设置MIME类型
                    Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
                            mTextDataValues); // 插入文本数据
                    try {
                        setTextDataId(Long.valueOf(uri.getPathSegments().get(1))); // 获取并设置文本数据ID
                    } catch (NumberFormatException e) {
                        Log.e(TAG, "Insert new text data fail with noteId" + noteId); // 记录日志
                        mTextDataValues.clear(); // 清空ContentValues
                        return null;
                    }
                } else {
                    builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
                            Notes.CONTENT_DATA_URI, mTextDataId)); // 创建更新操作
                    builder.withValues(mTextDataValues); // 设置更新的值
                    operationList.add(builder.build()); // 添加到操作列表
                }
                mTextDataValues.clear(); // 清空ContentValues
}
	        if(mCallDataValues.size() > 0) {
            mCallDataValues.put(DataColumns.NOTE_ID, noteId); // 设置便签ID
            if (mCallDataId == 0) {
                mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE); // 设置MIME类型
                Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
                        mCallDataValues); // 插入通话数据
                try {
                    setCallDataId(Long.valueOf(uri.getPathSegments().get(1))); // 获取并设置通话数据ID
                } catch (NumberFormatException e) {
                    Log.e(TAG, "Insert new call data fail with noteId" + noteId); // 记录日志
                    mCallDataValues.clear(); // 清空ContentValues
                    return null;
                }
            } else {
                builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
                        Notes.CONTENT_DATA_URI, mCallDataId)); // 创建更新操作
                builder.withValues(mCallDataValues); // 设置更新的值
                operationList.add(builder.build()); // 添加到操作列表
            }
            mCallDataValues.clear(); // 清空ContentValues
        }

        if (operationList.size() > 0) {
            try {
                ContentProviderResult[] results = context.getContentResolver().applyBatch(
                        Notes.AUTHORITY, operationList); // 批量执行操作
                return (results == null || results.length == 0 || results[0] == null) ? null
                        : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId); // 返回更新后的URI
            } catch (RemoteException e) {
                Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); // 记录日志
                return null;
            } catch (OperationApplicationException e) {
                Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); // 记录日志
                return null;
            }
        }
        return null;
    }
}