piy3algkx
/
Notes-master
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

注释修改

Browse Source
wangzhe
rio 2 years ago
parent dd4426d11f
commit 32748860ea
6 changed files with 350 additions and 42 deletions
Show Stats Download Patch File Download Diff File

BIN
.gradle/8.0/fileHashes/fileHashes.lock
View File

Binary file not shown.

32
app/src/main/java/net/micode/notes/data/Contact.java
Unescape View File

@ -3,16 +3,14 @@
package net.micode.notes.data;
// 导入的类
import android.content.Context;
import android.database.Cursor;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.Data;
import android.telephony.PhoneNumberUtils;
import android.util.Log;
import java.util.HashMap;
// 联系人类，用于管理联系人信息
import android.content.Context; // 提供应用程序环境的全局信息，如资源、启动活动、接收广播等
import android.database.Cursor; // 用于对数据库查询结果进行读取和遍历的接口
import android.provider.ContactsContract.CommonDataKinds.Phone; // 定义联系人电话信息的数据结构和常量
import android.provider.ContactsContract.Data; // 定义用于访问Android联系人数据表的常量
import android.telephony.PhoneNumberUtils; // 提供电话号码相关的实用程序方法，如格式化
import android.util.Log; // Android日志工具类，用于打印日志信息
import java.util.HashMap;// 联系人类，用于管理联系人信息
public class Contact {
// 缓存联系人名称与电话号码的映射关系
private static HashMap<String, String> sContactCache;
@ -73,3 +71,19 @@ public class Contact {
}
}
}
//用于与联系人相关数据交互的助手类。该类主要目的是从设备的联系人数据库中检索并缓存联系人名称。
//
//核心操作是 `getContact` 函数，它检查给定电话号码是否已缓存。如果没有，在联系人数据库中查找匹配的联系人，并将结果缓存以加速后续查询。
//
//以下是对这段代码的解释和注释：
//
//- `Context` 类是Android应用程序的环境信息接口，通过它可以访问资源、启动活动或服务等。
//- `Cursor` 提供了遍历数据库查询结果集的接口。
//- `ContactsContract.CommonDataKinds.Phone` 和 `ContactsContract.Data` 提供了访问联系人相关数据的特定字段和常量。
//- `PhoneNumberUtils` 包含了一些与电话号码操作相关的辅助函数，如格式化电话号码。
//- `Log` 用于输出调试信息。
//- `HashMap<String, String>` 用于缓存电话号码和联系人名称的对应关系。
//
//在 `getContact` 函数中，代码通过查询Android的联系人数据库来获取电话号码对应的显示名称。查询使用了特定的选择字符串 `CALLER_ID_SELECTION`，其中采用了匹配电话号码的过滤条件。
//
//当找到匹配的电话号码时，联系人名称会被放入缓存中并返回。如果没有找到匹配项或查询过程中发生异常，将会记录相应的日志。

4
app/src/main/java/net/micode/notes/data/Notes.java
Unescape View File

