提交

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

@@ -26,39 +26,64 @@ import android.database.Cursor;
 
 import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
+/**
+ * 闹钟初始化接收器 - 用于系统启动后重新注册所有已设置的便签提醒
+ * 
+ * 当设备启动完成或应用更新后，系统会发送特定广播触发此接收器
+ * 它会查询所有设置了未来提醒的便签，并重新注册到系统闹钟服务中
+ * 确保即使设备重启或应用更新，已设置的提醒依然会按时触发
+ */
 
 
 public class AlarmInitReceiver extends BroadcastReceiver {
+    // 查询便签数据时需要获取的列
 
     private static final String [] PROJECTION = new String [] {
-        NoteColumns.ID,
+        NoteColumns.ID,              // 便签ID
-        NoteColumns.ALERTED_DATE
+        NoteColumns.ALERTED_DATE    // 提醒日期时间
     };
+    // 投影列索引常量，提高代码可读性
 
     private static final int COLUMN_ID                = 0;
     private static final int COLUMN_ALERTED_DATE      = 1;
+    /**
+     * 接收广播并处理便签提醒初始化逻辑
+     * 
+     * @param context 应用上下文
+     * @param intent  触发广播的意图
+     */
 
     @Override
     public void onReceive(Context context, Intent intent) {
+        // 获取当前时间戳，用于筛选出未来的提醒
         long currentDate = System.currentTimeMillis();
+        // 查询条件：提醒时间在当前时间之后，并且类型为普通便签
         Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
                 PROJECTION,
                 NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
                 new String[] { String.valueOf(currentDate) },
                 null);
+                // 遍历查询结果，为每个便签设置系统提醒
 
         if (c != null) {
             if (c.moveToFirst()) {
                 do {
+                    // 获取便签提醒时间和ID
                     long alertDate = c.getLong(COLUMN_ALERTED_DATE);
+
+                    // 创建触发闹钟时要发送的广播意图
                     Intent sender = new Intent(context, AlarmReceiver.class);
                     sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
+                    // 创建待处理意图，用于系统在指定时间触发提醒
                     PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
+                    // 获取系统闹钟服务
                     AlarmManager alermManager = (AlarmManager) context
                             .getSystemService(Context.ALARM_SERVICE);
+                            // 设置提醒：使用RTC_WAKEUP类型，确保系统在指定时间唤醒并触发提醒
                     alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
                 } while (c.moveToNext());
             }
+            // 关闭游标，释放资源
             c.close();
         }
     }

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

@@ -19,12 +19,28 @@ package net.micode.notes.ui;
 import android.content.BroadcastReceiver;
 import android.content.Context;
 import android.content.Intent;
+/**
+ * 闹钟提醒接收器 - 负责接收系统闹钟触发的广播并启动提醒界面
+ * 
+ * 当便签设置的提醒时间到达时，系统会发送对应的广播，此接收器会捕获该广播
+ * 并启动一个全屏的提醒活动，向用户展示提醒内容
+ */
 
 public class AlarmReceiver extends BroadcastReceiver {
+    /**
+     * 接收系统闹钟广播并处理提醒逻辑
+     * 
+     * @param context 应用上下文
+     * @param intent  触发广播的意图，包含便签数据和提醒信息
+     */
     @Override
     public void onReceive(Context context, Intent intent) {
+        // 设置要启动的活动类为闹钟提醒界面
         intent.setClass(context, AlarmAlertActivity.class);
+        // 添加FLAG_ACTIVITY_NEW_TASK标志，因为在广播接收器中启动活动需要此标志
+        // 它表示在新的任务栈中启动活动，避免与现有任务栈冲突
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 启动闹钟提醒界面，向用户展示便签提醒
         context.startActivity(intent);
     }
 }

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

@@ -28,60 +28,119 @@ import android.content.DialogInterface;
 import android.content.DialogInterface.OnClickListener;
 import android.text.format.DateFormat;
 import android.text.format.DateUtils;
+/**
+ * 日期时间选择对话框 - 提供用户友好的界面来选择具体的日期和时间
+ * 
+ * 继承自AlertDialog，整合了自定义的DateTimePicker组件
+ * 支持12/24小时制显示，并提供日期时间选择回调接口
+ */
 
 public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
-
+    // 当前选择的日期时间
     private Calendar mDate = Calendar.getInstance();
+    // 是否使用24小时制
     private boolean mIs24HourView;
