标注

src/data/NotesProvider.java

@@ -1,320 +0,0 @@
-package net.micode.notes.data;
-
-import android.app.SearchManager;
-import android.content.ContentProvider;
-import android.content.ContentUris;
-import android.content.ContentValues;
-import android.content.Intent;
-import android.content.UriMatcher;
-import android.database.Cursor;
-import android.database.sqlite.SQLiteDatabase;
-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;
-//为存储和获取数据提供接口。可以在不同的应用程序之间共享数据
-//ContentProvider提供的方法
-//query：查询
-//insert：插入
-//update：更新
-//delete：删除
-//getType：得到数据类型
-public class NotesProvider extends ContentProvider {
-    // UriMatcher用于匹配Uri
-    private static final UriMatcher mMatcher;
-
-    private NotesDatabaseHelper mHelper;
-
-    private static final String TAG = "NotesProvider";
-
-    private static final int URI_NOTE            = 1;
-    private static final int URI_NOTE_ITEM       = 2;
-    private static final int URI_DATA            = 3;
-    private static final int URI_DATA_ITEM       = 4;
-
-    private static final int URI_SEARCH          = 5;
-    private static final int URI_SEARCH_SUGGEST  = 6;
-
-    static {
-        // 创建UriMatcher时，调用UriMatcher(UriMatcher.NO_MATCH)表示不匹配任何路径的返回码
-        mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
-        // 把需要匹配Uri路径全部给注册上
-        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
-        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
-        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
-        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
-        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);
-    }
-
-    /**
-     * 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.
-     */
-    // 声明 NOTES_SEARCH_PROJECTION
-    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 + ","
-            + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
-            + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
-            + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
-            + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
-    // 声明NOTES_SNIPPET_SEARCH_QUERY
-    private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
-            + " FROM " + TABLE.NOTE
-            + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
-            + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
-            + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
-
-    @Override
-    // Context只有在onCreate()中才被初始化
-    // 对mHelper进行实例化
-    public boolean onCreate() {
-        mHelper = NotesDatabaseHelper.getInstance(getContext());
-        return true;
-    }
-
-    @Override
-    // 查询uri在数据库中对应的位置
-    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
-                        String sortOrder) {
-        Cursor c = null;
-        // 获取可读数据库
-        SQLiteDatabase db = mHelper.getReadableDatabase();
-        String id = null;
-        // 匹配查找uri
-        switch (mMatcher.match(uri)) {
-            // 对于不同的匹配值，在数据库中查找相应的条目
-            case URI_NOTE:
-                c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
-                        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);
-                break;
-            case URI_DATA:
-                c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
-                        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);
-                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");
-                }
-
-                String searchString = null;
-                if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
-                    if (uri.getPathSegments().size() > 1) {
-                        // getPathSegments()方法得到一个String的List，
-                        // 在uri.getPathSegments().get(1)为第2个元素
-                        searchString = uri.getPathSegments().get(1);
-                    }
-                } else {
-                    searchString = uri.getQueryParameter("pattern");
-                }
-
-                if (TextUtils.isEmpty(searchString)) {
-                    return null;
-                }
-
-                try {
-                    searchString = String.format("%%%s%%", searchString);
-                    c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
-                            new String[] { searchString });
-                } catch (IllegalStateException ex) {
-                    Log.e(TAG, "got exception: " + ex.toString());
-                }
-                break;
-            default:
-                // 抛出异常
-                throw new IllegalArgumentException("Unknown URI " + uri);
-        }
-        if (c != null) {
-            c.setNotificationUri(getContext().getContentResolver(), uri);
-        }
-        return c;
-    }
-
-    @Override
-    // 插入一个uri
-    public Uri insert(Uri uri, ContentValues values) {
-        // 获得可写的数据库
-        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);
-                break;
-            // 如果存在，查找NOTE_ID
-            case URI_DATA:
-                if (values.containsKey(DataColumns.NOTE_ID)) {
-                    noteId = values.getAsLong(DataColumns.NOTE_ID);
-                } else {
-                    Log.d(TAG, "Wrong data format without note id:" + values.toString());
-                }
-                insertedId = dataId = db.insert(TABLE.DATA, null, values);
-                break;
-            default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
-        }
-        // Notify the note uri
-        // notifyChange获得一个ContextResolver对象并且更新里面的内容
-        if (noteId > 0) {
-            getContext().getContentResolver().notifyChange(
-                    ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
-        }
-
-        // Notify the data uri
-        if (dataId > 0) {
-            getContext().getContentResolver().notifyChange(
-                    ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
-        }
-
-        // 返回插入的uri的路径
-        return ContentUris.withAppendedId(uri, insertedId);
-    }
-
-    @Override
-    // 删除一个uri
-    public int delete(Uri uri, String selection, String[] selectionArgs) {
-        //Uri代表要操作的数据，Android上可用的每种资源 -包括 图像、视频片段、音频资源等都可以用Uri来表示。
-        int count = 0;
-        String id = null;
-        // 获得可写的数据库
-        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);
-                break;
-            case URI_NOTE_ITEM:
-                id = uri.getPathSegments().get(1);
-                /**
-                 * ID that smaller than 0 is system folder which is not allowed to
-                 * trash
-                 */
-                long noteId = Long.valueOf(id);
-                if (noteId <= 0) {
-                    break;
-                }
-                count = db.delete(TABLE.NOTE,
-                        NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
-                break;
-            case URI_DATA:
-                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);
-                deleteData = true;
-                break;
-            default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
-        }
-        if (count > 0) {
-            if (deleteData) {
-                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
-            }
-            getContext().getContentResolver().notifyChange(uri, null);
-        }
-        return count;
-    }
-
-    @Override
-    // 更新一个uri
-    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
-        int count = 0;
-        String id = null;
-        SQLiteDatabase db = mHelper.getWritableDatabase();
-        boolean updateData = false;
-        switch (mMatcher.match(uri)) {
-            case URI_NOTE:
-                increaseNoteVersion(-1, 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);
-                count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
-                        + parseSelection(selection), selectionArgs);
-                break;
-            case URI_DATA:
-                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);
-                updateData = true;
-                break;
-            default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
-        }
-
-        if (count > 0) {
-            if (updateData) {
-                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
-            }
-            getContext().getContentResolver().notifyChange(uri, null);
-        }
-        return count;
-    }
-
-    // 将字符串解析成规定格式
-    private String parseSelection(String selection) {
-        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
-    }
-
-    //增加一个noteVersion
-    private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
-        StringBuilder sql = new StringBuilder(120);
-        sql.append("UPDATE ");
-        sql.append(TABLE.NOTE);
-        sql.append(" SET ");
-        sql.append(NoteColumns.VERSION);
-        sql.append("=" + NoteColumns.VERSION + "+1 ");
-
-        if (id > 0 || !TextUtils.isEmpty(selection)) {
-            sql.append(" WHERE ");
-        }
-        if (id > 0) {
-            sql.append(NoteColumns.ID + "=" + String.valueOf(id));
-        }
-        if (!TextUtils.isEmpty(selection)) {
-            String selectString = id > 0 ? parseSelection(selection) : selection;
-            for (String args : selectionArgs) {
-                selectString = selectString.replaceFirst("\\?", args);
-            }
-            sql.append(selectString);
-        }
-
-        // execSQL()方法可以执行insert、delete、update和CREATE TABLE之类有更改行为的SQL语句
-        mHelper.getWritableDatabase().execSQL(sql.toString());
-    }
-
-    @Override
-    public String getType(Uri uri) {
-        // TODO Auto-generated method stub
-        return null;
-    }
-
-}