@ -18,7 +18,7 @@
// 包声明，指定这个文件属于哪个包
package net.micode.notes.data;
// 导入所需的类
// 用于表示网络和文件系统中的统一资源标识符（URI）。它通常用于在Android应用程序中处理URL和文件路径。
import android.net.Uri;
// 定义一个公开的 Notes 类，用于管理笔记相关的数据和常量
@ -31,7 +31,7 @@ public class Notes {
// 定义不同类型的笔记
public static final int TYPE_NOTE = 0; // 普通笔记类型
public static final int TYPE_FOLDER = 1; // 文件夹类型
public static final int TYPE_FOLDER = 1; // 文件夹类型，用于组织笔记
public static final int TYPE_SYSTEM = 2; // 系统文件夹类型
// 系统文件夹的标识符

333
app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java
Unescape View File

@ -19,111 +19,388 @@
package net.micode.notes.data;
// 导入所需的类
// 导入ContentValues类，用于存储和传递以键值对形式存储的数据，便于操作数据库中的行
import android.content.ContentValues;
// 导入Context类，代表应用程序环境的上下文，可以访问应用级别的资源、类和服务
import android.content.Context;
// 导入SQLiteDatabase类，代表SQLite数据库的一个实例，提供创建、查询、更新和删除数据库中数据的方法
import android.database.sqlite.SQLiteDatabase;
// 导入SQLiteOpenHelper类，用于管理数据库的创建和版本管理，是SQLite数据库访问的一个辅助类
import android.database.sqlite.SQLiteOpenHelper;
// 导入Log类，用于输出日志，方便调试和测试
import android.util.Log;
// 导入DataColumns接口，定义了Notes数据库中data表的数据库列名和类型
import net.micode.notes.data.Notes.DataColumns;
// 导入DataConstants类，定义了与Notes数据相关联的一些常量值
import net.micode.notes.data.Notes.DataConstants;
// 导入NoteColumns接口，定义了Notes数据库中note表的数据库列名和类型
import net.micode.notes.data.Notes.NoteColumns;
// 创建一个数据库帮助类，用于处理记事本应用的数据库创建和版本管理
public class NotesDatabaseHelper extends SQLiteOpenHelper {
// 定义数据库的名称和版本
private static final String DB_NAME = "note.db";
private static final int DB_VERSION = 4;
private static final int DB_VERSION = 4;
// 定义表名的常量接口
public interface TABLE {
public static final String NOTE = "note";
public static final String DATA = "data";
}
// 日志记录的标签
private static final String TAG = "NotesDatabaseHelper";
private static final String TAG = "NotesDatabaseHelper";
// 使用单例模式，保证只有一个实例化对象
private static NotesDatabaseHelper mInstance;
private static NotesDatabaseHelper mInstance;
// 包含创建Note表SQL语句的字符串
private static final String CREATE_NOTE_TABLE_SQL =
// 使用“CREATE TABLE”SQL命令创建note表。为Note表定义列名和列类型。
// Note表用来存储记事本的信息，例如ID、父ID、创建日期、修改日期等。
"...";
private static final String CREATE_NOTE_TABLE_SQL =
"CREATE TABLE " + TABLE.NOTE + "(" +
NoteColumns.ID + " INTEGER PRIMARY KEY," +
NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +
NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +
NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
")";
// 包含创建Data表SQL语句的字符串
private static final String CREATE_DATA_TABLE_SQL =
// 使用“CREATE TABLE”SQL命令创建data表。为Data表定义列名和列类型。
// Data表用来存储note的内容和附件信息等。
"...";
private static final String CREATE_DATA_TABLE_SQL =
"CREATE TABLE " + TABLE.DATA + "(" +
DataColumns.ID + " INTEGER PRIMARY KEY," +
DataColumns.MIME_TYPE + " TEXT NOT NULL," +
DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
DataColumns.CONTENT + " TEXT NOT NULL DEFAULT ''," +
DataColumns.DATA1 + " INTEGER," +
DataColumns.DATA2 + " INTEGER," +
DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," +
DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +
DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +
")";
// 包含创建Data的Note表索引SQL语句的字符串
private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
"CREATE INDEX IF NOT EXISTS note_id_index ON " +
TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
/**
* Increase folder's note count when move note to the folder
*/
// 包含创建触发器的SQL语句的字符串
// 触发器用于在更新、插入或删除note时自动更新相关的信息。
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER = "...";
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER = "...";
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER = "...";
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER = "...";
// ...更多触发器定义省略
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
"CREATE TRIGGER increase_folder_count_on_update "+
" AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
" WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
" END";
/**
* Decrease folder's note count when move note from folder
*/
//在更新笔记的PARENT_ID字段后，更新父文件夹的NOTES_COUNT字段，将其减少1。
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
"CREATE TRIGGER decrease_folder_count_on_update " +
" AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
" WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
" AND " + NoteColumns.NOTES_COUNT + ">0" + ";" +
" END";
/**
* Increase folder's note count when insert new note to the folder
*/
//在插入新笔记到文件夹时，更新父文件夹的NOTES_COUNT字段，将其增加1。
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
"CREATE TRIGGER increase_folder_count_on_insert " +
" AFTER INSERT ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
" WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
" END";
/**
* Decrease folder's note count when delete note from the folder
*/
//在从文件夹中删除笔记时，更新父文件夹的NOTES_COUNT字段，将其减少1。
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
"CREATE TRIGGER decrease_folder_count_on_delete " +
" AFTER DELETE ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
" WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
" AND " + NoteColumns.NOTES_COUNT + ">0;" +
" END";
/**
* Update note's content when insert data with type {@link DataConstants#NOTE}
*/
//在插入类型为"NOTE"的新数据时，更新笔记的内容。
private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
"CREATE TRIGGER update_note_content_on_insert " +
" AFTER INSERT ON " + TABLE.DATA +
" WHEN new." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
" WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
" END";
/**
* Update note's content when data with {@link DataConstants#NOTE} type has changed
*/
//当类型为"NOTE"的数据发生更改时，更新笔记的内容。
private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
"CREATE TRIGGER update_note_content_on_update " +
" AFTER UPDATE ON " + TABLE.DATA +
" WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
" WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
" END";
/**
* Update note's content when data with {@link DataConstants#NOTE} type has deleted
*/
//当类型为"NOTE"的数据被删除时，更新笔记的内容。
private static final String DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER =
"CREATE TRIGGER update_note_content_on_delete " +
" AFTER delete ON " + TABLE.DATA +
" WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.SNIPPET + "=''" +
" WHERE " + NoteColumns.ID + "=old." + DataColumns.NOTE_ID + ";" +
" END";
/**
* Delete datas belong to note which has been deleted
*/
//当删除一个笔记时，删除与该笔记关联的数据。
private static final String NOTE_DELETE_DATA_ON_DELETE_TRIGGER =
"CREATE TRIGGER delete_data_on_delete " +
" AFTER DELETE ON " + TABLE.NOTE +
" BEGIN" +
" DELETE FROM " + TABLE.DATA +
" WHERE " + DataColumns.NOTE_ID + "=old." + NoteColumns.ID + ";" +
" END";
/**
* Delete notes belong to folder which has been deleted
*/
//当删除一个文件夹时，删除属于该文件夹的所有笔记。
private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
"CREATE TRIGGER folder_delete_notes_on_delete " +
" AFTER DELETE ON " + TABLE.NOTE +
" BEGIN" +
" DELETE FROM " + TABLE.NOTE +
" WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
" END";
/**
* Move notes belong to folder which has been moved to trash folder
*/
//当将一个文件夹移动到垃圾文件夹时，将属于该文件夹的所有笔记也移动到垃圾文件夹中。
private static final String FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER =
"CREATE TRIGGER folder_move_notes_on_trash " +
" AFTER UPDATE ON " + TABLE.NOTE +
" WHEN new." + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
" WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
" END";
// 用来实例化NotesDatabaseHelper的公共构造函数。
// 需要传入Context对象来实例化SQLiteOpenHelper。
public NotesDatabaseHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION);
}
// 用于创建Note表的方法
public void createNoteTable(SQLiteDatabase db) {
db.execSQL(CREATE_NOTE_TABLE_SQL);
reCreateNoteTableTriggers(db);
createSystemFolder(db);
Log.d(TAG, "note table has been created");
}
//方法用于重新创建笔记表的触发器。它首先删除现有的触发器，
// 然后执行一系列的CREATE TRIGGER语句来创建新的触发器。
private void reCreateNoteTableTriggers(SQLiteDatabase db) {
db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_update");
db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_update");
db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_delete");
db.execSQL("DROP TRIGGER IF EXISTS delete_data_on_delete");
db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_insert");
db.execSQL("DROP TRIGGER IF EXISTS folder_delete_notes_on_delete");
db.execSQL("DROP TRIGGER IF EXISTS folder_move_notes_on_trash");
db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER);
db.execSQL(NOTE_DELETE_DATA_ON_DELETE_TRIGGER);
db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER);
db.execSQL(FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER);
db.execSQL(FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER);
}
//用于创建系统文件夹。它向NOTE表中插入了一些系统文件夹的记录，
// 包括通话记录文件夹、根文件夹、临时文件夹和垃圾文件夹。
private void createSystemFolder(SQLiteDatabase db) {
ContentValues values = new ContentValues();
// ... 类的其他部分包括更多触发器的创建、重建、以及表的升级方法已经省略。
/**
* call record foler for call notes
*/
values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER);
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
db.insert(TABLE.NOTE, null, values);
/**
* root folder which is default folder
*/
values.clear();
values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER);
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
db.insert(TABLE.NOTE, null, values);
/**
* temporary folder which is used for moving note
*/
values.clear();
values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER);
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
db.insert(TABLE.NOTE, null, values);
/**
* create trash folder
*/
values.clear();
values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
db.insert(TABLE.NOTE, null, values);
}
//用于创建数据表。它首先执行一个CREATE TABLE语句来创建数据表，
// 然后调用reCreateDataTableTriggers方法来重新创建数据表的触发器。
public void createDataTable(SQLiteDatabase db) {
db.execSQL(CREATE_DATA_TABLE_SQL);
reCreateDataTableTriggers(db);
db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL);
Log.d(TAG, "data table has been created");
}
//用于重新创建数据表的触发器。
private void reCreateDataTableTriggers(SQLiteDatabase db) {
db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert");
db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_update");
db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_delete");
db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER);
db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER);
db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER);
}
// getInstance方法用于获取NotesDatabaseHelper的单例对象。
// 如果还没有创建，它会创建一个新的实例并返回；如果已经创建，它将返回现有实例。
static synchronized NotesDatabaseHelper getInstance(Context context) {
if (mInstance == null) {
mInstance = new NotesDatabaseHelper(context);
}
return mInstance;
}
// 当数据库首次创建时调用onCreate方法。这个方法里调用前面定义的创建表的方法
// 当数据库首次创建时调用onCreate方法。这个方法里调用前面定义的创建表的方法。
@Override
public void onCreate(SQLiteDatabase db) {
createNoteTable(db);
createDataTable(db);
}
// 如果数据库版本升级，onUpgrade方法将被调用。
// 这个方法包含多种情况下的升级逻辑，以确保数据库结构是最新的。
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// ... 升级相关代码已省略
}
boolean reCreateTriggers = false;
boolean skipV2 = false;
if (oldVersion == 1) {
upgradeToV2(db);
skipV2 = true; // this upgrade including the upgrade from v2 to v3
oldVersion++;
}
if (oldVersion == 2 && !skipV2) {
upgradeToV3(db);
reCreateTriggers = true;
oldVersion++;
}
if (oldVersion == 3) {
upgradeToV4(db);
oldVersion++;
}
if (reCreateTriggers) {
reCreateNoteTableTriggers(db);
reCreateDataTableTriggers(db);
}
if (oldVersion != newVersion) {
throw new IllegalStateException("Upgrade notes database to version " + newVersion
+ "fails");
}
}
// 包含从数据库版本1升级到版本2的方法。
private void upgradeToV2(SQLiteDatabase db) {
// ... 升级逻辑已省略
db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE);
db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA);
createNoteTable(db);
createDataTable(db);
}
// 包含从数据库版本2升级到版本3的方法。
private void upgradeToV3(SQLiteDatabase db) {
// ... 升级逻辑已省略
// drop unused triggers
db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert");
db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_delete");
db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_update");
// add a column for gtask id
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.GTASK_ID
+ " TEXT NOT NULL DEFAULT ''");
// add a trash system folder
ContentValues values = new ContentValues();
values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
db.insert(TABLE.NOTE, null, values);
}
// 包含从数据库版本3升级到版本4的方法。
private void upgradeToV4(SQLiteDatabase db) {
// ... 升级逻辑已省略
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
+ " INTEGER NOT NULL DEFAULT 0");
}
}

