Update NotesProvider.java

xiaomi/src/data/NotesProvider.java

@@ -16,7 +16,6 @@
 
 package net.micode.notes.data;
 
-
 import android.app.SearchManager;
 import android.content.ContentProvider;
 import android.content.ContentUris;
@@ -34,7 +33,6 @@ 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 {
     private static final UriMatcher mMatcher;
 
@@ -42,28 +40,28 @@ public class NotesProvider extends ContentProvider {
 
     private static final String TAG = "NotesProvider";
 
-    private static final int URI_NOTE            = 1;
+    private static final int URI_NOTE            = 1; // 笔记表 URI
-    private static final int URI_NOTE_ITEM       = 2;
+    private static final int URI_NOTE_ITEM       = 2; // 单条笔记 URI
-    private static final int URI_DATA            = 3;
+    private static final int URI_DATA            = 3; // 数据表 URI
-    private static final int URI_DATA_ITEM       = 4;
+    private static final int URI_DATA_ITEM       = 4; // 单条数据 URI
 
-    private static final int URI_SEARCH          = 5;
+    private static final int URI_SEARCH          = 5; // 搜索 URI
-    private static final int URI_SEARCH_SUGGEST  = 6;
+    private static final int URI_SEARCH_SUGGEST  = 6; // 搜索建议 URI
 
     static {
         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
-        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
+        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE); // 匹配笔记表
-        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM); // 匹配单条笔记
-        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
+        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA); // 匹配数据表
-        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM); // 匹配单条数据
-        mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH);
+        mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH); // 匹配搜索
-        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST); // 匹配搜索建议
-        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST); // 匹配带参数的搜索建议
     }
 
     /**
-     * x'0A' represents the '\n' character in sqlite. For title and content in the search result,
+     * x'0A' 代表 sqlite 中的 '\n' 字符。对于搜索结果中的标题和内容，
-     * we will trim '\n' and white space in order to show more information.
+     * 我们将修剪 '\n' 和空格，以便显示更多信息。
      */
     private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
         + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
@@ -81,7 +79,7 @@ public class NotesProvider extends ContentProvider {
 
     @Override
     public boolean onCreate() {
-        mHelper = NotesDatabaseHelper.getInstance(getContext());
+        mHelper = NotesDatabaseHelper.getInstance(getContext()); // 获取数据库帮助类实例
         return true;
     }
 
@@ -89,41 +87,41 @@ public class NotesProvider extends ContentProvider {
     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
             String sortOrder) {
         Cursor c = null;
-        SQLiteDatabase db = mHelper.getReadableDatabase();
+        SQLiteDatabase db = mHelper.getReadableDatabase(); // 获取可读数据库
         String id = null;
         switch (mMatcher.match(uri)) {
             case URI_NOTE:
                 c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
-                        sortOrder);
+                        sortOrder); // 查询笔记表
                 break;
             case URI_NOTE_ITEM:
                 id = uri.getPathSegments().get(1);
                 c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
-                        + parseSelection(selection), selectionArgs, null, null, sortOrder);
+                        + parseSelection(selection), selectionArgs, null, null, sortOrder); // 查询单条笔记
                 break;
             case URI_DATA:
                 c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
-                        sortOrder);
+                        sortOrder); // 查询数据表
                 break;
             case URI_DATA_ITEM:
                 id = uri.getPathSegments().get(1);
                 c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
