pjhgq6s5i
/
llll.gitpractice
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

代码注释

Browse Source
鲍贤慧
鲍贤慧 2 months ago
parent 6010f5b5b2
commit 0f643edce5
3 changed files with 146 additions and 6 deletions
Show Stats Download Patch File Download Diff File

85
Notes-master/src/net/micode/notes/widget/NoteWidgetProvider.java
Unescape View File

@ -15,6 +15,7 @@
*/
package net.micode.notes.widget;
import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
@ -32,23 +33,39 @@ import net.micode.notes.tool.ResourceParser;
import net.micode.notes.ui.NoteEditActivity;
import net.micode.notes.ui.NotesListActivity;
/**
* 便签小部件提供者的抽象基类，为不同类型的便签小部件提供公共功能
* 该类继承自AppWidgetProvider，处理小部件的生命周期事件和更新逻辑
*/
public abstract class NoteWidgetProvider extends AppWidgetProvider {
// 查询便签数据时使用的投影列，定义了需要从数据库中获取的字段
public static final String [] PROJECTION = new String [] {
NoteColumns.ID,
NoteColumns.BG_COLOR_ID,
NoteColumns.SNIPPET
NoteColumns.ID, // 便签ID
NoteColumns.BG_COLOR_ID, // 背景颜色ID
NoteColumns.SNIPPET // 便签摘要内容
};
// 投影列的索引常量，用于快速访问查询结果中的特定列
public static final int COLUMN_ID = 0;
public static final int COLUMN_BG_COLOR_ID = 1;
public static final int COLUMN_SNIPPET = 2;
private static final String TAG = "NoteWidgetProvider";
/**
* 当一个或多个小部件被删除时调用
* 该方法会更新数据库，将被删除小部件关联的便签的widget_id字段设为无效值
*
* @param context 应用上下文
* @param appWidgetIds 被删除的小部件ID数组
*/
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
// 创建ContentValues对象，用于更新数据库
ContentValues values = new ContentValues();
values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
// 遍历所有被删除的小部件ID，更新关联便签的widget_id
for (int i = 0; i < appWidgetIds.length; i++) {
context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
values,
@ -57,6 +74,13 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
}
}
/**
* 根据小部件ID从数据库获取关联便签的信息
*
* @param context 应用上下文
* @param widgetId 小部件ID
* @return 返回包含便签信息的Cursor对象
*/
private Cursor getNoteWidgetInfo(Context context, int widgetId) {
return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
PROJECTION,
@ -65,68 +89,121 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
null);
}
/**
* 更新小部件内容（默认非隐私模式）
* 这是一个便捷方法，内部调用完整的update方法
*
* @param context 应用上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
update(context, appWidgetManager, appWidgetIds, false);
}
/**
* 更新小部件内容的完整方法
* 根据小部件ID从数据库获取关联便签的信息，然后更新小部件UI
*
* @param context 应用上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
* @param privacyMode 是否处于隐私模式
*/
private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
boolean privacyMode) {
// 遍历所有需要更新的小部件ID
for (int i = 0; i < appWidgetIds.length; i++) {
if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
// 设置默认背景和内容
int bgId = ResourceParser.getDefaultBgId(context);
String snippet = "";
// 创建用于启动便签编辑界面的Intent
Intent intent = new Intent(context, NoteEditActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());
// 查询与小部件关联的便签信息
Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);
if (c != null && c.moveToFirst()) {
// 检查是否存在多个便签关联到同一个小部件ID（异常情况）
if (c.getCount() > 1) {
Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
c.close();
return;
}
// 从Cursor中获取便签内容和背景颜色
snippet = c.getString(COLUMN_SNIPPET);
bgId = c.getInt(COLUMN_BG_COLOR_ID);
// 设置Intent参数，用于查看现有便签
intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
intent.setAction(Intent.ACTION_VIEW);
} else {
// 如果没有关联便签，设置默认提示信息
snippet = context.getResources().getString(R.string.widget_havenot_content);
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
}
// 关闭Cursor释放资源
if (c != null) {
c.close();
}
// 创建RemoteViews对象，用于更新小部件UI
RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
/**
* Generate the pending intent to start host for the widget
* 生成用于启动便签编辑界面的PendingIntent
*/
PendingIntent pendingIntent = null;
if (privacyMode) {
// 隐私模式下显示提示信息，点击跳转到便签列表
rv.setTextViewText(R.id.widget_text,
context.getString(R.string.widget_under_visit_mode));
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], new Intent(
context, NotesListActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);
} else {
// 正常模式下显示便签内容，点击跳转到便签编辑界面
rv.setTextViewText(R.id.widget_text, snippet);
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
PendingIntent.FLAG_UPDATE_CURRENT);
}
// 设置点击事件，并更新小部件
rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
}
}
}
/**
* 根据背景颜色ID获取对应的资源ID
* 由子类实现，用于定义不同类型小部件的背景资源映射
*
* @param bgId 背景颜色ID
* @return 对应的资源ID
*/
protected abstract int getBgResourceId(int bgId);
/**
* 获取小部件的布局ID
* 由子类实现，用于指定不同类型小部件的布局文件
*
* @return 布局资源ID
*/
protected abstract int getLayoutId();
/**
* 获取小部件类型
* 由子类实现，用于标识不同类型的小部件
*
* @return 小部件类型
*/
protected abstract int getWidgetType();
}

