Update AlarmAlertActivity.java

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

@@ -1,17 +1,15 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
+ * 本文件授权使用 Apache License, Version 2.0（以下简称“许可证”）；
- * 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.
  */
 
 // 导入必要的类和接口
@@ -21,8 +19,6 @@ import android.app.Activity;
 import android.app.AlertDialog;
 import android.content.Context;
 import android.content.DialogInterface;
-import android.content.DialogInterface.OnClickListener;
-import android.content.DialogInterface.OnDismissListener;
 import android.content.Intent;
 import android.media.AudioManager;
 import android.media.MediaPlayer;
@@ -40,171 +36,138 @@ import net.micode.notes.tool.DataUtils;
 
 import java.io.IOException;
 
-// AlarmAlertActivity类，继承自Activity，实现OnClickListener和OnDismissListener接口
+/**
-public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
+ * AlarmAlertActivity 类用于处理闹钟提醒功能。
-    private long mNoteId;      //文本在数据库存储中的ID号 
+ * 当闹钟时间到达时，该 Activity 会被触发，显示一个对话框并播放闹钟声音。
-    private String mSnippet;   //闹钟提示时出现的文本片段
+ */
-    private static final int SNIPPET_PREW_MAX_LEN = 60;
+public class AlarmAlertActivity extends Activity implements DialogInterface.OnClickListener, DialogInterface.OnDismissListener {
-    MediaPlayer mPlayer;
+    private long mNoteId;      // 便签在数据库中的 ID
- 
+    private String mSnippet;   // 闹钟提示时显示的文本片段
+    private static final int SNIPPET_PREVIEW_MAX_LEN = 60; // 文本片段的最大长度
+    private MediaPlayer mPlayer; // 用于播放闹钟声音的 MediaPlayer
+
     @Override
-    protected void onCreate(Bundle savedInstanceState) {    
+    protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        //Bundle类型的数据与Map类型的数据相似，都是以key-value的形式存储数据的
+        requestWindowFeature(Window.FEATURE_NO_TITLE); // 去掉标题栏
-        //onsaveInstanceState方法是用来保存Activity的状态的
+
-        //能从onCreate的参数savedInsanceState中获得状态数据
-        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
-            		//保持窗体点亮
                     | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
-                    //将窗体点亮
                     | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
-                    //允许窗体点亮时锁屏
                     | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
-        }//在手机锁屏后如果到了闹钟提示时间，点亮屏幕
+        }
- 
+
         Intent intent = getIntent();
- 
         try {
             mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
             mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
-            //根据ID从数据库中获取标签的内容；
+            if (mSnippet.length() > SNIPPET_PREVIEW_MAX_LEN) {
-            //getContentResolver（）是实现数据共享，实例存储。
+                mSnippet = mSnippet.substring(0, SNIPPET_PREVIEW_MAX_LEN) + getResources().getString(R.string.notelist_string_info);
-            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
+            }
-                    SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
-                    : mSnippet;
-            //判断标签片段是否达到符合长度
         } catch (IllegalArgumentException e) {
             e.printStackTrace();
             return;
         }
-        /*
+
-        try
-        {
-        	// 代码区
-        }
-        catch(Exception e)
-        {
-        	// 异常处理
-        }
-                     代码区如果有错误，就会返回所写异常的处理。*/
         mPlayer = new MediaPlayer();
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
             showActionDialog();
-            //弹出对话框
             playAlarmSound();
-            //闹钟提示音激发
         } else {
             finish();
-            //完成闹钟动作
         }
     }
- 
+
+    /**
+     * 检查屏幕是否处于开启状态。
+     * @return true 表示屏幕开启，false 表示屏幕关闭。
+     */
     private boolean isScreenOn() {
-    	//判断屏幕是否锁屏，调用系统函数判断，最后返回值是布尔类型
         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
         return pm.isScreenOn();
     }
- 
+
+    /**
+     * 播放闹钟声音。
+     */
     private void playAlarmSound() {
-    	//闹钟提示音激发
         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
-        //调用系统的铃声管理URI，得到闹钟提示音
+        int silentModeStreams = Settings.System.getInt(getContentResolver(), Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
-        int silentModeStreams = Settings.System.getInt(getContentResolver(),
+
-                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
- 
         if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
             mPlayer.setAudioStreamType(silentModeStreams);
         } else {
             mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
         }
+
         try {
             mPlayer.setDataSource(this, url);
-            //方法：setDataSource(Context context, Uri uri) 
-            //解释：无返回值，设置多媒体数据来源【根据 Uri】
             mPlayer.prepare();
-            //准备同步
             mPlayer.setLooping(true);
-            //设置是否循环播放
             mPlayer.start();
-            //开始播放
+        } catch (IllegalArgumentException | SecurityException | IllegalStateException | IOException e) {
-        } 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();
-        } catch (IllegalStateException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        } catch (IOException e) {
-            // TODO Auto-generated catch block
             e.printStackTrace();
         }
     }
- 
+
+    /**
+     * 显示操作对话框。
+     */
     private void showActionDialog() {
         AlertDialog.Builder dialog = new AlertDialog.Builder(this);
-        //AlertDialog的构造方法全部是Protected的
-        //所以不能直接通过new一个AlertDialog来创建出一个AlertDialog。
-        //要创建一个AlertDialog，就要用到AlertDialog.Builder中的create()方法
-        //如这里的dialog就是新建了一个AlertDialog
         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.show().setOnDismissListener(this);
     }
- 
+
+    /**
+     * 对话框按钮点击事件处理。
+     * @param dialog 对话框对象。
+     * @param which 被点击的按钮。
+     */
+    @Override
     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);
-                //开始动作
                 break;
             default:
-            	//这是确定操作
+                // 确定操作，不做任何处理
                 break;
         }
     }
- 
+
+    /**
+     * 对话框关闭事件处理。
+     * @param dialog 对话框对象。
+     */
+    @Override
     public void onDismiss(DialogInterface dialog) {
-    	//忽略
         stopAlarmSound();
-        //停止闹钟声音
         finish();
-        //完成该动作
     }
- 
+
+    /**
+     * 停止闹钟声音。
+     */
     private void stopAlarmSound() {
         if (mPlayer != null) {
             mPlayer.stop();
-            //停止播放
             mPlayer.release();
-            //释放MediaPlayer对象
             mPlayer = null;
         }
     }
-}
+}