+    // 日期时间选择回调接口
     private OnDateTimeSetListener mOnDateTimeSetListener;
+    // 自定义的日期时间选择器组件
     private DateTimePicker mDateTimePicker;
+    /**
+     * 日期时间设置回调接口
+     * 当用户确认选择的日期时间时触发
+     */
 
     public interface OnDateTimeSetListener {
+         /**
+         * 当用户设置日期时间时调用
+         * 
+         * @param dialog 日期时间选择对话框实例
+         * @param date   选择的时间戳（毫秒）
+         */
         void OnDateTimeSet(AlertDialog dialog, long date);
     }
+    /**
+     * 构造函数，初始化日期时间选择对话框
+     * 
+     * @param context 应用上下文
+     * @param date    默认选中的时间戳（毫秒）
+     */
 
     public DateTimePickerDialog(Context context, long date) {
+        // 初始化自定义日期时间选择器
         super(context);
         mDateTimePicker = new DateTimePicker(context);
         setView(mDateTimePicker);
+        // 设置日期时间变化监听器
         mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
             public void onDateTimeChanged(DateTimePicker view, int year, int month,
                     int dayOfMonth, int hourOfDay, int minute) {
+                        // 更新内部Calendar对象
                 mDate.set(Calendar.YEAR, year);
                 mDate.set(Calendar.MONTH, month);
                 mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
                 mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
                 mDate.set(Calendar.MINUTE, minute);
+                // 更新对话框标题显示
                 updateTitle(mDate.getTimeInMillis());
             }
         });
+        // 设置初始时间并清除秒数
         mDate.setTimeInMillis(date);
         mDate.set(Calendar.SECOND, 0);
+        // 设置选择器的当前日期时间
         mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
+        // 设置对话框按钮
         setButton(context.getString(R.string.datetime_dialog_ok), this);
         setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
+        // 设置24小时制显示（基于系统设置）
         set24HourView(DateFormat.is24HourFormat(this.getContext()));
+        // 更新对话框标题
         updateTitle(mDate.getTimeInMillis());
     }
+    /**
+     * 设置时间显示格式（12/24小时制）
+     * 
+     * @param is24HourView true表示使用24小时制，false表示使用12小时制
+     */
 
     public void set24HourView(boolean is24HourView) {
         mIs24HourView = is24HourView;
     }
+     /**
+     * 设置日期时间选择回调接口
+     * 
+     * @param callBack 实现了OnDateTimeSetListener接口的回调对象
+     */
 
     public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
         mOnDateTimeSetListener = callBack;
     }
+    /**
+     * 更新对话框标题，显示当前选择的日期时间
+     * 
+     * @param date 要显示的时间戳（毫秒）
+     */
 
     private void updateTitle(long date) {
+        // 设置日期时间显示标志
         int flag =
-            DateUtils.FORMAT_SHOW_YEAR |
+            DateUtils.FORMAT_SHOW_YEAR |  // 显示年份
-            DateUtils.FORMAT_SHOW_DATE |
+            DateUtils.FORMAT_SHOW_DATE |  // 显示日期
-            DateUtils.FORMAT_SHOW_TIME;
+            DateUtils.FORMAT_SHOW_TIME;   // 显示时间
+            // 根据24小时制设置标志
         flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
+        // 更新对话框标题
         setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
     }
