|
|
|
|
|
/*
|
|
|
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
|
|
|
*
|
|
|
* 版权声明：本文件由MiCode开源社区开发，遵循Apache License, Version 2.0协议；
|
|
|
* 您仅在遵守协议的前提下使用本文件，完整协议可通过以下链接获取：
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
* 注：未书面明确要求时，本软件按"原样"提供，不附带任何明示或暗示的保证。
|
|
|
*/
|
|
|
|
|
|
package net.micode.notes.model;
|
|
|
|
|
|
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;
|
|
|
|
|
|
/**
|
|
|
* 笔记模型类
|
|
|
* 负责管理笔记的创建、数据修改（文本/通话记录）以及与数据库的同步操作
|
|
|
*/
|
|
|
public class Note {
|
|
|
// 存储笔记主表（note表）的差异值（待更新的字段）
|
|
|
private ContentValues mNoteDiffValues;
|
|
|
// 存储笔记关联数据（文本/通话记录等子表数据）的管理类实例
|
|
|
private NoteData mNoteData;
|
|
|
private static final String TAG = "Note";
|
|
|
|
|
|
/**
|
|
|
* 静态方法：生成新笔记ID并插入数据库
|
|
|
* @param context 上下文环境
|
|
|
* @param folderId 笔记所属文件夹ID
|
|
|
* @return 新笔记的数据库ID（唯一标识）
|
|
|
*/
|
|
|
public static synchronized long getNewNoteId(Context context, long folderId) {
|
|
|
// 创建新笔记的初始值：创建时间、修改时间、类型、本地修改标志、父文件夹ID
|
|
|
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
|
|
|
|
|
|
// 插入到note表，获取返回的Uri（包含新笔记ID）
|
|
|
Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
|
|
|
|
|
|
long noteId = 0;
|
|
|
try {
|
|
|
// 从Uri路径中解析笔记ID（格式：content://.../notes/[noteId]）
|
|
|
noteId = Long.valueOf(uri.getPathSegments().get(1));
|
|
|
} catch (NumberFormatException e) {
|
|
|
Log.e(TAG, "获取笔记ID失败 :" + e.toString());
|
|
|
noteId = 0;
|
|
|
}
|
|
|
if (noteId == -1) {
|
|
|
throw new IllegalStateException("错误的笔记ID:" + noteId);
|
|
|
}
|
|
|
return noteId;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 构造方法：初始化笔记差异值和数据管理类
|
|
|
*/
|
|
|
public Note() {
|
|
|
mNoteDiffValues = new ContentValues(); // 初始化主表差异值容器
|
|
|
mNoteData = new NoteData(); // 初始化子表数据管理实例
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置笔记主表的属性值（如标题、提醒时间等）
|
|
|
* 每次调用会自动更新本地修改标志和修改时间
|
|
|
* @param key 笔记主表字段名（如NoteColumns.TITLE）
|
|
|
* @param value 字段对应的值
|
|
|
*/
|
|
|
public void setNoteValue(String key, String value) {
|
|
|
mNoteDiffValues.put(key, value);
|
|
|
// 标记本地修改（用于同步判断）
|
|
|
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
|
|
|
// 更新修改时间为当前系统时间
|
|
|
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置文本类型子表数据（如笔记内容）
|
|
|
* @param key 文本数据字段名（如TextNote.CONTENT）
|
|
|
* @param value 字段对应的值
|
|
|
*/
|
|
|
public void setTextData(String key, String value) {
|
|
|
mNoteData.setTextData(key, value);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置文本子表的ID（用于更新已有文本数据）
|
|
|
* @param id 文本数据在data表中的ID（需大于0）
|
|
|
*/
|
|
|
public void setTextDataId(long id) {
|
|
|
mNoteData.setTextDataId(id);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取当前文本子表的ID
|
|
|
* @return 文本数据在data表中的ID（0表示未创建）
|
|
|
*/
|
|
|
public long getTextDataId() {
|
|
|
return mNoteData.mTextDataId;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置通话记录子表的ID（用于更新已有通话数据）
|
|
|
* @param id 通话数据在data表中的ID（需大于0）
|
|
|
*/
|
|
|
public void setCallDataId(long id) {
|
|
|
mNoteData.setCallDataId(id);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置通话记录类型子表数据（如通话号码、时长等）
|
|
|
* @param key 通话数据字段名（如CallNote.NUMBER）
|
|
|
* @param value 字段对应的值
|
|
|
*/
|
|
|
public void setCallData(String key, String value) {
|
|
|
mNoteData.setCallData(key, value);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 判断笔记是否有本地修改（主表或子表数据被修改）
|
|
|
* @return true-有修改；false-无修改
|
|
|
*/
|
|
|
public boolean isLocalModified() {
|
|
|
// 主表差异值非空 或 子表数据有修改时，标记为有本地修改
|
|
|
return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 将笔记的修改同步到数据库（主表+子表）
|
|
|
* @param context 上下文环境
|
|
|
* @param noteId 待同步的笔记ID
|
|
|
* @return 同步成功-true；失败-false
|
|
|
*/
|
|
|
public boolean syncNote(Context context, long noteId) {
|
|
|
if (noteId <= 0) {
|
|
|
throw new IllegalArgumentException("错误的笔记ID:" + noteId);
|
|
|
}
|
|
|
|
|
|
// 无修改时直接返回成功
|
|
|
if (!isLocalModified()) {
|
|
|
return true;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 理论上，数据修改时应更新note表的LOCAL_MODIFIED和MODIFIED_DATE字段。
|
|
|
* 为数据安全，即使note表更新失败，仍尝试同步子表数据
|
|
|
*/
|
|
|
// 更新note表的差异值（如标题、修改时间等）
|
|
|
int updateCount = context.getContentResolver().update(
|
|
|
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), // 目标笔记Uri
|
|
|
mNoteDiffValues, // 待更新的字段
|
|
|
null,
|
|
|
null
|
|
|
);
|
|
|
if (updateCount == 0) {
|
|
|
Log.e(TAG, "更新笔记主表失败（不应发生）");
|
|
|
// 不返回，继续处理子表同步
|
|
|
}
|
|
|
mNoteDiffValues.clear(); // 清空已处理的差异值
|
|
|
|
|
|
// 子表数据有修改时，同步到data表
|
|
|
if (mNoteData.isLocalModified()
|
|
|
&& (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
|
|
|
return false; // 子表同步失败时返回false
|
|
|
}
|
|
|
|
|
|
return true;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 内部类：管理笔记的子表数据（文本/通话记录）
|
|
|
*/
|
|
|
private class NoteData {
|
|
|
private long mTextDataId; // 文本数据在data表中的ID（0表示未创建）
|
|
|
private ContentValues mTextDataValues; // 文本数据的差异值（待更新的字段）
|
|
|
private long mCallDataId; // 通话数据在data表中的ID（0表示未创建）
|
|
|
private ContentValues mCallDataValues; // 通话数据的差异值（待更新的字段）
|
|
|
private static final String TAG = "NoteData";
|
|
|
|
|
|
/**
|
|
|
* 构造方法：初始化子表数据容器
|
|
|
*/
|
|
|
public NoteData() {
|
|
|
mTextDataValues = new ContentValues();
|
|
|
mCallDataValues = new ContentValues();
|
|
|
mTextDataId = 0;
|
|
|
mCallDataId = 0;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 判断子表数据是否有本地修改
|
|
|
* @return true-有修改；false-无修改
|
|
|
*/
|
|
|
boolean isLocalModified() {
|
|
|
// 文本或通话数据差异值非空时，标记为有修改
|
|
|
return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置文本数据ID（校验ID有效性）
|
|
|
* @param id 文本数据在data表中的ID（需>0）
|
|
|
*/
|
|
|
void setTextDataId(long id) {
|
|
|
if (id <= 0) {
|
|
|
throw new IllegalArgumentException("文本数据ID必须大于0");
|
|
|
}
|
|
|
mTextDataId = id;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置通话数据ID（校验ID有效性）
|
|
|
* @param id 通话数据在data表中的ID（需>0）
|
|
|
*/
|
|
|
void setCallDataId(long id) {
|
|
|
if (id <= 0) {
|
|
|
throw new IllegalArgumentException("通话数据ID必须大于0");
|
|
|
}
|
|
|
mCallDataId = id;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置通话数据字段值（自动触发笔记修改标志）
|
|
|
* @param key 通话数据字段名（如CallNote.DURATION）
|
|
|
* @param value 字段值
|
|
|
*/
|
|
|
void setCallData(String key, String value) {
|
|
|
mCallDataValues.put(key, value);
|
|
|
// 同步更新主表的本地修改标志和修改时间
|
|
|
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
|
|
|
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 设置文本数据字段值（自动触发笔记修改标志）
|
|
|
* @param key 文本数据字段名（如TextNote.CONTENT）
|
|
|
* @param value 字段值
|
|
|
*/
|
|
|
void setTextData(String key, String value) {
|
|
|
mTextDataValues.put(key, value);
|
|
|
// 同步更新主表的本地修改标志和修改时间
|
|
|
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
|
|
|
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 将子表数据（文本/通话）插入或更新到数据库
|
|
|
* @param context 上下文环境
|
|
|
* @param noteId 关联的笔记ID
|
|
|
* @return 操作成功返回笔记Uri；失败返回null
|
|
|
*/
|
|
|
Uri pushIntoContentResolver(Context context, long noteId) {
|
|
|
// 校验笔记ID有效性
|
|
|
if (noteId <= 0) {
|
|
|
throw new IllegalArgumentException("错误的笔记ID:" + noteId);
|
|
|
}
|
|
|
|
|
|
// 批量操作容器（用于同时执行多个ContentProvider操作）
|
|
|
ArrayList<ContentProviderOperation> operationList = new ArrayList<>();
|
|
|
ContentProviderOperation.Builder builder = null;
|
|
|
|
|
|
// 处理文本数据
|
|
|
if (mTextDataValues.size() > 0) {
|
|
|
mTextDataValues.put(DataColumns.NOTE_ID, noteId); // 关联笔记ID
|
|
|
|
|
|
if (mTextDataId == 0) { // ID为0表示新增文本数据
|
|
|
// 设置MIME类型为文本笔记
|
|
|
mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
|
|
|
// 插入到data表，获取新数据的Uri
|
|
|
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI, mTextDataValues);
|
|
|
try {
|
|
|
// 解析新数据的ID并保存
|
|
|
setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
|
|
|
} catch (NumberFormatException e) {
|
|
|
Log.e(TAG, "插入新文本数据失败（笔记ID:" + noteId + "）");
|
|
|
mTextDataValues.clear(); // 清空无效数据
|
|
|
return null;
|
|
|
}
|
|
|
} else { // ID非0表示更新已有文本数据
|
|
|
// 构建更新操作（指定data表Uri和待更新值）
|
|
|
builder = ContentProviderOperation.newUpdate(
|
|
|
ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, mTextDataId));
|
|
|
builder.withValues(mTextDataValues);
|
|
|
operationList.add(builder.build()); // 添加到批量操作列表
|
|
|
}
|
|
|
mTextDataValues.clear(); // 清空已处理的差异值
|
|
|
}
|
|
|
|
|
|
// 处理通话数据（逻辑与文本数据类似）
|
|
|
if (mCallDataValues.size() > 0) {
|
|
|
mCallDataValues.put(DataColumns.NOTE_ID, noteId); // 关联笔记ID
|
|
|
|
|
|
if (mCallDataId == 0) { // ID为0表示新增通话数据
|
|
|
// 设置MIME类型为通话记录
|
|
|
mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
|
|
|
// 插入到data表，获取新数据的Uri
|
|
|
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI, mCallDataValues);
|
|
|
try {
|
|
|
// 解析新数据的ID并保存
|
|
|
setCallDataId(Long.valueOf(uri.getPathSegments().get(1)));
|
|
|
} catch (NumberFormatException e) {
|
|
|
Log.e(TAG, "插入新通话数据失败（笔记ID:" + noteId + "）");
|
|
|
mCallDataValues.clear(); // 清空无效数据
|
|
|
return null;
|
|
|
}
|
|
|
} else { // ID非0表示更新已有通话数据
|
|
|
// 构建更新操作（指定data表Uri和待更新值）
|
|
|
builder = ContentProviderOperation.newUpdate(
|
|
|
ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, mCallDataId));
|
|
|
builder.withValues(mCallDataValues);
|
|
|
operationList.add(builder.build()); // 添加到批量操作列表
|
|
|
}
|
|
|
mCallDataValues.clear(); // 清空已处理的差异值
|
|
|
}
|
|
|
|
|
|
// 执行批量操作（仅当有操作需要执行时）
|
|
|
if (operationList.size() > 0) {
|
|
|
try {
|
|
|
ContentProviderResult[] results = context.getContentResolver().applyBatch(
|
|
|
Notes.AUTHORITY, // 内容提供者的AUTHORITY
|
|
|
operationList // 批量操作列表
|
|
|
);
|
|
|
// 操作成功时返回笔记Uri；否则返回null
|
|
|
return (results == null || results.length == 0 || results[0] == null)
|
|
|
? null
|
|
|
: ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId);
|
|
|
} catch (RemoteException e) {
|
|
|
Log.e(TAG, "远程调用异常: " + e.toString() + " - " + e.getMessage());
|
|
|
return null;
|
|
|
} catch (OperationApplicationException e) {
|
|
|
Log.e(TAG, "操作应用异常: " + e.toString() + " - " + e.getMessage());
|
|
|
return null;
|
|
|
}
|
|
|
}
|
|
|
return null;
|
|
|
}
|
|
|
}
|
|
|
} |
