py6pboirn
/
qw-notes
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

增加注释

Browse Source
master
JLY 2 months ago
parent 40cf91cf9e
commit fa2dfce1b2
5 changed files with 128 additions and 76 deletions
Show Stats Download Patch File Download Diff File

8
.idea/deploymentTargetSelector.xml
Unescape View File

@ -4,6 +4,14 @@
<selectionStates> <selectionStates>
<SelectionState runConfigName="app"> <SelectionState runConfigName="app">
<option name="selectionMode" value="DROPDOWN" /> <option name="selectionMode" value="DROPDOWN" />
<DropdownSelection timestamp="2025-06-14T18:50:42.270638800Z">
<Target type="DEFAULT_BOOT">
<handle>
<DeviceId pluginId="PhysicalDevice" identifier="serial=9DX8D6J76L95PRPR" />
</handle>
</Target>
</DropdownSelection>
<DialogSelection />
</SelectionState> </SelectionState>
</selectionStates> </selectionStates>
</component> </component>

1
.idea/misc.xml
Unescape View File

@ -1,4 +1,3 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4"> <project version="4">
<component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="jbr-21" project-jdk-type="JavaSDK"> <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="jbr-21" project-jdk-type="JavaSDK">
<output url="file://$PROJECT_DIR$/build/classes" /> <output url="file://$PROJECT_DIR$/build/classes" />

62
app/src/main/java/net/micode/notes/model/WorkingNote.java
Unescape View File