src/main/java/net/micode/notes/ui/AlarmAlertActivity.java

@@ -46,23 +46,21 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        // 设置界面显示——无标题
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
+
+        requestWindowFeature(Window.FEATURE_NO_TITLE);//设置界面显示——无标题
 
         final Window win = getWindow();
-        // 设置窗体属性——在锁屏时显示
-        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
+
+        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);//设置窗体属性——在锁屏时显示
 
         if (!isScreenOn()) {
-            // 设置窗体属性——保持点亮、点亮屏幕、允许点亮时解锁
-            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON//保持点亮、点亮屏幕、允许点亮时解锁
                     | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
         }
 
-        // 获取传递的 Intent
-        Intent intent = getIntent();
+        Intent intent = getIntent();//获取传递的 Intent
 
         try {
             // 从 Intent 中获取数据并处理——获取标签 ID
@@ -80,24 +78,33 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
 
         mPlayer = new MediaPlayer();
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
-            // 显示对话框
-            showActionDialog();
-            // 播放闹钟提示音
-            playAlarmSound();
+            showActionDialog();// 显示对话框
+            playAlarmSound();// 播放闹钟提示音
         } else {
-            // 结束当前 Activity
-            finish();
+            finish();// 结束当前 Activity
         }
     }
-
+    /**
+     * @method  isScreenOn
+     * @description
+     * 判断屏幕是否锁屏，调用系统函数判断，最后返回值是布尔类型
+     * @date: 12/23/2023 11:21 PM
+     * @author: YangYizhe
+     * @param
+     * @return
+     */
     private boolean isScreenOn() {
-        //判断屏幕是否锁屏，调用系统函数判断，最后返回值是布尔类型
         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
         return pm.isScreenOn();
     }