-                        + parseSelection(selection), selectionArgs, null, null, sortOrder);
+                        + parseSelection(selection), selectionArgs, null, null, sortOrder); // 查询单条数据
                 break;
             case URI_SEARCH:
             case URI_SEARCH_SUGGEST:
                 if (sortOrder != null || projection != null) {
                     throw new IllegalArgumentException(
-                            "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
+                            "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query"); // 不允许指定排序、选择条件或投影
                 }
 
                 String searchString = null;
                 if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
                     if (uri.getPathSegments().size() > 1) {
-                        searchString = uri.getPathSegments().get(1);
+                        searchString = uri.getPathSegments().get(1); // 获取搜索字符串
                     }
                 } else {
-                    searchString = uri.getQueryParameter("pattern");
+                    searchString = uri.getQueryParameter("pattern"); // 获取搜索模式
                 }
 
                 if (TextUtils.isEmpty(searchString)) {
@@ -131,98 +129,97 @@ public class NotesProvider extends ContentProvider {
                 }
 
                 try {
-                    searchString = String.format("%%%s%%", searchString);
+                    searchString = String.format("%%%s%%", searchString); // 格式化搜索字符串
                     c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
-                            new String[] { searchString });
+                            new String[] { searchString }); // 执行搜索查询
                 } catch (IllegalStateException ex) {
                     Log.e(TAG, "got exception: " + ex.toString());
                 }
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("Unknown URI " + uri); // 未知 URI
         }
         if (c != null) {
-            c.setNotificationUri(getContext().getContentResolver(), uri);
+            c.setNotificationUri(getContext().getContentResolver(), uri); // 设置通知 URI
         }
         return c;
     }
 
     @Override
     public Uri insert(Uri uri, ContentValues values) {
-        SQLiteDatabase db = mHelper.getWritableDatabase();
+        SQLiteDatabase db = mHelper.getWritableDatabase(); // 获取可写数据库
         long dataId = 0, noteId = 0, insertedId = 0;
         switch (mMatcher.match(uri)) {
             case URI_NOTE:
-                insertedId = noteId = db.insert(TABLE.NOTE, null, values);
+                insertedId = noteId = db.insert(TABLE.NOTE, null, values); // 插入笔记
                 break;
             case URI_DATA:
                 if (values.containsKey(DataColumns.NOTE_ID)) {
-                    noteId = values.getAsLong(DataColumns.NOTE_ID);
+                    noteId = values.getAsLong(DataColumns.NOTE_ID); // 获取笔记 ID
                 } else {
                     Log.d(TAG, "Wrong data format without note id:" + values.toString());
                 }
-                insertedId = dataId = db.insert(TABLE.DATA, null, values);
+                insertedId = dataId = db.insert(TABLE.DATA, null, values); // 插入数据
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("Unknown URI " + uri); // 未知 URI
         }
-        // Notify the note uri
+        // 通知笔记 URI
         if (noteId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
         }
 
-        // Notify the data uri
+        // 通知数据 URI
         if (dataId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
         }
 
-        return ContentUris.withAppendedId(uri, insertedId);
+        return ContentUris.withAppendedId(uri, insertedId); // 返回插入的 URI
     }
 
     @Override
     public int delete(Uri uri, String selection, String[] selectionArgs) {
         int count = 0;
         String id = null;
-        SQLiteDatabase db = mHelper.getWritableDatabase();
+        SQLiteDatabase db = mHelper.getWritableDatabase(); // 获取可写数据库
         boolean deleteData = false;
         switch (mMatcher.match(uri)) {
             case URI_NOTE:
                 selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
-                count = db.delete(TABLE.NOTE, selection, selectionArgs);
+                count = db.delete(TABLE.NOTE, selection, selectionArgs); // 删除笔记
                 break;
             case URI_NOTE_ITEM:
                 id = uri.getPathSegments().get(1);
                 /**
-                 * ID that smaller than 0 is system folder which is not allowed to
+                 * ID 小于 0 的系统文件夹不允许删除
-                 * trash
                  */
                 long noteId = Long.valueOf(id);
                 if (noteId <= 0) {
                     break;
                 }
                 count = db.delete(TABLE.NOTE,
-                        NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                        NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs); // 删除单条笔记
                 break;
             case URI_DATA:
-                count = db.delete(TABLE.DATA, selection, selectionArgs);
+                count = db.delete(TABLE.DATA, selection, selectionArgs); // 删除数据
                 deleteData = true;
                 break;
             case URI_DATA_ITEM:
                 id = uri.getPathSegments().get(1);
                 count = db.delete(TABLE.DATA,
-                        DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                        DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs); // 删除单条数据
                 deleteData = true;
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("Unknown URI " + uri); // 未知 URI
         }
         if (count > 0) {
             if (deleteData) {
-                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null); // 通知笔记 URI
             }
-            getContext().getContentResolver().notifyChange(uri, null);
+            getContext().getContentResolver().notifyChange(uri, null); // 通知数据 URI
         }
         return count;
     }
