已经完成ui包中的AlaemAlertActivity类的150行左右的代码精读，后续的ui包精读正在进行中

src/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java

@@ -39,7 +39,9 @@ import net.micode.notes.tool.DataUtils;
 
 import java.io.IOException;
 
-
+/*该类继承自Activity类
+    功能：是实现了OnClickListener和OnDismissListener接口。
+ */
 public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
     private long mNoteId;
     private String mSnippet;
@@ -47,92 +49,103 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
     MediaPlayer mPlayer;
 
     @Override
+    /*
+        功能：首先设置窗口的特性，使得该Activity在锁屏状态下也能显示。
+     */
     protected void onCreate(Bundle savedInstanceState) {
-        super.onCreate(savedInstanceState);
+        super.onCreate(savedInstanceState);//继承父类的oncreate，执行父类方法，并获取由父类保存的activity状态信息
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
+        requestWindowFeature(Window.FEATURE_NO_TITLE);//定义activity活动的界面情况，这里是隐藏标题栏
-
+
-        final Window win = getWindow();
+        final Window win = getWindow();//用win变量获取当前窗口
-        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
+        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);//设定当前窗口标签，设置成锁定在屏幕上方。
-
+        //通过修改 WindowManager.LayoutParams 的属性，可以实现对窗口的自定义布局和交互行为。
-        if (!isScreenOn()) {
+        if (!isScreenOn()) {//使用后边定义的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_TURN_SCREEN_ON//这个标签的意思是如果屏幕是关着的话让屏幕亮起来
-                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON//这个标签的意思是允许屏幕锁屏的时候让屏幕亮起来
-                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
+                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);//这个标签的意思是让窗口布局随着窗口内容得到调整而调整
         }
 
-        Intent intent = getIntent();
+        Intent intent = getIntent();//intent中存的是这个活动的“意图”，这个数据类型可以在不同的Activity之间传递信息。
 
         try {
-            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));//intent中的data是指URL数据他定义了执行这个Activity所需要的数据，将URL解码，取第一个也即Note的ID号
-            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);//使用内容提供器来获取日期信息
             mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
                     SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
-                    : mSnippet;
+                    : mSnippet;//对日期信息进行处理
-        } catch (IllegalArgumentException e) {
+        } catch (IllegalArgumentException e) {//使用catch这个方式来捕捉try中出现的报错，如果上述过程中发生了这个异常，“当方法接收到一个非法或不合理的参数时”，就把异常情况打印出来
             e.printStackTrace();
             return;
         }
 
-        mPlayer = new MediaPlayer();
+        mPlayer = new MediaPlayer(); //创建一个新的多媒体变量传给mPlayer
-        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {//只有普通笔记才会有通知
-            showActionDialog();
+            showActionDialog();//打开操作对话框
-            playAlarmSound();
+            playAlarmSound();//打开播放提示音
         } else {
             finish();
         }
     }
-
+    /*
+    功能：用于判断当前屏幕是否处于开启状态，使用已经写好的PowerManger对象和
+     */
     private boolean isScreenOn() {
-        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
+        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); //使用 getSystemService获取系统服务，指定为获取电源状态
-        return pm.isScreenOn();
+        return pm.isScreenOn(); //使用自带的isScreenOn函数判断屏幕状态
     }
-
+    /*
+    功能：在物理层面上实现播放通知铃声的功能
+     */
     private void playAlarmSound() {
-        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
+        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);//获取默认铃声，是闹钟铃声
 
-        int silentModeStreams = Settings.System.getInt(getContentResolver(),
+        int silentModeStreams = Settings.System.getInt(getContentResolver(),//获取静音模式下影响音频流的类型，如果没有MODE_RINGER_STREAMS_AFFECTED一项也即不处于静音模式的话返回0
                 Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
 
-        if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
+        if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {//如果结果匹配，则将闹钟声音的音频设置成静音模式
             mPlayer.setAudioStreamType(silentModeStreams);
         } else {
-            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
+            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);//不是静音模式的话就正常设置成闹钟音频流
         }
         try {
-            mPlayer.setDataSource(this, url);
+            mPlayer.setDataSource(this, url);//准备设备，将音频源设成url
-            mPlayer.prepare();
+            mPlayer.prepare();//准备设备
-            mPlayer.setLooping(true);
+            mPlayer.setLooping(true);//设置循环
-            mPlayer.start();
+            mPlayer.start();//开始播放
-        } catch (IllegalArgumentException e) {
+        } catch (IllegalArgumentException e) {//try的过程中随时报错，这里有四种错误，这个是参数传递出错
             // TODO Auto-generated catch block
             e.printStackTrace();
-        } catch (SecurityException e) {
+        } catch (SecurityException e) {//这个是权限出错
             // TODO Auto-generated catch block
             e.printStackTrace();
-        } catch (IllegalStateException e) {
+        } catch (IllegalStateException e) {//音频播放器出错
             // TODO Auto-generated catch block
             e.printStackTrace();
-        } catch (IOException e) {
+        } catch (IOException e) {//数据源出错
             // TODO Auto-generated catch block
             e.printStackTrace();
         }
     }
-
+    /*
+    功能：显示一个对话框
+     */
     private void showActionDialog() {
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this);//创建一个新的对话框对象
-        dialog.setTitle(R.string.app_name);
+        dialog.setTitle(R.string.app_name);//设置标题，是app的名字
-        dialog.setMessage(mSnippet);
+        dialog.setMessage(mSnippet);//设置对话框内容，即为前面得到的信息
-        dialog.setPositiveButton(R.string.notealert_ok, this);
+        dialog.setPositiveButton(R.string.notealert_ok, this);//设置按钮，
-        if (isScreenOn()) {
+        if (isScreenOn()) {//如果屏幕是亮的话设置消极按钮
             dialog.setNegativeButton(R.string.notealert_enter, this);
         }
-        dialog.show().setOnDismissListener(this);
+        dialog.show().setOnDismissListener(this);//显示对话框，并显示一些操作
     }
-
+    /*
+    功能：看看是那个按钮被按了
+     */
     public void onClick(DialogInterface dialog, int which) {
         switch (which) {
-            case DialogInterface.BUTTON_NEGATIVE:
+            case DialogInterface.BUTTON_NEGATIVE://如果是消极按钮被按了，那么就是显示到编辑栏中
                 Intent intent = new Intent(this, NoteEditActivity.class);
                 intent.setAction(Intent.ACTION_VIEW);
                 intent.putExtra(Intent.EXTRA_UID, mNoteId);
@@ -142,17 +155,21 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
                 break;
         }
     }
-
+    /*
+    功能：关闭这个对话框的话，就关闭声音并且结束对话框
+     */
     public void onDismiss(DialogInterface dialog) {
         stopAlarmSound();
         finish();
     }
-
+    /*
+    功能：实现关闭铃声的物理层操作
+     */
     private void stopAlarmSound() {
-        if (mPlayer != null) {
+        if (mPlayer != null) {//如果声音还在播的话就。。。
-            mPlayer.stop();
+            mPlayer.stop();//停止声音
-            mPlayer.release();
+            mPlayer.release();//释放空间
-            mPlayer = null;
+            mPlayer = null;//设置成没有声音。
         }
     }
 }