+    /**
+     * 处理对话框按钮点击事件
+     * 
+     * @param arg0 对话框接口
+     * @param arg1 按钮标识
+     */
 
     public void onClick(DialogInterface arg0, int arg1) {
+        // 当用户点击"确定"按钮时，调用回调接口
         if (mOnDateTimeSetListener != null) {
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
         }

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

@@ -26,30 +26,60 @@ import android.widget.PopupMenu;
 import android.widget.PopupMenu.OnMenuItemClickListener;
 
 import net.micode.notes.R;
+/**
+ * 下拉菜单组件 - 封装PopupMenu实现按钮点击弹出菜单功能
+ * 
+ * 提供简洁的API来创建和管理下拉菜单，支持自定义菜单项和点击事件处理
+ * 主要用于在按钮点击时显示上下文相关的操作选项
+ */
 
 public class DropdownMenu {
+    // 触发下拉菜单的按钮
     private Button mButton;
+    // 系统弹出菜单组件
     private PopupMenu mPopupMenu;
+    // 菜单对象，用于操作菜单项
     private Menu mMenu;
+    /**
+     * 构造函数，初始化下拉菜单
+     * 
+     * @param context 应用上下文
+     * @param button  触发下拉菜单的按钮
+     * @param menuId  菜单资源ID，定义菜单项
+     */
 
     public DropdownMenu(Context context, Button button, int menuId) {
+        // 保存按钮引用并设置下拉图标
         mButton = button;
         mButton.setBackgroundResource(R.drawable.dropdown_icon);
+        // 初始化PopupMenu并填充菜单项
         mPopupMenu = new PopupMenu(context, mButton);
         mMenu = mPopupMenu.getMenu();
         mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
+        // 设置按钮点击事件，点击时显示菜单
         mButton.setOnClickListener(new OnClickListener() {
             public void onClick(View v) {
                 mPopupMenu.show();
             }
         });
     }
+    /**
+     * 设置菜单项点击监听器
+     * 
+     * @param listener 实现了OnMenuItemClickListener接口的监听器
+     */
 
     public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
         if (mPopupMenu != null) {
             mPopupMenu.setOnMenuItemClickListener(listener);
         }
     }
+    /**
+     * 根据ID查找菜单项
+     * 
+     * @param id 菜单项ID
+     * @return 对应的MenuItem对象，如果未找到则返回null
+     */
 
     public MenuItem findItem(int id) {
         return mMenu.findItem(id);

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

@@ -27,50 +27,104 @@ import android.widget.TextView;
 import net.micode.notes.R;
 import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
+/**
+ * 文件夹列表适配器 - 用于在ListView中显示便签文件夹列表
+ * 
+ * 继承自CursorAdapter，从数据库游标获取文件夹数据并绑定到视图
+ * 支持特殊处理根文件夹，将其显示为"上级文件夹"
+ */
 
 
 public class FoldersListAdapter extends CursorAdapter {
+    // 查询文件夹数据时需要获取的列
     public static final String [] PROJECTION = {
-        NoteColumns.ID,
+        NoteColumns.ID,   // 文件夹ID
-        NoteColumns.SNIPPET
+        NoteColumns.SNIPPET  // 文件夹名称
     };
+     // 投影列索引常量，提高代码可读性
 
     public static final int ID_COLUMN   = 0;
     public static final int NAME_COLUMN = 1;
+    /**
+     * 构造函数，初始化文件夹列表适配器
+     * 
+     * @param context 应用上下文
+     * @param c       包含文件夹数据的游标
+     */
 
     public FoldersListAdapter(Context context, Cursor c) {
         super(context, c);
         // TODO Auto-generated constructor stub
     }
+    /**
+     * 创建新的文件夹列表项视图
+     * 
+     * @param context 应用上下文
+     * @param cursor  当前数据游标
+     * @param parent  父视图组
+     * @return 新创建的FolderListItem视图
+     */
 
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
         return new FolderListItem(context);
     }
+     /**
+     * 将游标数据绑定到已有的视图
+     * 
+     * @param view    要绑定数据的视图
+     * @param context 应用上下文
+     * @param cursor  当前数据游标
+     */
 
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
         if (view instanceof FolderListItem) {
+            // 处理特殊情况：如果是根文件夹，显示"上级文件夹"文本
             String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                     .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
+                    // 绑定文件夹名称到视图
             ((FolderListItem) view).bind(folderName);
         }
     }
+    /**
+     * 获取指定位置的文件夹名称
+     * 
+     * @param context  应用上下文
+     * @param position 列表位置
+     * @return 文件夹名称，如果是根文件夹则返回"上级文件夹"
+     */
 
     public String getFolderName(Context context, int position) {
         Cursor cursor = (Cursor) getItem(position);
         return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                 .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
     }
+    /**
+     * 文件夹列表项视图类 - 表示列表中的一个文件夹项
+     */
 
     private class FolderListItem extends LinearLayout {
+         // 显示文件夹名称的文本视图
         private TextView mName;
+        /**
+         * 构造函数，初始化文件夹列表项视图
+         * 
+         * @param context 应用上下文
+         */
 
         public FolderListItem(Context context) {
             super(context);
+            // 加载布局资源
             inflate(context, R.layout.folder_list_item, this);
+            // 获取文件夹名称文本视图引用
             mName = (TextView) findViewById(R.id.tv_folder_name);
         }
+         /**
+         * 绑定文件夹名称到视图
+         * 
+         * @param name 要显示的文件夹名称
+         */
 
         public void bind(String name) {
             mName.setText(name);