23
app/src/main/java/net/micode/notes/data/NotesProvider.java
Unescape View File

@ -14,9 +14,10 @@
* limitations under the License.
*/
// 定义应用程序的数据包名
package net.micode.notes.data;
// 导入安卓系统类准备数据库和URI操作
import android.app.SearchManager;
import android.content.ContentProvider;
import android.content.ContentUris;
@ -29,18 +30,22 @@ import android.net.Uri;
import android.text.TextUtils;
import android.util.Log;
// 导入自定义类用于数据库字段和资源引用
import net.micode.notes.R;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.NotesDatabaseHelper.TABLE;
public class NotesProvider extends ContentProvider {
// URI匹配器，用于匹配传入的URI到指定操作
private static final UriMatcher mMatcher;
// SQLite数据库辅助类实例
private NotesDatabaseHelper mHelper;
// Log的标签
private static final String TAG = "NotesProvider";
// 定义URI类型的常量
private static final int URI_NOTE = 1;
private static final int URI_NOTE_ITEM = 2;
@ -49,6 +54,7 @@ public class NotesProvider extends ContentProvider {
private static final int URI_SEARCH = 5;
private static final int URI_SEARCH_SUGGEST = 6;
// 在静态初始化块中初始化URI匹配器，并将不同类型的URI添加到匹配器
static {
mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
@ -65,6 +71,7 @@ public class NotesProvider extends ContentProvider {
* x'0A' represents the '\n' character in sqlite. For title and content in the search result,
* we will trim '\n' and white space in order to show more information.
*/
// 定义用于搜索提议和搜索查询的SQL语句，移除字符串中的换行，并配置各列属性
private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
+ NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
+ "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
@ -78,12 +85,14 @@ public class NotesProvider extends ContentProvider {
+ " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
+ " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
+ " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
// 当ContentProvider被创建时会调用onCreate，并初始化DatabaseHelper
@Override
public boolean onCreate() {
mHelper = NotesDatabaseHelper.getInstance(getContext());
return true;
}
// 实现ContentProvider的query方法，针对不同类型的URI执行不同的查询
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
@ -146,6 +155,7 @@ public class NotesProvider extends ContentProvider {
}
return c;
}
// 实现ContentProvider的insert方法，根据不同URI在相应的表中插入数据
@Override
public Uri insert(Uri uri, ContentValues values) {
@ -180,6 +190,7 @@ public class NotesProvider extends ContentProvider {
return ContentUris.withAppendedId(uri, insertedId);
}
// 实现ContentProvider的delete方法，根据不同URI从相应的表中删除数据
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
@ -226,6 +237,7 @@ public class NotesProvider extends ContentProvider {
}
return count;
}
// 实现ContentProvider的update方法，根据不同URI更新相应表中的数据
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
@ -266,10 +278,12 @@ public class NotesProvider extends ContentProvider {
}
return count;
}
// 将额外的筛选条件附加到SQL查询的WHERE子句，用于SQL构建
private String parseSelection(String selection) {
return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
}
// 当执行更新操作时增加笔记的版本，用于更新追踪更改
private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
StringBuilder sql = new StringBuilder(120);
@ -295,7 +309,7 @@ public class NotesProvider extends ContentProvider {
mHelper.getWritableDatabase().execSQL(sql.toString());
}
// 根据传入的URI返回相应的MIME类型
@Override
public String getType(Uri uri) {
// TODO Auto-generated method stub
@ -303,3 +317,6 @@ public class NotesProvider extends ContentProvider {
}
}
//数据管理，包括创建、查询、更新和删除笔记和相关数据。它采用 `UriMatcher` 来识别不同的请求类型，
// 实现了数据的CRUD操作。代码中也定义了触发器来自动更新关联数据，如删除笔记时级联删除相关数据等，以确保数据一致性。

0
app/src/main/java/net/micode/notes/data/草稿.java
Unescape View File

Write Preview
Loading…
Cancel
Save