33
Notes-master/src/net/micode/notes/widget/NoteWidgetProvider_2x.java
Unescape View File

@ -23,23 +23,54 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
/**
* 2x尺寸便签小部件的提供者实现类
* 继承自NoteWidgetProvider，负责管理和更新2x大小的桌面便签小部件
*/
public class NoteWidgetProvider_2x extends NoteWidgetProvider {
/**
* 小部件更新回调方法
* 当小部件需要更新时被系统调用，调用父类的update方法处理更新逻辑
*
* @param context 应用上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// 调用父类的update方法处理小部件更新
super.update(context, appWidgetManager, appWidgetIds);
}
/**
* 获取小部件的布局ID
* 定义2x尺寸小部件使用的布局文件
*
* @return 2x尺寸小部件的布局资源ID
*/
@Override
protected int getLayoutId() {
return R.layout.widget_2x;
}
/**
* 根据背景颜色ID获取对应的资源ID
* 根据便签的背景颜色ID，返回2x尺寸小部件对应的背景资源
*
* @param bgId 背景颜色ID
* @return 对应的背景资源ID
*/
@Override
protected int getBgResourceId(int bgId) {
return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
}
/**
* 获取小部件类型
* 返回表示2x尺寸小部件的类型常量
*
* @return 小部件类型常量
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_2X;

34
Notes-master/src/net/micode/notes/widget/NoteWidgetProvider_4x.java
Unescape View File

@ -23,22 +23,54 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
/**
* 4x尺寸便签小部件的提供者实现类
* 继承自NoteWidgetProvider，负责管理和更新4x大小的桌面便签小部件
*/
public class NoteWidgetProvider_4x extends NoteWidgetProvider {
/**
* 小部件更新回调方法
* 当小部件需要更新时被系统调用，调用父类的update方法处理更新逻辑
*
* @param context 应用上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// 调用父类的update方法处理小部件更新
super.update(context, appWidgetManager, appWidgetIds);
}
/**
* 获取小部件的布局ID
* 定义4x尺寸小部件使用的布局文件
*
* @return 4x尺寸小部件的布局资源ID
*/
@Override
protected int getLayoutId() {
return R.layout.widget_4x;
}
/**
* 根据背景颜色ID获取对应的资源ID
* 根据便签的背景颜色ID，返回4x尺寸小部件对应的背景资源
*
* @param bgId 背景颜色ID
* @return 对应的背景资源ID
*/
@Override
protected int getBgResourceId(int bgId) {
return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
}
/**
* 获取小部件类型
* 返回表示4x尺寸小部件的类型常量
*
* @return 小部件类型常量
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_4X;

Write Preview
Loading…
Cancel
Save