@ -31,7 +31,10 @@ import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.Notes.TextNote; import net.micode.notes.data.Notes.TextNote;
import net.micode.notes.tool.ResourceParser.NoteBgResources; import net.micode.notes.tool.ResourceParser.NoteBgResources;
/**
* WorkingNote 类代表一个正在编辑的笔记对象
* 它负责管理笔记的内容、状态和与数据库的交互
*/
public class WorkingNote { public class WorkingNote {
// Note for the working note // Note for the working note
private Note mNote; private Note mNote;
@ -42,26 +45,18 @@ public class WorkingNote {
// Note mode // Note mode
private int mMode; private int mMode;
private long mAlertDate; private long mAlertDate; // 提醒时间
private long mModifiedDate; // 修改时间
private long mModifiedDate; private int mBgColorId; // 背景颜色ID
private int mWidgetId; // 小部件ID
private int mBgColorId; private int mWidgetType; // 小部件类型
private long mFolderId; // 文件夹ID
private int mWidgetId; private Context mContext; // 上下文
private boolean mIsDeleted; // 是否已删除
private int mWidgetType; private NoteSettingChangedListener mNoteSettingStatusListener; // 笔记设置变化监听器
private long mFolderId;
private Context mContext;
private static final String TAG = "WorkingNote"; private static final String TAG = "WorkingNote";
private boolean mIsDeleted;
private NoteSettingChangedListener mNoteSettingStatusListener;
public static final String[] DATA_PROJECTION = new String[] { public static final String[] DATA_PROJECTION = new String[] {
DataColumns.ID, DataColumns.ID,
DataColumns.CONTENT, DataColumns.CONTENT,
@ -174,6 +169,15 @@ public class WorkingNote {
} }
} }
/**
* 创建新的空笔记
* @param context 上下文
* @param folderId 文件夹ID
* @param widgetId 小部件ID
* @param widgetType 小部件类型
* @param defaultBgColorId 默认背景颜色ID
* @return 新创建的WorkingNote对象
*/
public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId, public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
int widgetType, int defaultBgColorId) { int widgetType, int defaultBgColorId) {
WorkingNote note = new WorkingNote(context, folderId); WorkingNote note = new WorkingNote(context, folderId);
@ -183,10 +187,20 @@ public class WorkingNote {
return note; return note;
} }
/**
* 从数据库加载笔记
* @param context 上下文
* @param id 笔记ID
* @return 加载的WorkingNote对象
*/
public static WorkingNote load(Context context, long id) { public static WorkingNote load(Context context, long id) {
return new WorkingNote(context, id, 0); return new WorkingNote(context, id, 0);
} }
/**
* 保存笔记到数据库
* @return 是否保存成功
*/
public synchronized boolean saveNote() { public synchronized boolean saveNote() {
if (isWorthSaving()) { if (isWorthSaving()) {
if (!existInDatabase()) { if (!existInDatabase()) {
@ -199,7 +213,7 @@ public class WorkingNote {
mNote.syncNote(mContext, mNoteId); mNote.syncNote(mContext, mNoteId);
/** /**
* Update widget content if there exist any widget of this note * 如果笔记有关联的小部件，更新小部件内容
*/ */
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
&& mWidgetType != Notes.TYPE_WIDGET_INVALIDE && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
@ -229,6 +243,11 @@ public class WorkingNote {
mNoteSettingStatusListener = l; mNoteSettingStatusListener = l;
} }
/**
* 设置提醒时间
* @param date 提醒时间戳
* @param set 是否设置提醒
*/
public void setAlertDate(long date, boolean set) { public void setAlertDate(long date, boolean set) {
if (date != mAlertDate) { if (date != mAlertDate) {
mAlertDate = date; mAlertDate = date;
@ -288,6 +307,11 @@ public class WorkingNote {
} }
} }
/**
* 将笔记转换为通话记录笔记
* @param phoneNumber 电话号码
* @param callDate 通话时间
*/
public void convertToCallNote(String phoneNumber, long callDate) { public void convertToCallNote(String phoneNumber, long callDate) {
mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate)); mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));
mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber); mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber);

55
app/src/main/java/net/micode/notes/ui/NoteEditActivity.java
Unescape View File

@ -73,17 +73,20 @@ import java.util.Map;
import java.util.regex.Matcher; import java.util.regex.Matcher;
import java.util.regex.Pattern; import java.util.regex.Pattern;
/**
* NoteEditActivity 是笔记编辑界面的主要活动类
* 负责处理笔记的创建、编辑、保存等功能
*/
public class NoteEditActivity extends Activity implements OnClickListener, public class NoteEditActivity extends Activity implements OnClickListener,
NoteSettingChangedListener, OnTextViewChangeListener { NoteSettingChangedListener, OnTextViewChangeListener {
/**
* 头部视图持有者类，用于管理笔记编辑界面的头部视图元素
*/
private class HeadViewHolder { private class HeadViewHolder {
public TextView tvModified; public TextView tvModified; // 显示修改时间
public ImageView ivAlertIcon; // 提醒图标
public ImageView ivAlertIcon; public TextView tvAlertDate; // 提醒时间
public ImageView ibSetBgColor; // 设置背景颜色按钮
public TextView tvAlertDate;
public ImageView ibSetBgColor;
} }
private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>(); private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
@ -189,18 +192,19 @@ public class NoteEditActivity extends Activity implements OnClickListener,
} }
} }
private boolean initActivityState(Intent intent) {
/** /**
* If the user specified the {@link Intent#ACTION_VIEW} but not provided with id, * 初始化活动状态
* then jump to the NotesListActivity * @param intent 启动活动的Intent
* @return 是否成功初始化
*/ */
private boolean initActivityState(Intent intent) {
mWorkingNote = null; mWorkingNote = null;
if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {
long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
mUserQuery = ""; mUserQuery = "";
/** /**
* Starting from the searched result * 从搜索结果启动
*/ */
if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {
noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));
@ -305,6 +309,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
showAlertHeader(); showAlertHeader();
} }
/**
* 显示提醒头部信息
* 根据笔记的提醒时间显示相应的提醒信息
*/
private void showAlertHeader() { private void showAlertHeader() {
if (mWorkingNote.hasClockAlert()) { if (mWorkingNote.hasClockAlert()) {
long time = System.currentTimeMillis(); long time = System.currentTimeMillis();
@ -611,6 +619,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
startActivity(intent); startActivity(intent);
} }
/**
* 删除当前笔记
* 如果笔记存在于数据库中，则将其移动到回收站或直接删除
*/
private void deleteCurrentNote() { private void deleteCurrentNote() {
if (mWorkingNote.existInDatabase()) { if (mWorkingNote.existInDatabase()) {
HashSet<Long> ids = new HashSet<Long>(); HashSet<Long> ids = new HashSet<Long>();
@ -807,6 +819,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
} }
} }
/**
* 获取当前编辑的文本内容
* @return 是否包含已勾选的项目
*/
private boolean getWorkingText() { private boolean getWorkingText() {
boolean hasChecked = false; boolean hasChecked = false;
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
@ -830,16 +846,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
return hasChecked; return hasChecked;
} }
/**
* 保存笔记
* @return 是否保存成功
*/
private boolean saveNote() { private boolean saveNote() {
getWorkingText(); getWorkingText();
boolean saved = mWorkingNote.saveNote(); boolean saved = mWorkingNote.saveNote();
if (saved) { if (saved) {
/** /**
* There are two modes from List view to edit view, open one note, * 从列表视图到编辑视图有两种模式：
* create/edit a node. Opening node requires to the original * 1. 打开一个笔记
* position in the list when back from edit view, while creating a * 2. 创建/编辑一个笔记
* new node requires to the top of the list. This code * 打开笔记需要返回到列表中的原始位置
* {@link #RESULT_OK} is used to identify the create/edit state * 创建新笔记需要返回到列表顶部
* 使用RESULT_OK来标识创建/编辑状态
*/ */
setResult(RESULT_OK); setResult(RESULT_OK);
} }

74
app/src/main/java/net/micode/notes/ui/NotesListActivity.java
Unescape View File

@ -78,53 +78,45 @@ import java.io.InputStream;
import java.io.InputStreamReader; import java.io.InputStreamReader;
import java.util.HashSet; import java.util.HashSet;
/**
* NotesListActivity 是笔记列表界面的主要活动类
* 负责显示所有笔记的列表，并提供创建、编辑、删除笔记等功能
*/
public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener { public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0; private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0; // 文件夹笔记列表查询令牌
private static final int FOLDER_LIST_QUERY_TOKEN = 1; // 文件夹列表查询令牌
private static final int FOLDER_LIST_QUERY_TOKEN = 1; private static final int MENU_FOLDER_DELETE = 0; // 删除文件夹菜单项
private static final int MENU_FOLDER_VIEW = 1; // 查看文件夹菜单项
private static final int MENU_FOLDER_DELETE = 0; private static final int MENU_FOLDER_CHANGE_NAME = 2; // 修改文件夹名称菜单项
private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction"; // 是否添加介绍笔记的偏好设置键
private static final int MENU_FOLDER_VIEW = 1;
private static final int MENU_FOLDER_CHANGE_NAME = 2;
private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";
/**
* 列表编辑状态枚举
*/
private enum ListEditState { private enum ListEditState {
NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER NOTE_LIST, // 笔记列表
SUB_FOLDER, // 子文件夹
CALL_RECORD_FOLDER // 通话记录文件夹
}; };
private ListEditState mState; private ListEditState mState; // 当前列表编辑状态
private BackgroundQueryHandler mBackgroundQueryHandler; // 后台查询处理器
private BackgroundQueryHandler mBackgroundQueryHandler; private NotesListAdapter mNotesListAdapter; // 笔记列表适配器
private ListView mNotesListView; // 笔记列表视图
private NotesListAdapter mNotesListAdapter; private Button mAddNewNote; // 添加新笔记按钮
private boolean mDispatch; // 是否正在分发事件
private ListView mNotesListView; private int mOriginY; // 原始Y坐标
private int mDispatchY; // 分发Y坐标
private Button mAddNewNote; private TextView mTitleBar; // 标题栏
private long mCurrentFolderId; // 当前文件夹ID
private boolean mDispatch; private ContentResolver mContentResolver; // 内容解析器
private ModeCallback mModeCallBack; // 模式回调
private int mOriginY; private NoteItemData mFocusNoteDataItem; // 当前焦点笔记数据项
private int mDispatchY;
private TextView mTitleBar;
private long mCurrentFolderId;
private ContentResolver mContentResolver;
private ModeCallback mModeCallBack;
private static final String TAG = "NotesListActivity"; private static final String TAG = "NotesListActivity";
public static final int NOTES_LISTVIEW_SCROLL_RATE = 30; public static final int NOTES_LISTVIEW_SCROLL_RATE = 30;
private NoteItemData mFocusNoteDataItem;
private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?"; private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?";
private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>" private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>"
@ -159,6 +151,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
} }
} }
/**
* 从原始资源文件设置应用信息
* 用于首次启动时创建介绍笔记
*/
private void setAppInfoFromRawRes() { private void setAppInfoFromRawRes() {
SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this); SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) { if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
@ -211,6 +207,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
} }
} }
/**
* 启动异步笔记列表查询
* 在活动启动时调用，用于加载笔记列表
*/
@Override @Override
protected void onStart() { protected void onStart() {
super.onStart(); super.onStart();

Write Preview
Loading…
Cancel
Save