-
+    /**
+     * @method  playAlarmSound
+     * @description
+     * 播放闹钟提示音
+     * @date: 12/23/2023 11:21 PM
+     * @author: YangYizhe
+     */
     private void playAlarmSound() {
-        //闹钟提示音激发
         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
         //调用系统的铃声管理URI，得到闹钟提示音
         int silentModeStreams = Settings.System.getInt(getContentResolver(),
@@ -110,19 +117,12 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         }
         try {
             mPlayer.setDataSource(this, url);
-            //方法：setDataSource(Context context, Uri uri) 
-            //解释：无返回值，设置多媒体数据来源【根据 Uri】
             mPlayer.prepare();
-            //准备同步
-            mPlayer.setLooping(true);
-            //设置是否循环播放
-            mPlayer.start();
-            //开始播放
+            mPlayer.setLooping(true);//设置是否循环播放
+            mPlayer.start();//开始播放
         } catch (IllegalArgumentException e) {
             // TODO Auto-generated catch block
             e.printStackTrace();
-            //e.printStackTrace()函数功能是抛出异常， 还将显示出更深的调用信息
-            //System.out.println(e)，这个方法打印出异常，并且输出在哪里出现的异常
         } catch (SecurityException e) {
             // TODO Auto-generated catch block
             e.printStackTrace();
@@ -134,61 +134,67 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
             e.printStackTrace();
         }
     }
-
-    private void showActionDialog() {
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
-        /* AlertDialog的构造方法全部是Protected的
+    /**
+     * @method  showActionDialog
+     * @description
+     * AlertDialog的构造方法全部是Protected的
      * 所以不能直接通过new一个AlertDialog来创建出一个AlertDialog。
      * 要创建一个AlertDialog，就要用到AlertDialog.Builder中的create()方法
      * 如这里的dialog就是新建了一个AlertDialog
+     * @date: 12/23/2023 11:28 PM
+     * @author: YangYizhe
      */
-        dialog.setTitle(R.string.app_name);
-        //为对话框设置标题
-        dialog.setMessage(mSnippet);
-        //为对话框设置内容
-        dialog.setPositiveButton(R.string.notealert_ok, this);
-        //给对话框添加"Yes"按钮
+    private void showActionDialog() {
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+        dialog.setTitle(R.string.app_name);//为对话框设置标题
+        dialog.setMessage(mSnippet);//为对话框设置内容
+        dialog.setPositiveButton(R.string.notealert_ok, this);//给对话框添加"Yes"按钮
         if (isScreenOn()) {
-            dialog.setNegativeButton(R.string.notealert_enter, this);
-        }//对话框添加"No"按钮
+            dialog.setNegativeButton(R.string.notealert_enter, this);//对话框添加"No"按钮
+        }
         dialog.show().setOnDismissListener(this);
     }
-
+    /**
+     * @method  onClick
+     * @description 处理点击事件
+     * @date: 12/23/2023 11:27 PM
+     * @author: YangYizhe
+     * @param dialog
+     * @param which
+     */
     public void onClick(DialogInterface dialog, int which) {
-        switch (which) {
-            //用which来选择click后下一步的操作
-            case DialogInterface.BUTTON_NEGATIVE:
-                //这是取消操作
-                Intent intent = new Intent(this, NoteEditActivity.class);
-                //实现两个类间的数据传输
-                intent.setAction(Intent.ACTION_VIEW);
-                //设置动作属性
-                intent.putExtra(Intent.EXTRA_UID, mNoteId);
-                //实现key-value对
-                //EXTRA_UID为key；mNoteId为键
-                startActivity(intent);
-                //开始动作
+        switch (which) {//用which来选择click后下一步的操作
+            case DialogInterface.BUTTON_NEGATIVE://这是取消操作
+                Intent intent = new Intent(this, NoteEditActivity.class);//实现两个类间的数据传输
+                intent.setAction(Intent.ACTION_VIEW);//设置动作属性
+                intent.putExtra(Intent.EXTRA_UID, mNoteId);//实现key-value对     EXTRA_UID为key；mNoteId为键
+                startActivity(intent);//开始动作
                 break;
             default:
-                //这是确定操作
                 break;
         }
     }
-
+    /**
+     * @method  onDismiss
+     * @description 忽略
+     * @date: 12/23/2023 11:25 PM
+     * @author: YangYizhe
+     * @param dialog
+     */
     public void onDismiss(DialogInterface dialog) {
-        //忽略
-        stopAlarmSound();
-        //停止闹钟声音
+        stopAlarmSound();//停止闹钟声音
         finish();
-        //完成该动作
     }
-
+    /**
+     * @method  stopAlarmSound
+     * @description 停止闹钟的声音
+     * @date: 12/23/2023 11:26 PM
+     * @author: YangYizhe
+     */
     private void stopAlarmSound() {
         if (mPlayer != null) {
-            mPlayer.stop();
-            //停止播放
-            mPlayer.release();
-            //释放MediaPlayer对象
+            mPlayer.stop();//停止播放
+            mPlayer.release();//释放MediaPlayer对象
             mPlayer = null;
         }
     }