p2feyuxrl
/
touge
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Compare commits

merge into: p2feyuxrl:liboyang_branch
Branches Tags
p2feyuxrl:master
p2feyuxrl:zhangsiyi_branch
p2feyuxrl:liunan_branch
p2feyuxrl:develop
p2feyuxrl:liboyang_branch
p2feyuxrl:liuhui_branch
p2feyuxrl:main
...
pull from: p2feyuxrl:main
Branches Tags
p2feyuxrl:master
p2feyuxrl:zhangsiyi_branch
p2feyuxrl:liunan_branch
p2feyuxrl:develop
p2feyuxrl:liboyang_branch
p2feyuxrl:liuhui_branch
p2feyuxrl:main

No commits in common. 'liboyang_branch' and 'main' have entirely different histories.
liboyang_b ... main

2 changed files with 2 additions and 391 deletions
Show Stats

2
README.md
Unescape View File

@ -0,0 +1,2 @@
# touge

391
src/Note.java
Unescape View File

@ -1,391 +0,0 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.model;
// 导入内容提供者操作相关类，用于批量操作数据库
import android.content.ContentProviderOperation;
import android.content.ContentProviderResult;
// 用于在URI后面追加ID
import android.content.ContentUris;
// 用于存储键值对数据，类似于Map
import android.content.ContentValues;
// Android上下文类，用于访问系统资源
import android.content.Context;
// 操作应用异常，批量操作时可能抛出
import android.content.OperationApplicationException;
// URI类，用于标识数据资源
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;
// ArrayList列表类
import java.util.ArrayList;
// Note类：表示一个便签的数据模型，负责管理便签的属性和关联数据
public class Note {
// 存储便签本身的属性差异值（修改后的值）
private ContentValues mNoteDiffValues;
// 存储便签关联的数据（文本数据和通话数据）
private NoteData mNoteData;
// 日志标签
private static final String TAG = "Note";
/**
* 创建一个新的便签ID，用于向数据库中添加新便签
* @param context Android上下文
* @param folderId 便签所属的文件夹ID
* @return 新创建的便签ID
*/
public static synchronized long getNewNoteId(Context context, long folderId) {
// 在数据库中创建一个新的便签记录
// ContentValues用于存储要插入的键值对
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);
// 设置父文件夹ID
values.put(NoteColumns.PARENT_ID, folderId);
// 通过内容解析器插入到数据库，返回新记录的URI
Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
// 初始化便签ID为0
long noteId = 0;
try {
// 从URI路径中解析出ID（路径格式通常为 content://authority/note/123）
// getPathSegments().get(1) 获取路径的第二个部分（ID）
noteId = Long.valueOf(uri.getPathSegments().get(1));
} catch (NumberFormatException e) {
// 如果URI格式不正确，记录错误日志
Log.e(TAG, "Get note id error :" + e.toString());
noteId = 0;
}
// 如果ID为-1，说明出现错误，抛出异常
if (noteId == -1) {
throw new IllegalStateException("Wrong note id:" + noteId);
}
// 返回新创建的便签ID
return noteId;
}
// 构造函数：初始化Note对象
public Note() {
// 初始化便签属性差异值容器
mNoteDiffValues = new ContentValues();
// 初始化便签数据对象
mNoteData = new NoteData();
}
// 设置便签的属性值（如标题、背景色等）
// @param key 属性键名
// @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 属性键名
// @param value 属性值
public void setTextData(String key, String value) {
mNoteData.setTextData(key, value);
}
// 设置文本数据的ID
// @param id 文本数据在数据库中的ID
public void setTextDataId(long id) {
mNoteData.setTextDataId(id);
}
// 获取文本数据的ID
// @return 文本数据ID
public long getTextDataId() {
return mNoteData.mTextDataId;
}
// 设置通话记录数据的ID
// @param id 通话数据在数据库中的ID
public void setCallDataId(long id) {
mNoteData.setCallDataId(id);
}
// 设置通话记录数据的属性值
// @param key 属性键名
// @param value 属性值
public void setCallData(String key, String value) {
mNoteData.setCallData(key, value);
}
// 检查本地是否有修改
// @return true表示有修改，false表示无修改
public boolean isLocalModified() {
// 便签属性有修改 或 便签数据有修改，返回true
return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
}
// 同步便签到数据库
// @param context Android上下文
// @param noteId 便签ID
// @return true表示同步成功，false表示失败
public boolean syncNote(Context context, long noteId) {
// 检查便签ID是否有效
if (noteId <= 0) {
throw new IllegalArgumentException("Wrong note id:" + noteId);
}
// 如果本地没有修改，直接返回成功
if (!isLocalModified()) {
return true;
}
/**
* 理论上，一旦数据发生变化，便签应该在NoteColumns.LOCAL_MODIFIED和NoteColumns.MODIFIED_DATE上更新
* 为了数据安全，即使更新便签失败，我们也会更新便签数据信息
*/
// 更新便签属性到数据库
// ContentUris.withAppendedId 将noteId附加到URI后面，形成完整的资源路径
if (context.getContentResolver().update(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
null) == 0) {
// 如果更新失败，记录错误日志
Log.e(TAG, "Update note error, should not happen");
// 不返回，继续执行（为了数据安全）
}
// 清除已同步的差异值
mNoteDiffValues.clear();
// 如果便签数据有修改，尝试推送到数据库
if (mNoteData.isLocalModified()
&& (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
// 如果推送失败，返回false
return false;
}
// 所有同步操作完成，返回成功
return true;
}
// 内部类：NoteData，用于管理便签的关联数据（文本数据和通话记录数据）
private class NoteData {
// 文本数据在数据库中的ID
private long mTextDataId;
// 存储文本数据的属性值
private ContentValues mTextDataValues;
// 通话记录数据在数据库中的ID
private long mCallDataId;
// 存储通话记录数据的属性值
private ContentValues mCallDataValues;
// 日志标签
private static final String TAG = "NoteData";
// 构造函数：初始化NoteData对象
public NoteData() {
// 初始化文本数据容器
mTextDataValues = new ContentValues();
// 初始化通话数据容器
mCallDataValues = new ContentValues();
// 初始化文本数据ID为0
mTextDataId = 0;
// 初始化通话数据ID为0
mCallDataId = 0;
}
// 检查本地数据是否有修改
// @return true表示有修改，false表示无修改
boolean isLocalModified() {
// 文本数据有修改 或 通话数据有修改，返回true
return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
}
// 设置文本数据的ID
// @param id 文本数据ID
void setTextDataId(long id) {
// 检查ID是否有效
if(id <= 0) {
throw new IllegalArgumentException("Text data id should larger than 0");
}
// 设置文本数据ID
mTextDataId = id;
}
// 设置通话记录数据的ID
// @param id 通话数据ID
void setCallDataId(long id) {
// 检查ID是否有效
if (id <= 0) {
throw new IllegalArgumentException("Call data id should larger than 0");
}
// 设置通话数据ID
mCallDataId = id;
}
// 设置通话记录数据的属性值
// @param key 属性键名
// @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 属性键名
// @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());
}
// 将数据推送到ContentResolver（数据库）
// @param context Android上下文
// @param noteId 便签ID
// @return 成功返回URI，失败返回null
Uri pushIntoContentResolver(Context context, long noteId) {
/**
* 安全检查：检查便签ID是否有效
*/
if (noteId <= 0) {
throw new IllegalArgumentException("Wrong note id:" + noteId);
}
// 创建批量操作列表
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
// 批量操作构建器
ContentProviderOperation.Builder builder = null;
// 如果文本数据有修改
if(mTextDataValues.size() > 0) {
// 设置关联的便签ID
mTextDataValues.put(DataColumns.NOTE_ID, noteId);
// 如果文本数据ID为0，说明是新数据，需要插入
if (mTextDataId == 0) {
// 设置MIME类型为文本便签
mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
// 插入到数据库
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
mTextDataValues);
try {
// 从返回的URI中解析出新插入的数据ID
setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
// 如果解析失败，记录错误日志
Log.e(TAG, "Insert new text data fail with noteId" + noteId);
// 清空文本数据容器
mTextDataValues.clear();
return null;
}
} else {
// 如果是已有数据，构建更新操作
// 创建更新操作的构建器，指定要更新的资源URI
builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mTextDataId));
// 设置要更新的值
builder.withValues(mTextDataValues);
// 将操作添加到批量操作列表
operationList.add(builder.build());
}
// 清空文本数据容器
mTextDataValues.clear();
}
// 如果通话记录数据有修改
if(mCallDataValues.size() > 0) {
// 设置关联的便签ID
mCallDataValues.put(DataColumns.NOTE_ID, noteId);
// 如果通话数据ID为0，说明是新数据，需要插入
if (mCallDataId == 0) {
// 设置MIME类型为通话记录
mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
// 插入到数据库
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
mCallDataValues);
try {
// 从返回的URI中解析出新插入的数据ID
setCallDataId(Long.valueOf(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
// 如果解析失败，记录错误日志
Log.e(TAG, "Insert new call data fail with noteId" + noteId);
// 清空通话数据容器
mCallDataValues.clear();
return null;
}
} else {
// 如果是已有数据，构建更新操作
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, 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, 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;
}
}
// 没有需要执行的操作，返回null
return null;
}
}
}
Write Preview
Loading…
Cancel
Save