|
|
以下是为 `Notes.java` 文件生成的中文注释：
|
|
|
|
|
|
```java
|
|
|
/*
|
|
|
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
|
|
|
*
|
|
|
* 版权所有，遵循 Apache License 2.0 许可证。
|
|
|
* 您可以从 http://www.apache.org/licenses/LICENSE-2.0 获取许可证副本。
|
|
|
*/
|
|
|
|
|
|
package net.micode.notes.data;
|
|
|
|
|
|
import android.net.Uri;
|
|
|
|
|
|
/**
|
|
|
* Notes 类用于定义笔记和文件夹的相关常量、Uri 和接口。
|
|
|
*/
|
|
|
public class Notes {
|
|
|
/**
|
|
|
* 内容提供者的权威名称。
|
|
|
*/
|
|
|
public static final String AUTHORITY = "micode_notes";
|
|
|
|
|
|
/**
|
|
|
* 日志标签。
|
|
|
*/
|
|
|
public static final String TAG = "Notes";
|
|
|
|
|
|
/**
|
|
|
* 笔记类型。
|
|
|
*/
|
|
|
public static final int TYPE_NOTE = 0;
|
|
|
|
|
|
/**
|
|
|
* 文件夹类型。
|
|
|
*/
|
|
|
public static final int TYPE_FOLDER = 1;
|
|
|
|
|
|
/**
|
|
|
* 系统类型。
|
|
|
*/
|
|
|
public static final int TYPE_SYSTEM = 2;
|
|
|
|
|
|
/**
|
|
|
* 系统文件夹的 ID。
|
|
|
* {@link Notes#ID_ROOT_FOLDER } 是默认文件夹。
|
|
|
* {@link Notes#ID_TEMPARAY_FOLDER } 是未归属文件夹的笔记。
|
|
|
* {@link Notes#ID_CALL_RECORD_FOLDER} 是存储通话记录的文件夹。
|
|
|
*/
|
|
|
public static final int ID_ROOT_FOLDER = 0;
|
|
|
public static final int ID_TEMPARAY_FOLDER = -1;
|
|
|
public static final int ID_CALL_RECORD_FOLDER = -2;
|
|
|
public static final int ID_TRASH_FOLER = -3;
|
|
|
|
|
|
/**
|
|
|
* Intent 额外数据键值对。
|
|
|
*/
|
|
|
public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
|
|
|
public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
|
|
|
public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
|
|
|
public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
|
|
|
public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
|
|
|
public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
|
|
|
|
|
|
/**
|
|
|
* 小部件类型。
|
|
|
*/
|
|
|
public static final int TYPE_WIDGET_INVALIDE = -1;
|
|
|
public static final int TYPE_WIDGET_2X = 0;
|
|
|
public static final int TYPE_WIDGET_4X = 1;
|
|
|
|
|
|
/**
|
|
|
* 数据常量类，包含笔记和通话记录的内容类型。
|
|
|
*/
|
|
|
public static class DataConstants {
|
|
|
public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
|
|
|
public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 查询所有笔记和文件夹的 Uri。
|
|
|
*/
|
|
|
public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
|
|
|
|
|
|
/**
|
|
|
* 查询数据的 Uri。
|
|
|
*/
|
|
|
public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
|
|
|
|
|
|
/**
|
|
|
* 笔记或文件夹的列名接口。
|
|
|
*/
|
|
|
public interface NoteColumns {
|
|
|
/**
|
|
|
* 行的唯一 ID。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String ID = "_id";
|
|
|
|
|
|
/**
|
|
|
* 笔记或文件夹的父级 ID。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String PARENT_ID = "parent_id";
|
|
|
|
|
|
/**
|
|
|
* 创建日期。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String CREATED_DATE = "created_date";
|
|
|
|
|
|
/**
|
|
|
* 最后修改日期。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String MODIFIED_DATE = "modified_date";
|
|
|
|
|
|
/**
|
|
|
* 提醒日期。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String ALERTED_DATE = "alert_date";
|
|
|
|
|
|
/**
|
|
|
* 文件夹名称或笔记文本内容。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String SNIPPET = "snippet";
|
|
|
|
|
|
/**
|
|
|
* 笔记的小部件 ID。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String WIDGET_ID = "widget_id";
|
|
|
|
|
|
/**
|
|
|
* 笔记的小部件类型。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String WIDGET_TYPE = "widget_type";
|
|
|
|
|
|
/**
|
|
|
* 笔记的背景颜色 ID。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String BG_COLOR_ID = "bg_color_id";
|
|
|
|
|
|
/**
|
|
|
* 是否有附件。
|
|
|
* <P> 类型: INTEGER </P>
|
|
|
*/
|
|
|
public static final String HAS_ATTACHMENT = "has_attachment";
|
|
|
|
|
|
/**
|
|
|
* 文件夹中的笔记数量。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String NOTES_COUNT = "notes_count";
|
|
|
|
|
|
/**
|
|
|
* 文件类型：文件夹或笔记。
|
|
|
* <P> 类型: INTEGER </P>
|
|
|
*/
|
|
|
public static final String TYPE = "type";
|
|
|
|
|
|
/**
|
|
|
* 最后同步 ID。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String SYNC_ID = "sync_id";
|
|
|
|
|
|
/**
|
|
|
* 是否本地已修改。
|
|
|
* <P> 类型: INTEGER </P>
|
|
|
*/
|
|
|
public static final String LOCAL_MODIFIED = "local_modified";
|
|
|
|
|
|
/**
|
|
|
* 移动到临时文件夹之前的原始父级 ID。
|
|
|
* <P> 类型: INTEGER </P>
|
|
|
*/
|
|
|
public static final String ORIGIN_PARENT_ID = "origin_parent_id";
|
|
|
|
|
|
/**
|
|
|
* Google 任务 ID。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String GTASK_ID = "gtask_id";
|
|
|
|
|
|
/**
|
|
|
* 版本代码。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String VERSION = "version";
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 数据列名接口。
|
|
|
*/
|
|
|
public interface DataColumns {
|
|
|
/**
|
|
|
* 行的唯一 ID。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String ID = "_id";
|
|
|
|
|
|
/**
|
|
|
* 该项的 MIME 类型。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String MIME_TYPE = "mime_type";
|
|
|
|
|
|
/**
|
|
|
* 所属笔记的引用 ID。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String NOTE_ID = "note_id";
|
|
|
|
|
|
/**
|
|
|
* 创建日期。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String CREATED_DATE = "created_date";
|
|
|
|
|
|
/**
|
|
|
* 最后修改日期。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String MODIFIED_DATE = "modified_date";
|
|
|
|
|
|
/**
|
|
|
* 数据内容。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String CONTENT = "content";
|
|
|
|
|
|
/**
|
|
|
* 泛型数据列，用于整数类型。
|
|
|
* <P> 类型: INTEGER </P>
|
|
|
*/
|
|
|
public static final String DATA1 = "data1";
|
|
|
|
|
|
/**
|
|
|
* 泛型数据列，用于整数类型。
|
|
|
* <P> 类型: INTEGER </P>
|
|
|
*/
|
|
|
public static final String DATA2 = "data2";
|
|
|
|
|
|
/**
|
|
|
* 泛型数据列，用于文本类型。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String DATA3 = "data3";
|
|
|
|
|
|
/**
|
|
|
* 泛型数据列，用于文本类型。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String DATA4 = "data4";
|
|
|
|
|
|
/**
|
|
|
* 泛型数据列，用于文本类型。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String DATA5 = "data5";
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 文本笔记类，实现 DataColumns 接口。
|
|
|
*/
|
|
|
public static final class TextNote implements DataColumns {
|
|
|
/**
|
|
|
* 标识文本是否为检查列表模式。
|
|
|
* <P> 类型: Integer 1: 检查列表模式 0: 正常模式 </P>
|
|
|
*/
|
|
|
public static final String MODE = DATA1;
|
|
|
|
|
|
/**
|
|
|
* 检查列表模式标识。
|
|
|
*/
|
|
|
public static final int MODE_CHECK_LIST = 1;
|
|
|
|
|
|
/**
|
|
|
* 内容类型。
|
|
|
*/
|
|
|
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
|
|
|
|
|
|
/**
|
|
|
* 内容项类型。
|
|
|
*/
|
|
|
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
|
|
|
|
|
|
/**
|
|
|
* 内容 URI。
|
|
|
*/
|
|
|
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 通话记录类，实现 DataColumns 接口。
|
|
|
*/
|
|
|
public static final class CallNote implements DataColumns {
|
|
|
/**
|
|
|
* 通话日期。
|
|
|
* <P> 类型: INTEGER (long) </P>
|
|
|
*/
|
|
|
public static final String CALL_DATE = DATA1;
|
|
|
|
|
|
/**
|
|
|
* 电话号码。
|
|
|
* <P> 类型: TEXT </P>
|
|
|
*/
|
|
|
public static final String PHONE_NUMBER = DATA3;
|
|
|
|
|
|
/**
|
|
|
* 内容类型。
|
|
|
*/
|
|
|
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
|
|
|
|
|
|
/**
|
|
|
* 内容项类型。
|
|
|
*/
|
|
|
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
|
|
|
|
|
|
/**
|
|
|
* 内容 URI。
|
|
|
*/
|
|
|
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
|
|
|
}
|
|
|
}
|
|
|
```
|
|
|
|
|
|
|
|
|
### 主要改动：
|
|
|
1. **类和接口的注释**：为每个类和接口添加了简要说明。
|
|
|
2. **字段的注释**：为每个字段添加了详细的中文注释，解释其用途和数据类型。
|
|
|
3. **方法的注释**：为每个静态内部类的方法添加了注释。
|
|
|
|
|
|
这样可以更好地理解代码的功能和结构。 |