@@ -231,44 +228,44 @@ public class NotesProvider extends ContentProvider {
     public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
         int count = 0;
         String id = null;
-        SQLiteDatabase db = mHelper.getWritableDatabase();
+        SQLiteDatabase db = mHelper.getWritableDatabase(); // 获取可写数据库
         boolean updateData = false;
         switch (mMatcher.match(uri)) {
             case URI_NOTE:
-                increaseNoteVersion(-1, selection, selectionArgs);
+                increaseNoteVersion(-1, selection, selectionArgs); // 增加笔记版本
-                count = db.update(TABLE.NOTE, values, selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, selection, selectionArgs); // 更新笔记
                 break;
             case URI_NOTE_ITEM:
                 id = uri.getPathSegments().get(1);
-                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
+                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs); // 增加单条笔记版本
                 count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
-                        + parseSelection(selection), selectionArgs);
+                        + parseSelection(selection), selectionArgs); // 更新单条笔记
                 break;
             case URI_DATA:
-                count = db.update(TABLE.DATA, values, selection, selectionArgs);
+                count = db.update(TABLE.DATA, values, selection, selectionArgs); // 更新数据
                 updateData = true;
                 break;
             case URI_DATA_ITEM:
                 id = uri.getPathSegments().get(1);
                 count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id
-                        + parseSelection(selection), selectionArgs);
+                        + parseSelection(selection), selectionArgs); // 更新单条数据
                 updateData = true;
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("Unknown URI " + uri); // 未知 URI
         }
 
         if (count > 0) {
             if (updateData) {
-                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null); // 通知笔记 URI
             }
-            getContext().getContentResolver().notifyChange(uri, null);
+            getContext().getContentResolver().notifyChange(uri, null); // 通知数据 URI
         }
         return count;
     }
 
     private String parseSelection(String selection) {
-        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
+        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""); // 解析选择条件
     }
 
     private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
@@ -277,23 +274,23 @@ public class NotesProvider extends ContentProvider {
         sql.append(TABLE.NOTE);
         sql.append(" SET ");
         sql.append(NoteColumns.VERSION);
-        sql.append("=" + NoteColumns.VERSION + "+1 ");
+        sql.append("=" + NoteColumns.VERSION + "+1 "); // 增加版本号
 
         if (id > 0 || !TextUtils.isEmpty(selection)) {
             sql.append(" WHERE ");
         }
         if (id > 0) {
-            sql.append(NoteColumns.ID + "=" + String.valueOf(id));
+            sql.append(NoteColumns.ID + "=" + String.valueOf(id)); // 指定 ID
         }
         if (!TextUtils.isEmpty(selection)) {
             String selectString = id > 0 ? parseSelection(selection) : selection;
             for (String args : selectionArgs) {
                 selectString = selectString.replaceFirst("\\?", args);
             }
-            sql.append(selectString);
+            sql.append(selectString); // 添加选择条件
         }
 
-        mHelper.getWritableDatabase().execSQL(sql.toString());
+        mHelper.getWritableDatabase().execSQL(sql.toString()); // 执行 SQL 语句
     }
 
     @Override
@@ -301,5 +298,4 @@ public class NotesProvider extends ContentProvider {
         // TODO Auto-generated method stub
         return null;
     }
-
 }