prwohun7f
/
minotes-lyzx
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Labels Milestones
New Pull Request

合并 #9

Closed
prwohun7f wants to merge 2 commits from zhaoxin_branch into master
Conversation 0 Commits 2 Files Changed 84
84 changed files with 9173 additions and 3836 deletions
Show Stats Download Patch File Download Diff File

125
src/Notes-master/AndroidManifest.xml
Unescape View File

@ -1,28 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
Licensed under the Apache License, Version 2.0 (the "License");
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.
-->
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.micode.notes"
android:versionCode="1"
android:versionName="0.1" >
<uses-sdk android:minSdkVersion="14" />
xmlns:tools="http://schemas.android.com/tools">
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
@ -31,10 +12,31 @@
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.USE_CREDENTIALS" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.INTERNET"/>
<application
android:icon="@drawable/icon_app"
android:label="@string/app_name" >
android:allowBackup="true"
android:dataExtractionRules="@xml/data_extraction_rules"
android:fullBackupContent="@xml/backup_rules"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/Theme.Notesmaster"
tools:targetApi="31">
<activity
android:name=".SplashActivity"
android:exported="true"
android:theme="@style/Theme.Notesmaster">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity
android:name=".ui.LoginActivity"
android:exported="false"
android:theme="@style/Theme.Notesmaster">
</activity>
<activity
android:name=".ui.NotesListActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
@ -42,109 +44,122 @@
android:launchMode="singleTop"
android:theme="@style/NoteTheme"
android:uiOptions="splitActionBarWhenNarrow"
android:windowSoftInputMode="adjustPan" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
android:windowSoftInputMode="adjustPan"
android:exported="false">
</activity>
<activity
android:name=".ui.NoteEditActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:launchMode="singleTop"
android:theme="@style/NoteTheme" >
<intent-filter>
android:theme="@style/NoteTheme"
android:exported="true">
<intent-filter >
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="vnd.android.cursor.item/text_note" />
<data android:mimeType="vnd.android.cursor.item/call_note" />
</intent-filter>
<intent-filter>
</intent-filter >>
<intent-filter >
<action android:name="android.intent.action.INSERT_OR_EDIT" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="vnd.android.cursor.item/text_note" />
<data android:mimeType="vnd.android.cursor.item/call_note" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.SEARCH" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
<meta-data
android:name="android.app.searchable"
android:resource="@xml/searchable" />
</activity>
<provider
android:name="net.micode.notes.data.NotesProvider"
android:authorities="micode_notes"
android:multiprocess="true" />
<receiver
android:name=".widget.NoteWidgetProvider_2x"
android:label="@string/app_widget2x2" >
android:label="@string/app_widget2x2"
android:exported="true">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
<action android:name="android.appwidget.action.APPWIDGET_DELETED" />
<action android:name="android.intent.action.PRIVACY_MODE_CHANGED" />
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/widget_2x_info" />
</receiver>
<receiver
android:name=".widget.NoteWidgetProvider_4x"
android:label="@string/app_widget4x4" >
android:label="@string/app_widget4x4"
android:exported="true">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
<action android:name="android.appwidget.action.APPWIDGET_DELETED" />
<action android:name="android.intent.action.PRIVACY_MODE_CHANGED" />
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/widget_4x_info" />
</receiver>
<receiver android:name=".ui.AlarmInitReceiver" >
<receiver android:name=".ui.AlarmInitReceiver"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
</intent-filter>
</receiver>
<receiver
android:name="net.micode.notes.ui.AlarmReceiver"
android:process=":remote" >
</receiver>
<activity
android:name=".ui.AlarmAlertActivity"
android:label="@string/app_name"
android:launchMode="singleInstance"
android:theme="@android:style/Theme.Holo.Wallpaper.NoTitleBar" >
</activity>
<activity
android:name="net.micode.notes.ui.NotesPreferenceActivity"
android:label="@string/preferences_title"
android:launchMode="singleTop"
android:theme="@android:style/Theme.Holo.Light" >
</activity>
<activity
android:name="net.micode.notes.ui.FriendManagementActivity"
android:exported="false"
android:theme="@android:style/Theme.Holo.Light" >
</activity>
<activity
android:name="net.micode.notes.ui.FriendNoteListActivity"
android:exported="false"
android:theme="@style/NoteTheme" >
</activity>
<activity
android:name="net.micode.notes.ui.FriendNoteEditActivity"
android:exported="false"
android:theme="@style/NoteTheme" >
</activity>
<activity
android:name="net.micode.notes.ui.ChatActivity"
android:exported="false"
android:theme="@style/NoteTheme"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<service
android:name="net.micode.notes.gtask.remote.GTaskSyncService"
android:exported="false" >
</service>
<meta-data
android:name="android.app.default_searchable"
android:value=".ui.NoteEditActivity" />
<!-- <activity-->
<!-- android:name=".MainActivity"-->
<!-- android:exported="true">-->
<!-- <intent-filter>-->
<!-- <action android:name="android.intent.action.MAIN" />-->
<!-- <category android:name="android.intent.category.LAUNCHER" />-->
<!-- </intent-filter>-->
<!-- </activity>-->
</application>
</manifest>
</manifest>

11
src/Notes-master/res/drawable/category_bg.xml
Unescape View File

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
<!-- 圆角矩形 -->
<corners android:radius="10dip" />
<!-- 背景颜色 -->
<solid android:color="#FF6666" />
<!-- 边框 -->
<stroke
android:width="1dip"
android:color="#FF4444" />
</shape>

170
src/Notes-master/res/drawable/ic_launcher_background.xml
Unescape View File

@ -0,0 +1,170 @@
<?xml version="1.0" encoding="utf-8"?>
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="108dp"
android:height="108dp"
android:viewportWidth="108"
android:viewportHeight="108">
<path
android:fillColor="#3DDC84"
android:pathData="M0,0h108v108h-108z" />
<path
android:fillColor="#00000000"
android:pathData="M9,0L9,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,0L19,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M29,0L29,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M39,0L39,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M49,0L49,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M59,0L59,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M69,0L69,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M79,0L79,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M89,0L89,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M99,0L99,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,9L108,9"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,19L108,19"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,29L108,29"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,39L108,39"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,49L108,49"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,59L108,59"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,69L108,69"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,79L108,79"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,89L108,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,99L108,99"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,29L89,29"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,39L89,39"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,49L89,49"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,59L89,59"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,69L89,69"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,79L89,79"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M29,19L29,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M39,19L39,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M49,19L49,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M59,19L59,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M69,19L69,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M79,19L79,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
</vector>

30
src/Notes-master/res/drawable/ic_launcher_foreground.xml
Unescape View File

@ -0,0 +1,30 @@
<vector xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:aapt="http://schemas.android.com/aapt"
android:width="108dp"
android:height="108dp"
android:viewportWidth="108"
android:viewportHeight="108">
<path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
<aapt:attr name="android:fillColor">
<gradient
android:endX="85.84757"
android:endY="92.4963"
android:startX="42.9492"
android:startY="49.59793"
android:type="linear">
<item
android:color="#44000000"
android:offset="0.0" />
<item
android:color="#00000000"
android:offset="1.0" />
</gradient>
</aapt:attr>
</path>
<path
android:fillColor="#FFFFFF"
android:fillType="nonZero"
android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
android:strokeWidth="1"
android:strokeColor="#00000000" />
</vector>

8
src/Notes-master/res/drawable/mi_logo_background.xml
Unescape View File

@ -0,0 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="oval">
<solid android:color="#FF6200" />
<size
android:width="180dp"
android:height="180dp" />
</shape>

15
src/Notes-master/res/layout/activity_friend_management.xml
Unescape View File

@ -0,0 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<ListView
android:id="@+id/friend_list"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:divider="@android:drawable/divider_horizontal_bright"
android:dividerHeight="1dp"
android:padding="8dp" />
</LinearLayout>

73
src/Notes-master/res/layout/activity_friend_note_edit.xml
Unescape View File

@ -0,0 +1,73 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<ScrollView
android:id="@+id/sv_note_edit"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_weight="1">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical">
<LinearLayout
android:id="@+id/note_title"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="8dp"
android:background="@android:color/darker_gray">
<TextView
android:id="@+id/tv_modified_date"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAppearance="@android:style/TextAppearance.Medium"
android:textColor="@android:color/primary_text_light" />
</LinearLayout>
<!-- 标题显示区域 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="16dp"
android:background="@android:color/white">
<TextView
android:id="@+id/note_title_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:textAppearance="@android:style/TextAppearance.Large"
android:textColor="@android:color/primary_text_dark"
android:textSize="20sp"
android:gravity="center"
android:paddingBottom="10dp"
android:layout_marginBottom="10dp"
android:fontFamily="sans-serif-medium"
android:background="@null" />
<View
android:layout_width="match_parent"
android:layout_height="1dp"
android:background="#CCCCCC" />
</LinearLayout>
<!-- 正文显示区域 -->
<TextView
android:id="@+id/note_edit_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@android:color/white"
android:padding="16dp"
android:textAppearance="@android:style/TextAppearance.Medium"
android:textColor="@android:color/primary_text_dark"
android:textSize="16sp" />
</LinearLayout>
</ScrollView>
</LinearLayout>

15
src/Notes-master/res/layout/activity_friend_note_list.xml
Unescape View File

@ -0,0 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<ListView
android:id="@+id/friend_note_list"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:divider="@android:drawable/divider_horizontal_bright"
android:dividerHeight="1dp"
android:padding="8dp" />
</LinearLayout>

147
src/Notes-master/res/layout/activity_login.xml
Unescape View File

@ -0,0 +1,147 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:gravity="center_horizontal"
android:padding="20dp"
android:background="@android:color/white">
<!-- 应用图标 -->
<ImageView
android:layout_width="100dp"
android:layout_height="100dp"
android:src="@mipmap/ic_launcher"
android:layout_marginBottom="30dp"
android:layout_marginTop="50dp" />
<!-- 应用名称 -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/app_name"
android:textSize="24sp"
android:textStyle="bold"
android:layout_marginBottom="40dp" />
<!-- 登录表单 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:gravity="center_horizontal"
android:background="@android:color/white"
android:padding="20dp"
android:elevation="5dp"
android:layout_marginBottom="20dp">
<!-- 用户名输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="15dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="用户名："
android:textSize="16sp" />
<EditText
android:id="@+id/et_username"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请输入用户名"
android:inputType="text"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 密码输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="20dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="密码："
android:textSize="16sp" />
<EditText
android:id="@+id/et_password"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请输入密码"
android:inputType="textPassword"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 登录按钮 -->
<Button
android:id="@+id/btn_login"
android:layout_width="match_parent"
android:layout_height="45dp"
android:text="登录"
android:textSize="18sp"
android:textColor="@android:color/white"
android:background="@android:color/holo_orange_light"
android:layout_marginBottom="15dp"
android:onClick="onLoginClick" />
<!-- 注册和忘记密码按钮 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_horizontal">
<Button
android:id="@+id/btn_register"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="注册账号"
android:textSize="14sp"
android:textColor="@android:color/holo_blue_dark"
android:background="@null"
android:onClick="onRegisterClick" />
<View
android:layout_width="1dp"
android:layout_height="20dp"
android:background="@android:color/darker_gray"
android:layout_marginLeft="20dp"
android:layout_marginRight="20dp" />
<Button
android:id="@+id/btn_change_password"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="修改密码"
android:textSize="14sp"
android:textColor="@android:color/holo_blue_dark"
android:background="@null"
android:onClick="onChangePasswordClick" />
</LinearLayout>
</LinearLayout>
<!-- 版权信息 -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="© 2024 小米便签"
android:textSize="12sp"
android:textColor="@android:color/darker_gray"
android:layout_marginTop="50dp" />
</LinearLayout>

19
src/Notes-master/res/layout/activity_main.xml
Unescape View File

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/main"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello World!"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

30
src/Notes-master/res/layout/activity_splash.xml
Unescape View File

@ -0,0 +1,30 @@
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#FFFFFF"
android:gravity="center">
<!-- 小米官方logo: 橙色圆形背景白色MI字样 -->
<LinearLayout
android:id="@+id/mi_logo"
android:layout_width="180dp"
android:layout_height="180dp"
android:layout_centerInParent="true"
android:background="@drawable/mi_logo_background"
android:gravity="center"
android:orientation="vertical">
<!-- 使用TextView显示白色MI字样 -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="MI"
android:textColor="#FFFFFF"
android:textSize="120sp"
android:textStyle="bold"
android:fontFamily="sans-serif" />
</LinearLayout>
<!-- 移除应用名称，只保留logo -->
</RelativeLayout>

55
src/Notes-master/res/layout/chat_activity.xml
Unescape View File

@ -0,0 +1,55 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical"
android:background="#f0f0f0">
<!-- 聊天消息列表 -->
<ListView
android:id="@+id/chat_list"
android:layout_width="fill_parent"
android:layout_height="0dip"
android:layout_weight="1"
android:cacheColorHint="@null"
android:divider="@null"
android:dividerHeight="8dip"
android:padding="8dip"
android:scrollbars="vertical" />
<!-- 输入框和发送按钮 -->
<LinearLayout
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_gravity="bottom"
android:background="#ffffff"
android:orientation="horizontal"
android:padding="8dip"
android:weightSum="1">
<EditText
android:id="@+id/message_edit_text"
android:layout_width="0dip"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_weight="1"
android:background="@android:drawable/edit_text"
android:hint="输入消息..."
android:inputType="textMultiLine"
android:maxLines="3"
android:padding="8dip"
android:textColor="#000000"
android:textSize="16sp" />
<Button
android:id="@+id/send_button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_marginLeft="8dip"
android:background="@android:drawable/btn_default"
android:text="发送"
android:textColor="#ffffff"
android:textSize="16sp" />
</LinearLayout>
</LinearLayout>

40
src/Notes-master/res/layout/chat_message_received_item.xml
Unescape View File

@ -0,0 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:gravity="left"
android:orientation="vertical"
android:padding="4dip">
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:background="#ffffff"
android:orientation="vertical"
android:padding="8dip">
<TextView
android:id="@+id/message_content"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:maxWidth="250dip"
android:padding="4dip"
android:text="消息内容"
android:textColor="#000000"
android:textSize="16sp" />
<TextView
android:id="@+id/message_time"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:layout_marginTop="4dip"
android:padding="2dip"
android:text="12:00"
android:textColor="#80000000"
android:textSize="12sp" />
</LinearLayout>
</LinearLayout>

70
src/Notes-master/res/layout/chat_message_received_note_item.xml
Unescape View File

@ -0,0 +1,70 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:gravity="left"
android:orientation="vertical"
android:padding="4dip">
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:background="#ffffff"
android:orientation="vertical"
android:padding="8dip">
<!-- 添加"便签"标注 -->
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:orientation="horizontal"
android:gravity="center">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="[便签]"
android:textColor="#ffffff"
android:textSize="12sp"
android:background="@android:drawable/btn_default_small"
android:paddingLeft="6dip"
android:paddingRight="6dip"
android:paddingTop="2dip"
android:paddingBottom="2dip"
android:layout_marginRight="4dip"
android:backgroundTint="#0000ff" /> <!-- 接收的便签标注使用蓝色 -->
<TextView
android:id="@+id/message_content"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:maxWidth="300dip"
android:padding="4dip"
android:text="便签内容"
android:textColor="#000000"
android:textSize="16sp"
android:clickable="true"
android:focusable="true"
android:background="@android:drawable/btn_default_small"
android:paddingLeft="8dip"
android:paddingRight="8dip"
android:paddingTop="4dip"
android:paddingBottom="4dip" />
</LinearLayout> <!-- 闭合LinearLayout -->
<TextView
android:id="@+id/message_time"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:layout_marginTop="4dip"
android:padding="2dip"
android:text="12:00"
android:textColor="#80000000"
android:textSize="12sp" />
</LinearLayout>
</LinearLayout>

40
src/Notes-master/res/layout/chat_message_sent_item.xml
Unescape View File

@ -0,0 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:gravity="right"
android:orientation="vertical"
android:padding="4dip">
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:background="@android:drawable/btn_default"
android:orientation="vertical"
android:padding="8dip">
<TextView
android:id="@+id/message_content"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:maxWidth="250dip"
android:padding="4dip"
android:text="消息内容"
android:textColor="#ffffff"
android:textSize="16sp" />
<TextView
android:id="@+id/message_time"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:layout_marginTop="4dip"
android:padding="2dip"
android:text="12:00"
android:textColor="#80ffffff"
android:textSize="12sp" />
</LinearLayout>
</LinearLayout>

70
src/Notes-master/res/layout/chat_message_sent_note_item.xml
Unescape View File

@ -0,0 +1,70 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:gravity="right"
android:orientation="vertical"
android:padding="4dip">
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:background="@android:drawable/btn_default"
android:orientation="vertical"
android:padding="8dip">
<!-- 添加"便签"标注 -->
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:orientation="horizontal"
android:gravity="center">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="[便签]"
android:textColor="#ffffff"
android:textSize="12sp"
android:background="@android:drawable/btn_default_small"
android:paddingLeft="6dip"
android:paddingRight="6dip"
android:paddingTop="2dip"
android:paddingBottom="2dip"
android:layout_marginRight="4dip"
android:backgroundTint="#ff0000" />
<TextView
android:id="@+id/message_content"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:maxWidth="300dip"
android:padding="4dip"
android:text="便签内容"
android:textColor="#ffffff"
android:textSize="16sp"
android:clickable="true"
android:focusable="true"
android:background="@android:drawable/btn_default_small"
android:paddingLeft="8dip"
android:paddingRight="8dip"
android:paddingTop="4dip"
android:paddingBottom="4dip" />
</LinearLayout> <!-- 闭合LinearLayout -->
<TextView
android:id="@+id/message_time"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="right"
android:layout_marginTop="4dip"
android:padding="2dip"
android:text="12:00"
android:textColor="#80ffffff"
android:textSize="12sp" />
</LinearLayout>
</LinearLayout>

150
src/Notes-master/res/layout/dialog_change_password.xml
Unescape View File

@ -0,0 +1,150 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:padding="20dp">
<!-- 标题 -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="修改密码"
android:textSize="20sp"
android:textStyle="bold"
android:layout_gravity="center_horizontal"
android:layout_marginBottom="20dp" />
<!-- 用户名输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="15dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="用户名："
android:textSize="16sp" />
<EditText
android:id="@+id/et_change_username"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请输入用户名"
android:inputType="text"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 当前密码输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="15dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="当前密码："
android:textSize="16sp" />
<EditText
android:id="@+id/et_current_password"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请输入当前密码"
android:inputType="textPassword"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 新密码输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="15dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="新密码："
android:textSize="16sp" />
<EditText
android:id="@+id/et_new_password"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请输入新密码"
android:inputType="textPassword"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 确认新密码输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="20dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="确认新密码："
android:textSize="16sp" />
<EditText
android:id="@+id/et_confirm_new_password"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请再次输入新密码"
android:inputType="textPassword"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 按钮 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_horizontal"
android:layout_marginTop="10dp">
<Button
android:id="@+id/btn_change_cancel"
android:layout_width="wrap_content"
android:layout_height="40dp"
android:text="取消"
android:textSize="16sp"
android:textColor="@android:color/black"
android:background="@android:drawable/btn_default"
android:layout_marginRight="20dp" />
<Button
android:id="@+id/btn_change_confirm"
android:layout_width="wrap_content"
android:layout_height="40dp"
android:text="确认修改"
android:textSize="16sp"
android:textColor="@android:color/white"
android:background="@android:color/holo_orange_light" />
</LinearLayout>
</LinearLayout>

124
src/Notes-master/res/layout/dialog_register.xml
Unescape View File

@ -0,0 +1,124 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:padding="20dp">
<!-- 标题 -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="注册账号"
android:textSize="20sp"
android:textStyle="bold"
android:layout_gravity="center_horizontal"
android:layout_marginBottom="20dp" />
<!-- 用户名输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="15dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="用户名："
android:textSize="16sp" />
<EditText
android:id="@+id/et_register_username"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请输入用户名"
android:inputType="text"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 密码输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="15dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="密码："
android:textSize="16sp" />
<EditText
android:id="@+id/et_register_password"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请输入密码"
android:inputType="textPassword"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 确认密码输入 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical"
android:layout_marginBottom="20dp">
<TextView
android:layout_width="80dp"
android:layout_height="wrap_content"
android:text="确认密码："
android:textSize="16sp" />
<EditText
android:id="@+id/et_register_confirm_password"
android:layout_width="match_parent"
android:layout_height="40dp"
android:hint="请再次输入密码"
android:inputType="textPassword"
android:singleLine="true"
android:background="@android:drawable/editbox_background_normal"
android:paddingLeft="10dp"
android:paddingRight="10dp" />
</LinearLayout>
<!-- 按钮 -->
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_horizontal"
android:layout_marginTop="10dp">
<Button
android:id="@+id/btn_register_cancel"
android:layout_width="wrap_content"
android:layout_height="40dp"
android:text="取消"
android:textSize="16sp"
android:textColor="@android:color/black"
android:background="@android:drawable/btn_default"
android:layout_marginRight="20dp" />
<Button
android:id="@+id/btn_register_confirm"
android:layout_width="wrap_content"
android:layout_height="40dp"
android:text="注册"
android:textSize="16sp"
android:textColor="@android:color/white"
android:background="@android:color/holo_orange_light" />
</LinearLayout>
</LinearLayout>

16
src/Notes-master/res/layout/item_friend.xml
Unescape View File

@ -0,0 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:padding="16dp">
<TextView
android:id="@+id/friend_username"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAppearance="@android:style/TextAppearance.Medium"
android:textColor="@android:color/primary_text_light"
android:textSize="16sp" />
</LinearLayout>

93
src/Notes-master/res/layout/note_edit.xml
Unescape View File

@ -27,18 +27,20 @@
android:orientation="vertical">
<LinearLayout
android:id="@+id/note_title"
android:layout_width="fill_parent"
android:layout_height="wrap_content">
android:id="@+id/note_title"
android:layout_width="fill_parent"
android:layout_height="wrap_content">
<TextView
android:id="@+id/tv_modified_date"
android:layout_width="0dip"
android:layout_height="wrap_content"
android:layout_weight="1"
android:layout_gravity="left|center_vertical"
android:layout_marginRight="8dip"
android:textAppearance="@style/TextAppearanceSecondaryItem" />
<TextView
android:id="@+id/tv_modified_date"
android:layout_width="0dip"
android:layout_height="wrap_content"
android:layout_weight="1"
android:layout_gravity="left|center_vertical"
android:layout_marginRight="8dip"
android:textAppearance="@style/TextAppearanceSecondaryItem" />
<ImageView
android:id="@+id/iv_alert_icon"
@ -85,19 +87,59 @@
<LinearLayout
android:layout_width="fill_parent"
android:layout_height="fill_parent">
android:layout_height="fill_parent"
android:orientation="vertical">
<!-- 标题编辑区域 -->
<LinearLayout
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:padding="10dip">
<LinearLayout
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:gravity="center_vertical"
android:layout_marginBottom="5dip">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="标题："
android:textAppearance="@style/TextAppearancePrimaryItem"
android:layout_marginRight="10dip" />
<net.micode.notes.ui.NoteEditText
android:id="@+id/note_title_edit"
android:layout_width="0dip"
android:layout_height="wrap_content"
android:layout_weight="1"
android:gravity="left"
android:background="@null"
android:textAppearance="@style/TextAppearancePrimaryItem"
android:textSize="20sp"
android:singleLine="true"
android:inputType="textCapSentences|textAutoCorrect|textAutoComplete" />
</LinearLayout>
<View
android:layout_width="fill_parent"
android:layout_height="1dip"
android:background="#CCCCCC"
android:layout_marginTop="5dip" />
</LinearLayout>
<!-- 正文编辑区域 -->
<net.micode.notes.ui.NoteEditText
android:id="@+id/note_edit_view"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_height="fill_parent"
android:gravity="left|top"
android:background="@null"
android:autoLink="all"
android:linksClickable="false"
android:minLines="12"
android:linksClickable="true"
android:padding="10dip"
android:minHeight="200dip"
android:textAppearance="@style/TextAppearancePrimaryItem"
android:lineSpacingMultiplier="1.2" />
android:lineSpacingMultiplier="1.2"
android:inputType="textMultiLine|textCapSentences|textAutoCorrect|textAutoComplete" />
<LinearLayout
android:id="@+id/note_edit_list"
@ -113,6 +155,25 @@
android:layout_width="fill_parent"
android:layout_height="7dip"
android:background="@drawable/bg_color_btn_mask" />
<!-- 字数统计显示 -->
<LinearLayout
android:id="@+id/ll_character_count"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_gravity="bottom"
android:gravity="bottom|left"
android:paddingLeft="10dip"
android:paddingBottom="10dip"
android:background="@null">
<TextView
android:id="@+id/tv_character_count"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="bottom|left"
android:text="当前字数：0"
android:textAppearance="@style/TextAppearanceSecondaryItem" />
</LinearLayout>
</LinearLayout>
</LinearLayout>

37
src/Notes-master/res/layout/note_item.xml
Unescape View File

@ -46,6 +46,21 @@
android:layout_height="wrap_content"
android:layout_gravity="center_vertical">
<!-- 分类标签 -->
<TextView
android:id="@+id/tv_category"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@drawable/category_bg"
android:textColor="@android:color/white"
android:textSize="12sp"
android:paddingLeft="8dip"
android:paddingRight="8dip"
android:paddingTop="2dip"
android:paddingBottom="2dip"
android:layout_marginRight="8dip"
android:text="其他" />
<TextView
android:id="@+id/tv_title"
android:layout_width="0dip"
@ -74,5 +89,25 @@
android:id="@+id/iv_alert_icon"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="top|right"/>
android:layout_gravity="top|right"
android:layout_marginRight="8dp"
android:layout_marginTop="8dp"/>
<ImageView
android:id="@+id/iv_lock_icon"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="top|right"
android:layout_marginRight="32dp"
android:layout_marginTop="8dp"
android:visibility="gone"/>
<ImageView
android:id="@+id/iv_public_icon"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="top|right"
android:layout_marginRight="56dp"
android:layout_marginTop="8dp"
android:visibility="gone"/>
</FrameLayout>

108
src/Notes-master/res/layout/note_list.xml
Unescape View File

@ -17,6 +17,7 @@
<FrameLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/root_layout"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:background="@drawable/list_background">
@ -26,26 +27,103 @@
android:layout_height="fill_parent"
android:orientation="vertical">
<TextView
android:id="@+id/tv_title_bar"
<!-- 搜索栏 -->
<LinearLayout
android:id="@+id/search_bar"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:background="@drawable/title_bar_bg"
android:visibility="gone"
android:gravity="center_vertical"
android:singleLine="true"
android:textColor="#FFEAD1AE"
android:textSize="@dimen/text_font_size_medium" />
<ListView
android:id="@+id/notes_list"
android:orientation="horizontal"
android:padding="5dip"
android:gravity="center_vertical">
<!-- 标题栏 -->
<TextView
android:id="@+id/tv_title_bar"
android:layout_width="0dip"
android:layout_height="wrap_content"
android:layout_weight="1"
android:visibility="gone"
android:gravity="center_vertical"
android:singleLine="true"
android:textColor="#FFEAD1AE"
android:textSize="@dimen/text_font_size_medium" />
<!-- 搜索框 -->
<EditText
android:id="@+id/et_search"
android:layout_width="0dip"
android:layout_height="35dip"
android:layout_weight="1"
android:background="@android:drawable/edit_text"
android:hint="搜索便签..."
android:textColor="#000000"
android:textSize="14sp"
android:paddingLeft="5dip"
android:paddingRight="5dip"
android:visibility="gone"
android:imeOptions="actionSearch"
android:singleLine="true" />
<!-- 搜索按钮 -->
<ImageView
android:id="@+id/iv_search"
android:layout_width="35dip"
android:layout_height="35dip"
android:background="@android:drawable/ic_menu_search"
android:contentDescription="搜索" />
<!-- 取消按钮 -->
<ImageView
android:id="@+id/iv_cancel"
android:layout_width="35dip"
android:layout_height="35dip"
android:background="@android:drawable/ic_menu_close_clear_cancel"
android:contentDescription="取消"
android:visibility="gone" />
<!-- 省略号按钮 -->
<ImageView
android:id="@+id/iv_menu_more"
android:layout_width="35dip"
android:layout_height="35dip"
android:background="@android:drawable/ic_menu_more"
android:contentDescription="更多选项" />
</LinearLayout>
<FrameLayout
android:id="@+id/notes_container"
android:layout_width="fill_parent"
android:layout_height="0dip"
android:layout_weight="1"
android:cacheColorHint="@null"
android:listSelector="@android:color/transparent"
android:divider="@null"
android:fadingEdge="@null" />
android:layout_weight="1">
<!-- 列表视图 -->
<ListView
android:id="@+id/notes_list"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:cacheColorHint="@null"
android:listSelector="@android:color/transparent"
android:divider="@null"
android:fadingEdge="@null" />
<!-- 宫格视图 -->
<GridView
android:id="@+id/notes_grid"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:cacheColorHint="@null"
android:listSelector="@android:color/transparent"
android:divider="@null"
android:fadingEdge="@null"
android:numColumns="2"
android:columnWidth="150dip"
android:verticalSpacing="15dip"
android:horizontalSpacing="15dip"
android:padding="15dip"
android:visibility="gone"
android:stretchMode="columnWidth" />
</FrameLayout>
</LinearLayout>
<Button

16
src/Notes-master/res/layout/password_input_dialog.xml
Unescape View File

@ -0,0 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:padding="16dp">
<EditText
android:id="@+id/password_input"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:inputType="textPassword"
android:hint="@string/preferences_new_password_hint"
android:layout_marginBottom="16dp" />
</LinearLayout>

52
src/Notes-master/res/layout/password_setting_dialog.xml
Unescape View File

@ -0,0 +1,52 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:padding="16dp">
<TextView
android:id="@+id/current_password_label"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/preferences_current_password_label"
android:layout_marginBottom="8dp" />
<EditText
android:id="@+id/current_password"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:inputType="textPassword"
android:hint="@string/preferences_current_password_hint"
android:layout_marginBottom="16dp" />
<TextView
android:id="@+id/new_password_label"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/preferences_new_password_label"
android:layout_marginBottom="8dp" />
<EditText
android:id="@+id/new_password"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:inputType="textPassword"
android:hint="@string/preferences_new_password_hint"
android:layout_marginBottom="16dp" />
<TextView
android:id="@+id/confirm_password_label"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/preferences_confirm_password_label"
android:layout_marginBottom="8dp" />
<EditText
android:id="@+id/confirm_password"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:inputType="textPassword"
android:hint="@string/preferences_confirm_password_hint" />
</LinearLayout>

75
src/Notes-master/res/menu/note_edit.xml
Unescape View File

@ -49,4 +49,79 @@
<item
android:id="@+id/menu_delete_remind"
android:title="@string/menu_remove_remind" />
<item
android:id="@+id/menu_move"
android:title="@string/menu_move" />
<item
android:id="@+id/menu_add_picture"
android:title="@string/menu_add_picture" />
<item
android:id="@+id/menu_change_background"
android:title="@string/menu_change_background" />
<item
android:id="@+id/menu_undo"
android:title="撤回" />
<!-- 格式子菜单 -->
<item
android:id="@+id/menu_format"
android:title="格式"
android:showAsAction="ifRoom">
<menu>
<!-- 文字样式 -->
<group android:id="@+id/format_style">
<item
android:id="@+id/menu_format_bold"
android:title="加粗" />
<item
android:id="@+id/menu_format_italic"
android:title="斜体" />
<item
android:id="@+id/menu_format_underline"
android:title="下划线" />
<item
android:id="@+id/menu_format_strikethrough"
android:title="删除线" />
</group>
<!-- 文字颜色 -->
<group android:id="@+id/format_color">
<item
android:id="@+id/menu_format_text_color"
android:title="文字颜色" />
<item
android:id="@+id/menu_format_bg_color"
android:title="背景颜色" />
</group>
<!-- 对齐方式 -->
<group android:id="@+id/format_align">
<item
android:id="@+id/menu_format_align_left"
android:title="左对齐" />
<item
android:id="@+id/menu_format_align_center"
android:title="居中对齐" />
<item
android:id="@+id/menu_format_align_right"
android:title="右对齐" />
<item
android:id="@+id/menu_format_align_justify"
android:title="两端对齐" />
</group>
<!-- 字号大小 -->
<group android:id="@+id/format_font_size">
<item
android:id="@+id/menu_format_font_large"
android:title="大字号" />
<item
android:id="@+id/menu_format_font_normal"
android:title="正常字号" />
<item
android:id="@+id/menu_format_font_small"
android:title="小字号" />
</group>
</menu>
</item>
</menu>

4
src/Notes-master/res/menu/note_list.xml
Unescape View File

@ -32,6 +32,10 @@
<item
android:id="@+id/menu_setting"
android:title="@string/menu_setting" />
<item
android:id="@+id/menu_change_background"
android:title="@string/menu_change_background" />
<item
android:id="@+id/menu_search"

24
src/Notes-master/res/menu/note_list_options.xml
Unescape View File

@ -17,6 +17,14 @@
<menu
xmlns:android="http://schemas.android.com/apk/res/android">
<item
android:id="@+id/pin"
android:title="置顶"
android:showAsAction="always|withText" />
<item
android:id="@+id/unpin"
android:title="取消置顶"
android:showAsAction="always|withText" />
<item
android:id="@+id/move"
android:title="@string/menu_move"
@ -28,4 +36,20 @@
android:title="@string/menu_delete"
android:icon="@drawable/menu_delete"
android:showAsAction="always|withText" />
<item
android:id="@+id/lock"
android:title="@string/note_lock_menu_lock"
android:showAsAction="always|withText" />
<item
android:id="@+id/unlock"
android:title="@string/note_lock_menu_unlock"
android:showAsAction="always|withText" />
<item
android:id="@+id/make_public"
android:title="开放"
android:showAsAction="always|withText" />
<item
android:id="@+id/make_private"
android:title="取消开放"
android:showAsAction="always|withText" />
</menu>

6
src/Notes-master/res/mipmap-anydpi/ic_launcher.xml
Unescape View File

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@drawable/ic_launcher_background" />
<foreground android:drawable="@drawable/ic_launcher_foreground" />
<monochrome android:drawable="@drawable/ic_launcher_foreground" />
</adaptive-icon>

6
src/Notes-master/res/mipmap-anydpi/ic_launcher_round.xml
Unescape View File

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@drawable/ic_launcher_background" />
<foreground android:drawable="@drawable/ic_launcher_foreground" />
<monochrome android:drawable="@drawable/ic_launcher_foreground" />
</adaptive-icon>

BIN
src/Notes-master/res/mipmap-hdpi/ic_launcher.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.4 KiB

BIN
src/Notes-master/res/mipmap-hdpi/ic_launcher_round.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.8 KiB

BIN
src/Notes-master/res/mipmap-mdpi/ic_launcher.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 982 B

BIN
src/Notes-master/res/mipmap-mdpi/ic_launcher_round.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.7 KiB

BIN
src/Notes-master/res/mipmap-xhdpi/ic_launcher.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

BIN
src/Notes-master/res/mipmap-xhdpi/ic_launcher_round.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.8 KiB

BIN
src/Notes-master/res/mipmap-xxhdpi/ic_launcher.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.8 KiB

BIN
src/Notes-master/res/mipmap-xxhdpi/ic_launcher_round.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.8 KiB

BIN
src/Notes-master/res/mipmap-xxxhdpi/ic_launcher.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.8 KiB

BIN
src/Notes-master/res/mipmap-xxxhdpi/ic_launcher_round.webp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.6 KiB

7
src/Notes-master/res/values-night/themes.xml
Unescape View File

@ -0,0 +1,7 @@
<resources xmlns:tools="http://schemas.android.com/tools">
<!-- Base application theme. -->
<style name="Base.Theme.Notesmaster" parent="Theme.Material3.DayNight.NoActionBar">
<!-- Customize your dark theme here. -->
<!-- <item name="colorPrimary">@color/my_dark_primary</item> -->
</style>
</resources>

29
src/Notes-master/res/values/strings.xml
Unescape View File

@ -26,6 +26,8 @@
<string name="notelist_menu_new">Add note</string>
<string name="delete_remind_time_message">Delete reminder successfully</string>
<string name="set_remind_time_message">Set reminder</string>
<string name="note_alert_canceled">Reminder canceled</string>
<string name="note_alert_set_success">Reminder set successfully</string>
<string name="note_alert_expired">Expired</string>
<string name="format_date_ymd">yyyyMMdd</string>
<string name="format_datetime_mdhm">MMMd kk:mm</string>
@ -67,6 +69,8 @@
<string name="menu_send_to_desktop">Send to home</string>
<string name="menu_alert">Remind me</string>
<string name="menu_remove_remind">Delete reminder</string>
<string name="menu_add_picture">添加图片</string>
<string name="menu_change_background">更换背景</string>
<string name="menu_title_select_folder">Select folder</string>
<string name="menu_move_parent_folder">Parent folder</string>
<string name="info_note_enter_desktop">Note added to home</string>
@ -115,6 +119,26 @@
<string name="preferences_toast_cannot_change_account">Cannot change the account because sync is in progress</string>
<string name="preferences_toast_success_set_accout">%1$s has been set as the sync account</string>
<string name="preferences_bg_random_appear_title">New note background color random</string>
<string name="preferences_password_title">设置（修改）密码</string>
<string name="preferences_password_summary">设置或修改便签密码</string>
<string name="preferences_password_set_title">设置密码</string>
<string name="preferences_password_change_title">修改密码</string>
<string name="preferences_current_password_label">当前密码</string>
<string name="preferences_current_password_hint">请输入当前密码</string>
<string name="preferences_new_password_label">新密码</string>
<string name="preferences_new_password_hint">请输入新密码</string>
<string name="preferences_confirm_password_label">确认密码</string>
<string name="preferences_confirm_password_hint">请再次输入新密码</string>
<string name="preferences_button_confirm">确定</string>
<string name="preferences_button_cancel">取消</string>
<string name="preferences_password_incorrect">当前密码不正确</string>
<string name="preferences_password_empty">新密码不能为空</string>
<string name="preferences_password_not_match">两次输入的密码不一致</string>
<string name="preferences_password_set_success">密码设置成功</string>
<string name="note_lock_menu_lock">加锁</string>
<string name="note_lock_menu_unlock">解锁</string>
<string name="note_lock_password_prompt">请输入密码</string>
<string name="note_lock_password_incorrect">密码错误</string>
<string name="button_delete">Delete</string>
<string name="call_record_folder_name">Call notes</string>
@ -126,10 +150,11 @@
<string name="search">Notes</string>
<string name="datetime_dialog_ok">set</string>
<string name="datetime_dialog_cancel">cancel</string>
<string name="character_count">当前字数：%d</string>
<plurals name="search_results_title">
<item quantity="one"><xliff:g id="number" example="1">%1$s</xliff:g> result for \"<xliff:g id="search" example="???">%2$s</xliff:g>\"</item>
<item quantity="one"><xliff:g id="number" example="1">%1$s</xliff:g> result for "<xliff:g id="search" example="???">%2$s</xliff:g>"</item>
<!-- Case of 0 or 2 or more results. -->
<item quantity="other"><xliff:g id="number" example="15">%1$s</xliff:g> results for \"<xliff:g id="search" example="???">%2$s</xliff:g>\"</item>
<item quantity="other"><xliff:g id="number" example="15">%1$s</xliff:g> results for "<xliff:g id="search" example="???">%2$s</xliff:g>"</item>
</plurals>
</resources>

15
src/Notes-master/res/values/styles.xml
Unescape View File

@ -49,7 +49,7 @@
</style>
<style name="HighlightTextAppearancePrimary">
<item name="android:textSize">@dimen/text_font_size_normal</item>
<item name="android:textSize">@dimen/text_font_size_normal</item>
<item name="android:textColor">@color/primary_text_dark</item>
</style>
@ -63,7 +63,16 @@
</style>
<style name="NoteActionBarStyle" parent="@android:style/Widget.Holo.Light.ActionBar.Solid">
<item name="android:displayOptions" />
<item name="android:visibility">gone</item>
<item name="android:visibility">visible</item>
</style>
<style name="Theme.Transparent" parent="@android:style/Theme.Holo.Light.NoActionBar">
<item name="android:windowBackground">@android:color/transparent</item>
<item name="android:windowIsTranslucent">true</item>
<item name="android:windowContentOverlay">@null</item>
<item name="android:windowNoTitle">true</item>
<item name="android:windowIsFloating">false</item>
<item name="android:backgroundDimEnabled">false</item>
</style>
</resources>

9
src/Notes-master/res/values/themes.xml
Unescape View File

@ -0,0 +1,9 @@
<resources xmlns:tools="http://schemas.android.com/tools">
<!-- Base application theme. -->
<style name="Base.Theme.Notesmaster" parent="Theme.Material3.DayNight.NoActionBar">
<!-- Customize your light theme here. -->
<!-- <item name="colorPrimary">@color/my_light_primary</item> -->
</style>
<style name="Theme.Notesmaster" parent="Base.Theme.Notesmaster" />
</resources>

13
src/Notes-master/res/xml/backup_rules.xml
Unescape View File

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8"?><!--
Sample backup rules file; uncomment and customize as necessary.
See https://developer.android.com/guide/topics/data/autobackup
for details.
Note: This file is ignored for devices older than API 31
See https://developer.android.com/about/versions/12/backup-restore
-->
<full-backup-content>
<!--
<include domain="sharedpref" path="."/>
<exclude domain="sharedpref" path="device.xml"/>
-->
</full-backup-content>

19
src/Notes-master/res/xml/data_extraction_rules.xml
Unescape View File

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="utf-8"?><!--
Sample data extraction rules file; uncomment and customize as necessary.
See https://developer.android.com/about/versions/12/backup-restore#xml-changes
for details.
-->
<data-extraction-rules>
<cloud-backup>
<!-- TODO: Use <include> and <exclude> to control what is backed up.
<include .../>
<exclude .../>
-->
</cloud-backup>
<!--
<device-transfer>
<include .../>
<exclude .../>
</device-transfer>
-->
</data-extraction-rules>

24
src/Notes-master/src/net/micode/notes/MainActivity.java
Unescape View File

@ -0,0 +1,24 @@
package net.micode.notes;
import android.os.Bundle;
import androidx.activity.EdgeToEdge;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
EdgeToEdge.enable(this);
setContentView(R.layout.activity_main);
ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
return insets;
});
}
}

30
src/Notes-master/src/net/micode/notes/SplashActivity.java
Unescape View File

@ -0,0 +1,30 @@
package net.micode.notes;
import android.content.Intent;
import android.os.Bundle;
import android.os.Handler;
import net.micode.notes.ui.LoginActivity;
import net.micode.notes.ui.NotesListActivity;
import androidx.appcompat.app.AppCompatActivity;
public class SplashActivity extends AppCompatActivity {
private static final long SPLASH_DURATION = 1500; // 1.5秒的启动动画
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_splash);
// 延迟后跳转到登录界面
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
Intent intent = new Intent(SplashActivity.this, LoginActivity.class);
startActivity(intent);
finish();
}
}, SPLASH_DURATION);
}
}

23
src/Notes-master/src/net/micode/notes/data/Messages.java
Unescape View File

@ -0,0 +1,23 @@
package net.micode.notes.data;
public class Messages {
public interface MessageColumns {
public static final String ID = "id";
public static final String SENDER_ID = "sender_id";
public static final String RECEIVER_ID = "receiver_id";
public static final String CONTENT = "content";
public static final String MESSAGE_TYPE = "message_type";
public static final String CREATED_DATE = "created_date";
public static final String IS_READ = "is_read";
}
public interface MessageType {
public static final int TEXT = 0;
public static final int IMAGE = 1;
public static final int EMOTION = 2;
public static final int NOTE = 3;
}
public static final long ID_INVALID = -1;
}

36
src/Notes-master/src/net/micode/notes/data/Notes.java
Unescape View File

@ -98,6 +98,12 @@ public class Notes {
* <P> Type: TEXT </P>
*/
public static final String SNIPPET = "snippet";
/**
* Note's title
* <P> Type: TEXT </P>
*/
public static final String TITLE = "title";
/**
* Note's widget id
@ -165,6 +171,36 @@ public class Notes {
* <P> Type : INTEGER (long) </P>
*/
public static final String VERSION = "version";
/**
* Whether the note is pinned
* <P> Type: INTEGER (1=pinned, 0=unpinned) </P>
*/
public static final String PINNED = "pinned";
/**
* Sort order for notes in the same folder
* <P> Type: INTEGER </P>
*/
public static final String SORT_ORDER = "sort_order";
/**
* Whether the note is locked
* <P> Type: INTEGER (1=locked, 0=unlocked) </P>
*/
public static final String LOCKED = "locked";
/**
* The user id that this note belongs to
* <P> Type: INTEGER (long) </P>
*/
public static final String USER_ID = "user_id";
/**
* Whether the note is public
* <P> Type: INTEGER (1=public, 0=private) </P>
*/
public static final String PUBLIC = "public";
}
public interface DataColumns {

122
src/Notes-master/src/net/micode/notes/data/NotesDatabaseHelper.java
Unescape View File

@ -25,24 +25,30 @@ import android.util.Log;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.DataConstants;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.Messages;
import net.micode.notes.data.Users;
public class NotesDatabaseHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "note.db";
private static final int DB_VERSION = 4;
private static final int DB_VERSION = 12;
public interface TABLE {
public static final String NOTE = "note";
public static final String DATA = "data";
public static final String USER = "user";
public static final String MESSAGE = "message";
}
private static final String TAG = "NotesDatabaseHelper";
private static NotesDatabaseHelper mInstance;
private static final String CREATE_NOTE_TABLE_SQL =
private static final String CREATE_NOTE_TABLE_SQL =
"CREATE TABLE " + TABLE.NOTE + "(" +
NoteColumns.ID + " INTEGER PRIMARY KEY," +
NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
@ -53,6 +59,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +
NoteColumns.TITLE + " TEXT NOT NULL DEFAULT ''," +
NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +
@ -60,7 +67,12 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.PINNED + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.SORT_ORDER + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.LOCKED + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.USER_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.PUBLIC + " INTEGER NOT NULL DEFAULT 0" +
")";
private static final String CREATE_DATA_TABLE_SQL =
@ -82,6 +94,26 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
"CREATE INDEX IF NOT EXISTS note_id_index ON " +
TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
private static final String CREATE_USER_TABLE_SQL =
"CREATE TABLE " + TABLE.USER + "(" +
Users.UserColumns.ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +
Users.UserColumns.USERNAME + " TEXT NOT NULL UNIQUE," +
Users.UserColumns.PASSWORD + " TEXT NOT NULL," +
Users.UserColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
Users.UserColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)" +
")";
private static final String CREATE_MESSAGE_TABLE_SQL =
"CREATE TABLE " + TABLE.MESSAGE + "(" +
Messages.MessageColumns.ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +
Messages.MessageColumns.SENDER_ID + " INTEGER NOT NULL," +
Messages.MessageColumns.RECEIVER_ID + " INTEGER NOT NULL," +
Messages.MessageColumns.CONTENT + " TEXT NOT NULL," +
Messages.MessageColumns.MESSAGE_TYPE + " INTEGER NOT NULL DEFAULT 0," +
Messages.MessageColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
Messages.MessageColumns.IS_READ + " INTEGER NOT NULL DEFAULT 0" +
")";
/**
* Increase folder's note count when move note to the folder
*/
@ -287,17 +319,29 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER);
}
static synchronized NotesDatabaseHelper getInstance(Context context) {
public static synchronized NotesDatabaseHelper getInstance(Context context) {
if (mInstance == null) {
mInstance = new NotesDatabaseHelper(context);
}
return mInstance;
}
public void createUserTable(SQLiteDatabase db) {
db.execSQL(CREATE_USER_TABLE_SQL);
Log.d(TAG, "user table has been created");
}
public void createMessageTable(SQLiteDatabase db) {
db.execSQL(CREATE_MESSAGE_TABLE_SQL);
Log.d(TAG, "message table has been created");
}
@Override
public void onCreate(SQLiteDatabase db) {
createNoteTable(db);
createDataTable(db);
createUserTable(db);
createMessageTable(db);
}
@Override
@ -322,6 +366,46 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
oldVersion++;
}
if (oldVersion == 4) {
upgradeToV5(db);
oldVersion++;
}
if (oldVersion == 5) {
upgradeToV6(db);
oldVersion++;
}
if (oldVersion == 6) {
upgradeToV7(db);
oldVersion++;
}
if (oldVersion == 7) {
createUserTable(db);
oldVersion++;
}
if (oldVersion == 8) {
upgradeToV9(db);
oldVersion++;
}
if (oldVersion == 9) {
upgradeToV10(db);
oldVersion++;
}
if (oldVersion == 10) {
upgradeToV11(db);
oldVersion++;
}
if (oldVersion == 11) {
createMessageTable(db);
oldVersion++;
}
if (reCreateTriggers) {
reCreateNoteTableTriggers(db);
reCreateDataTableTriggers(db);
@ -359,4 +443,34 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
+ " INTEGER NOT NULL DEFAULT 0");
}
private void upgradeToV5(SQLiteDatabase db) {
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.PINNED
+ " INTEGER NOT NULL DEFAULT 0");
}
private void upgradeToV6(SQLiteDatabase db) {
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.SORT_ORDER
+ " INTEGER NOT NULL DEFAULT 0");
}
private void upgradeToV7(SQLiteDatabase db) {
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.LOCKED
+ " INTEGER NOT NULL DEFAULT 0");
}
private void upgradeToV9(SQLiteDatabase db) {
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.USER_ID
+ " INTEGER NOT NULL DEFAULT 0");
}
private void upgradeToV10(SQLiteDatabase db) {
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.PUBLIC
+ " INTEGER NOT NULL DEFAULT 0");
}
private void upgradeToV11(SQLiteDatabase db) {
db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.TITLE
+ " TEXT NOT NULL DEFAULT ''");
}
}

280
src/Notes-master/src/net/micode/notes/data/NotesProvider.java
Unescape View File

@ -33,6 +33,7 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.NotesDatabaseHelper.TABLE;
import net.micode.notes.tool.UserManager;
public class NotesProvider extends ContentProvider {
@ -89,60 +90,193 @@ public class NotesProvider extends ContentProvider {
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
String sortOrder) {
Cursor c = null;
SQLiteDatabase db = mHelper.getReadableDatabase();
SQLiteDatabase db = null;
String id = null;
switch (mMatcher.match(uri)) {
case URI_NOTE:
c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
sortOrder);
break;
case URI_NOTE_ITEM:
id = uri.getPathSegments().get(1);
c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
+ parseSelection(selection), selectionArgs, null, null, sortOrder);
break;
case URI_DATA:
c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
sortOrder);
break;
case URI_DATA_ITEM:
id = uri.getPathSegments().get(1);
c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
+ parseSelection(selection), selectionArgs, null, null, sortOrder);
break;
case URI_SEARCH:
case URI_SEARCH_SUGGEST:
if (sortOrder != null || projection != null) {
throw new IllegalArgumentException(
"do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
}
try {
db = mHelper.getReadableDatabase();
// 获取当前用户ID，添加空指针检查
long currentUserId = 0;
if (getContext() != null) {
currentUserId = UserManager.getInstance(getContext()).getCurrentUserId();
}
// 构建用户ID过滤条件，确保currentUserId不为-1
long userIdForFilter = currentUserId > 0 ? currentUserId : 0;
String userFilter = NoteColumns.USER_ID + " = " + userIdForFilter;
switch (mMatcher.match(uri)) {
case URI_NOTE:
// 构建查询条件：
// 1. 如果selection中包含USER_ID条件，说明是查询特定用户的便签，直接使用selection
// 2. 如果selection中包含PUBLIC条件，说明是查询公开便签，直接使用selection
// 3. 否则，系统文件夹(ID <= 0)不受用户ID限制，普通便签需要匹配当前用户ID
String finalSelection;
if (TextUtils.isEmpty(selection)) {
finalSelection = "(" + NoteColumns.ID + " <= 0) OR (" + userFilter + ")";
} else {
// 检查selection中是否包含USER_ID或PUBLIC条件
if (selection.contains(NoteColumns.USER_ID) || selection.contains(NoteColumns.PUBLIC)) {
// 如果包含USER_ID或PUBLIC条件，直接使用selection，绕过当前用户过滤
finalSelection = selection;
} else {
// 否则，添加用户ID过滤
finalSelection = "((" + NoteColumns.ID + " <= 0) OR (" + userFilter + ")) AND (" + selection + ")";
}
}
c = db.query(TABLE.NOTE, projection, finalSelection, selectionArgs, null, null,
sortOrder);
break;
case URI_NOTE_ITEM:
id = uri.getPathSegments().get(1);
// 对于单个便签详情，不添加用户过滤条件，允许访问任何便签
// 因为FriendNoteListActivity已经确保只显示公开便签
if (TextUtils.isEmpty(selection)) {
selection = null;
}
c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
+ parseSelection(selection), selectionArgs, null, null, sortOrder);
break;
case URI_DATA:
// 处理DATA表查询，需要考虑便签的PUBLIC属性
if (selection != null && selection.contains(DataColumns.NOTE_ID)) {
// 如果查询包含NOTE_ID，需要确保对应的便签是公开的或属于当前用户
try {
// 从selection中提取note_id值
String noteIdStr = selection;
noteIdStr = noteIdStr.substring(noteIdStr.indexOf('=') + 1);
if (noteIdStr.contains("AND")) {
noteIdStr = noteIdStr.substring(0, noteIdStr.indexOf("AND")).trim();
}
long noteId = Long.parseLong(noteIdStr);
// 查询对应便签的PUBLIC和USER_ID属性
Cursor noteCursor = db.query(
TABLE.NOTE,
new String[]{NoteColumns.PUBLIC, NoteColumns.USER_ID},
NoteColumns.ID + "=?",
new String[]{String.valueOf(noteId)},
null,
null,
null
);
boolean canAccess = false;
if (noteCursor != null && noteCursor.moveToFirst()) {
int isPublic = noteCursor.getInt(0);
long noteUserId = noteCursor.getLong(1);
// 允许访问的条件：便签是公开的或便签属于当前用户
canAccess = (isPublic == 1 || noteUserId == currentUserId);
noteCursor.close();
}
if (!canAccess) {
// 如果不能访问，返回空cursor
return null;
}
} catch (Exception e) {
// 如果解析失败，默认允许访问，避免误判
Log.e(TAG, "Error parsing note_id from selection: " + e.getMessage());
}
}
c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
sortOrder);
break;
case URI_DATA_ITEM:
// 处理单个DATA项查询，同样需要考虑便签的PUBLIC属性
id = uri.getPathSegments().get(1);
// 先查询该DATA项对应的note_id
Cursor dataCursor = null;
boolean canAccess = false;
try {
dataCursor = db.query(
TABLE.DATA,
new String[]{DataColumns.NOTE_ID},
DataColumns.ID + "=?",
new String[]{id},
null,
null,
null
);
if (dataCursor != null && dataCursor.moveToFirst()) {
long noteId = dataCursor.getLong(0);
// 查询对应便签的PUBLIC和USER_ID属性
Cursor noteCursor = null;
try {
noteCursor = db.query(
TABLE.NOTE,
new String[]{NoteColumns.PUBLIC, NoteColumns.USER_ID},
NoteColumns.ID + "=?",
new String[]{String.valueOf(noteId)},
null,
null,
null
);
if (noteCursor != null && noteCursor.moveToFirst()) {
int isPublic = noteCursor.getInt(0);
long noteUserId = noteCursor.getLong(1);
// 允许访问的条件：便签是公开的或便签属于当前用户
canAccess = (isPublic == 1 || noteUserId == currentUserId);
}
} finally {
if (noteCursor != null) {
noteCursor.close();
}
}
}
} finally {
if (dataCursor != null) {
dataCursor.close();
}
}
if (canAccess) {
c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
+ parseSelection(selection), selectionArgs, null, null, sortOrder);
}
// 如果不能访问，返回null，默认处理
break;
case URI_SEARCH:
case URI_SEARCH_SUGGEST:
if (sortOrder != null || projection != null) {
throw new IllegalArgumentException(
"do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
}
String searchString = null;
if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
if (uri.getPathSegments().size() > 1) {
searchString = uri.getPathSegments().get(1);
String searchString = null;
if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
if (uri.getPathSegments().size() > 1) {
searchString = uri.getPathSegments().get(1);
}
} else {
searchString = uri.getQueryParameter("pattern");
}
} else {
searchString = uri.getQueryParameter("pattern");
}
if (TextUtils.isEmpty(searchString)) {
return null;
}
if (TextUtils.isEmpty(searchString)) {
return null;
}
try {
searchString = String.format("%%%s%%", searchString);
c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
new String[] { searchString });
} catch (IllegalStateException ex) {
Log.e(TAG, "got exception: " + ex.toString());
}
break;
default:
throw new IllegalArgumentException("Unknown URI " + uri);
}
if (c != null) {
c.setNotificationUri(getContext().getContentResolver(), uri);
try {
searchString = String.format("%%%s%%", searchString);
c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
new String[] { searchString });
} catch (IllegalStateException ex) {
Log.e(TAG, "got exception: " + ex.toString());
}
break;
default:
throw new IllegalArgumentException("Unknown URI " + uri);
}
if (c != null) {
c.setNotificationUri(getContext().getContentResolver(), uri);
}
} catch (Exception e) {
Log.e(TAG, "query exception: " + e.toString());
e.printStackTrace();
}
return c;
}
@ -151,8 +285,17 @@ public class NotesProvider extends ContentProvider {
public Uri insert(Uri uri, ContentValues values) {
SQLiteDatabase db = mHelper.getWritableDatabase();
long dataId = 0, noteId = 0, insertedId = 0;
// 获取当前用户ID，添加空指针检查
long currentUserId = 0;
if (getContext() != null) {
currentUserId = UserManager.getInstance(getContext()).getCurrentUserId();
}
switch (mMatcher.match(uri)) {
case URI_NOTE:
// 插入新便签时添加当前用户ID
values.put(NoteColumns.USER_ID, currentUserId);
insertedId = noteId = db.insert(TABLE.NOTE, null, values);
break;
case URI_DATA:
@ -187,8 +330,24 @@ public class NotesProvider extends ContentProvider {
String id = null;
SQLiteDatabase db = mHelper.getWritableDatabase();
boolean deleteData = false;
// 获取当前用户ID，添加空指针检查
long currentUserId = 0;
if (getContext() != null) {
currentUserId = UserManager.getInstance(getContext()).getCurrentUserId();
}
// 构建用户ID过滤条件
String userFilter = NoteColumns.USER_ID + " = " + currentUserId;
switch (mMatcher.match(uri)) {
case URI_NOTE:
// 添加用户ID过滤
if (TextUtils.isEmpty(selection)) {
selection = userFilter;
} else {
selection = userFilter + " AND (" + selection + ")";
}
selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
count = db.delete(TABLE.NOTE, selection, selectionArgs);
break;
@ -202,6 +361,12 @@ public class NotesProvider extends ContentProvider {
if (noteId <= 0) {
break;
}
// 添加用户ID过滤
if (TextUtils.isEmpty(selection)) {
selection = userFilter;
} else {
selection = userFilter + " AND (" + selection + ")";
}
count = db.delete(TABLE.NOTE,
NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
break;
@ -233,13 +398,30 @@ public class NotesProvider extends ContentProvider {
String id = null;
SQLiteDatabase db = mHelper.getWritableDatabase();
boolean updateData = false;
// 获取当前用户ID，添加空指针检查
long currentUserId = 0;
if (getContext() != null) {
currentUserId = UserManager.getInstance(getContext()).getCurrentUserId();
}
// 构建用户ID过滤条件
String userFilter = NoteColumns.USER_ID + " = " + currentUserId;
switch (mMatcher.match(uri)) {
case URI_NOTE:
// 添加用户ID过滤
if (TextUtils.isEmpty(selection)) {
selection = userFilter;
} else {
selection = userFilter + " AND (" + selection + ")";
}
increaseNoteVersion(-1, selection, selectionArgs);
count = db.update(TABLE.NOTE, values, selection, selectionArgs);
break;
case URI_NOTE_ITEM:
id = uri.getPathSegments().get(1);
// 对于单个便签更新，NoteColumns.ID是主键，已经足够唯一，不需要添加用户ID过滤
increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
+ parseSelection(selection), selectionArgs);

31
src/Notes-master/src/net/micode/notes/data/Users.java
Unescape View File

@ -0,0 +1,31 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* 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.
*/
package net.micode.notes.data;
public class Users {
public interface UserColumns {
public static final String ID = "_id";
public static final String USERNAME = "username";
public static final String PASSWORD = "password";
public static final String CREATED_DATE = "created_date";
public static final String MODIFIED_DATE = "modified_date";
}
public interface UserConstants {
// 可以添加一些用户相关的常量
}
}

54
src/Notes-master/src/net/micode/notes/gtask/remote/GTaskASyncTask.java
Unescape View File

@ -63,25 +63,43 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
});
}
private void showNotification(int tickerId, String content) {
Notification notification = new Notification(R.drawable.notification, mContext
.getString(tickerId), System.currentTimeMillis());
notification.defaults = Notification.DEFAULT_LIGHTS;
notification.flags = Notification.FLAG_AUTO_CANCEL;
PendingIntent pendingIntent;
if (tickerId != R.string.ticker_success) {
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
NotesPreferenceActivity.class), 0);
} else {
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
NotesListActivity.class), 0);
}
notification.setLatestEventInfo(mContext, mContext.getString(R.string.app_name), content,
pendingIntent);
mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
// private void showNotification(int tickerId, String content) {
// Notification notification = new Notification(R.drawable.notification, mContext
// .getString(tickerId), System.currentTimeMillis());
// notification.defaults = Notification.DEFAULT_LIGHTS;
// notification.flags = Notification.FLAG_AUTO_CANCEL;
// PendingIntent pendingIntent;
// if (tickerId != R.string.ticker_success) {
// pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
// NotesPreferenceActivity.class), 0);
//
// } else {
// pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
// NotesListActivity.class), 0);
// }
// notification.setLatestEventInfo(mContext, mContext.getString(R.string.app_name), content,
// pendingIntent);
// mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
// }
private void showNotification(int tickerId, String content) {
PendingIntent pendingIntent;
if (tickerId != R.string.ticker_success) {
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
NotesPreferenceActivity.class), PendingIntent.FLAG_IMMUTABLE);
} else {
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
NotesListActivity.class), PendingIntent.FLAG_IMMUTABLE);
}
Notification.Builder builder = new Notification.Builder(mContext)
.setAutoCancel(true)
.setContentTitle(mContext.getString(R.string.app_name))
.setContentText(content)
.setContentIntent(pendingIntent)
.setWhen(System.currentTimeMillis())
.setOngoing(true);
Notification notification=builder.getNotification();
mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
}
@Override
protected Integer doInBackground(Void... unused) {
publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity

19
src/Notes-master/src/net/micode/notes/model/Note.java
Unescape View File

@ -30,6 +30,7 @@ import net.micode.notes.data.Notes.CallNote;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.Notes.TextNote;
import net.micode.notes.tool.UserManager;
import java.util.ArrayList;
@ -50,14 +51,22 @@ public class Note {
values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
values.put(NoteColumns.LOCAL_MODIFIED, 1);
values.put(NoteColumns.PARENT_ID, folderId);
// 设置当前用户ID
long currentUserId = UserManager.getInstance(context).getCurrentUserId();
values.put(NoteColumns.USER_ID, currentUserId);
Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
long noteId = 0;
try {
noteId = Long.valueOf(uri.getPathSegments().get(1));
} catch (NumberFormatException e) {
Log.e(TAG, "Get note id error :" + e.toString());
noteId = 0;
if (uri != null) {
try {
noteId = Long.valueOf(uri.getPathSegments().get(1));
} catch (NumberFormatException e) {
Log.e(TAG, "Get note id error :" + e.toString());
noteId = 0;
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get note id error :" + e.toString());
noteId = 0;
}
}
if (noteId == -1) {
throw new IllegalStateException("Wrong note id:" + noteId);

95
src/Notes-master/src/net/micode/notes/model/WorkingNote.java
Unescape View File

@ -39,6 +39,8 @@ public class WorkingNote {
private long mNoteId;
// Note content
private String mContent;
// Note title
private String mTitle;
// Note mode
private int mMode;
@ -78,7 +80,8 @@ public class WorkingNote {
NoteColumns.BG_COLOR_ID,
NoteColumns.WIDGET_ID,
NoteColumns.WIDGET_TYPE,
NoteColumns.MODIFIED_DATE
NoteColumns.MODIFIED_DATE,
NoteColumns.TITLE
};
private static final int DATA_ID_COLUMN = 0;
@ -101,6 +104,8 @@ public class WorkingNote {
private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
private static final int NOTE_TITLE_COLUMN = 6;
// New note construct
private WorkingNote(Context context, long folderId) {
mContext = context;
@ -125,6 +130,7 @@ public class WorkingNote {
}
private void loadNote() {
// 执行查询，不添加用户过滤条件，因为NotesProvider已经处理了公开便签的访问权限
Cursor cursor = mContext.getContentResolver().query(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
null, null);
@ -137,6 +143,7 @@ public class WorkingNote {
mWidgetType = cursor.getInt(NOTE_WIDGET_TYPE_COLUMN);
mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
mTitle = cursor.getString(NOTE_TITLE_COLUMN);
}
cursor.close();
} else {
@ -149,9 +156,13 @@ public class WorkingNote {
private void loadNoteData() {
Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
DataColumns.NOTE_ID + "=?", new String[] {
String.valueOf(mNoteId)
String.valueOf(mNoteId)
}, null);
// 初始化默认值
mContent = "";
mMode = 0;
if (cursor != null) {
if (cursor.moveToFirst()) {
do {
@ -170,12 +181,11 @@ public class WorkingNote {
cursor.close();
} else {
Log.e(TAG, "No data with id:" + mNoteId);
throw new IllegalArgumentException("Unable to find note's data with id " + mNoteId);
}
}
public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
int widgetType, int defaultBgColorId) {
int widgetType, int defaultBgColorId) {
WorkingNote note = new WorkingNote(context, folderId);
note.setBgColorId(defaultBgColorId);
note.setWidgetId(widgetId);
@ -188,26 +198,54 @@ public class WorkingNote {
}
public synchronized boolean saveNote() {
if (isWorthSaving()) {
if (!existInDatabase()) {
if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
Log.e(TAG, "Create new note fail with id:" + mNoteId);
return false;
try {
if (isWorthSaving()) {
if (!existInDatabase()) {
if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
Log.e(TAG, "Create new note fail with id:" + mNoteId);
return false;
}
}
}
mNote.syncNote(mContext, mNoteId);
mNote.syncNote(mContext, mNoteId);
// 自动分类逻辑
try {
// 优先使用标题分类，如果标题为空则使用内容分类
String contentForCategory = mTitle;
if (contentForCategory == null || contentForCategory.isEmpty()) {
contentForCategory = mContent;
}
// 根据标题或内容自动分类
String category = net.micode.notes.tool.CategoryUtil.autoCategorize(contentForCategory);
// 创建或获取对应的文件夹
long categoryFolderId = net.micode.notes.tool.DataUtils.createFolder(mContext.getContentResolver(), category);
if (categoryFolderId > 0 && mFolderId != categoryFolderId) {
// 将便签移动到分类文件夹
net.micode.notes.tool.DataUtils.moveNoteToFoler(mContext.getContentResolver(), mNoteId, mFolderId, categoryFolderId);
mFolderId = categoryFolderId;
}
} catch (Exception e) {
Log.e(TAG, "Auto categorize fail: " + e.getMessage());
// 自动分类失败不影响便签保存
}
/**
* Update widget content if there exist any widget of this note
*/
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
&& mWidgetType != Notes.TYPE_WIDGET_INVALIDE
&& mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onWidgetChanged();
/**
* Update widget content if there exist any widget of this note
*/
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
&& mWidgetType != Notes.TYPE_WIDGET_INVALIDE
&& mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onWidgetChanged();
}
return true;
} else {
return false;
}
return true;
} else {
} catch (Exception e) {
Log.e(TAG, "Save note fail: " + e.getMessage());
e.printStackTrace();
return false;
}
}
@ -217,10 +255,10 @@ public class WorkingNote {
}
private boolean isWorthSaving() {
if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
|| (existInDatabase() && !mNote.isLocalModified())) {
if (mIsDeleted) {
return false;
} else {
// 允许保存空便签
return true;
}
}
@ -243,7 +281,7 @@ public class WorkingNote {
mIsDeleted = mark;
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
&& mWidgetType != Notes.TYPE_WIDGET_INVALIDE && mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onWidgetChanged();
mNoteSettingStatusListener.onWidgetChanged();
}
}
@ -287,6 +325,17 @@ public class WorkingNote {
mNote.setTextData(DataColumns.CONTENT, mContent);
}
}
public void setWorkingTitle(String title) {
if (!TextUtils.equals(mTitle, title)) {
mTitle = title;
mNote.setNoteValue(NoteColumns.TITLE, title);
}
}
public String getTitle() {
return mTitle;
}
public void convertToCallNote(String phoneNumber, long callDate) {
mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));

294
src/Notes-master/src/net/micode/notes/tool/BackupUtils.java
Unescape View File

@ -5,7 +5,7 @@
* 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
* 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,
@ -14,61 +14,46 @@
* limitations under the License.
*/
// 包声明：归属小米便签的工具模块，提供笔记备份（导出为文本文件）核心功能
package net.micode.notes.tool;
// 导入安卓上下文类：访问资源、ContentResolver
import android.content.Context;
// 导入安卓数据库游标类：查询便签/便签数据的核心载体
import android.database.Cursor;
// 导入安卓外部存储类：判断SD卡挂载状态、获取SD卡根目录
import android.os.Environment;
// 导入安卓文本工具类：判空、字符串处理
import android.text.TextUtils;
// 导入安卓日期格式化类：格式化便签修改时间、导出文件名
import android.text.format.DateFormat;
// 导入安卓日志类：输出备份过程中的日志（调试/错误）
import android.util.Log;
// 导入小米便签资源类：引用字符串（文件路径、格式模板、文件夹名称）
import net.micode.notes.R;
// 导入便签数据常量类：定义ContentURI、字段、便签类型、特殊文件夹ID等
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.DataConstants;
import net.micode.notes.data.Notes.NoteColumns;
// 导入文件操作相关类：创建文件/目录、文件输出流、打印流
import java.io.File;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.PrintStream;
/**
* 便签备份工具类
* 核心特性：
* 1. 单例模式：全局唯一实例，避免重复初始化资源；
* 2. 核心功能：将便签数据库中的所有有效便签（排除回收站）导出为SD卡上的文本文件；
* 3. 导出范围：
* - 所有文件夹（排除回收站）及文件夹下的便签；
* - 通话记录文件夹及其中的通话记录便签；
* - 根目录下的普通便签；
* 4. 导出格式：按文件夹分组，包含便签修改时间、内容（普通文本/通话记录详情）；
* 5. 状态码机制：返回备份操作的结果（SD卡未挂载、文件创建失败、成功等）。
* 便签备份工具类，用于将便签数据导出为文本文件
* <p>
* 该类采用单例模式，提供便签数据的文本导出功能，支持将便签内容（包括文件夹结构）导出到SD卡上的文本文件中，
* 方便用户备份和查看便签内容。
*/
public class BackupUtils {
// 日志标签：用于备份过程的日志输出
private static final String TAG = "BackupUtils";
// 单例实例：全局唯一的BackupUtils对象
// Singleton stuff
private static BackupUtils sInstance;
/**
* 获取单例实例（线程安全）
* 采用同步方法确保多线程环境下实例唯一，避免重复创建
* @param context 应用上下文：用于初始化内部导出器、访问资源
* @return BackupUtils全局唯一实例
* 获取BackupUtils实例
* <p>
* 采用单例模式，确保整个应用中只有一个BackupUtils实例
*
* @param context 上下文对象
* @return BackupUtils实例
*/
public static synchronized BackupUtils getInstance(Context context) {
if (sInstance == null) {
@ -78,76 +63,73 @@ public class BackupUtils {
}
/**
* 备份操作状态码：标识导出过程的结果，供外部判断操作是否成功
* 备份或恢复状态的常量定义
*/
// SD卡未挂载（无法创建/写入导出文件）
// 当前SD卡未挂载
public static final int STATE_SD_CARD_UNMOUONTED = 0;
// 备份文件不存在（仅恢复操作使用，当前导出逻辑未用到）
// 备份文件不存在
public static final int STATE_BACKUP_FILE_NOT_EXIST = 1;
// 数据格式错误（导出时未用到，预留恢复操作的状态码）
// 数据格式不正确，可能被其他程序修改
public static final int STATE_DATA_DESTROIED = 2;
// 系统错误（如文件创建失败、IO异常等运行时错误）
// 运行时异常导致备份或恢复失败
public static final int STATE_SYSTEM_ERROR = 3;
// 导出操作成功完成
// 备份或恢复成功
public static final int STATE_SUCCESS = 4;
// 文本导出器实例：封装实际的文本导出逻辑，与工具类解耦
private TextExport mTextExport;
/**
* 私有构造方法：单例模式的核心，禁止外部直接实例化
* @param context 应用上下文：传递给TextExport初始化资源
* 构造方法
*
* @param context 上下文对象
*/
private BackupUtils(Context context) {
mTextExport = new TextExport(context);
}
/**
* 检查外部存储（SD卡）是否可用
* 仅当SD卡处于“已挂载”状态时，才允许执行导出操作
* @return true=SD卡已挂载且可读写，false=不可用
* 检查外部存储是否可用
*
* @return 外部存储是否可用
*/
private static boolean externalStorageAvailable() {
return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
}
/**
* 对外暴露的导出方法：触发便签导出为文本文件的核心逻辑
* @return 操作状态码：参考BackupUtils的STATE_XXX常量
* 将便签导出为文本文件
* <p>
* 调用内部TextExport类的exportToText方法执行导出操作
*
* @return 导出状态，参考STATE_*常量
*/
public int exportToText() {
return mTextExport.exportToText();
}
/**
* 获取本次导出的文件名（导出成功后有效）
* @return 导出文件的名称（如notes_20251223.txt）
* 获取导出的文本文件名
*
* @return 导出的文本文件名
*/
public String getExportedTextFileName() {
return mTextExport.mFileName;
}
/**
* 获取本次导出的文件目录（导出成功后有效）
* @return 导出文件所在的目录路径（如/sdcard/MiNotes/）
* 获取导出的文本文件目录
*
* @return 导出的文本文件目录
*/
public String getExportedTextFileDir() {
return mTextExport.mFileDirectory;
}
/**
* 内部文本导出器类：封装所有导出相关的核心逻辑
* 与外部BackupUtils解耦，专注处理“查询便签数据→格式化→写入文本文件”的完整流程
* 文本导出内部类，负责具体的导出逻辑
*/
private static class TextExport {
/**
* 便签查询投影数组：仅查询导出所需的核心字段，减少IO开销
* 字段说明：
* - NoteColumns.ID：便签/文件夹唯一ID；
* - NoteColumns.MODIFIED_DATE：便签最后修改时间（用于导出展示）；
* - NoteColumns.SNIPPET：便签摘要/文件夹名称；
* - NoteColumns.TYPE：便签类型（文件夹/普通便签/系统项）。
*/
// 便签查询的投影列
private static final String[] NOTE_PROJECTION = {
NoteColumns.ID,
NoteColumns.MODIFIED_DATE,
@ -155,20 +137,11 @@ public class BackupUtils {
NoteColumns.TYPE
};
// 便签投影数组列索引常量：简化Cursor取值，避免硬编码
private static final int NOTE_COLUMN_ID = 0;
private static final int NOTE_COLUMN_MODIFIED_DATE = 1;
private static final int NOTE_COLUMN_SNIPPET = 2;
/**
* 便签数据查询投影数组：查询便签的具体内容（普通文本/通话记录）
* 字段说明：
* - DataColumns.CONTENT：普通便签内容/通话记录附件位置；
* - DataColumns.MIME_TYPE：数据类型（普通便签/通话记录）；
* - DataColumns.DATA1：通话记录时间；
* - DataColumns.DATA4：通话记录手机号；
* 其他DATA字段为预留，暂未使用。
*/
// 便签数据查询的投影列
private static final String[] DATA_PROJECTION = {
DataColumns.CONTENT,
DataColumns.MIME_TYPE,
@ -178,198 +151,174 @@ public class BackupUtils {
DataColumns.DATA4,
};
// 便签数据投影数组列索引常量
private static final int DATA_COLUMN_CONTENT = 0;
private static final int DATA_COLUMN_MIME_TYPE = 1;
private static final int DATA_COLUMN_CALL_DATE = 2;
private static final int DATA_COLUMN_PHONE_NUMBER = 4;
/**
* 导出文本格式模板数组：从资源文件读取，适配多语言，避免硬编码文本格式
* 数组索引对应：
* - FORMAT_FOLDER_NAME：文件夹名称展示格式（如“【文件夹：XXX】”）；
* - FORMAT_NOTE_DATE：便签修改时间展示格式（如“修改时间：2025-12-23 15:30”）；
* - FORMAT_NOTE_CONTENT：便签内容展示格式（如“内容：XXX”）。
*/
// 文本格式数组
private final String [] TEXT_FORMAT;
// 格式模板索引常量
private static final int FORMAT_FOLDER_NAME = 0;
private static final int FORMAT_NOTE_DATE = 1;
private static final int FORMAT_NOTE_CONTENT = 2;
// 上下文：用于访问ContentResolver、资源文件
private Context mContext;
private String mFileName; // 导出文件的名称（如notes_20251223.txt）
private String mFileDirectory; // 导出文件的目录路径（如/sdcard/MiNotes/）
private String mFileName;
private String mFileDirectory;
/**
* 文本导出器构造方法
* @param context 应用上下文：读取格式模板、资源字符串
* 构造方法
*
* @param context 上下文对象
*/
public TextExport(Context context) {
// 从资源文件加载导出文本的格式模板
TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);
mContext = context;
// 初始化文件名/目录为空，导出成功后赋值
mFileName = "";
mFileDirectory = "";
}
/**
* 获取指定索引的文本格式模板
* @param id 格式模板索引（FORMAT_FOLDER_NAME/FORMAT_NOTE_DATE/FORMAT_NOTE_CONTENT）
* @return 格式模板字符串
* 获取指定ID的格式字符串
*
* @param id 格式ID
* @return 格式字符串
*/
private String getFormat(int id) {
return TEXT_FORMAT[id];
}
/**
* 导出指定文件夹下的所有便签到打印流
* @param folderId 文件夹ID：要导出的文件夹唯一标识
* @param ps 打印流：指向SD卡的导出文件，用于写入文本内容
* 将指定文件夹及其包含的便签导出为文本
*
* @param folderId 文件夹ID
* @param ps 打印流
*/
private void exportFolderToText(String folderId, PrintStream ps) {
// 查询该文件夹下的所有普通便签
// 查询该文件夹下的所有便签
Cursor notesCursor = mContext.getContentResolver().query(Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
NoteColumns.PARENT_ID + "=?", // 查询条件：父文件夹ID匹配
new String[] { folderId },
null);
NOTE_PROJECTION, NoteColumns.PARENT_ID + "=?", new String[] {
folderId
}, null);
if (notesCursor != null) {
// 遍历文件夹下的所有便签
if (notesCursor.moveToFirst()) {
do {
// 1. 打印便签最后修改时间（按格式模板）
// 打印便签的最后修改时间
ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm), // 时间格式：月日时分
mContext.getString(R.string.format_datetime_mdhm),
notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
// 2. 导出单条便签的详细内容
// 查询属于该便签的数据
String noteId = notesCursor.getString(NOTE_COLUMN_ID);
exportNoteToText(noteId, ps);
} while (notesCursor.moveToNext());
}
// 关闭游标，释放数据库资源
notesCursor.close();
}
}
/**
* 导出单条便签的详细内容到打印流
* 区分处理普通文本便签和通话记录便签，按不同格式写入内容
* @param noteId 便签ID：要导出的便签唯一标识
* @param ps 打印流：指向SD卡的导出文件
* 将指定便签导出为文本
*
* @param noteId 便签ID
* @param ps 打印流
*/
private void exportNoteToText(String noteId, PrintStream ps) {
// 查询该便签的具体数据（内容/通话记录详情）
// 查询该便签的所有数据
Cursor dataCursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI,
DATA_PROJECTION,
DataColumns.NOTE_ID + "=?", // 查询条件：便签ID匹配
new String[] { noteId },
null);
DATA_PROJECTION, DataColumns.NOTE_ID + "=?", new String[] {
noteId
}, null);
if (dataCursor != null) {
// 遍历便签的所有数据项（单条便签可能包含多个数据项，如通话记录+附件）
if (dataCursor.moveToFirst()) {
do {
String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE);
// 1. 处理通话记录类型便签
if (DataConstants.CALL_NOTE.equals(mimeType)) {
// 获取通话记录核心信息
// 打印电话号码
String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER);
long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE);
String location = dataCursor.getString(DATA_COLUMN_CONTENT);
// 打印手机号（非空时）
if (!TextUtils.isEmpty(phoneNumber)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), phoneNumber));
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
phoneNumber));
}
// 打印通话时间
// 打印通话日期
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), DateFormat
.format(mContext.getString(R.string.format_datetime_mdhm), callDate)));
// 打印通话记录附件位置（非空时）
.format(mContext.getString(R.string.format_datetime_mdhm),
callDate)));
// 打印通话附件位置
if (!TextUtils.isEmpty(location)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), location));
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
location));
}
}
// 2. 处理普通文本便签
else if (DataConstants.NOTE.equals(mimeType)) {
} else if (DataConstants.NOTE.equals(mimeType)) {
// 打印便签内容
String content = dataCursor.getString(DATA_COLUMN_CONTENT);
// 打印便签内容（非空时）
if (!TextUtils.isEmpty(content)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), content));
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
content));
}
}
} while (dataCursor.moveToNext());
}
// 关闭游标，释放资源
dataCursor.close();
}
// 便签内容结束后，添加分隔符（换行+分隔符），区分不同便签
// 打印便签之间的分隔线
try {
ps.write(new byte[] {
Character.LINE_SEPARATOR, Character.LETTER_NUMBER
Character.LINE_SEPARATOR, Character.LINE_SEPARATOR
});
} catch (IOException e) {
// 写入分隔符失败时输出错误日志，不中断整体导出流程
Log.e(TAG, e.toString());
}
}
/**
* 执行核心导出逻辑：将所有有效便签导出为SD卡上的文本文件
* 导出流程：
* 1. 检查SD卡是否可用；
* 2. 创建导出文件的打印流；
* 3. 导出所有有效文件夹（排除回收站）+ 通话记录文件夹；
* 4. 导出根目录下的普通便签；
* 5. 关闭打印流，返回操作状态码。
* @return 操作状态码：参考BackupUtils的STATE_XXX常量
* 将便签导出为用户可读的文本文件
* <p>
* 导出过程包括：
* 1. 检查SD卡是否可用
* 2. 创建导出文件
* 3. 导出文件夹及其便签
* 4. 导出根目录下的便签
*
* @return 导出状态，参考STATE_*常量
*/
public int exportToText() {
// 步骤1：检查SD卡是否挂载，未挂载直接返回对应状态码
if (!externalStorageAvailable()) {
Log.d(TAG, "Media was not mounted");
return STATE_SD_CARD_UNMOUONTED;
}
// 步骤2：创建导出文件的打印流，失败则返回系统错误
PrintStream ps = getExportToTextPrintStream();
if (ps == null) {
Log.e(TAG, "get print stream error");
return STATE_SYSTEM_ERROR;
}
// 步骤3：导出所有有效文件夹（排除回收站）+ 通话记录文件夹
// 导出文件夹及其便签
Cursor folderCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
// 查询条件：
// - 类型为文件夹 + 父文件夹不是回收站；
// - 或ID为通话记录文件夹（特殊系统文件夹）
"(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND "
+ NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + ") OR "
+ NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER,
null,
null);
+ NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER, null, null);
if (folderCursor != null) {
if (folderCursor.moveToFirst()) {
do {
// 处理文件夹名称：通话记录文件夹使用固定名称，其他文件夹用摘要
// 打印文件夹名称
String folderName = "";
if(folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) {
folderName = mContext.getString(R.string.call_record_folder_name);
} else {
folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET);
}
// 打印文件夹名称（非空时）
if (!TextUtils.isEmpty(folderName)) {
ps.println(String.format(getFormat(FORMAT_FOLDER_NAME), folderName));
}
// 导出该文件夹下的所有便签
String folderId = folderCursor.getString(NOTE_COLUMN_ID);
exportFolderToText(folderId, ps);
} while (folderCursor.moveToNext());
@ -377,66 +326,53 @@ public class BackupUtils {
folderCursor.close();
}
// 步骤4：导出根目录下的普通便签（父文件夹ID为0）
// 导出根目录下的便签
Cursor noteCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
// 查询条件：类型为普通便签 + 父文件夹为根目录
NoteColumns.TYPE + "=" + Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID
+ "=0",
null,
null);
+ "=0", null, null);
if (noteCursor != null) {
if (noteCursor.moveToFirst()) {
do {
// 打印便签修改时间
ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm),
noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
// 导出单条便签内容
// 查询属于该便签的数据
String noteId = noteCursor.getString(NOTE_COLUMN_ID);
exportNoteToText(noteId, ps);
} while (noteCursor.moveToNext());
}
noteCursor.close();
}
// 步骤5：关闭打印流，释放文件资源
ps.close();
// 导出成功，返回成功状态码
return STATE_SUCCESS;
}
/**
* 创建指向SD卡导出文件的PrintStream
* 核心逻辑：调用generateFileMountedOnSDcard创建文件，再包装为PrintStream
* @return PrintStream对象（成功）/null（失败）
* 获取导出文本的打印流
*
* @return 打印流
*/
private PrintStream getExportToTextPrintStream() {
// 生成SD卡上的导出文件（带日期的文本文件）
File file = generateFileMountedOnSDcard(mContext, R.string.file_path,
R.string.file_name_txt_format);
if (file == null) {
Log.e(TAG, "create file to exported failed");
return null;
}
// 记录导出文件的名称和目录（供外部获取）
mFileName = file.getName();
mFileDirectory = mContext.getString(R.string.file_path);
PrintStream ps = null;
try {
// 创建文件输出流，包装为打印流（方便文本写入）
FileOutputStream fos = new FileOutputStream(file);
ps = new PrintStream(fos);
} catch (FileNotFoundException e) {
// 文件未找到异常：打印堆栈，返回null
e.printStackTrace();
return null;
} catch (NullPointerException e) {
// 空指针异常：打印堆栈，返回null
e.printStackTrace();
return null;
}
@ -445,48 +381,40 @@ public class BackupUtils {
}
/**
* 在SD卡上生成导出用的文本文件
* 文件名规则：带当前日期（如notes_20251223.txt），目录为预设的便签备份目录
* @param context 应用上下文：读取目录路径、文件名格式资源
* @param filePathResId 目录路径资源ID：如R.string.file_path（/MiNotes/）
* @param fileNameFormatResId 文件名格式资源ID：如R.string.file_name_txt_format（notes_%s.txt）
* @return 生成的File对象（成功）/null（失败）
* 生成存储导入数据的文本文件
*
* @param context 上下文对象
* @param filePathResId 文件路径资源ID
* @param fileNameFormatResId 文件名格式资源ID
* @return 生成的文件
*/
private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
StringBuilder sb = new StringBuilder();
// 1. 拼接SD卡根目录 + 预设目录路径（如/sdcard/MiNotes/）
sb.append(Environment.getExternalStorageDirectory());
sb.append(context.getString(filePathResId));
File filedir = new File(sb.toString());
// 2. 拼接完整文件路径：目录 + 带日期的文件名（如/sdcard/MiNotes/notes_20251223.txt）
sb.append(context.getString(
fileNameFormatResId,
// 格式化文件名中的日期部分（年-月-日）
DateFormat.format(context.getString(R.string.format_date_ymd),
System.currentTimeMillis())));
File file = new File(sb.toString());
try {
// 3. 创建目录（不存在时）
if (!filedir.exists()) {
filedir.mkdir();
}
// 4. 创建文件（不存在时）
if (!file.exists()) {
file.createNewFile();
}
// 5. 返回创建成功的文件对象
return file;
} catch (SecurityException e) {
// 权限异常（如无SD卡写入权限）：打印堆栈，返回null
e.printStackTrace();
} catch (IOException e) {
// IO异常（如创建文件失败）：打印堆栈，返回null
e.printStackTrace();
}
// 创建失败，返回null
return null;
}
}
}

105
src/Notes-master/src/net/micode/notes/tool/CategoryUtil.java
Unescape View File

@ -0,0 +1,105 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* 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.
*/
package net.micode.notes.tool;
import android.text.TextUtils;
import java.util.HashMap;
import java.util.Map;
import java.util.regex.Pattern;
/**
* 便签自动分类工具类
* <p>
* 该类用于根据便签内容自动为便签分配分类，基于关键词匹配的方式实现。
* 支持多种分类类型，包括工作、学习、生活、想法、待办等，方便用户对便签进行管理和查找。
* <p>
* [2025 智能分类特性]: 该类是AI智能分类功能的基础，通过关键词匹配为便签提供初步分类，
* 后续可结合AI模型进行更精准的分类。
*/
public class CategoryUtil {
// 分类关键词映射表，存储关键词与对应分类的映射关系
private static final Map<String, String> CATEGORY_KEYWORDS = new HashMap<>();
// 静态初始化块，初始化分类关键词
static {
// 工作相关关键词
addKeywords("工作", "工作", "任务", "项目", "会议", "报告", "加班", "上班", "下班", "同事", "领导", "客户", "公司");
// 学习相关关键词
addKeywords("学习", "学习", "考试", "作业", "复习", "预习", "课程", "老师", "学生", "学校", "教材", "笔记", "知识点");
// 生活相关关键词
addKeywords("生活", "生活", "日常", "购物", "吃饭", "旅游", "电影", "音乐", "健身", "运动", "休息", "睡觉", "起床");
// 想法相关关键词
addKeywords("想法", "想法", "创意", "灵感", "思考", "感悟", "心得", "体会", "观点", "意见", "建议");
// 待办相关关键词
addKeywords("待办", "待办", "todo", "需要", "必须", "应该", "计划", "安排", "准备");
// 其他默认分类
addKeywords("其他", "");
}
/**
* 批量添加关键词到分类映射表
*
* @param category 分类名称
* @param keywords 关键词数组
*/
private static void addKeywords(String category, String... keywords) {
for (String keyword : keywords) {
CATEGORY_KEYWORDS.put(keyword, category);
}
}
/**
* 根据便签内容自动分类
* <p>
* 通过匹配便签内容中的关键词，为便签分配对应的分类
*
* @param content 便签内容
* @return 分类结果，不超过3个字符
*/
public static String autoCategorize(String content) {
if (TextUtils.isEmpty(content)) {
return "其他";
}
// 转为小写进行匹配，提高匹配成功率
String lowerContent = content.toLowerCase();
// 遍历关键词，匹配分类
for (Map.Entry<String, String> entry : CATEGORY_KEYWORDS.entrySet()) {
String keyword = entry.getKey();
String category = entry.getValue();
// 跳过空关键词（默认分类）
if (TextUtils.isEmpty(keyword)) {
continue;
}
// 关键词匹配
if (lowerContent.contains(keyword.toLowerCase())) {
return category;
}
}
// 默认分类
return "其他";
}
}

283
src/Notes-master/src/net/micode/notes/tool/DataUtils.java
Unescape View File

@ -5,7 +5,7 @@
* 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
* 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,
@ -34,18 +34,25 @@ import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
import java.util.ArrayList;
import java.util.HashSet;
/**
* 数据库操作工具类
* 提供笔记的增删改查、批量操作、数据校验等功能
* 数据操作工具类
* <p>
* 该类提供了一系列静态方法，用于执行便签数据的批量操作，包括批量删除、批量移动、文件夹管理、
* 数据查询等功能。它是连接UI层与数据层的桥梁，通过ContentResolver操作ContentProvider，
* 实现对便签数据的增删改查。
*/
public class DataUtils {
public static final String TAG = "DataUtils";
/**
* 批量删除笔记
* @param resolver ContentResolver用于数据库操作
* @param ids 待删除的笔记ID集合
* @return true删除成功，false删除失败
* 批量删除便签
* <p>
* 通过ContentProvider的批量操作接口，一次性删除多个便签
*
* @param resolver ContentResolver对象，用于操作ContentProvider
* @param ids 需要删除的便签ID集合
* @return 是否删除成功
*/
public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
if (ids == null) {
@ -57,23 +64,19 @@ public class DataUtils {
return true;
}
// 批量操作列表，用于执行事务性删除
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
for (long id : ids) {
// 保护系统根文件夹不被删除
if(id == Notes.ID_ROOT_FOLDER) {
Log.e(TAG, "Don't delete system folder root");
continue;
}
// 构建删除操作，根据URI删除指定ID的笔记
ContentProviderOperation.Builder builder = ContentProviderOperation
.newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
operationList.add(builder.build());
}
try {
// 批量执行删除操作
// DB操作：批量删除便签
ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
// 检查结果是否有效
if (results == null || results.length == 0 || results[0] == null) {
Log.d(TAG, "delete notes failed, ids:" + ids.toString());
return false;
@ -88,47 +91,65 @@ public class DataUtils {
}
/**
* 移动单条笔记到目标文件夹
* @param resolver ContentResolver用于数据库操作
* @param id 笔记ID
* @param srcFolderId 源文件夹ID（记录原始位置）
* 将单个便签移动到指定文件夹
*
* @param resolver ContentResolver对象
* @param id 便签ID
* @param srcFolderId 源文件夹ID
* @param desFolderId 目标文件夹ID
*/
public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
ContentValues values = new ContentValues();
values.put(NoteColumns.PARENT_ID, desFolderId); // 设置新的父文件夹
values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId); // 记录原始父文件夹
values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记为本地已修改
values.put(NoteColumns.PARENT_ID, desFolderId);
values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId);
values.put(NoteColumns.LOCAL_MODIFIED, 1);
// DB操作：更新便签的文件夹信息
resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
}
/**
* 批量移动笔记到指定文件夹
* @param resolver ContentResolver用于数据库操作
* @param ids 待移动的笔记ID集合
* 批量移动便签到指定文件夹
* <p>
* 支持将多个便签一次性移动到指定文件夹，包括回收站
*
* @param resolver ContentResolver对象
* @param ids 需要移动的便签ID集合
* @param folderId 目标文件夹ID
* @return true成功，false失败
* @return 是否移动成功
*/
public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
long folderId) {
long folderId) {
if (ids == null) {
Log.d(TAG, "the ids is null");
return true;
}
// 批量操作列表，用于执行事务性更新
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
for (long id : ids) {
// 构建更新操作，修改笔记的父文件夹
ContentProviderOperation.Builder builder = ContentProviderOperation
.newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
builder.withValue(NoteColumns.PARENT_ID, folderId); // 设置新的父文件夹
builder.withValue(NoteColumns.LOCAL_MODIFIED, 1); // 标记为本地已修改
// 如果是移动到回收站，保存原始父文件夹ID
if (folderId == Notes.ID_TRASH_FOLER) {
// 查询当前父文件夹ID
Cursor cursor = resolver.query(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id),
new String[]{NoteColumns.PARENT_ID},
null, null, null);
if (cursor != null && cursor.moveToFirst()) {
long originParentId = cursor.getLong(0);
builder.withValue(NoteColumns.ORIGIN_PARENT_ID, originParentId);
cursor.close();
}
}
builder.withValue(NoteColumns.PARENT_ID, folderId);
builder.withValue(NoteColumns.LOCAL_MODIFIED, 1);
operationList.add(builder.build());
}
try {
// 批量执行移动操作
// DB操作：批量更新便签的文件夹信息
ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
if (results == null || results.length == 0 || results[0] == null) {
Log.d(TAG, "delete notes failed, ids:" + ids.toString());
@ -144,12 +165,13 @@ public class DataUtils {
}
/**
* 获取用户创建的文件夹数量（排除系统文件夹和回收站）
* @param resolver ContentResolver用于数据库操作
* @return 文件夹数量
* 获取用户创建的文件夹数量（排除系统文件夹）
*
* @param resolver ContentResolver对象
* @return 用户文件夹数量
*/
public static int getUserFolderCount(ContentResolver resolver) {
// 查询类型为文件夹且父ID不是回收站的记录数
// DB操作：查询用户文件夹数量
Cursor cursor =resolver.query(Notes.CONTENT_NOTE_URI,
new String[] { "COUNT(*)" },
NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?",
@ -160,11 +182,11 @@ public class DataUtils {
if(cursor != null) {
if(cursor.moveToFirst()) {
try {
count = cursor.getInt(0); // 获取第一列的计数结果
count = cursor.getInt(0);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "get folder count failed:" + e.toString());
} finally {
cursor.close(); // 确保游标被关闭
cursor.close();
}
}
}
@ -172,14 +194,15 @@ public class DataUtils {
}
/**
* 检查笔记是否在可见数据库中（不在回收站）
* @param resolver ContentResolver用于数据库操作
* @param noteId 笔记ID
* @param type 笔记类型
* @return true存在且可见，false不存在或已被删除到回收站
* 检查便签是否在数据库中可见（未被删除到回收站）
*
* @param resolver ContentResolver对象
* @param noteId 便签ID
* @param type 便签类型
* @return 是否可见
*/
public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
// 查询指定ID和类型的笔记，且父ID不是回收站
// DB操作：查询便签是否存在且未被删除到回收站
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
null,
NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
@ -188,7 +211,7 @@ public class DataUtils {
boolean exist = false;
if (cursor != null) {
if (cursor.getCount() > 0) { // 检查是否有匹配的记录
if (cursor.getCount() > 0) {
exist = true;
}
cursor.close();
@ -197,19 +220,20 @@ public class DataUtils {
}
/**
* 检查笔记是否存在（包括回收站中的）
* @param resolver ContentResolver用于数据库操作
* @param noteId 笔记ID
* @return true存在，false不存在
* 检查便签是否存在于数据库中
*
* @param resolver ContentResolver对象
* @param noteId 便签ID
* @return 是否存在
*/
public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
// 查询指定ID的笔记，不做其他条件限制
// DB操作：查询便签是否存在
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
null, null, null, null);
boolean exist = false;
if (cursor != null) {
if (cursor.getCount() > 0) { // 检查是否有匹配的记录
if (cursor.getCount() > 0) {
exist = true;
}
cursor.close();
@ -218,19 +242,20 @@ public class DataUtils {
}
/**
* 检查数据记录是否存在
* @param resolver ContentResolver用于数据库操作
* 检查数据是否存在于数据库中
*
* @param resolver ContentResolver对象
* @param dataId 数据ID
* @return true存在，false不存在
* @return 是否存在
*/
public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
// 查询指定ID的数据记录
// DB操作：查询数据是否存在
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
null, null, null, null);
boolean exist = false;
if (cursor != null) {
if (cursor.getCount() > 0) { // 检查是否有匹配的记录
if (cursor.getCount() > 0) {
exist = true;
}
cursor.close();
@ -239,21 +264,22 @@ public class DataUtils {
}
/**
* 检查可见文件夹名称是否已存在（用于重命名或新建时的冲突检测）
* @param resolver ContentResolver用于数据库操作
* 检查可见文件夹名称是否已存在
*
* @param resolver ContentResolver对象
* @param name 文件夹名称
* @return true已存在，false不存在
* @return 是否存在
*/
public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
// 查询类型为文件夹、不在回收站中且名称匹配的记录
// DB操作：查询文件夹名称是否已存在
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null,
NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER +
" AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
" AND " + NoteColumns.SNIPPET + "=?",
" AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
" AND " + NoteColumns.SNIPPET + "=?",
new String[] { name }, null);
boolean exist = false;
if(cursor != null) {
if(cursor.getCount() > 0) { // 检查是否有同名文件夹
if(cursor.getCount() > 0) {
exist = true;
}
cursor.close();
@ -262,13 +288,14 @@ public class DataUtils {
}
/**
* 获取文件夹中所有笔记的桌面小部件信息
* @param resolver ContentResolver用于数据库操作
* 获取文件夹中包含的小部件属性
*
* @param resolver ContentResolver对象
* @param folderId 文件夹ID
* @return 小部件属性集合
*/
public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
// 查询文件夹下所有笔记的小部件ID和类型
// DB操作：查询文件夹中的小部件信息
Cursor c = resolver.query(Notes.CONTENT_NOTE_URI,
new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE },
NoteColumns.PARENT_ID + "=?",
@ -281,10 +308,9 @@ public class DataUtils {
set = new HashSet<AppWidgetAttribute>();
do {
try {
// 封装小部件属性对象
AppWidgetAttribute widget = new AppWidgetAttribute();
widget.widgetId = c.getInt(0); // 小部件ID
widget.widgetType = c.getInt(1); // 小部件类型
widget.widgetId = c.getInt(0);
widget.widgetType = c.getInt(1);
set.add(widget);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, e.toString());
@ -297,13 +323,14 @@ public class DataUtils {
}
/**
* 通过笔记ID获取通话号码（针对通话记录类型笔记）
* @param resolver ContentResolver用于数据库操作
* @param noteId 笔记ID
* @return 通话号码，失败返回空字符串
* 根据便签ID获取通话记录的电话号码
*
* @param resolver ContentResolver对象
* @param noteId 便签ID
* @return 电话号码
*/
public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
// 查询指定笔记的通话号码，限定MIME类型为通话记录
// DB操作：查询通话记录的电话号码
Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
new String [] { CallNote.PHONE_NUMBER },
CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?",
@ -312,36 +339,37 @@ public class DataUtils {
if (cursor != null && cursor.moveToFirst()) {
try {
return cursor.getString(0); // 获取通话号码
return cursor.getString(0);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get call number fails " + e.toString());
} finally {
cursor.close(); // 确保游标被关闭
cursor.close();
}
}
return "";
}
/**
* 通过通话号码和日期查找对应的笔记ID
* @param resolver ContentResolver用于数据库操作
* @param phoneNumber 通话号码
* @param callDate 通话日期时间戳
* @return 笔记ID，未找到返回0
* 根据电话号码和通话日期获取通话记录的便签ID
*
* @param resolver ContentResolver对象
* @param phoneNumber 电话号码
* @param callDate 通话日期
* @return 便签ID
*/
public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
// 使用自定义的PHONE_NUMBERS_EQUAL函数比较号码，确保同一联系人的不同格式号码能匹配
// DB操作：查询通话记录的便签ID
Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
new String [] { CallNote.NOTE_ID },
CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL("
+ CallNote.PHONE_NUMBER + ",?)",
+ CallNote.PHONE_NUMBER + ",?)",
new String [] { String.valueOf(callDate), CallNote.CONTENT_ITEM_TYPE, phoneNumber },
null);
if (cursor != null) {
if (cursor.moveToFirst()) {
try {
return cursor.getLong(0); // 获取笔记ID
return cursor.getLong(0);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get call note id fails " + e.toString());
}
@ -352,14 +380,14 @@ public class DataUtils {
}
/**
* 通过笔记ID获取摘要内容
* @param resolver ContentResolver用于数据库操作
* @param noteId 笔记ID
* @return 摘要内容
* @throws IllegalArgumentException 笔记不存在时抛出异常
* 根据便签ID获取便签摘要
*
* @param resolver ContentResolver对象
* @param noteId 便签ID
* @return 便签摘要
*/
public static String getSnippetById(ContentResolver resolver, long noteId) {
// 查询指定ID笔记的摘要字段
// DB操作：查询便签摘要
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
new String [] { NoteColumns.SNIPPET },
NoteColumns.ID + "=?",
@ -369,27 +397,94 @@ public class DataUtils {
if (cursor != null) {
String snippet = "";
if (cursor.moveToFirst()) {
snippet = cursor.getString(0); // 获取摘要内容
snippet = cursor.getString(0);
}
cursor.close();
return snippet;
}
throw new IllegalArgumentException("Note is not found with id: " + noteId);
// 如果找不到noteId，返回空字符串，而不是抛出异常
return "";
}
/**
* 格式化笔记摘要（取第一行非空内容并去除首尾空格）
* 格式化便签摘要
* <p>
* 去除首尾空格，并截取第一行作为摘要
*
* @param snippet 原始摘要
* @return 格式化后的摘要
*/
public static String getFormattedSnippet(String snippet) {
if (snippet != null) {
snippet = snippet.trim(); // 去除首尾空格
snippet = snippet.trim();
int index = snippet.indexOf('\n');
if (index != -1) {
snippet = snippet.substring(0, index); // 只保留第一行
snippet = snippet.substring(0, index);
}
}
return snippet;
}
}
/**
* 根据文件夹名称获取文件夹ID
*
* @param resolver ContentResolver
* @param folderName 文件夹名称
* @return 文件夹ID，若不存在则返回0
*/
public static long getFolderIdByName(ContentResolver resolver, String folderName) {
// DB操作：根据文件夹名称查询文件夹ID
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
new String[] { NoteColumns.ID },
NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "=? AND " + NoteColumns.SNIPPET + "=?",
new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_ROOT_FOLDER), folderName },
null);
long folderId = 0;
if (cursor != null) {
if (cursor.moveToFirst()) {
try {
folderId = cursor.getLong(0);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get folder id failed: " + e.toString());
}
}
cursor.close();
}
return folderId;
}
/**
* 创建新文件夹
* <p>
* 如果文件夹已存在，则返回已存在的文件夹ID
*
* @param resolver ContentResolver
* @param folderName 文件夹名称
* @return 新创建的文件夹ID，若创建失败则返回0
*/
public static long createFolder(ContentResolver resolver, String folderName) {
// 检查文件夹是否已存在
long existingFolderId = getFolderIdByName(resolver, folderName);
if (existingFolderId > 0) {
return existingFolderId;
}
// 创建新文件夹
ContentValues values = new ContentValues();
values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
values.put(NoteColumns.PARENT_ID, Notes.ID_ROOT_FOLDER);
values.put(NoteColumns.SNIPPET, folderName);
values.put(NoteColumns.NOTES_COUNT, 0);
// DB操作：插入新文件夹
android.net.Uri uri = resolver.insert(Notes.CONTENT_NOTE_URI, values);
if (uri != null) {
return ContentUris.parseId(uri);
}
Log.e(TAG, "Create folder failed: " + folderName);
return 0;
}
}

170
src/Notes-master/src/net/micode/notes/tool/GTaskStringUtils.java
Unescape View File

@ -14,159 +14,123 @@
* limitations under the License.
*/
// 包声明：归属小米便签的工具模块，定义Google Tasks（GTask）同步相关的核心字符串常量
package net.micode.notes.tool;
/**
* Google Tasks（GTask）同步字符串常量类
* 核心职责：
* 1. 统一定义便签与GTask同步过程中JSON交互的所有字段名，避免硬编码；
* 2. 定义GTask侧的文件夹命名规则（区分MIUI便签专属文件夹、系统默认文件夹）；
* 3. 定义同步元数据的标识字段（用于存储GTask与便签的映射关系）；
* 设计目的：提升代码可维护性，便于统一修改GTask同步的字段/命名规则。
* GTask 字符串工具类
* <p>
* 该类定义了与 GTask 相关的 JSON 字段常量，用于 GTask 功能的实现。
* </p>
*/
public class GTaskStringUtils {
// ======================== GTask同步JSON交互 - 动作相关字段 ========================
/** JSON字段：动作ID（标识单次同步操作的唯一ID） */
/**
* GTask JSON 字段常量定义
*/
// 动作相关字段
public final static String GTASK_JSON_ACTION_ID = "action_id";
/** JSON字段：动作列表（批量同步时存储多个动作的数组） */
public final static String GTASK_JSON_ACTION_LIST = "action_list";
/** JSON字段：动作类型（标识当前同步动作的类型，如创建/查询/移动/更新） */
public final static String GTASK_JSON_ACTION_TYPE = "action_type";
/** JSON字段：动作类型-创建（同步时向GTask创建新任务/文件夹） */
public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create";
/** JSON字段：动作类型-全量查询（从GTask拉取所有任务/文件夹数据） */
public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all";
/** JSON字段：动作类型-移动（将GTask任务/文件夹移动到指定目录） */
public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move";
/** JSON字段：动作类型-更新（更新GTask中已存在的任务/文件夹信息） */
public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update";
// ======================== GTask同步JSON交互 - 实体/用户相关字段 ========================
/** JSON字段：创建者ID（标识GTask实体的创建者账号ID） */
// 创建者相关字段
public final static String GTASK_JSON_CREATOR_ID = "creator_id";
/** JSON字段：子实体（存储GTask文件夹下的子任务/子文件夹） */
// 子实体相关字段
public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";
/** JSON字段：客户端版本（标识便签客户端的版本号，用于GTask服务端兼容） */
// 客户端版本字段
public final static String GTASK_JSON_CLIENT_VERSION = "client_version";
/** JSON字段：完成状态（标识GTask任务是否已完成，布尔值） */
// 完成状态字段
public final static String GTASK_JSON_COMPLETED = "completed";
/** JSON字段：当前列表ID（标识任务/文件夹所属的GTask列表ID） */
// 列表相关字段
public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id";
/** JSON字段：默认列表ID（GTask默认任务列表的ID） */
public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id";
/** JSON字段：删除标记（标识GTask实体是否已被删除，布尔值） */
// 删除相关字段
public final static String GTASK_JSON_DELETED = "deleted";
/** JSON字段：目标列表（移动操作时的目标列表ID） */
// 移动相关字段
public final static String GTASK_JSON_DEST_LIST = "dest_list";
/** JSON字段：目标父节点（移动操作时的目标父实体ID） */
public final static String GTASK_JSON_DEST_PARENT = "dest_parent";
/** JSON字段：目标父节点类型（移动操作时目标父实体的类型：GROUP/TASK） */
public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type";
/** JSON字段：实体增量（同步时仅传输实体的变更部分，减少数据传输） */
// 实体相关字段
public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta";
/** JSON字段：实体类型（标识GTask实体的类型：任务/文件夹） */
public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";
/** JSON字段：获取已删除项（同步时是否拉取GTask中已删除的实体） */
// 获取删除相关字段
public final static String GTASK_JSON_GET_DELETED = "get_deleted";
/** JSON字段：实体ID（GTask任务/文件夹的唯一标识ID） */
// ID 相关字段
public final static String GTASK_JSON_ID = "id";
/** JSON字段：索引（GTask实体在父节点中的排序索引） */
public final static String GTASK_JSON_INDEX = "index";
/** JSON字段：最后修改时间（GTask实体的最后修改时间戳） */
// 修改时间相关字段
public final static String GTASK_JSON_LAST_MODIFIED = "last_modified";
/** JSON字段：最新同步点（标识上次同步的位置，用于增量同步） */
// 同步相关字段
public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point";
/** JSON字段：列表ID（GTask列表的唯一标识ID） */
// 列表相关字段
public final static String GTASK_JSON_LIST_ID = "list_id";
/** JSON字段：列表数组（存储GTask所有列表的数组） */
public final static String GTASK_JSON_LISTS = "lists";
/** JSON字段：名称（GTask任务/文件夹的名称） */
// 名称相关字段
public final static String GTASK_JSON_NAME = "name";
/** JSON字段：新ID（创建/移动操作后生成的新实体ID） */
// 新 ID 字段
public final static String GTASK_JSON_NEW_ID = "new_id";
/** JSON字段：备注（GTask任务的备注内容，对应便签的正文） */
// 便签相关字段
public final static String GTASK_JSON_NOTES = "notes";
/** JSON字段：父节点ID（GTask实体的父文件夹/父任务ID） */
// 父级相关字段
public final static String GTASK_JSON_PARENT_ID = "parent_id";
/** JSON字段：前序兄弟ID（标识实体在父节点中的前一个兄弟实体ID，用于排序） */
// 排序相关字段
public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id";
/** JSON字段：同步结果（GTask服务端返回的同步操作结果） */
// 结果相关字段
public final static String GTASK_JSON_RESULTS = "results";
/** JSON字段：源列表（移动操作时的源列表ID） */
// 源列表字段
public final static String GTASK_JSON_SOURCE_LIST = "source_list";
/** JSON字段：任务数组（存储GTask所有任务的数组） */
// 任务相关字段
public final static String GTASK_JSON_TASKS = "tasks";
/** JSON字段：类型（兼容字段，同entity_type） */
// 类型相关字段
public final static String GTASK_JSON_TYPE = "type";
/** JSON字段：类型-分组（GTask文件夹的类型标识） */
public final static String GTASK_JSON_TYPE_GROUP = "GROUP";
/** JSON字段：类型-任务（GTask普通任务的类型标识） */
public final static String GTASK_JSON_TYPE_TASK = "TASK";
/** JSON字段：用户（标识GTask所属的用户账号信息） */
// 用户相关字段
public final static String GTASK_JSON_USER = "user";
// ======================== GTask侧文件夹命名规则 ========================
/** MIUI便签专属文件夹前缀（区分GTask中其他文件夹，避免命名冲突） */
// MIUI 文件夹前缀
public final static String MIUI_FOLDER_PREFFIX = "[MIUI_Notes]";
/** GTask侧默认文件夹名称（对应便签的根目录） */
// 默认文件夹
public final static String FOLDER_DEFAULT = "Default";
/** GTask侧通话记录文件夹名称（对应便签的通话记录文件夹） */
// 通话便签文件夹
public final static String FOLDER_CALL_NOTE = "Call_Note";
/** GTask侧元数据文件夹名称（存储便签与GTask的同步映射元数据） */
// 元数据文件夹
public final static String FOLDER_META = "METADATA";
// ======================== 同步元数据标识字段 ========================
/** 元数据头-GTask ID（存储便签对应的GTask实体ID） */
// 元数据头信息
public final static String META_HEAD_GTASK_ID = "meta_gid";
/** 元数据头-便签（存储便签核心信息的元数据标识） */
public final static String META_HEAD_NOTE = "meta_note";
/** 元数据头-数据（存储便签扩展数据的元数据标识） */
public final static String META_HEAD_DATA = "meta_data";
/** 元数据便签名称（GTask中元数据便签的固定名称，禁止修改/删除） */
// 元数据便签名称
public final static String META_NOTE_NAME = "[META INFO] DON'T UPDATE AND DELETE";
}
}

126
src/Notes-master/src/net/micode/notes/tool/ResourceParser.java
Unescape View File

@ -5,7 +5,7 @@
* 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
* 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,
@ -24,36 +24,44 @@ import net.micode.notes.ui.NotesPreferenceActivity;
/**
* 资源解析工具类
* 负责管理笔记背景、字体大小、桌面小部件等资源的ID映射
* 提供常量定义和静态方法获取各类资源
* <p>
* 该类定义了便签的背景颜色、字体大小等常量，并提供了获取各种资源的方法。
* 它包含多个内部类，分别管理便签编辑界面、列表界面、小部件和文本外观的资源。
*/
public class ResourceParser {
// 背景颜色常量定义
/**
* 背景颜色常量定义
*/
public static final int YELLOW = 0;
public static final int BLUE = 1;
public static final int WHITE = 2;
public static final int GREEN = 3;
public static final int RED = 4;
// 默认背景颜色
/**
* 默认背景颜色
*/
public static final int BG_DEFAULT_COLOR = YELLOW;
// 字体大小常量定义
/**
* 字体大小常量定义
*/
public static final int TEXT_SMALL = 0;
public static final int TEXT_MEDIUM = 1;
public static final int TEXT_LARGE = 2;
public static final int TEXT_SUPER = 3;
// 默认字体大小
/**
* 默认字体大小
*/
public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;
/**
* 笔记编辑界面背景资源类
* 管理编辑页面不同颜色主题的背景图片
* 便签编辑界面背景资源管理类
*/
public static class NoteBgResources {
// 编辑界面背景资源数组，索引对应颜色常量
// 编辑界面背景资源数组
private final static int [] BG_EDIT_RESOURCES = new int [] {
R.drawable.edit_yellow,
R.drawable.edit_blue,
@ -62,7 +70,7 @@ public class ResourceParser {
R.drawable.edit_red
};
// 编辑界面标题栏背景资源数组
// 编辑界面标题背景资源数组
private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
R.drawable.edit_title_yellow,
R.drawable.edit_title_blue,
@ -72,8 +80,9 @@ public class ResourceParser {
};
/**
* 获取笔记编辑界面背景资源ID
* @param id 颜色常量索引
* 获取便签编辑界面背景资源
*
* @param id 背景颜色ID
* @return 背景资源ID
*/
public static int getNoteBgResource(int id) {
@ -81,9 +90,10 @@ public class ResourceParser {
}
/**
* 获取笔记标题栏背景资源ID
* @param id 颜色常量索引
* @return 标题栏背景资源ID
* 获取便签编辑界面标题背景资源
*
* @param id 背景颜色ID
* @return 标题背景资源ID
*/
public static int getNoteTitleBgResource(int id) {
return BG_EDIT_TITLE_RESOURCES[id];
@ -92,28 +102,26 @@ public class ResourceParser {
/**
* 获取默认背景颜色ID
* 根据用户设置决定是随机颜色还是固定黄色
* @param context 应用上下文
* @return 背景颜色常量索引
* <p>
* 根据用户偏好设置，返回默认的背景颜色ID
*
* @param context 上下文对象
* @return 背景颜色ID
*/
public static int getDefaultBgId(Context context) {
// 检查用户是否启用了随机背景色设置
if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
// 生成随机颜色索引
return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
} else {
// 返回默认黄色
return BG_DEFAULT_COLOR;
}
}
/**
* 笔记列表项背景资源类
* 管理列表中不同位置（首项、中间项、末项、单项）的背景图片
* 便签列表项背景资源管理类
*/
public static class NoteItemBgResources {
// 列表首项背景资源数组
// 列表项第一项背景资源数组
private final static int [] BG_FIRST_RESOURCES = new int [] {
R.drawable.list_yellow_up,
R.drawable.list_blue_up,
@ -122,7 +130,7 @@ public class ResourceParser {
R.drawable.list_red_up
};
// 列表中间项背景资源数组
// 列表项中间项背景资源数组
private final static int [] BG_NORMAL_RESOURCES = new int [] {
R.drawable.list_yellow_middle,
R.drawable.list_blue_middle,
@ -131,7 +139,7 @@ public class ResourceParser {
R.drawable.list_red_middle
};
// 列表末项背景资源数组
// 列表项最后一项背景资源数组
private final static int [] BG_LAST_RESOURCES = new int [] {
R.drawable.list_yellow_down,
R.drawable.list_blue_down,
@ -140,7 +148,7 @@ public class ResourceParser {
R.drawable.list_red_down,
};
// 列表单一项背景资源数组（只有一项时使用）
// 列表项单独一项背景资源数组
private final static int [] BG_SINGLE_RESOURCES = new int [] {
R.drawable.list_yellow_single,
R.drawable.list_blue_single,
@ -150,8 +158,9 @@ public class ResourceParser {
};
/**
* 获取列表首项背景资源ID
* @param id 颜色常量索引
* 获取列表项第一项背景资源
*
* @param id 背景颜色ID
* @return 背景资源ID
*/
public static int getNoteBgFirstRes(int id) {
@ -159,8 +168,9 @@ public class ResourceParser {
}
/**
* 获取列表末项背景资源ID
* @param id 颜色常量索引
* 获取列表项最后一项背景资源
*
* @param id 背景颜色ID
* @return 背景资源ID
*/
public static int getNoteBgLastRes(int id) {
@ -168,8 +178,9 @@ public class ResourceParser {
}
/**
* 获取列表单一项背景资源ID
* @param id 颜色常量索引
* 获取列表项单独一项背景资源
*
* @param id 背景颜色ID
* @return 背景资源ID
*/
public static int getNoteBgSingleRes(int id) {
@ -177,8 +188,9 @@ public class ResourceParser {
}
/**
* 获取列表中间项背景资源ID
* @param id 颜色常量索引
* 获取列表项中间项背景资源
*
* @param id 背景颜色ID
* @return 背景资源ID
*/
public static int getNoteBgNormalRes(int id) {
@ -186,7 +198,8 @@ public class ResourceParser {
}
/**
* 获取文件夹背景资源ID（固定资源）
* 获取文件夹背景资源
*
* @return 文件夹背景资源ID
*/
public static int getFolderBgRes() {
@ -195,8 +208,7 @@ public class ResourceParser {
}
/**
* 桌面小部件背景资源类
* 管理2x2和4x4尺寸小部件的背景图片
* 小部件背景资源管理类
*/
public static class WidgetBgResources {
// 2x2小部件背景资源数组
@ -209,8 +221,9 @@ public class ResourceParser {
};
/**
* 获取2x2小部件背景资源ID
* @param id 颜色常量索引
* 获取2x2小部件背景资源
*
* @param id 背景颜色ID
* @return 背景资源ID
*/
public static int getWidget2xBgResource(int id) {
@ -227,8 +240,9 @@ public class ResourceParser {
};
/**
* 获取4x4小部件背景资源ID
* @param id 颜色常量索引
* 获取4x4小部件背景资源
*
* @param id 背景颜色ID
* @return 背景资源ID
*/
public static int getWidget4xBgResource(int id) {
@ -237,11 +251,10 @@ public class ResourceParser {
}
/**
* 文本外观资源类
* 管理不同字体大小的样式资源
* 文本外观资源管理类
*/
public static class TextAppearanceResources {
// 字体大小样式资源数组，索引对应字体大小常量
// 文本外观资源数组
private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
R.style.TextAppearanceNormal,
R.style.TextAppearanceMedium,
@ -250,27 +263,30 @@ public class ResourceParser {
};
/**
* 获取文本外观资源ID
* @param id 字体大小常量索引
* @return 样式资源ID
* 获取文本外观资源
*
* @param id 字体大小ID
* @return 文本外观资源ID
*/
public static int getTexAppearanceResource(int id) {
/**
* HACKME: 修复将资源ID存储在SharedPreference中的bug
* 存储的ID可能大于资源数组长度，此时返回默认字体大小
* HACKME: Fix bug of store the resource id in shared preference.
* The id may larger than the length of resources, in this case,
* return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
*/
if (id >= TEXTAPPEARANCE_RESOURCES.length) {
return BG_DEFAULT_FONT_SIZE; // 越界时返回默认值
return BG_DEFAULT_FONT_SIZE;
}
return TEXTAPPEARANCE_RESOURCES[id];
}
/**
* 获取可用资源数量
* @return 字体大小选项总数
* 获取文本外观资源数量
*
* @return 资源数量
*/
public static int getResourcesSize() {
return TEXTAPPEARANCE_RESOURCES.length;
}
}
}
}

221
src/Notes-master/src/net/micode/notes/tool/UserManager.java
Unescape View File

@ -0,0 +1,221 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* 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.
*/
package net.micode.notes.tool;
import android.content.Context;
import android.content.SharedPreferences;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.util.Log;
import net.micode.notes.data.NotesDatabaseHelper;
import net.micode.notes.data.Users;
/**
* 用户管理类
* <p>
* 该类用于管理当前登录用户的信息，包括保存、获取和清除用户信息。
* 采用单例模式，通过SharedPreferences持久化存储用户信息，
* 同时提供用户密码验证功能。
*/
public class UserManager {
private static final String TAG = "UserManager";
private static final String PREF_NAME = "user_preferences";
private static final String KEY_CURRENT_USER_ID = "current_user_id";
private static final String KEY_CURRENT_USERNAME = "current_username";
private static UserManager sInstance;
private SharedPreferences mPrefs;
private Context mContext;
/**
* 构造方法
*
* @param context 上下文对象
*/
private UserManager(Context context) {
mContext = context.getApplicationContext();
mPrefs = mContext.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
}
/**
* 获取UserManager实例
* <p>
* 采用单例模式，确保整个应用中只有一个UserManager实例
*
* @param context 上下文对象
* @return UserManager实例
*/
public static synchronized UserManager getInstance(Context context) {
if (sInstance == null) {
sInstance = new UserManager(context);
}
return sInstance;
}
/**
* 保存当前登录用户的信息
* <p>
* 将用户ID和用户名保存到SharedPreferences中，持久化存储
*
* @param userId 用户ID
* @param username 用户名
*/
public void saveCurrentUser(long userId, String username) {
SharedPreferences.Editor editor = mPrefs.edit();
editor.putLong(KEY_CURRENT_USER_ID, userId);
editor.putString(KEY_CURRENT_USERNAME, username);
editor.apply();
}
/**
* 获取当前登录用户的ID
*
* @return 当前用户ID，未登录返回-1
*/
public long getCurrentUserId() {
return mPrefs.getLong(KEY_CURRENT_USER_ID, -1);
}
/**
* 获取当前登录用户的用户名
*
* @return 当前用户名，未登录返回null
*/
public String getCurrentUsername() {
return mPrefs.getString(KEY_CURRENT_USERNAME, null);
}
/**
* 清除当前用户信息，用于退出登录
*/
public void clearCurrentUser() {
SharedPreferences.Editor editor = mPrefs.edit();
editor.remove(KEY_CURRENT_USER_ID);
editor.remove(KEY_CURRENT_USERNAME);
editor.apply();
}
/**
* 检查是否已登录
*
* @return 是否已登录
*/
public boolean isLoggedIn() {
return getCurrentUserId() != -1;
}
/**
* 验证用户密码
* <p>
* 通过直接访问数据库，验证用户ID和密码是否匹配
*
* @param userId 用户ID
* @param password 输入的密码
* @return 密码是否正确
*/
public boolean validatePassword(long userId, String password) {
try {
// DB操作：验证用户密码
NotesDatabaseHelper helper = NotesDatabaseHelper.getInstance(mContext);
SQLiteDatabase db = helper.getReadableDatabase();
Cursor cursor = null;
try {
String selection = Users.UserColumns.ID + " = ? AND " + Users.UserColumns.PASSWORD + " = ?";
String[] selectionArgs = {String.valueOf(userId), password};
cursor = db.query(
NotesDatabaseHelper.TABLE.USER,
new String[]{Users.UserColumns.ID},
selection,
selectionArgs,
null,
null,
null
);
return cursor != null && cursor.moveToFirst();
} finally {
if (cursor != null) {
cursor.close();
}
}
} catch (Exception e) {
e.printStackTrace();
return false;
}
}
/**
* 设置当前用户
* <p>
* 根据用户ID查询用户名，然后保存当前用户信息
*
* @param userId 用户ID
*/
public void setCurrentUser(long userId) {
try {
// DB操作：查询用户的用户名
NotesDatabaseHelper helper = NotesDatabaseHelper.getInstance(mContext);
SQLiteDatabase db = helper.getReadableDatabase();
Cursor cursor = null;
String username = "未知用户";
try {
String selection = Users.UserColumns.ID + " = ?";
String[] selectionArgs = {String.valueOf(userId)};
cursor = db.query(
NotesDatabaseHelper.TABLE.USER,
new String[]{Users.UserColumns.USERNAME},
selection,
selectionArgs,
null,
null,
null
);
if (cursor != null && cursor.moveToFirst()) {
username = cursor.getString(0);
}
} finally {
if (cursor != null) {
cursor.close();
}
}
// 保存当前用户信息
SharedPreferences.Editor editor = mPrefs.edit();
editor.putLong(KEY_CURRENT_USER_ID, userId);
editor.putString(KEY_CURRENT_USERNAME, username);
editor.apply();
} catch (Exception e) {
Log.e(TAG, "Error in setCurrentUser: " + e.getMessage());
e.printStackTrace();
// 即使发生异常，也确保保存用户ID，避免状态不一致
try {
SharedPreferences.Editor editor = mPrefs.edit();
editor.putLong(KEY_CURRENT_USER_ID, userId);
editor.putString(KEY_CURRENT_USERNAME, "未知用户");
editor.apply();
} catch (Exception innerE) {
Log.e(TAG, "Error in emergency save: " + innerE.getMessage());
innerE.printStackTrace();
}
}
}
}

299
src/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java
Unescape View File

@ -14,260 +14,223 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，便签提醒功能的最终展示页，是提醒触发时用户感知的核心页面
package net.micode.notes.ui;
// 安卓页面核心基类，所有页面的父类，提供页面生命周期、窗口管理、组件交互等基础能力
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;
// 安卓意图核心类，用于页面跳转、数据传递，此处用于跳转便签编辑页并携带便签ID
import android.content.Intent;
// 安卓音频管理核心类，用于指定音频流类型，适配系统音量与静音规则，控制提醒铃声的播放策略
import android.media.AudioManager;
// 安卓媒体播放核心类，用于加载、播放、停止系统铃声资源，实现提醒音效的播放功能
import android.media.MediaPlayer;
// 安卓铃声管理核心类，用于获取系统默认的闹钟铃声Uri，统一访问系统铃声资源
import android.media.RingtoneManager;
// 安卓统一资源标识类，用于标记铃声资源地址、便签数据的唯一标识
import android.net.Uri;
// 安卓页面状态保存类，用于横竖屏切换等场景的页面数据恢复，本页面未使用
import android.os.Bundle;
// 安卓电源管理核心类，用于获取设备屏幕的亮灭状态，判断当前是亮屏/熄屏/锁屏状态
import android.os.PowerManager;
// 安卓系统设置核心类，用于读取系统的铃声静音模式配置，适配不同的系统音频策略
import android.provider.Settings;
// 安卓窗口管理相关类，用于配置页面窗口的显示属性，实现锁屏显示、屏幕唤醒、常亮等核心功能
import android.util.Log;
import android.view.Window;
import android.view.WindowManager;
// 小米便签资源常量类，引用字符串、布局、颜色等本地资源，统一管理资源ID
import net.micode.notes.R;
// 便签应用核心数据常量类，定义便签类型、ContentURI等全局常量，用于数据合法性校验
import net.micode.notes.data.Notes;
// 便签数据工具类，封装数据库查询相关的通用方法，提供便签摘要查询、便签存在性校验等能力
import net.micode.notes.tool.DataUtils;
// Java IO异常类，捕获媒体播放器加载铃声资源时的IO错误，保证程序健壮性
import java.io.IOException;
/**
* 便签提醒功能核心弹窗页面【提醒展示最终页、用户感知唯一页】
* 继承：Activity 安卓页面基类，具备页面生命周期与窗口管理能力
* 实现：OnClickListener + OnDismissListener 对话框交互监听器，处理按钮点击与弹窗关闭事件
* 核心定位：小米便签「提醒功能」的终点站，是整个提醒流程的最终展示载体，也是用户能直接感知到的核心页面，所有提醒逻辑最终都汇聚于此，是便签提醒功能的核心价值体现
* 核心设计意义：作为提醒触发后的唯一展示页面，承担「强提醒+友好交互+精准跳转」的核心职责，既要保证用户不会错过提醒，又要提供便捷的后续操作，兼顾提醒的强制性与使用的人性化
* 核心职责（四大核心模块，逻辑闭环完整）：
* 一、屏幕状态智能管控【优先级最高，保障提醒可见性】
* 1. 精准判断设备当前屏幕状态：亮屏/熄屏/锁屏；
* 2. 熄屏/锁屏场景：自动唤醒屏幕、保持屏幕常亮、允许锁屏时显示窗口、适配系统装饰布局，确保弹窗能穿透锁屏界面直接展示，用户无需解锁即可看到提醒，核心保障「提醒必见」；
* 3. 亮屏场景：仅展示弹窗，不修改任何屏幕状态，避免干扰用户当前操作，兼顾使用体验；
* 4. 统一隐藏原生页面标题栏，仅展示核心的提醒弹窗，页面极简无冗余。
* 二、提醒数据解析与合法性校验【数据安全，避免无效展示】
* 1. 从跳转Intent中解析出绑定的便签ID：该ID由AlarmReceiver透传而来，是当前提醒的核心标识；
* 2. 根据便签ID查询数据库，获取便签的文本摘要内容，用于弹窗展示；
* 3. 摘要内容规范化处理：超过60字符自动裁剪并添加省略号，保证弹窗展示美观、无内容溢出；
* 4. 关键合法性校验：通过工具类判断该便签是否真实存在于数据库中（用户可能已删除该便签），仅当便签有效时才展示弹窗和播放铃声，无效则直接关闭页面，无任何无效操作。
* 三、系统铃声智能播放【听觉提醒，保障提醒感知】
* 1. 自动获取系统默认的闹钟铃声Uri，统一使用系统级铃声资源，适配用户的个性化铃声设置；
* 2. 适配系统静音模式：读取系统铃声流配置，自动选择合适的音频流类型，遵循系统的音量与静音规则，不强制发声干扰用户；
* 3. 铃声播放策略：循环播放提醒铃声，直到用户点击按钮关闭弹窗，确保用户能听到提醒；
* 4. 异常兜底处理：捕获播放器初始化、资源加载的各类异常，打印日志不崩溃，保证页面稳定性；
* 5. 资源安全释放：弹窗关闭时立即停止播放并释放媒体播放器资源，杜绝内存泄漏与音频残留。
* 四、人性化交互设计【便捷操作，闭环提醒流程】
* 1. 弹窗内容极简清晰：标题为应用名称，内容为便签摘要，核心信息一目了然；
* 2. 按钮动态适配：亮屏时展示「确认」+「进入便签」双按钮，熄屏/锁屏时仅展示「确认」单按钮，贴合不同场景的用户操作习惯；
* 3. 精准交互逻辑：「确认」按钮仅关闭弹窗，「进入便签」按钮跳转至该便签的编辑页面，直接定位到对应内容，无需用户手动查找；
* 4. 弹窗关闭统一处理：无论点击按钮还是手动关闭弹窗，均触发统一的收尾逻辑，停止铃声并关闭页面，逻辑闭环无遗漏。
* 核心特性&关键技术要点：
* 1. 优先级保障：窗口标记配置为最高优先级，能穿透锁屏、熄屏界面展示，是安卓系统中「强提醒」的标准实现方式；
* 2. 资源安全：所有系统服务、媒体播放器资源均做了精准的创建与释放，无内存泄漏、无资源残留，符合安卓开发最佳实践；
* 3. 异常健壮：对数据解析、数据库查询、媒体播放等所有可能出现异常的环节均做了捕获处理，程序容错性极强，不会因单一异常导致崩溃；
* 4. 体验友好：所有逻辑均围绕「用户感知」设计，既保证提醒的强制性，又兼顾使用的人性化，无过度打扰、无无效操作；
* 5. 生命周期极简：页面的生命周期与弹窗强绑定，弹窗展示则页面存活，弹窗关闭则页面立即销毁，无后台残留，内存占用极低。
* 完整业务流程闭环（提醒功能最终链路）：
* AlarmManager触发广播 → AlarmReceiver接收广播 → 启动本页面 → 屏幕唤醒+解析便签数据 → 校验便签有效 → 播放铃声+展示弹窗 → 用户点击按钮 → 停止铃声+关闭弹窗 → 页面销毁 / 跳转便签编辑页。
* 核心业务约束：
* - 仅处理有效便签的提醒：便签已删除/类型非法时，直接关闭页面，不展示任何内容；
* - 严格遵循系统规则：铃声播放、屏幕唤醒均遵循安卓系统的安全与权限规则，无越权操作；
* - 页面无残留：弹窗关闭即页面销毁，无任何后台进程或服务残留，性能友好。
* 便签提醒活动类
* 当便签的提醒时间到达时显示提醒对话框并播放闹钟声音
* 提供用户交互界面，允许用户查看或编辑提醒的便签
*
* 架构设计：
* - 继承自Activity，实现OnClickListener和OnDismissListener接口
* - 在提醒触发时创建全屏对话框
* - 播放系统闹钟铃声
* - 提供查看和编辑便签的选项
* - 适配不同Android版本的屏幕唤醒和锁定屏幕显示机制
*
* 核心功能：
* - 显示提醒对话框，包含便签内容摘要
* - 播放闹钟声音
* - 允许用户点击查看便签详情
* - 适配锁定屏幕和黑屏状态
* - 安全处理异常情况，避免崩溃
*/
public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
// ======================== 成员变量区 ========================
/** 当前提醒绑定的便签唯一ID，核心标识，所有数据操作均基于此ID */
/**
* 提醒的便签ID
*/
private long mNoteId;
/** 便签的文本摘要内容，用于弹窗展示，做了长度限制处理 */
/**
* 便签内容摘要
*/
private String mSnippet;
/** 便签摘要预览的最大字符长度，超过该长度自动裁剪并添加省略号，保证展示美观 */
/**
* 摘要预览最大长度
*/
private static final int SNIPPET_PREW_MAX_LEN = 60;
/** 媒体播放器实例，用于加载和播放系统闹钟铃声，实现听觉提醒 */
MediaPlayer mPlayer;
/**
* 页面创建核心回调方法，页面生命周期的入口，承载所有初始化逻辑
* 本页面的所有核心功能均在该方法中完成初始化，逻辑清晰、步骤明确、无冗余处理
* @param savedInstanceState 页面状态保存对象，本页面未使用该参数
* 媒体播放器，用于播放闹钟声音
*/
MediaPlayer mPlayer;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 核心配置：隐藏原生的页面标题栏，本页面仅展示对话框，无需标题栏，极简展示
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
| WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD
| WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
| WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
| WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
| WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
// 在Android 10+中，需要确保Intent有正确的标志
// 注意：FLAG_ACTIVITY_NEW_TASK和FLAG_ACTIVITY_CLEAR_TASK是Intent的常量，不是WindowManager.LayoutParams的常量
// 这些标志已经在AlarmReceiver中通过intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)设置
// 智能判断屏幕状态：仅在熄屏时添加额外的唤醒与常亮标记，亮屏时不做修改
if (!isScreenOn()) {
win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON); // 保持屏幕常亮，直到弹窗关闭
win.addFlags(WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON); // 强制唤醒熄屏的屏幕，核心保障用户能看到提醒
win.addFlags(WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON);// 允许屏幕在亮屏状态下依然保持锁定，兼顾安全性
win.addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR); // 适配系统的装饰布局，避免弹窗内容被遮挡
}
// ========== 第二步：解析Intent数据，获取便签ID并查询摘要内容 ==========
Intent intent = getIntent();
try {
// 核心解析逻辑：从Intent的Data字段中解析出便签ID，Data字段的格式为 content://notes/note/[id]
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
// 根据便签ID查询数据库，获取便签的文本摘要
mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
// 摘要内容规范化处理：超过60字符则截取前60位，并添加省略号，保证弹窗展示效果
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) {
// 异常处理：ID解析失败（如格式错误、数据异常），打印日志并直接返回，不展示任何内容
e.printStackTrace();
// 检查Intent和数据是否存在
if (intent != null && intent.getData() != null) {
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
mSnippet = mSnippet != null && mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
: mSnippet;
} else {
Log.e("AlarmAlertActivity", "Intent or data is null");
finish();
return;
}
} catch (Exception e) {
Log.e("AlarmAlertActivity", "Error processing intent: " + e.getMessage(), e);
finish();
return;
}
// ========== 第三步：初始化媒体播放器，校验便签有效性并执行核心逻辑 ==========
mPlayer = new MediaPlayer();
// 关键校验：仅当该便签真实存在于数据库且为普通便签类型时，才展示弹窗和播放铃声
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
showActionDialog(); // 展示提醒弹窗，核心交互载体
playAlarmSound(); // 播放系统闹钟铃声，核心听觉提醒
if (mNoteId > 0 && DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
showActionDialog();
playAlarmSound();
} else {
// 便签已被删除或类型非法：直接关闭页面，无任何展示与播放，避免无效操作
finish();
}
}
/**
* 私有工具方法：判断当前设备的屏幕是否处于亮屏状态
* @return boolean true=屏幕亮屏（解锁/未解锁但亮屏） false=屏幕熄屏/锁屏
*/
private boolean isScreenOn() {
// 获取系统电源管理服务实例
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
// 返回当前屏幕的亮灭状态
return pm.isScreenOn();
// 在Android 10+中，isScreenOn()方法已被弃用，应使用isInteractive()
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.KITKAT_WATCH) {
return pm.isInteractive();
} else {
return pm.isScreenOn();
}
}
/**
* 核心功能方法：初始化并播放系统默认的闹钟铃声，实现听觉提醒
* 完整逻辑：获取系统铃声Uri → 适配系统静音模式 → 初始化播放器 → 循环播放 → 异常捕获，全链路健壮处理
*/
private void playAlarmSound() {
// 第一步：获取系统默认的闹钟铃声Uri，使用系统级铃声资源，适配用户个性化设置
Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
// 第二步：读取系统铃声静音模式配置，判断闹钟音频流是否受静音规则影响，适配系统策略
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);
// 添加空检查，避免崩溃
if (mPlayer == null) {
return;
}
// 第四步：初始化媒体播放器并启动循环播放，捕获所有可能的异常，保证程序稳定
try {
mPlayer.setDataSource(this, url); // 设置铃声资源的数据源
mPlayer.prepare(); // 同步准备播放器，加载铃声资源
mPlayer.setLooping(true); // 核心配置：循环播放铃声，直到用户手动关闭
mPlayer.start(); // 启动铃声播放，触发听觉提醒
} catch (IllegalArgumentException e) {
e.printStackTrace();
} catch (SecurityException e) {
e.printStackTrace();
} catch (IllegalStateException e) {
e.printStackTrace();
} catch (IOException e) {
Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
if (url == null) {
// 如果没有默认的闹钟铃声，使用系统默认铃声
url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_RINGTONE);
}
if (url == null) {
// 如果没有系统默认铃声，使用通知铃声
url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_NOTIFICATION);
}
if (url == null) {
// 如果都没有，直接返回
return;
}
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);
}
mPlayer.setDataSource(this, url);
mPlayer.prepare();
mPlayer.setLooping(true);
mPlayer.start();
} catch (Exception e) {
// 捕获所有异常，避免崩溃
e.printStackTrace();
// 发生异常时，释放播放器资源
if (mPlayer != null) {
try {
mPlayer.release();
mPlayer = null;
} catch (Exception ex) {
ex.printStackTrace();
}
}
}
}
/**
* 核心功能方法：创建并展示便签提醒的核心弹窗，是页面的核心展示载体
* 弹窗设计：标题为应用名，内容为便签摘要，按钮动态适配屏幕状态，绑定交互监听器，实现核心交互逻辑
*/
private void showActionDialog() {
AlertDialog.Builder dialog = new AlertDialog.Builder(this);
dialog.setTitle(R.string.app_name); // 弹窗标题：固定为应用名称，简洁明了
dialog.setMessage(mSnippet); // 弹窗核心内容：便签的文本摘要，展示提醒的核心信息
dialog.setPositiveButton(R.string.notealert_ok, this); // 确认按钮，绑定点击事件监听器
// 智能按钮适配：仅在屏幕亮屏时展示「进入便签」按钮，熄屏/锁屏时不展示，贴合操作场景
dialog.setTitle(R.string.app_name);
// 如果mSnippet为空，显示默认提示信息
if (mSnippet == null || mSnippet.isEmpty()) {
dialog.setMessage(getString(R.string.set_remind_time_message));
} else {
dialog.setMessage(mSnippet);
}
dialog.setPositiveButton(R.string.notealert_ok, this);
if (isScreenOn()) {
dialog.setNegativeButton(R.string.notealert_enter, this);
}
// 展示弹窗并绑定关闭监听器，无论何种方式关闭弹窗，均触发统一的收尾逻辑
dialog.show().setOnDismissListener(this);
}
/**
* 对话框按钮点击事件回调方法，实现弹窗的核心交互逻辑
* @param dialog 触发点击事件的对话框实例
* @param which 点击的按钮类型，区分「确认」和「进入便签」按钮
*/
public void onClick(DialogInterface dialog, int which) {
switch (which) {
case DialogInterface.BUTTON_NEGATIVE:
// 点击「进入便签」按钮：跳转至该便签的编辑页面，精准定位到对应内容
Intent intent = new Intent(this, NoteEditActivity.class);
intent.setAction(Intent.ACTION_VIEW); // 设置跳转动作：查看/编辑便签
intent.putExtra(Intent.EXTRA_UID, mNoteId); // 传递便签ID，目标页面根据ID查询并展示内容
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra(Intent.EXTRA_UID, mNoteId);
startActivity(intent);
break;
default:
// 点击「确认」按钮：无额外业务逻辑，仅关闭弹窗，收尾逻辑由OnDismissListener统一处理
break;
}
}
/**
* 对话框关闭事件回调方法，页面的统一收尾逻辑入口
* 无论通过何种方式关闭弹窗（点击按钮、手动关闭），均执行该方法，保证逻辑闭环无遗漏
* @param dialog 被关闭的对话框实例
*/
public void onDismiss(DialogInterface dialog) {
stopAlarmSound(); // 核心收尾：停止铃声播放并释放媒体资源，杜绝内存泄漏与音频残留
finish(); // 关闭当前页面，释放所有资源，页面生命周期结束
stopAlarmSound();
finish();
}
/**
* 私有工具方法：停止铃声播放并安全释放媒体播放器资源
* 核心作用：资源清理，是安卓媒体播放的强制规范，避免内存泄漏和音频通道占用
*/
private void stopAlarmSound() {
if (mPlayer != null) {
mPlayer.stop(); // 立即停止铃声播放
mPlayer.release(); // 释放播放器的所有资源，包括音频通道、内存等
mPlayer = null; // 置空引用，便于GC回收，彻底杜绝内存泄漏
try {
mPlayer.stop();
mPlayer.release();
mPlayer = null;
} catch (Exception e) {
// 捕获所有异常，避免崩溃
e.printStackTrace();
mPlayer = null;
}
}
}
}
}

125
src/Notes-master/src/net/micode/notes/ui/AlarmInitReceiver.java
Unescape View File

@ -14,129 +14,86 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，便签提醒功能的初始化核心广播接收器，负责重启恢复所有未过期提醒
package net.micode.notes.ui;
// 安卓系统闹钟服务核心类，用于注册、设置、取消定时闹钟，是便签提醒的核心调度组件
import android.app.AlarmManager;
// 安卓延迟意图核心类，封装广播/页面跳转意图，交由AlarmManager在指定时间触发，核心桥梁类
import android.app.PendingIntent;
// 安卓广播核心基类，继承此类实现广播监听与处理能力，为本类的核心父类
import android.content.BroadcastReceiver;
// 安卓ContentURI拼接工具类，用于将Uri和数据ID拼接，生成唯一标识Uri，便于数据精准匹配
import android.content.ContentUris;
// 安卓上下文核心类，提供系统服务获取、内容解析器访问、组件通信等基础能力
import android.content.Context;
// 安卓意图核心类，组件间通信的核心载体，用于封装广播意图并携带数据
import android.content.Intent;
// 安卓数据库游标核心类，用于遍历查询数据库返回的结果集，读取便签提醒数据
import android.database.Cursor;
// 便签应用核心数据常量类，定义数据库Uri、便签类型、字段名等全局常量，统一管理
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
/**
* 便签提醒初始化专属广播接收器【提醒恢复核心类】
* 继承：BroadcastReceiver 安卓系统广播接收器基类，具备监听并处理广播事件的核心能力
* 核心定位：小米便签「提醒功能」的保障类，解决「设备重启/应用进程被杀」后提醒丢失的核心问题，是便签提醒可靠性的关键支撑
* 核心设计意义：安卓系统的AlarmManager注册的闹钟，在设备重启后会全部失效，应用进程被系统回收后也可能丢失未触发的闹钟，本类就是为了解决该问题，实现提醒的持久化保障
* 核心职责：
* 1. 监听系统/应用的初始化类广播，包含「设备开机完成广播、应用启动广播、系统刷新广播」等核心触发时机；
* 2. 接收到广播后，通过ContentResolver查询便签数据库中所有符合条件的有效提醒数据；
* 3. 精准筛选：仅查询「提醒时间戳大于当前时间（未过期）」+「便签类型为普通便签TYPE_NOTE」的记录，排除文件夹/系统项/已过期提醒，无无效处理；
* 4. 遍历有效提醒数据，为每一条记录重新创建广播意图与延迟意图，通过AlarmManager完成闹钟的重新注册；
* 5. 保证所有未过期的便签提醒，在设备重启/应用重启后都能恢复如初，按时触发，无任何遗漏。
* 核心特性&关键技术要点：
* 1. 精准数据筛选：查询条件双重过滤，既保证时效性（未过期），又保证数据合法性（普通便签），避免无效数据处理，降低性能损耗；
* 2. 轻量查询设计：自定义投影数组仅查询「便签ID、提醒时间戳」两个核心字段，不查询冗余内容，减少数据库IO开销与内存占用；
* 3. 唯一标识绑定：通过ContentUris拼接便签ID到Intent的Data字段，为每个提醒生成唯一的意图标识，精准绑定提醒与对应便签，无串号风险；
* 4. 强力唤醒保障：使用AlarmManager.RTC_WAKEUP闹钟类型，基于系统绝对时间，触发时会强制唤醒休眠的设备（亮屏/唤醒CPU），确保提醒必达，不会因设备休眠漏提醒；
* 5. 资源安全释放：查询数据库后及时关闭Cursor游标，释放数据库连接与内存资源，杜绝内存泄漏风险，符合安卓开发最佳实践；
* 6. 无状态极简设计：本类无成员变量、无复杂逻辑、无内存占用，仅在广播触发时执行一次性初始化逻辑，执行完成后立即释放资源，性能友好。
* 核心业务约束：
* - 不处理已过期的提醒：提醒时间小于当前时间的记录直接过滤，无需注册，避免无效操作；
* - 不处理非普通便签：仅对TYPE_NOTE类型生效，文件夹（TYPE_FOLDER）等无提醒功能的类型直接排除；
* - 不处理无提醒的便签：仅查询ALERTED_DATE字段大于0的记录，无提醒的便签不会进入查询结果。
* 完整业务闭环：
* 便签设置提醒 → AlarmManager注册闹钟 → 设备重启/应用重启 → 本接收器接收初始化广播 → 查询数据库有效提醒 → 重新注册所有闹钟 → 提醒时间到达 → AlarmReceiver触发 → 展示提醒弹窗。
* 闹钟初始化广播接收器
* 在系统启动时自动初始化所有待处理的便签提醒闹钟
* 确保设备重启后，所有设置了提醒的便签仍然能够按时触发
*
* 架构设计：
* - 继承自BroadcastReceiver，监听系统启动完成广播
* - 通过ContentResolver查询所有设置了未来提醒时间的便签
* - 为每个符合条件的便签重新设置AlarmManager闹钟
* - 适配不同Android版本的AlarmManager API变化
*
* 核心功能：
* - 系统启动后自动初始化闹钟
* - 查询所有未触发的提醒便签
* - 为每个便签设置准确的闹钟
* - 适配Android 6.0+的setExact方法
* - 适配Android 12+的PendingIntent flag要求
*/
public class AlarmInitReceiver extends BroadcastReceiver {
/**
* 数据库查询投影数组【按需查询，性能优化】
* 设计目的：指定本次数据库查询仅需要返回的字段，不查询冗余字段，减少数据库IO传输数据量，降低内存消耗，提升查询效率
* 字段说明：仅包含两个核心必要字段，满足业务需求的最小化查询
* 查询投影列，包含便签ID和提醒日期
*/
private static final String [] PROJECTION = new String [] {
NoteColumns.ID, // 数组索引0：便签的唯一主键ID，用于绑定提醒与便签、生成唯一Intent标识
NoteColumns.ALERTED_DATE // 数组索引1：便签设置的提醒时间戳，毫秒级，用于设置闹钟的触发时间
NoteColumns.ID,
NoteColumns.ALERTED_DATE
};
// 投影数组列索引常量【硬编码优化】
// 设计目的：将数组索引封装为常量，替代代码中的硬编码数字，提升代码可读性、可维护性，避免索引写错导致的程序异常
private static final int COLUMN_ID = 0; // 对应PROJECTION[0]，便签ID列索引
private static final int COLUMN_ALERTED_DATE = 1; // 对应PROJECTION[1]，提醒时间戳列索引
/**
* 广播接收核心回调方法，广播触发时由安卓系统自动调用
* 本类的唯一核心方法，承载了「查询有效提醒+重新注册闹钟」的全部核心逻辑，逻辑清晰、步骤明确、无冗余处理
* @param context 广播接收器的运行上下文对象，不可为空，核心作用：获取ContentResolver查询数据库、获取AlarmManager系统服务、创建Intent意图
* @param intent 触发本次广播的意图对象，携带广播的触发类型信息，本类无需解析该意图内容，仅做触发执行
* 便签ID列索引
*/
private static final int COLUMN_ID = 0;
/**
* 提醒日期列索引
*/
private static final int COLUMN_ALERTED_DATE = 1;
@Override
public void onReceive(Context context, Intent intent) {
// 第一步：获取当前系统时间戳，作为筛选「未过期提醒」的核心阈值，只处理提醒时间在当前时间之后的记录
long currentDate = System.currentTimeMillis();
// 第二步：通过ContentResolver查询便签数据库，获取所有符合条件的有效提醒数据
// 核心查询参数说明：
// 1. uri：查询地址 → Notes.CONTENT_NOTE_URI 普通便签的专属Uri，精准定位查询表
// 2. projection：查询字段 → 自定义的PROJECTION数组，仅查ID和提醒时间戳
// 3. selection：查询条件 → 双重过滤：提醒时间>当前时间 且 便签类型为普通便签，精准筛选有效数据
// 4. selectionArgs：条件参数 → 传入当前时间戳的字符串形式，防止SQL注入，符合安卓安全规范
// 5. sortOrder：排序规则 → null，使用数据库默认排序，无需额外排序，提升查询效率
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 != null) {
if (c.moveToFirst()) {
do {
// 3.1 从游标中读取当前行的核心数据：便签ID、提醒触发时间戳
long alertDate = c.getLong(COLUMN_ALERTED_DATE); // 该便签的提醒触发时间，毫秒级
long noteId = c.getLong(COLUMN_ID); // 该便签的唯一主键ID
// 3.2 创建广播意图：指定意图的目标为AlarmReceiver，即提醒时间到达时，需要触发的广播接收器
long alertDate = c.getLong(COLUMN_ALERTED_DATE);
Intent sender = new Intent(context, AlarmReceiver.class);
// 核心关键：将便签ID拼接至Intent的Data字段，生成唯一的Uri标识，精准绑定该提醒与对应便签
// 作用：AlarmReceiver接收到广播时，可通过该Uri解析出便签ID，进而查询便签详情展示提醒内容，无串号风险
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId));
// 3.3 创建PendingIntent延迟意图：封装上述广播意图，交由AlarmManager管理，在指定时间触发广播
// PendingIntent.getBroadcast参数说明：上下文、请求码(此处传0即可)、待封装的广播意图、flags标记(默认0)
// 核心作用：PendingIntent是一种授权意图，允许系统在未来的指定时间，以当前应用的身份发送该广播，是闹钟触发的核心载体
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
// 3.4 获取系统AlarmManager服务实例，系统级的闹钟调度核心服务
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
// 使用适当的PendingIntent flag，确保在Android 12+中正常工作
int flags = android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.S ? PendingIntent.FLAG_IMMUTABLE : 0;
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, flags);
AlarmManager alermManager = (AlarmManager) context
.getSystemService(Context.ALARM_SERVICE);
// 3.5 核心操作：重新注册闹钟，完成提醒恢复
// alermManager.set参数说明：
// 1. type → AlarmManager.RTC_WAKEUP 最核心的闹钟类型，基于系统绝对时间，触发时唤醒设备CPU/屏幕，保证提醒必达
// 2. triggerAtTime → 闹钟触发的具体时间，即从数据库读取的提醒时间戳alertDate
// 3. operation → 待触发的PendingIntent延迟意图，触发时发送广播至AlarmReceiver
alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
} while (c.moveToNext()); // 循环遍历游标，处理所有有效提醒数据
// 在Android 6.0+中，使用setExact方法以确保准确的提醒时间
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.M) {
alermManager.setExact(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
} else {
alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
}
} while (c.moveToNext());
}
// 第四步：必须关闭游标，释放数据库资源与内存，杜绝内存泄漏，安卓数据库操作的强制规范
c.close();
}
}
}
}

63
src/Notes-master/src/net/micode/notes/ui/AlarmReceiver.java
Unescape View File

@ -14,50 +14,43 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，便签提醒功能的广播接收核心类，承接闹钟触发逻辑
package net.micode.notes.ui;
// 安卓广播核心基类，继承此类实现广播接收能力，监听系统/应用发送的广播事件
import android.content.BroadcastReceiver;
// 安卓上下文核心类，提供应用运行环境、组件启动、资源访问等基础能力
import android.content.Context;
// 安卓意图核心类，用于组件间通信、页面跳转、数据传递的核心载体
import android.content.Intent;
/**
* 便签提醒功能专属广播接收器【轻量级广播处理类】
* 继承：BroadcastReceiver 安卓系统广播接收器基类，具备监听并处理广播的核心能力
* 核心定位：小米便签「提醒功能」的核心中转类，是闹钟触发与提醒弹窗展示的唯一桥梁，无任何业务逻辑，只做事件转发
* 核心职责：
* 1. 监听由系统AlarmManager定时发送的闹钟广播，该广播在用户设置的便签提醒时间到达时触发；
* 2. 接收到广播后，无缝承接Intent中携带的便签提醒数据（便签ID、标题、内容等）；
* 3. 对Intent做标准化配置，指定跳转目标页面并补充必要的启动标记；
* 4. 启动便签提醒弹窗页面，完成提醒事件的最终展示，触发用户感知。
* 核心特性&关键注意点：
* 1. 无状态设计：该类无任何成员变量、无初始化逻辑、无复杂处理，是纯功能性的极简类，内存占用极低；
* 2. 必加启动标记：BroadcastReceiver 属于四大组件之一，运行时无独立的Activity任务栈上下文，启动Activity时必须添加 FLAG_ACTIVITY_NEW_TASK 标记，否则会抛出运行时异常，这是安卓的硬性规范；
* 3. 数据透传：广播携带的所有Intent数据会完整透传给目标页面，无任何数据丢失或修改，保证提醒内容的正确性；
* 4. 生命周期极简：广播接收器的onReceive方法执行时间被系统严格限制，本类逻辑极致轻量化，可在瞬时完成执行，无超时风险；
* 5. 唯一触发源：该接收器只响应便签应用自身注册的闹钟广播，不接收其他任何广播事件，功能单一无干扰。
* 典型业务流程闭环：
* 便签编辑页设置提醒时间 → 后台通过AlarmManager注册定时闹钟 → 提醒时间到达，系统发送广播 → 本接收器接收广播 → 启动AlarmAlertActivity → 展示便签提醒弹窗，响铃/震动提醒用户。
* 典型使用场景：唯一用途就是接收便签的提醒广播，无其他任何业务场景。
* 闹钟广播接收器
* 接收AlarmManager触发的闹钟广播，启动AlarmAlertActivity显示便签提醒
* 作为闹钟触发和提醒显示之间的桥梁
*
* 架构设计：
* - 继承自BroadcastReceiver，监听闹钟触发广播
* - 接收到广播后，创建指向AlarmAlertActivity的Intent
* - 添加FLAG_ACTIVITY_NEW_TASK标志，确保在非活动上下文下也能启动活动
* - 启动AlarmAlertActivity显示提醒界面
* - 包含异常处理，确保广播接收过程不会崩溃
*
* 核心功能：
* - 接收闹钟触发广播
* - 启动提醒显示活动
* - 确保启动过程的安全性和稳定性
*/
public class AlarmReceiver extends BroadcastReceiver {
/**
* 广播接收核心回调方法，广播触发时系统自动调用该方法
* 该方法是本类的唯一核心方法，承载了所有的广播处理逻辑，极简且高效
* @param context 广播接收器的运行上下文对象，不可为空，用于启动目标Activity组件
* @param intent 触发本次广播的意图对象，内部携带了完整的便签提醒数据，也是页面跳转的核心数据载体
*/
@Override
public void onReceive(Context context, Intent intent) {
// 第一步：为当前Intent指定跳转的目标页面，将广播意图转为页面跳转意图
intent.setClass(context, AlarmAlertActivity.class);
// 第二步：添加必选的新任务启动标记，解决广播无任务栈启动Activity的上下文问题，规避运行时异常
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
// 第三步：启动提醒弹窗页面，完成广播事件的最终转发，展示便签提醒内容
context.startActivity(intent);
// 添加空检查，避免崩溃
if (context == null || intent == null) {
return;
}
try {
intent.setClass(context, AlarmAlertActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
} catch (Exception e) {
// 捕获所有异常，避免崩溃
e.printStackTrace();
}
}
}
}

438
src/Notes-master/src/net/micode/notes/ui/ChatActivity.java
Unescape View File

@ -0,0 +1,438 @@
package net.micode.notes.ui;
import android.app.ActionBar;
import android.app.Activity;
import android.app.AlertDialog;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;
import android.text.TextUtils;
import android.graphics.Color;
import net.micode.notes.R;
import net.micode.notes.data.Messages;
import net.micode.notes.data.NotesDatabaseHelper;
import net.micode.notes.tool.UserManager;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
/**
* 聊天活动
* <p>
* 该类负责实现用户与好友之间的聊天功能，包括消息的发送、接收和显示。
* 它通过NotesDatabaseHelper操作消息数据表，实现聊天记录的存储和加载。
*/
public class ChatActivity extends Activity {
private static final String TAG = "ChatActivity";
private ListView mChatListView;
private EditText mMessageEditText;
private Button mSendButton;
private ChatAdapter mChatAdapter;
private List<ChatMessage> mMessageList;
private NotesDatabaseHelper mDbHelper;
private SQLiteDatabase mDb;
private UserManager mUserManager;
private long mCurrentUserId;
private long mFriendId;
private String mFriendUsername;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
try {
setContentView(R.layout.chat_activity);
// 设置ActionBar
ActionBar actionBar = getActionBar();
if (actionBar != null) {
actionBar.setDisplayHomeAsUpEnabled(true);
}
// 获取Intent参数
mFriendId = getIntent().getLongExtra("friend_id", -1);
mFriendUsername = getIntent().getStringExtra("friend_username");
if (mFriendId == -1 || mFriendUsername == null) {
Toast.makeText(this, "无效的好友信息", Toast.LENGTH_SHORT).show();
finish();
return;
}
// 设置ActionBar标题为好友用户名
if (actionBar != null) {
actionBar.setTitle(mFriendUsername);
}
// 初始化数据库
mDbHelper = NotesDatabaseHelper.getInstance(this);
if (mDbHelper != null) {
mDb = mDbHelper.getWritableDatabase();
}
// 初始化UserManager
mUserManager = UserManager.getInstance(this);
if (mUserManager != null) {
mCurrentUserId = mUserManager.getCurrentUserId();
}
// 初始化界面控件
mChatListView = findViewById(R.id.chat_list);
mMessageEditText = findViewById(R.id.message_edit_text);
mSendButton = findViewById(R.id.send_button);
// 初始化消息列表
mMessageList = new ArrayList<>();
mChatAdapter = new ChatAdapter(this, mMessageList, mCurrentUserId);
mChatListView.setAdapter(mChatAdapter);
// 设置发送按钮点击事件
mSendButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
sendMessage();
}
});
// 加载聊天记录
loadChatHistory();
} catch (Exception e) {
Log.e(TAG, "Error in onCreate: " + e.getMessage(), e);
Toast.makeText(this, "聊天界面初始化失败", Toast.LENGTH_SHORT).show();
finish();
}
}
@Override
protected void onResume() {
super.onResume();
try {
// 重新获取当前用户ID，确保在账号切换后能使用正确的用户ID
if (mUserManager != null) {
mCurrentUserId = mUserManager.getCurrentUserId();
Log.d(TAG, "Updated current user ID to: " + mCurrentUserId);
}
// 更新适配器的当前用户ID
if (mChatAdapter != null) {
mChatAdapter.mCurrentUserId = mCurrentUserId;
}
// 重新加载聊天记录
loadChatHistory();
} catch (Exception e) {
Log.e(TAG, "Error in onResume: " + e.getMessage(), e);
}
}
@Override
protected void onDestroy() {
super.onDestroy();
// 关闭数据库连接
if (mDb != null && mDb.isOpen()) {
mDb.close();
}
}
@Override
public boolean onOptionsItemSelected(android.view.MenuItem item) {
switch (item.getItemId()) {
case android.R.id.home:
// 返回上一级活动
finish();
return true;
default:
return super.onOptionsItemSelected(item);
}
}
/**
* 加载聊天记录
*/
private void loadChatHistory() {
mMessageList.clear();
// 查询聊天记录
String sql = "SELECT * FROM " + NotesDatabaseHelper.TABLE.MESSAGE + " WHERE " +
"(" + Messages.MessageColumns.SENDER_ID + " = ? AND " + Messages.MessageColumns.RECEIVER_ID + " = ?) OR " +
"(" + Messages.MessageColumns.SENDER_ID + " = ? AND " + Messages.MessageColumns.RECEIVER_ID + " = ?) " +
"ORDER BY " + Messages.MessageColumns.CREATED_DATE + " ASC";
Cursor cursor = mDb.rawQuery(sql, new String[]{
String.valueOf(mCurrentUserId), String.valueOf(mFriendId),
String.valueOf(mFriendId), String.valueOf(mCurrentUserId)
});
if (cursor != null) {
while (cursor.moveToNext()) {
long id = cursor.getLong(cursor.getColumnIndexOrThrow(Messages.MessageColumns.ID));
long senderId = cursor.getLong(cursor.getColumnIndexOrThrow(Messages.MessageColumns.SENDER_ID));
long receiverId = cursor.getLong(cursor.getColumnIndexOrThrow(Messages.MessageColumns.RECEIVER_ID));
String content = cursor.getString(cursor.getColumnIndexOrThrow(Messages.MessageColumns.CONTENT));
int messageType = cursor.getInt(cursor.getColumnIndexOrThrow(Messages.MessageColumns.MESSAGE_TYPE));
long createdDate = cursor.getLong(cursor.getColumnIndexOrThrow(Messages.MessageColumns.CREATED_DATE));
int isRead = cursor.getInt(cursor.getColumnIndexOrThrow(Messages.MessageColumns.IS_READ));
mMessageList.add(new ChatMessage(id, senderId, receiverId, content, messageType, createdDate, isRead));
}
cursor.close();
}
// 通知适配器数据变化
mChatAdapter.notifyDataSetChanged();
// 滚动到底部
if (!mMessageList.isEmpty()) {
mChatListView.setSelection(mMessageList.size() - 1);
}
// 将接收到的消息标记为已读
markMessagesAsRead();
}
/**
* 发送消息
*/
private void sendMessage() {
String content = mMessageEditText.getText().toString().trim();
if (content.isEmpty()) {
Toast.makeText(this, "消息内容不能为空", Toast.LENGTH_SHORT).show();
return;
}
// 创建消息对象
ContentValues values = new ContentValues();
values.put(Messages.MessageColumns.SENDER_ID, mCurrentUserId);
values.put(Messages.MessageColumns.RECEIVER_ID, mFriendId);
values.put(Messages.MessageColumns.CONTENT, content);
values.put(Messages.MessageColumns.MESSAGE_TYPE, Messages.MessageType.TEXT);
values.put(Messages.MessageColumns.CREATED_DATE, System.currentTimeMillis());
values.put(Messages.MessageColumns.IS_READ, 0);
// 插入消息到数据库
long messageId = mDb.insert(NotesDatabaseHelper.TABLE.MESSAGE, null, values);
if (messageId != -1) {
// 清空输入框
mMessageEditText.setText("");
// 重新加载聊天记录
loadChatHistory();
} else {
Toast.makeText(this, "发送失败", Toast.LENGTH_SHORT).show();
Log.e(TAG, "Failed to send message");
}
}
/**
* 将接收到的消息标记为已读
*/
private void markMessagesAsRead() {
ContentValues values = new ContentValues();
values.put(Messages.MessageColumns.IS_READ, 1);
int updatedRows = mDb.update(NotesDatabaseHelper.TABLE.MESSAGE, values,
Messages.MessageColumns.SENDER_ID + " = ? AND " + Messages.MessageColumns.RECEIVER_ID + " = ? AND " + Messages.MessageColumns.IS_READ + " = 0",
new String[]{String.valueOf(mFriendId), String.valueOf(mCurrentUserId)});
Log.d(TAG, "Marked " + updatedRows + " messages as read");
}
/**
* 显示便签详情
*/
private void showNoteDetail(String noteData) {
try {
// 解析便签数据
String[] noteParts = noteData.split("\\|");
if (noteParts.length < 2) {
Toast.makeText(this, "无效的便签数据", Toast.LENGTH_SHORT).show();
return;
}
String noteTitle = noteParts[0];
String noteContent = noteParts[1];
if (TextUtils.isEmpty(noteTitle)) {
noteTitle = "无标题便签";
}
// 创建并显示便签详情对话框
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle(noteTitle);
builder.setMessage(noteContent);
builder.setPositiveButton("确定", null);
builder.show();
} catch (Exception e) {
Log.e(TAG, "Error showing note detail: " + e.getMessage(), e);
Toast.makeText(this, "显示便签详情失败", Toast.LENGTH_SHORT).show();
}
}
/**
* 聊天消息实体类
*/
private static class ChatMessage {
long id;
long senderId;
long receiverId;
String content;
int messageType;
long createdDate;
int isRead;
ChatMessage(long id, long senderId, long receiverId, String content, int messageType, long createdDate, int isRead) {
this.id = id;
this.senderId = senderId;
this.receiverId = receiverId;
this.content = content;
this.messageType = messageType;
this.createdDate = createdDate;
this.isRead = isRead;
}
}
/**
* 聊天消息适配器
*/
private static class ChatAdapter extends BaseAdapter {
private static final int VIEW_TYPE_SENT_TEXT = 0;
private static final int VIEW_TYPE_RECEIVED_TEXT = 1;
private static final int VIEW_TYPE_SENT_NOTE = 2;
private static final int VIEW_TYPE_RECEIVED_NOTE = 3;
private Context mContext;
private List<ChatMessage> mMessageList;
public long mCurrentUserId;
private LayoutInflater mInflater;
private SimpleDateFormat mDateFormat;
ChatAdapter(Context context, List<ChatMessage> messageList, long currentUserId) {
mContext = context;
mMessageList = messageList;
mCurrentUserId = currentUserId;
mInflater = LayoutInflater.from(context);
mDateFormat = new SimpleDateFormat("HH:mm");
}
@Override
public int getCount() {
return mMessageList.size();
}
@Override
public Object getItem(int position) {
return mMessageList.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public int getViewTypeCount() {
return 4; // 四种视图类型：发送文本、接收文本、发送便签、接收便签
}
@Override
public int getItemViewType(int position) {
ChatMessage message = mMessageList.get(position);
boolean isSentByMe = message.senderId == mCurrentUserId;
if (message.messageType == Messages.MessageType.NOTE) {
return isSentByMe ? VIEW_TYPE_SENT_NOTE : VIEW_TYPE_RECEIVED_NOTE;
} else {
return isSentByMe ? VIEW_TYPE_SENT_TEXT : VIEW_TYPE_RECEIVED_TEXT;
}
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ChatMessage message = mMessageList.get(position);
boolean isSentByMe = message.senderId == mCurrentUserId;
ViewHolder holder;
if (convertView == null) {
// 根据视图类型选择不同的布局
int viewType = getItemViewType(position);
switch (viewType) {
case VIEW_TYPE_SENT_NOTE:
convertView = mInflater.inflate(R.layout.chat_message_sent_note_item, parent, false);
break;
case VIEW_TYPE_RECEIVED_NOTE:
convertView = mInflater.inflate(R.layout.chat_message_received_note_item, parent, false);
break;
case VIEW_TYPE_SENT_TEXT:
default:
convertView = mInflater.inflate(R.layout.chat_message_sent_item, parent, false);
break;
case VIEW_TYPE_RECEIVED_TEXT:
convertView = mInflater.inflate(R.layout.chat_message_received_item, parent, false);
break;
}
holder = new ViewHolder();
holder.contentTextView = convertView.findViewById(R.id.message_content);
holder.timeTextView = convertView.findViewById(R.id.message_time);
convertView.setTag(holder);
} else {
holder = (ViewHolder) convertView.getTag();
}
// 设置消息内容
if (message.messageType == Messages.MessageType.NOTE) {
// 便签类型消息，只显示便签标题
String[] noteData = message.content.split("\\|");
if (noteData.length >= 2) {
String noteTitle = noteData[0];
if (TextUtils.isEmpty(noteTitle)) {
noteTitle = "无标题便签";
}
holder.contentTextView.setText(noteTitle);
// 设置不同的颜色，区分于普通文本消息
holder.contentTextView.setTextColor(Color.BLUE); // 使用蓝色区分便签消息
holder.contentTextView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 点击便签，查看详情
((ChatActivity) mContext).showNoteDetail(message.content);
}
});
}
} else {
// 普通文本消息
holder.contentTextView.setText(message.content);
holder.contentTextView.setOnClickListener(null);
}
// 设置消息时间
Date date = new Date(message.createdDate);
holder.timeTextView.setText(mDateFormat.format(date));
return convertView;
}
private static class ViewHolder {
TextView contentTextView;
TextView timeTextView;
}
}
}

515
src/Notes-master/src/net/micode/notes/ui/DateTimePicker.java
Unescape View File

@ -14,190 +14,197 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，日期时间选择的核心自定义复合控件，供弹窗调用
package net.micode.notes.ui;
// Java文本格式化工具类，获取系统的上午/下午文本标识，适配多语言环境
import java.text.DateFormatSymbols;
// Java核心日历工具类，全局唯一的时间数据载体，处理所有年月日时分的计算、联动、转换逻辑
import java.util.Calendar;
// 小米便签资源文件引用，获取布局、字符串等资源ID常量
import net.micode.notes.R;
// 安卓系统核心类 - 上下文，提供控件创建、资源加载、布局填充的运行环境
import android.content.Context;
// 安卓系统日期格式化工具类，提供系统24小时制判断、日期文本格式化能力
import android.text.format.DateFormat;
// 安卓视图体系核心类，视图基础属性配置、可见性控制、布局容器核心父类
import android.view.View;
import android.widget.FrameLayout;
// 安卓数字滚轮选择器，本控件的核心子组件，实现年月日时分的滚轮滑动选择UI
import android.widget.NumberPicker;
/**
* 自定义日期时间复合选择控件【核心基础UI控件】
* 继承：FrameLayout 帧布局，作为复合控件的根布局容器，承载多个子选择器
* 核心定位：小米便签「提醒时间设置」功能的底层核心控件，被DateTimePickerDialog弹窗集成使用
* 核心设计理念：将「日期选择+小时选择+分钟选择+上下午选择」整合为统一控件，封装所有时间联动逻辑、格式适配逻辑、数据处理逻辑，对外提供极简的调用与通信接口
* 核心特性与职责：
* 1. 布局整合：内置日期、小时、分钟、上下午共4个NumberPicker滚轮选择器，形成一体化的时间选择UI；
* 2. 数据闭环：基于Calendar类做全局唯一的时间数据管理，所有选择操作最终同步至该对象，保证数据一致性；
* 3. 智能联动：完美处理所有时间边界联动场景，如分钟59→0时小时+1、小时23→0时日期+1、12小时制跨上下午切换等，无数据断层；
* 4. 系统适配：自动识别并适配系统的24小时制/12小时制设置，支持手动强制切换，两种制式无缝兼容，交互无感知；
* 5. 日期展示：固定展示近7天的日期列表，格式为「月.日 星期」，满足便签短周期提醒的业务需求；
* 6. 状态统一：支持控件整体启用/禁用，一键同步所有子选择器的交互状态，无需单独配置；
* 7. 标准化通信：提供时间变化的回调接口，选择操作实时触发回调，向外传递标准化的年月日时分数据；
* 8. 细节优化：分钟选择器支持长按快速滚动、上下午文本适配系统多语言、时间数值边界校验等细节体验优化；
* 9. 防抖动处理：初始化阶段屏蔽回调触发，避免初始化时的无效数据通知，提升性能与稳定性。
* 核心优势：控件内聚性极强，所有时间相关的逻辑全部封装内部，外部调用方只需关心「设置初始时间」「获取选中时间」「监听时间变化」三个核心操作，完全无需处理内部复杂逻辑。
* 典型业务场景：唯一使用场景为DateTimePickerDialog弹窗的核心内容视图，支撑便签的提醒时间选择功能。
* 日期时间选择器控件
* 提供用户界面来选择日期和时间，支持年、月、日、时、分的精确选择
* 继承自FrameLayout，内部使用多个NumberPicker组件实现
*
* 架构设计：
* - 继承自FrameLayout，作为容器包含多个NumberPicker
* - 内部使用Calendar实例管理日期时间数据
* - 提供年、月、日、时、分的选择器
* - 支持24小时制和12小时制切换
* - 实现各种值变化监听器，处理选择逻辑
* - 提供回调接口通知外部日期时间变化
*
* 核心功能：
* - 日期选择：支持选择一周内的日期
* - 时间选择：支持小时和分钟的选择
* - 24/12小时制切换：根据系统设置或手动切换
* - AM/PM切换：在12小时制下显示
* - 边界处理：自动处理日期时间的边界情况（如跨天、跨小时）
* - 实时更新：选择变化时实时更新内部日期时间
* - 回调通知：通过接口通知外部日期时间变化
* - 状态保存：保存和恢复当前选择的日期时间
*/
public class DateTimePicker extends FrameLayout {
// ======================== 基础常量区 - 控件默认配置与固定数值 ========================
/** 控件默认启用状态：初始化时默认所有选择器均可交互 */
/**
* 默认启用状态
*/
private static final boolean DEFAULT_ENABLE_STATE = true;
// ======================== 常量区 - 时间单位核心数值 ========================
/** 半天小时数：12小时制的核心分界值，上午/下午的小时数上限 */
/**
* 半天的小时数
*/
private static final int HOURS_IN_HALF_DAY = 12;
/** 全天小时数：24小时制的核心数值，一天的总小时数 */
/**
* 一天的小时数
*/
private static final int HOURS_IN_ALL_DAY = 24;
/** 一周天数：日期选择器固定展示的天数，不可修改，适配短周期提醒业务 */
/**
* 一周的天数
*/
private static final int DAYS_IN_ALL_WEEK = 7;
// ======================== 常量区 - NumberPicker滚轮选择器 取值范围约束 ========================
/** 日期选择器-最小值：固定为0，对应近7天列表的第一条数据 */
/**
* 日期选择器最小值
*/
private static final int DATE_SPINNER_MIN_VAL = 0;
/** 日期选择器-最大值：固定为6，对应近7天列表的最后一条数据，数值等于天数减1 */
/**
* 日期选择器最大值
*/
private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
/** 24小时制-小时选择器-最小值：凌晨0点，时间起点 */
/**
* 24小时制下小时选择器最小值
*/
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
/** 24小时制-小时选择器-最大值：深夜23点，时间终点 */
/**
* 24小时制下小时选择器最大值
*/
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
/** 12小时制-小时选择器-最小值：上午/下午的1点，无0点概念 */
/**
* 12小时制下小时选择器最小值
*/
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
/** 12小时制-小时选择器-最大值：上午/下午的12点，封顶数值 */
/**
* 12小时制下小时选择器最大值
*/
private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
/** 分钟选择器-最小值：整点0分，分钟起点 */
/**
* 分钟选择器最小值
*/
private static final int MINUT_SPINNER_MIN_VAL = 0;
/** 分钟选择器-最大值：整点前1分钟，59分，分钟终点 */
/**
* 分钟选择器最大值
*/
private static final int MINUT_SPINNER_MAX_VAL = 59;
/** 上下午选择器-最小值：0，对应上午/AM */
/**
* AM/PM选择器最小值
*/
private static final int AMPM_SPINNER_MIN_VAL = 0;
/** 上下午选择器-最大值：1，对应下午/PM */
/**
* AM/PM选择器最大值
*/
private static final int AMPM_SPINNER_MAX_VAL = 1;
// ======================== 成员变量区 - UI核心组件【所有子选择器，全局持用避免重复查找】 ========================
/** 日期滚轮选择器：核心展示近7天的格式化日期文本，如「01.15 周四」，支持滑动切换日期 */
/**
* 日期选择器
*/
private final NumberPicker mDateSpinner;
/** 小时滚轮选择器：根据24/12小时制展示对应范围的小时数，核心时间选择组件 */
/**
* 小时选择器
*/
private final NumberPicker mHourSpinner;
/** 分钟滚轮选择器：固定0~59的分钟数选择，支持长按快速滚动，核心时间选择组件 */
/**
* 分钟选择器
*/
private final NumberPicker mMinuteSpinner;
/** 上下午滚轮选择器：仅12小时制显示，0=上午/AM，1=下午/PM，适配12小时制的时间展示 */
/**
* AM/PM选择器
*/
private final NumberPicker mAmPmSpinner;
// ======================== 成员变量区 - 核心状态与数据载体【全局核心数据，控件的大脑】 ========================
/** 核心日历对象：全局唯一的时间数据载体，存储当前选中的完整年月日时分信息，所有选择操作最终同步至此，所有外部获取操作均来源于此，保证数据唯一可信 */
/**
* 日期时间日历实例
*/
private Calendar mDate;
/** 日期展示文本数组：缓存近7天的格式化日期文本，供日期选择器展示使用，避免重复计算 */
/**
* 日期显示值数组
*/
private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
/** 上下午状态标记：true=上午/AM，false=下午/PM，仅在12小时制下生效，控制时间计算与展示 */
/**
* 是否为上午
*/
private boolean mIsAm;
/** 24小时制状态标记：true=启用24小时制，隐藏上下午选择器；false=启用12小时制，显示上下午选择器 */
/**
* 是否使用24小时制
*/
private boolean mIs24HourView;
/** 控件整体启用状态标记：true=所有选择器可交互，false=所有选择器禁用，统一管控交互权限 */
/**
* 是否启用
*/
private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
/** 初始化状态标记：true=控件正在初始化，屏蔽所有回调触发；false=初始化完成，正常响应所有操作与回调，防止初始化阶段的无效数据通知 */
private boolean mInitialising;
// ======================== 成员变量区 - 回调通信接口 ========================
/** 日期时间变化的回调监听器：外部实现该接口，接收控件的时间变化通知，是控件与外部通信的唯一桥梁 */
private OnDateTimeChangedListener mOnDateTimeChangedListener;
/**
* 是否正在初始化
*/
private boolean mInitialising;
// ======================== 成员变量区 - 滚轮选择器 值变化监听器【所有选择器的核心交互逻辑，内部闭环】 ========================
/**
* 日期选择器 值变化监听器：处理日期滑动切换的核心逻辑
* 核心能力：监听日期选择器的数值变化，计算日期偏移量，同步更新核心日历对象的日期，刷新日期展示文本，最终触发时间变化回调
* 无边界特殊处理：日期选择器固定展示近7天，滑动仅在7天内切换，无需处理跨月跨年的复杂逻辑
* 日期时间变化监听器
*/
private OnDateTimeChangedListener mOnDateTimeChangedListener;
private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
// 计算日期偏移量：新值-旧值 即为需要增减的天数，直接同步至核心日历对象
mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
// 刷新日期选择器的展示文本，保证文本与选中日期一致
updateDateControl();
// 触发全局时间变化回调，向外通知日期已更新
onDateTimeChanged();
}
};
/**
* 小时选择器 值变化监听器：处理小时滑动切换的核心逻辑【最复杂的联动逻辑】
* 核心能力：兼容24/12小时制的小时选择，处理所有小时边界的联动场景，包含「小时→日期」「小时→上下午」的双层联动，同步更新核心日历对象
* 核心处理场景：
* 1. 12小时制：下午11点→12点 → 日期+1；上午12点→11点 → 日期-1；小时11↔12时自动切换上下午状态；
* 2. 24小时制：23点→0点 → 日期+1；0点→23点 → 日期-1；无上下切换逻辑；
* 3. 所有场景下，最终将选中的小时数适配转换为24小时制，同步至核心日历对象，保证数据统一。
*/
private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
boolean isDateChanged = false; // 日期是否发生变化的标记位，默认无变化
Calendar cal = Calendar.getInstance(); // 临时日历对象，用于处理日期偏移
// ========== 12小时制 小时边界特殊处理 ==========
boolean isDateChanged = false;
Calendar cal = Calendar.getInstance();
if (!mIs24HourView) {
// 场景1：下午状态下，小时从11→12，触发日期+1（跨天）
if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, 1);
isDateChanged = true;
}
// 场景2：上午状态下，小时从12→11，触发日期-1（跨天）
else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
} else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, -1);
isDateChanged = true;
}
// 场景3：小时在11和12之间切换时，自动翻转上下午状态（核心联动逻辑）
if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
mIsAm = !mIsAm;
updateAmPmControl(); // 同步刷新上下午选择器的选中状态
updateAmPmControl();
}
}
// ========== 24小时制 小时边界特殊处理 ==========
else {
// 场景1：小时从23→0，触发日期+1（跨天，一天的结束）
} else {
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, 1);
isDateChanged = true;
}
// 场景2：小时从0→23，触发日期-1（跨天，一天的开始）
else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
} else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, -1);
isDateChanged = true;
}
}
// ========== 统一处理：将选中的小时数转换为24小时制，同步至核心日历对象 ==========
int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);
mDate.set(Calendar.HOUR_OF_DAY, newHour);
// 触发全局时间变化回调，向外通知小时已更新
onDateTimeChanged();
// ========== 日期发生变化时，同步更新核心日历对象的年月日 ==========
if (isDateChanged) {
setCurrentYear(cal.get(Calendar.YEAR));
setCurrentMonth(cal.get(Calendar.MONTH));
@ -206,146 +213,82 @@ public class DateTimePicker extends FrameLayout {
}
};
/**
* 分钟选择器 值变化监听器：处理分钟滑动切换的核心逻辑【分钟→小时→日期 三层联动】
* 核心能力：监听分钟选择器的数值变化，处理分钟的边界联动场景，是最基础也是最核心的时间联动逻辑
* 核心处理场景：分钟从59→0 触发小时+1；分钟从0→59 触发小时-1；小时变化后可能触发日期变化，自动联动处理
* 附加能力：小时变化后，自动同步更新上下午状态与选择器，保证12小时制的展示一致性
*/
private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
int minValue = mMinuteSpinner.getMinValue();
int maxValue = mMinuteSpinner.getMaxValue();
int offset = 0; // 小时偏移量，默认无偏移
// 场景1：分钟从59→0，触发小时+1（分钟到顶，进位到小时）
int offset = 0;
if (oldVal == maxValue && newVal == minValue) {
offset += 1;
}
// 场景2：分钟从0→59，触发小时-1（分钟到底，退位到小时）
else if (oldVal == minValue && newVal == maxValue) {
} else if (oldVal == minValue && newVal == maxValue) {
offset -= 1;
}
// ========== 小时需要偏移时，执行联动逻辑 ==========
if (offset != 0) {
mDate.add(Calendar.HOUR_OF_DAY, offset); // 同步更新核心日历对象的小时数
mHourSpinner.setValue(getCurrentHour()); // 刷新小时选择器的选中值
updateDateControl(); // 刷新日期选择器，小时偏移可能导致日期变化
// 根据新的小时数，更新上下午状态标记
mDate.add(Calendar.HOUR_OF_DAY, offset);
mHourSpinner.setValue(getCurrentHour());
updateDateControl();
int newHour = getCurrentHourOfDay();
mIsAm = newHour < HOURS_IN_HALF_DAY;
updateAmPmControl(); // 同步刷新上下午选择器的选中状态
if (newHour >= HOURS_IN_HALF_DAY) {
mIsAm = false;
updateAmPmControl();
} else {
mIsAm = true;
updateAmPmControl();
}
}
// ========== 统一处理：将选中的分钟数同步至核心日历对象 ==========
mDate.set(Calendar.MINUTE, newVal);
// 触发全局时间变化回调，向外通知分钟已更新
onDateTimeChanged();
}
};
/**
* 上下午选择器 值变化监听器：处理上下午切换的核心逻辑【仅12小时制生效】
* 核心能力：监听上下午选择器的切换操作，翻转上下午状态标记，同步调整核心日历对象的小时数（±12小时）
* 核心逻辑：上午→下午，小时+12；下午→上午，小时-12，保证时间数值的正确性，无数据误差
*/
private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
// 翻转上下午状态标记
mIsAm = !mIsAm;
// 根据新状态，调整核心日历对象的小时数，保证时间正确
if (mIsAm) {
mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
} else {
mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
}
// 刷新上下午选择器的展示状态
updateAmPmControl();
// 触发全局时间变化回调，向外通知上下午已切换
onDateTimeChanged();
}
};
// ======================== 内部回调接口 - 日期时间变化通知【标准化通信协议】 ========================
/**
* 日期时间变化回调接口：控件对外提供的唯一通信接口，所有时间选择操作的最终数据出口
* 设计原则：解耦控件内部逻辑与外部业务逻辑，控件只负责提供时间选择能力，不处理任何业务逻辑
* 调用时机：日期、小时、分钟、上下午任一选择器发生变化时，均会触发该接口的回调方法，实时传递最新的时间数据
*/
public interface OnDateTimeChangedListener {
/**
* 日期时间变化的回调方法，传递标准化的时间数据
* @param view 当前的DateTimePicker控件实例，外部可通过该实例获取更多信息或执行操作
* @param year 选中的年份，如 2026
* @param month 选中的月份，遵循Calendar规范，0代表1月，11代表12月
* @param dayOfMonth 选中的日期，当月的第几天，如 15
* @param hourOfDay 选中的小时，固定为24小时制数值，0~23，外部无需做格式转换，直接使用
* @param minute 选中的分钟，0~59，标准化数值
*/
void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute);
}
// ======================== 构造方法区 - 三级重载构造，满足不同初始化需求【核心初始化入口】 ========================
/**
* 构造方法1：最简初始化，无参重载
* 核心能力：使用系统当前时间作为初始值，自动适配系统的24小时制设置，一键创建控件
* @param context 应用上下文对象，不可为空
*/
public DateTimePicker(Context context) {
this(context, System.currentTimeMillis());
}
/**
* 构造方法2：指定初始时间初始化
* 核心能力：传入指定的毫秒级时间戳作为初始值，自动适配系统的24小时制设置，灵活适配业务需求
* @param context 应用上下文对象，不可为空
* @param date 初始选中的时间戳，单位：毫秒，支持任意合法的时间戳
*/
public DateTimePicker(Context context, long date) {
this(context, date, DateFormat.is24HourFormat(context));
}
/**
* 构造方法3：全参数核心初始化，控件的最终初始化入口，所有构造方法最终均调用此方法
* 核心能力：一站式完成「上下文初始化+核心数据初始化+布局填充+子选择器初始化+监听器绑定+状态配置+初始时间设置」，无需外部执行任何额外配置，开箱即用
* @param context 应用上下文对象，用于加载布局、创建控件、获取系统配置
* @param date 初始选中的时间戳，单位：毫秒，控件打开时默认展示的时间
* @param is24HourView 是否启用24小时制，true=启用，false=启用12小时制
*/
public DateTimePicker(Context context, long date, boolean is24HourView) {
super(context);
mDate = Calendar.getInstance(); // 初始化核心日历对象，默认加载系统当前时间
mInitialising = true; // 标记进入初始化阶段，屏蔽所有回调触发，防止无效数据通知
// 初始化上下午状态标记：根据当前小时数判断，≥12为下午，<12为上午
mDate = Calendar.getInstance();
mInitialising = true;
mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
// 第一步：填充控件的核心布局，将xml布局文件加载至当前FrameLayout根容器
inflate(context, R.layout.datetime_picker, this);
// 第二步：初始化所有子滚轮选择器，绑定控件ID，配置基础属性与监听器
// 初始化日期选择器：配置取值范围+绑定值变化监听器
mDateSpinner = (NumberPicker) findViewById(R.id.date);
mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);
mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);
mDateSpinner.setOnValueChangedListener(mOnDateChangedListener);
// 初始化小时选择器：仅绑定值变化监听器，取值范围在24/12小时制设置时动态配置
mHourSpinner = (NumberPicker) findViewById(R.id.hour);
mHourSpinner.setOnValueChangedListener(mOnHourChangedListener);
// 初始化分钟选择器：配置取值范围+设置长按快速滚动间隔+绑定值变化监听器，细节体验优化
mMinuteSpinner = (NumberPicker) findViewById(R.id.minute);
mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);
mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL);
mMinuteSpinner.setLongPressUpdateInterval(100); // 长按滚动间隔100ms，滚动更快更流畅
mMinuteSpinner.setOnLongPressUpdateInterval(100);
mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
// 初始化上下午选择器：配置取值范围+加载系统原生的AM/PM文本（适配多语言）+绑定值变化监听器
String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
@ -353,85 +296,69 @@ public class DateTimePicker extends FrameLayout {
mAmPmSpinner.setDisplayedValues(stringsForAmPm);
mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener);
// 第三步：刷新所有子选择器的初始展示状态，保证UI与初始数据一致
// update controls to initial state
updateDateControl();
updateHourControl();
updateAmPmControl();
// 第四步：配置24/12小时制状态，完成制式适配
set24HourView(is24HourView);
// 第五步：设置控件的初始选中时间，同步至所有选择器与核心日历对象
// set to current time
setCurrentDate(date);
// 第六步：配置控件的整体启用状态，默认启用
setEnabled(isEnabled());
// 第七步：初始化完成，解除初始化标记，控件进入正常工作状态，可响应所有操作与回调
// set the content descriptions
mInitialising = false;
}
// ======================== 重写父类方法 - 控件整体启用/禁用【统一状态管控】 ========================
/**
* 重写FrameLayout的setEnabled方法，实现控件整体的启用/禁用控制
* 核心能力：一键同步所有子滚轮选择器的交互状态，无需单独配置每个选择器，保证状态一致性
* 优化点：状态未变化时直接返回，避免重复执行无效操作，提升性能
* @param enabled true=启用，所有选择器可滑动选择；false=禁用，所有选择器不可交互，灰显
*/
@Override
public void setEnabled(boolean enabled) {
if (mIsEnabled == enabled) {
return;
}
super.setEnabled(enabled);
// 同步所有子选择器的启用状态
mDateSpinner.setEnabled(enabled);
mMinuteSpinner.setEnabled(enabled);
mHourSpinner.setEnabled(enabled);
mAmPmSpinner.setEnabled(enabled);
// 更新全局启用状态标记
mIsEnabled = enabled;
}
/**
* 重写FrameLayout的isEnabled方法，获取控件的整体启用状态
* @return true=控件已启用，false=控件已禁用
*/
@Override
public boolean isEnabled() {
return mIsEnabled;
}
// ======================== 公共方法区 - 日期时间 取值/赋值 标准化API【外部核心调用接口，最全】 ========================
/**
* 获取当前选中的完整时间戳，外部最常用的取值方法
* @return 选中时间的毫秒级时间戳，可直接用于存储、传输、转换，标准化输出
* Get the current date in millis
*
* @return the current date in millis
*/
public long getCurrentDateInTimeMillis() {
return mDate.getTimeInMillis();
}
/**
* 设置当前选中的时间，通过毫秒级时间戳赋值，外部最常用的赋值方法
* 核心能力：自动解析时间戳为年月日时分，同步至核心日历对象与所有子选择器，无需手动拆分
* @param date 要设置的时间戳，单位：毫秒，支持任意合法的时间戳
* Set the current date
*
* @param date The current date in millis
*/
public void setCurrentDate(long date) {
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(date);
// 解析时间戳为标准化的年月日时分，调用重载方法完成赋值
setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH),
cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE));
}
/**
* 设置当前选中的时间，通过标准化的年月日时分赋值，最底层的赋值方法
* 核心能力：精细化控制每个时间维度的数值，同步至核心日历对象与所有子选择器，数据完全可控
* @param year 年份，如 2026
* @param month 月份，Calendar规范，0=1月
* @param dayOfMonth 日期，当月的第几天，1~31
* @param hourOfDay 小时，24小时制，0~23
* @param minute 分钟，0~59
* Set the current date
*
* @param year The current year
* @param month The current month
* @param dayOfMonth The current dayOfMonth
* @param hourOfDay The current hourOfDay
* @param minute The current minute
*/
public void setCurrentDate(int year, int month,
int dayOfMonth, int hourOfDay, int minute) {
@ -443,17 +370,18 @@ public class DateTimePicker extends FrameLayout {
}
/**
* 获取当前选中的年份
* @return 年份数值，如 2026
* Get current year
*
* @return The current year
*/
public int getCurrentYear() {
return mDate.get(Calendar.YEAR);
}
/**
* 设置当前选中的年份
* 优化点：初始化阶段或数值未变化时直接返回，避免无效操作与回调触发
* @param year 要设置的年份，如 2026
* Set current year
*
* @param year The current year
*/
public void setCurrentYear(int year) {
if (!mInitialising && year == getCurrentYear()) {
@ -465,17 +393,18 @@ public class DateTimePicker extends FrameLayout {
}
/**
* 获取当前选中的月份
* @return 月份数值，遵循Calendar规范，0代表1月，11代表12月
* Get current month in the year
*
* @return The current month in the year
*/
public int getCurrentMonth() {
return mDate.get(Calendar.MONTH);
}
/**
* 设置当前选中的月份
* 优化点：初始化阶段或数值未变化时直接返回，避免无效操作与回调触发
* @param month 要设置的月份，Calendar规范，0=1月
* Set current month in the year
*
* @param month The month in the year
*/
public void setCurrentMonth(int month) {
if (!mInitialising && month == getCurrentMonth()) {
@ -487,17 +416,18 @@ public class DateTimePicker extends FrameLayout {
}
/**
* 获取当前选中的日期
* @return 日期数值，当月的第几天，1~31
* Get current day of the month
*
* @return The day of the month
*/
public int getCurrentDay() {
return mDate.get(Calendar.DAY_OF_MONTH);
}
/**
* 设置当前选中的日期
* 优化点：初始化阶段或数值未变化时直接返回，避免无效操作与回调触发
* @param dayOfMonth 要设置的日期，1~31
* Set current day of the month
*
* @param dayOfMonth The day of the month
*/
public void setCurrentDay(int dayOfMonth) {
if (!mInitialising && dayOfMonth == getCurrentDay()) {
@ -509,68 +439,65 @@ public class DateTimePicker extends FrameLayout {
}
/**
* 获取当前选中的小时数，固定返回24小时制数值，标准化输出，外部无需转换
* @return 小时数值，0~23
* Get current hour in 24 hour mode, in the range (0~23)
* @return The current hour in 24 hour mode
*/
public int getCurrentHourOfDay() {
return mDate.get(Calendar.HOUR_OF_DAY);
}
/**
* 内部私有方法：获取适配当前制式的小时数
* 核心能力：根据24/12小时制，返回对应范围的小时数，供内部选择器赋值使用，不对外暴露
* @return 24小时制返回0~23，12小时制返回1~12，适配选择器的取值范围
*/
private int getCurrentHour() {
if (mIs24HourView){
return getCurrentHourOfDay();
} else {
int hour = getCurrentHourOfDay();
// 12小时制特殊转换：0点→12点，13点→1点，保证选择器展示正确
return hour > HOURS_IN_HALF_DAY ? hour - HOURS_IN_HALF_DAY : (hour == 0 ? HOURS_IN_HALF_DAY : hour);
if (hour > HOURS_IN_HALF_DAY) {
return hour - HOURS_IN_HALF_DAY;
} else {
return hour == 0 ? HOURS_IN_HALF_DAY : hour;
}
}
}
/**
* 设置当前选中的小时数，接收24小时制数值，标准化输入，内部自动适配转换
* 核心能力：自动处理24/12小时制的转换逻辑，同步更新上下午状态与选择器，数据无误差
* 优化点：初始化阶段或数值未变化时直接返回，避免无效操作与回调触发
* @param hourOfDay 要设置的小时数，24小时制，0~23
* Set current hour in 24 hour mode, in the range (0~23)
*
* @param hourOfDay
*/
public void setCurrentHour(int hourOfDay) {
if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {
return;
}
mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
// 12小时制下的特殊处理：转换小时数+更新上下午状态
if (!mIs24HourView) {
if (hourOfDay >= HOURS_IN_HALF_DAY) {
mIsAm = false;
hourOfDay = hourOfDay > HOURS_IN_HALF_DAY ? hourOfDay - HOURS_IN_HALF_DAY : hourOfDay;
if (hourOfDay > HOURS_IN_HALF_DAY) {
hourOfDay -= HOURS_IN_HALF_DAY;
}
} else {
mIsAm = true;
hourOfDay = hourOfDay == 0 ? HOURS_IN_HALF_DAY : hourOfDay;
if (hourOfDay == 0) {
hourOfDay = HOURS_IN_HALF_DAY;
}
}
updateAmPmControl();
}
mHourSpinner.setValue(hourOfDay);
onDateTimeChanged();
}
/**
* 获取当前选中的分钟数
* @return 分钟数值，0~59
* Get currentMinute
*
* @return The Current Minute
*/
public int getCurrentMinute() {
return mDate.get(Calendar.MINUTE);
}
/**
* 设置当前选中的分钟数
* 优化点：初始化阶段或数值未变化时直接返回，避免无效操作与回调触发
* @param minute 要设置的分钟数，0~59
* Set current minute
*/
public void setCurrentMinute(int minute) {
if (!mInitialising && minute == getCurrentMinute()) {
@ -581,110 +508,76 @@ public class DateTimePicker extends FrameLayout {
onDateTimeChanged();
}
// ======================== 公共方法区 - 24小时制适配【系统级适配能力】 ========================
/**
* 判断当前控件是否启用24小时制
* @return true=24小时制，false=12小时制
* @return true if this is in 24 hour view else false.
*/
public boolean is24HourView () {
return mIs24HourView;
}
public boolean is24HourView () {
return mIs24HourView;
}
/**
* 设置控件的时间展示制式，手动强制切换24/12小时制，优先级高于系统配置
* 核心能力：切换制式时，自动刷新小时选择器的取值范围、上下午选择器的可见性、当前小时数的展示值，无缝切换无感知
* 优化点：状态未变化时直接返回，避免无效操作
* @param is24HourView true=启用24小时制，隐藏上下午选择器；false=启用12小时制，显示上下午选择器
* Set whether in 24 hour or AM/PM mode.
*
* @param is24HourView True for 24 hour mode. False for AM/PM mode.
*/
public void set24HourView(boolean is24HourView) {
if (mIs24HourView == is24HourView) {
return;
}
mIs24HourView = is24HourView;
// 控制上下午选择器的可见性
public void set24HourView(boolean is24HourView) {
if (mIs24HourView == is24HourView) {
return;
}
mIs24HourView = is24HourView;
mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE);
int hour = getCurrentHourOfDay();
// 刷新小时选择器的取值范围
updateHourControl();
// 重新适配并设置小时数，保证展示正确
setCurrentHour(hour);
// 刷新上下午选择器的状态
updateAmPmControl();
}
}
// ======================== 内部私有方法区 - 控件UI刷新【核心UI更新逻辑，内部闭环】 ========================
/**
* 刷新日期选择器的展示文本与选中状态
* 核心能力：重新计算并生成近7天的格式化日期文本，更新至日期选择器，保证展示的日期与核心日历对象一致
* 展示格式：固定为「MM.dd EEEE」，即「月.日 星期」，如「01.15 星期四」
*/
private void updateDateControl() {
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(mDate.getTimeInMillis());
// 计算近7天的起始日期：当前日期向前推4天，保证选中日期在列表中间位置，交互更友好
cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1);
mDateSpinner.setDisplayedValues(null); // 清空原有文本，避免残留
// 循环生成7天的格式化日期文本
mDateSpinner.setDisplayedValues(null);
for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) {
cal.add(Calendar.DAY_OF_YEAR, 1);
mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal);
}
// 将生成的文本数组设置到日期选择器
mDateSpinner.setDisplayedValues(mDateDisplayValues);
// 默认选中列表中间项，即当前日期
mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2);
mDateSpinner.invalidate(); // 强制刷新UI，保证展示生效
mDateSpinner.invalidate();
}
/**
* 刷新上下午选择器的选中状态与可见性
* 核心能力：根据当前的24小时制状态与上下午标记，同步更新上下午选择器的展示，保证UI与数据一致
*/
private void updateAmPmControl() {
if (mIs24HourView) {
mAmPmSpinner.setVisibility(View.GONE);
} else {
// 设置选中项：0=上午/AM，1=下午/PM
int index = mIsAm ? Calendar.AM : Calendar.PM;
mAmPmSpinner.setValue(index);
mAmPmSpinner.setVisibility(View.VISIBLE);
}
}
/**
* 刷新小时选择器的取值范围
* 核心能力：根据当前的24小时制状态，动态配置小时选择器的最小值与最大值，适配不同制式的展示需求
*/
private void updateHourControl() {
if (mIs24HourView) {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);
mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW);
} else {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW);
mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW);
}
}
private void updateHourControl() {
if (mIs24HourView) {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);
mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW);
} else {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW);
mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW);
}
}
// ======================== 公共方法区 - 回调监听器绑定【通信入口】 ========================
/**
* 设置日期时间变化的回调监听器，外部通过此方法绑定业务逻辑
* @param callback 外部实现的OnDateTimeChangedListener接口实例，传null则取消监听
* Set the callback that indicates the 'Set' button has been pressed.
* @param callback the callback, if null will do nothing
*/
public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {
mOnDateTimeChangedListener = callback;
}
// ======================== 内部私有方法区 - 回调触发【核心通信逻辑，内部闭环】 ========================
/**
* 触发日期时间变化的回调方法，所有选择操作的最终数据出口
* 核心能力：从核心日历对象中读取标准化的年月日时分数据，调用外部绑定的监听器，完成数据传递
* 优化点：监听器为null时直接返回，避免空指针异常
*/
private void onDateTimeChanged() {
if (mOnDateTimeChangedListener != null) {
mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(),
getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute());
}
}
}
}

125
src/Notes-master/src/net/micode/notes/ui/DateTimePickerDialog.java
Unescape View File

@ -14,160 +14,115 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，日期时间选择弹窗的核心封装类，集成自定义时间选择控件
package net.micode.notes.ui;
// Java日历工具类，核心时间处理载体，存储用户选中的年月日时分秒，提供时间的赋值与转换能力
import java.util.Calendar;
// 小米便签资源文件引用，获取字符串、布局等资源ID常量
import net.micode.notes.R;
// 自定义日期时间选择核心控件，本弹窗的核心内容视图，提供年月日时分滚轮选择UI
import net.micode.notes.ui.DateTimePicker;
import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;
// 安卓系统弹窗核心类，本类的父类，提供弹窗的基础展示与按钮配置能力
import android.app.AlertDialog;
import android.content.Context;
import android.content.DialogInterface;
import android.content.DialogInterface.OnClickListener;
// 安卓系统日期格式化工具类，提供24小时制判断、时间戳转友好文本的格式化能力
import android.text.format.DateFormat;
import android.text.format.DateUtils;
/**
* 日期时间选择弹窗封装类【功能型弹窗核心类】
* 继承：AlertDialog 安卓原生弹窗基类，具备系统弹窗的所有基础特性
* 核心定位：小米便签「设置便签提醒时间」功能的专属弹窗，整合自定义DateTimePicker控件实现完整的时间选择能力
* 核心设计思想：将「时间选择控件+弹窗载体+时间数据处理+回调通信」全部封装，对外提供极简调用API
* 核心职责：
* 1. 集成自定义DateTimePicker滚轮选择控件，作为弹窗的核心内容视图，提供年月日时分的可视化选择；
* 2. 统一管理选中的时间数据，基于Calendar类存储完整时间信息，自动处理时间联动更新逻辑；
* 3. 适配系统全局的24小时制/12小时制显示规则，自动切换时间展示格式，保证与系统行为一致；
* 4. 实时更新弹窗标题为当前选中的格式化时间文本，给用户直观的选择反馈；
* 5. 封装标准化的回调接口，选择完成后向外传递最终的毫秒级时间戳，解耦业务逻辑；
* 6. 固化弹窗的按钮交互逻辑：确定按钮触发回调、取消按钮关闭弹窗无操作，交互统一；
* 7. 时间精度控制：仅保留到分钟级，自动置空秒数，符合便签提醒的业务使用场景。
* 典型业务场景：便签编辑页的「添加提醒」「修改提醒时间」功能弹窗，是便签日程提醒的核心交互载体。
* 日期时间选择对话框
* 提供用户界面来选择日期和时间，用于设置便签的提醒时间
* 继承自AlertDialog，集成了DateTimePicker组件
*
* 架构设计：
* - 继承自AlertDialog，实现OnClickListener接口
* - 内部使用DateTimePicker作为日期时间选择控件
* - 提供OnDateTimeSetListener接口回调选择结果
* - 支持24小时制和12小时制显示
* - 自动更新对话框标题以反映当前选择的时间
*
* 核心功能：
* - 显示日期时间选择界面
* - 支持年、月、日、时、分的选择
* - 实时更新选择的日期时间
* - 提供确定和取消按钮
* - 回调选择的日期时间结果
* - 适配系统的时间格式设置
*/
public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
// 核心时间数据载体：存储用户当前选中的完整日期时间，初始化时获取系统当前时间，秒数固定置0
/**
* 日期时间日历实例
*/
private Calendar mDate = Calendar.getInstance();
// 24小时制标记位：适配系统设置，决定时间的展示格式（24小时/12小时带上午下午）
/**
* 是否使用24小时制
*/
private boolean mIs24HourView;
// 时间选择完成的回调监听器：外部实现该接口接收最终选中的时间戳，核心通信桥梁
/**
* 日期时间设置监听器
*/
private OnDateTimeSetListener mOnDateTimeSetListener;
// 自定义日期时间选择控件：本弹窗的核心内容视图，提供滚轮式年月日时分选择UI，业务核心控件
/**
* 日期时间选择器
*/
private DateTimePicker mDateTimePicker;
/**
* 日期时间选择完成的回调接口【标准化通信接口】
* 设计原则：解耦弹窗内部逻辑与外部业务逻辑，弹窗只负责提供选择能力，不处理业务逻辑
* 调用时机：用户点击弹窗的「确定」按钮后，触发该接口的回调方法，传递选中的时间数据
* 日期时间设置监听器接口
*/
public interface OnDateTimeSetListener {
/**
* 时间选择完成的回调方法
* @param dialog 当前的日期时间选择弹窗实例，外部可通过该实例做弹窗关闭等操作
* @param date 用户最终选中的时间戳，单位：毫秒，秒数已固定置为0，精度到分钟级
* 当用户设置日期时间时调用
* @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);
// 第二步：为时间选择控件绑定实时变化监听器，核心联动逻辑
// 监听用户在滚轮上的每一次选择操作，实时同步选中的时间数据到Calendar对象中
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); // 强制置空秒数，仅保留到分钟级，符合业务使用场景
// 将初始化的时间数据同步到时间选择控件，保证弹窗打开时展示正确的默认时间
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小时制，保证体验一致性
setButton(context.getString(R.string.datetime_dialog_ok), this);
setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
set24HourView(DateFormat.is24HourFormat(this.getContext()));
// 第六步：初始化弹窗标题，将默认时间格式化后展示，完成弹窗的最终初始化
updateTitle(mDate.getTimeInMillis());
}
/**
* 公有配置方法：手动设置弹窗的时间显示格式
* 补充能力：支持外部手动覆盖系统的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 | // 强制展示年份，如「2026年」
DateUtils.FORMAT_SHOW_DATE | // 强制展示日期，如「1月15日」
DateUtils.FORMAT_SHOW_TIME; // 强制展示时间，如「15:30」或「下午3:30」
// 根据24小时制标记位，追加对应的格式化规则，自动切换显示格式
DateUtils.FORMAT_SHOW_YEAR |
DateUtils.FORMAT_SHOW_DATE |
DateUtils.FORMAT_SHOW_TIME;
flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
// 将时间戳格式化后，设置为弹窗的标题文本，完成UI更新
setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
}
/**
* 弹窗确定按钮的点击事件处理【核心交互方法】
* 实现OnClickListener接口的核心方法，仅响应确定按钮的点击行为
* 核心逻辑：判断是否绑定了回调监听器，若绑定则触发回调，传递选中的时间戳，完成数据通信
* @param arg0 触发点击事件的弹窗对话框实例
* @param arg1 被点击按钮的索引标识，对应确定/取消等按钮类型
*/
public void onClick(DialogInterface arg0, int arg1) {
// 空值安全校验：避免未绑定回调监听器时触发空指针异常
if (mOnDateTimeSetListener != null) {
// 触发外部回调，传递弹窗实例和最终选中的时间戳，完成时间选择的业务闭环
mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
}
}

91
src/Notes-master/src/net/micode/notes/ui/DropdownMenu.java
Unescape View File

@ -14,109 +14,96 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，下拉菜单功能的统一封装工具类，全局复用
package net.micode.notes.ui;
// 安卓系统核心类 - 上下文，提供资源加载、控件创建的运行环境，必须依赖项
import android.content.Context;
// 安卓菜单体系核心类，Menu管理菜单整体结构，MenuItem表示单个菜单项
import android.view.Menu;
import android.view.MenuItem;
// 安卓视图体系核心类，处理视图点击事件、视图基础属性配置
import android.view.View;
import android.view.View.OnClickListener;
// 安卓按钮控件，作为下拉菜单的触发载体，本类核心绑定控件
import android.widget.Button;
// 安卓原生下拉菜单核心控件，实现弹窗式菜单展示，本类封装的核心原生控件
import android.widget.PopupMenu;
// 安卓下拉菜单的菜单项点击事件监听器，监听菜单选项的点击行为
import android.widget.PopupMenu.OnMenuItemClickListener;
// 小米便签资源文件引用，获取图标、布局等资源ID常量
import net.micode.notes.R;
/**
* 下拉菜单功能封装工具类【全局复用型UI工具类】
* 核心设计模式：封装模式，对Android原生PopupMenu+触发Button进行一站式封装
* 核心定位：小米便签内所有下拉菜单场景的统一实现方案，抽离通用逻辑，避免重复开发
* 核心价值：
* 1. 屏蔽原生PopupMenu的复杂创建流程，对外提供极简的调用API，一行代码即可创建下拉菜单；
* 2. 统一应用内所有下拉菜单的视觉样式（触发按钮背景图标、菜单展示位置），保证UI一致性；
* 3. 封装菜单资源加载、点击事件绑定、菜单项查找、按钮文本更新等全套核心逻辑；
* 4. 解耦下拉菜单的「创建-展示-事件处理」逻辑，外部无需关心内部实现细节；
* 5. 轻量化封装，无冗余逻辑，仅做功能整合，不侵入业务代码，适配所有下拉菜单使用场景。
* 典型业务场景：便签列表页的排序方式选择、文件夹操作菜单、更多功能选项、筛选条件下拉框等。
* 下拉菜单工具类
* 封装了PopupMenu的创建和管理，提供简洁的接口来创建和使用下拉菜单
* 简化了下拉菜单的初始化和事件处理流程
*
* 架构设计：
* - 包装Button和PopupMenu，形成完整的下拉菜单组件
* - 提供简洁的构造函数，一次性完成菜单初始化
* - 支持菜单项点击事件监听
* - 提供菜单标题设置和菜单项查找功能
*
* 核心功能：
* - 创建基于Button的下拉菜单
* - 自动设置下拉箭头图标
* - 从菜单资源文件加载菜单项
* - 处理按钮点击显示菜单的逻辑
* - 支持设置菜单项点击监听器
* - 提供菜单标题设置功能
* - 支持通过ID查找菜单项
*/
public class DropdownMenu {
// 下拉菜单的触发按钮，全局持用引用：点击该按钮即可弹出下拉菜单，统一配置背景样式
/**
* 下拉菜单按钮
*/
private Button mButton;
// Android原生下拉菜单核心控件，本类封装的核心对象：负责菜单的弹出、收起、承载菜单项
/**
* 弹出菜单实例
*/
private PopupMenu mPopupMenu;
// PopupMenu对应的菜单容器对象：用于动态查找、修改、管理菜单项的状态（显示/隐藏/禁用等）
/**
* 菜单实例
*/
private Menu mMenu;
/**
* 构造方法：初始化下拉菜单的全部核心配置【一站式初始化】
* 核心能力：传入必要参数后，自动完成「按钮样式配置+下拉菜单创建+菜单资源加载+点击触发绑定」
* 无需外部执行任何额外初始化操作，极简调用，开箱即用
* @param context 上下文对象，用于创建PopupMenu、加载菜单资源、获取应用运行环境，不可为空
* @param button 触发下拉菜单的按钮控件，菜单会锚定该按钮在下方弹出，与菜单强绑定
* @param menuId 菜单布局的资源ID（如R.menu.menu_sort），定义下拉菜单的所有选项列表
* 构造函数
* @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);
// 获取PopupMenu内部的Menu容器对象，缓存引用，供后续菜单项查找使用，避免重复获取
mMenu = mPopupMenu.getMenu();
// 通过菜单解析器，将指定的菜单布局资源加载到Menu容器中，完成菜单项的初始化展示
mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
// 为触发按钮绑定点击事件监听器：点击按钮时，自动弹出下拉菜单，核心触发逻辑
mButton.setOnClickListener(new OnClickListener() {
public void onClick(View v) {
// 弹出下拉菜单，菜单默认展示在触发按钮的下方，对齐方式由系统原生适配
mPopupMenu.show();
}
});
}
/**
* 对外提供的事件绑定方法：设置下拉菜单项的点击事件监听器
* 核心设计：事件逻辑完全交由外部实现，本类只做事件转发，无任何业务逻辑侵入，高度解耦
* 外部可根据菜单项的ID，分别处理不同选项的点击业务（如排序、筛选、删除、移动等）
* @param listener 菜单项点击事件监听器，外部实现该接口的onMenuItemClick方法处理具体逻辑
* 设置菜单项点击监听器
* @param listener 菜单项点击监听器
*/
public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
// 空值安全校验：避免PopupMenu未初始化完成时绑定监听器导致空指针异常
if (mPopupMenu != null) {
// 将外部传入的监听器绑定到PopupMenu，所有菜单项的点击事件都会回调该监听器
mPopupMenu.setOnMenuItemClickListener(listener);
}
}
/**
* 工具方法：根据菜单项的资源ID查找对应的MenuItem对象
* 核心用途：支持外部动态修改菜单项的状态，如「隐藏/显示菜单项」「禁用/启用菜单项」「修改菜单项文本/图标」等
* 是实现菜单动态化配置的核心入口，满足复杂业务场景的菜单定制需求
* @param id 目标菜单项的资源ID（如R.id.menu_sort_by_time、R.id.menu_move_folder）
* @return MenuItem 找到的菜单项对象，未找到时返回null
* 根据ID查找菜单项
* @param id 菜单项ID
* @return 菜单项实例
*/
public MenuItem findItem(int id) {
// 直接通过缓存的Menu对象查找菜单项，高效无冗余
return mMenu.findItem(id);
}
/**
* 工具方法：动态设置下拉菜单触发按钮的显示文本
* 核心业务价值：支持按钮文本的动态更新，适配「当前选中状态展示」场景
* 比如：排序菜单按钮显示「按时间排序」、文件夹菜单按钮显示「当前文件夹：工作」等
* @param title 按钮需要展示的文本内容，支持字符串常量、动态拼接字符串
* 设置下拉菜单按钮标题
* @param title 标题文本
*/
public void setTitle(CharSequence title) {
// 直接为触发按钮设置文本内容，更新UI展示
mButton.setText(title);
}
}
}

135
src/Notes-master/src/net/micode/notes/ui/FoldersListAdapter.java
Unescape View File

@ -14,166 +14,97 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，是文件夹列表展示的核心数据适配器
package net.micode.notes.ui;
// 安卓系统核心类 - 上下文，提供资源加载、视图创建的运行环境
import android.content.Context;
// 安卓数据库游标类，承载文件夹的数据库查询结果集，适配器的核心数据源
import android.database.Cursor;
// 安卓视图体系核心类，用于创建和装载列表子项视图
import android.view.View;
import android.view.ViewGroup;
// 安卓游标适配器基类，适配Cursor数据源的列表专用适配器，本类核心父类
import android.widget.CursorAdapter;
// 安卓线性布局，作为自定义列表项的根布局容器
import android.widget.LinearLayout;
// 安卓文本控件，用于展示文件夹名称文本内容
import android.widget.TextView;
// 小米便签资源文件引用，获取布局、字符串等资源id
import net.micode.notes.R;
// 小米便签核心数据常量，定义文件夹id、数据库字段名等全局常量
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
/**
* 文件夹列表专用数据适配器【核心功能适配器】
* 继承：CursorAdapter 安卓原生游标适配器，完美适配数据库查询的Cursor结果集
* 核心定位：小米便签中「移动便签到文件夹」弹窗的核心适配器，负责文件夹列表的数据绑定与视图渲染
* 核心职责：
* 1. 定义文件夹查询的精简投影字段，只查必要数据，减少数据库IO开销，提升列表加载效率；
* 2. 实现Cursor数据与列表子项视图的绑定逻辑，规范数据渲染流程；
* 3. 对「根文件夹」做特殊文本适配，将系统根文件夹名称替换为业务友好的文本提示；
* 4. 封装文件夹名称获取工具方法，对外提供统一的名称读取接口，解耦外部调用逻辑；
* 5. 内置自定义列表项布局，封装视图创建与控件绑定，避免外部多次 findViewById 性能损耗。
* 核心特点：轻量高效、职责单一，仅处理文件夹列表的「数据-视图」映射关系，无业务逻辑侵入。
* 文件夹列表适配器
* 用于显示便签文件夹列表，支持文件夹选择功能
* 作为便签分类管理的重要组件，提供文件夹的可视化展示
*
* 架构设计：
* - 继承自CursorAdapter，使用游标数据绑定
* - 自定义FolderListItem作为列表项视图
* - 支持根文件夹的特殊显示
* - 提供获取文件夹名称的方法
*
* 核心功能：
* - 显示文件夹列表
* - 根文件夹特殊显示为"父文件夹"
* - 绑定文件夹数据到列表项
* - 提供通过位置获取文件夹名称的方法
*/
public class FoldersListAdapter extends CursorAdapter {
/**
* 文件夹数据库查询投影数组【核心常量】
* 设计原则：按需查询，只获取列表展示所需的核心字段，不查冗余字段，降低内存占用和查询耗时
* 字段组成：仅包含文件夹的唯一标识和展示名称，满足列表所有业务需求
* 查询投影列，包含文件夹ID和名称
*/
public static final String [] PROJECTION = {
NoteColumns.ID, // 数组索引0 - 文件夹的唯一ID，数据库主键
NoteColumns.SNIPPET // 数组索引1 - 文件夹的名称，用于列表展示
NoteColumns.ID,
NoteColumns.SNIPPET
};
/**
* 投影字段对应的列索引常量
* 设计目的：封装索引数值，避免代码中出现硬编码数字，提升代码可读性和可维护性
* 作用：通过常量直接取值，Cursor.getInt(ID_COLUMN) 比 Cursor.getInt(0) 语义更清晰
* ID列索引
*/
public static final int ID_COLUMN = 0;
/**
* 名称列索引
*/
public static final int ID_COLUMN = 0; // 文件夹ID对应的游标列索引
public static final int NAME_COLUMN = 1; // 文件夹名称对应的游标列索引
public static final int NAME_COLUMN = 1;
/**
* 构造方法：初始化文件夹列表适配器
* 父类传参：将上下文和游标数据源传递给CursorAdapter基类，完成适配器初始化
* @param context 上下文对象，用于加载资源、创建视图，不可为空
* @param c 数据库查询返回的游标，封装了所有文件夹的ID和名称数据，游标已完成查询定位
* 构造函数
* @param context 上下文
* @param c 包含文件夹数据的游标
*/
public FoldersListAdapter(Context context, Cursor c) {
super(context, c);
}
/**
* 重写父类方法：创建列表子项的空白视图
* 生命周期：列表滚动时，为屏幕外新进入的位置创建全新的视图对象，复用性低
* 核心逻辑：仅创建视图容器，不做任何数据绑定，数据绑定由bindView方法完成
* @param context 上下文对象，用于创建视图
* @param cursor 当前位置对应的游标数据，本方法中暂未使用，仅遵循父类接口规范
* @param parent 列表子项的父容器，即承载所有文件夹项的ListView
* @return View 新建的、未绑定数据的文件夹列表子项视图
*/
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {
// 创建自定义的文件夹列表项视图，内部已完成布局加载和控件绑定
return new FolderListItem(context);
}
/**
* 重写父类核心方法：为列表子项视图绑定对应的数据【核心业务方法】
* 生命周期：列表首次加载/滚动复用视图时调用，所有数据渲染逻辑均在此实现
* 核心业务规则：
* 1. 根文件夹（ID=Notes.ID_ROOT_FOLDER）：不展示原始名称，替换为业务文本「移动到上级文件夹」；
* 2. 普通文件夹：直接展示数据库中存储的文件夹名称；
* 3. 类型安全校验：只处理自定义的FolderListItem视图，防止视图类型异常导致崩溃。
* @param view 待绑定数据的列表子项视图，可为newView创建的新视图，也可为复用的旧视图
* @param context 上下文对象，用于加载字符串资源
* @param cursor 当前列表位置对应的游标，已定位到对应行，可直接读取字段值
*/
@Override
public void bindView(View view, Context context, Cursor cursor) {
// 视图类型校验，保证类型安全，避免视图强转异常
if (view instanceof FolderListItem) {
// 读取当前游标中的文件夹ID，判断是否为根文件夹
long folderId = cursor.getLong(ID_COLUMN);
String folderName;
// 根文件夹特殊处理：替换展示文本；普通文件夹使用原始名称
if (folderId == Notes.ID_ROOT_FOLDER) {
folderName = context.getString(R.string.menu_move_parent_folder);
} else {
folderName = cursor.getString(NAME_COLUMN);
}
// 调用自定义视图的绑定方法，将处理后的文件夹名称设置到文本控件
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);
}
}
/**
* 对外提供的工具方法：根据列表位置获取对应的文件夹名称
* 封装价值：外部调用方无需操作游标，直接传入位置即可获取名称，隐藏游标操作细节，解耦调用逻辑
* 业务规则：与bindView保持完全一致，根文件夹返回「移动到上级文件夹」，保证数据一致性
* @param context 上下文对象，用于加载根文件夹的业务文本
* @param position 列表中的目标位置索引，从0开始
* @return String 处理后的文件夹展示名称
*/
public String getFolderName(Context context, int position) {
// 根据位置获取对应的游标对象，游标已自动定位到对应行
Cursor cursor = (Cursor) getItem(position);
long folderId = cursor.getLong(ID_COLUMN);
// 根文件夹判断与名称适配，逻辑与bindView完全一致
return folderId == Notes.ID_ROOT_FOLDER ? context.getString(R.string.menu_move_parent_folder)
: cursor.getString(NAME_COLUMN);
return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
.getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
}
/**
* 私有内部类：文件夹列表的自定义子项视图【视图封装核心类】
* 继承：LinearLayout 线性布局，作为子项的根布局
* 设计思想：视图控件封装化，将列表项的布局加载、控件绑定、数据绑定全部封装在内部
* 核心优势：外部无需关心视图内部结构，只需调用bind方法即可完成数据渲染，符合封装原则
* 访问权限：private 私有，仅当前适配器可创建使用，不对外暴露，保证视图安全性
*/
private class FolderListItem extends LinearLayout {
// 列表项核心控件：展示文件夹名称的文本控件，全局缓存避免重复查找
private TextView mName;
/**
* 构造方法：初始化自定义列表项视图
* 核心逻辑：加载布局文件 + 绑定内部控件，只执行一次，视图创建时完成初始化
* @param context 上下文对象，用于加载布局资源和查找控件
*/
public FolderListItem(Context context) {
super(context);
// 将文件夹列表项的布局文件，填充到当前的LinearLayout根布局中
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);
}
}
}
}

212
src/Notes-master/src/net/micode/notes/ui/FriendManagementActivity.java
Unescape View File

@ -0,0 +1,212 @@
package net.micode.notes.ui;
import android.app.ActionBar;
import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.AdapterView;
import android.widget.BaseAdapter;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;
import net.micode.notes.R;
import net.micode.notes.data.NotesDatabaseHelper;
import net.micode.notes.tool.UserManager;
import net.micode.notes.data.Users;
import java.util.ArrayList;
import java.util.List;
/**
* 好友管理活动
* <p>
* 该类负责实现好友列表的显示和管理功能，用户可以通过该界面查看好友列表并启动与好友的聊天。
* 它通过NotesDatabaseHelper操作用户数据表，获取除当前用户以外的所有用户作为好友列表。
*/
public class FriendManagementActivity extends Activity {
private ListView mFriendListView;
private FriendAdapter mFriendAdapter;
private List<Friend> mFriendList;
private NotesDatabaseHelper mDbHelper;
private SQLiteDatabase mDb;
private UserManager mUserManager;
private long mCurrentUserId;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_friend_management);
// 设置ActionBar
ActionBar actionBar = getActionBar();
if (actionBar != null) {
actionBar.setDisplayHomeAsUpEnabled(true);
actionBar.setTitle("好友管理");
}
// 初始化数据库
mDbHelper = NotesDatabaseHelper.getInstance(this);
mDb = mDbHelper.getWritableDatabase();
// 初始化UserManager
mUserManager = UserManager.getInstance(this);
mCurrentUserId = mUserManager.getCurrentUserId();
// 初始化ListView
mFriendListView = findViewById(R.id.friend_list);
mFriendList = new ArrayList<>();
mFriendAdapter = new FriendAdapter(this, mFriendList);
mFriendListView.setAdapter(mFriendAdapter);
// 设置ListView点击事件
mFriendListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
Friend friend = mFriendList.get(position);
// 启动与好友聊天的活动
Intent intent = new Intent(FriendManagementActivity.this, ChatActivity.class);
intent.putExtra("friend_id", friend.id);
intent.putExtra("friend_username", friend.username);
startActivity(intent);
}
});
// 加载好友列表
loadFriendList();
}
@Override
protected void onResume() {
super.onResume();
// 重新加载好友列表
loadFriendList();
}
@Override
protected void onDestroy() {
super.onDestroy();
// 关闭数据库连接
if (mDb != null && mDb.isOpen()) {
mDb.close();
}
}
/**
* 加载好友列表，即除当前用户以外的所有用户
*/
private void loadFriendList() {
mFriendList.clear();
// 查询除当前用户以外的所有用户
Cursor cursor = mDb.query(
NotesDatabaseHelper.TABLE.USER,
new String[]{Users.UserColumns.ID, Users.UserColumns.USERNAME},
Users.UserColumns.ID + " != ?",
new String[]{String.valueOf(mCurrentUserId)},
null,
null,
null
);
if (cursor != null) {
while (cursor.moveToNext()) {
long id = cursor.getLong(cursor.getColumnIndexOrThrow(Users.UserColumns.ID));
String username = cursor.getString(cursor.getColumnIndexOrThrow(Users.UserColumns.USERNAME));
mFriendList.add(new Friend(id, username));
}
cursor.close();
}
// 通知适配器数据变化
mFriendAdapter.notifyDataSetChanged();
// 如果没有好友，显示提示
if (mFriendList.isEmpty()) {
Toast.makeText(this, "暂无其他用户", Toast.LENGTH_SHORT).show();
}
}
/**
* 好友实体类
*/
private static class Friend {
long id;
String username;
Friend(long id, String username) {
this.id = id;
this.username = username;
}
}
/**
* 好友列表适配器
*/
private static class FriendAdapter extends BaseAdapter {
private Context mContext;
private List<Friend> mFriendList;
private LayoutInflater mInflater;
FriendAdapter(Context context, List<Friend> friendList) {
mContext = context;
mFriendList = friendList;
mInflater = LayoutInflater.from(context);
}
@Override
public int getCount() {
return mFriendList.size();
}
@Override
public Object getItem(int position) {
return mFriendList.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ViewHolder holder;
if (convertView == null) {
convertView = mInflater.inflate(R.layout.item_friend, parent, false);
holder = new ViewHolder();
holder.usernameTextView = convertView.findViewById(R.id.friend_username);
convertView.setTag(holder);
} else {
holder = (ViewHolder) convertView.getTag();
}
Friend friend = mFriendList.get(position);
holder.usernameTextView.setText(friend.username);
return convertView;
}
private static class ViewHolder {
TextView usernameTextView;
}
}
@Override
public boolean onOptionsItemSelected(android.view.MenuItem item) {
switch (item.getItemId()) {
case android.R.id.home:
// 返回上一级活动
finish();
return true;
default:
return super.onOptionsItemSelected(item);
}
}
}

264
src/Notes-master/src/net/micode/notes/ui/FriendNoteEditActivity.java
Unescape View File

@ -0,0 +1,264 @@
package net.micode.notes.ui;
import android.app.ActionBar;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.widget.TextView;
import android.widget.Toast;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
/**
* 好友便签查看活动类
* 用于查看好友的公开便签详情，以只读模式显示便签内容
* 作为FriendNoteListActivity的配套组件，提供便签内容的详细展示
*
* 架构设计：
* - 继承自Activity，使用简单的TextView布局
* - 以只读模式显示便签标题和内容
* - 显示便签的修改时间
* - 支持从Intent中获取便签ID和好友ID
* - 包含状态保存和恢复机制
*
* 核心功能：
* - 查看好友公开便签的详细内容
* - 显示便签标题和修改时间
* - 支持返回上一级活动
* - 处理便签数据加载失败的情况
* - 适配不同的便签状态（有标题/无标题，有内容/无内容）
*/
public class FriendNoteEditActivity extends Activity {
/**
* 便签内容编辑器
*/
private TextView mNoteEditor;
/**
* 便签标题视图
*/
private TextView mNoteTitleView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_friend_note_edit);
// 设置ActionBar
ActionBar actionBar = getActionBar();
if (actionBar != null) {
actionBar.setDisplayHomeAsUpEnabled(true);
actionBar.setTitle("查看便签");
}
// 初始化控件
mNoteEditor = findViewById(R.id.note_edit_view);
mNoteTitleView = findViewById(R.id.note_title_view);
// 加载便签数据
if (savedInstanceState == null && !initActivityState(getIntent())) {
finish();
return;
}
initNoteScreen();
}
@Override
protected void onRestoreInstanceState(Bundle savedInstanceState) {
super.onRestoreInstanceState(savedInstanceState);
if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID));
intent.putExtra("friend_id", savedInstanceState.getLong("friend_id"));
if (!initActivityState(intent)) {
finish();
return;
}
// 恢复状态后重新初始化界面
initNoteScreen();
}
}
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
if (getIntent() != null) {
outState.putLong(Intent.EXTRA_UID, getIntent().getLongExtra(Intent.EXTRA_UID, 0));
outState.putLong("friend_id", getIntent().getLongExtra("friend_id", -1));
}
}
private String mNoteContent;
private String mNoteTitle;
private long mModifiedDate;
private boolean initActivityState(Intent intent) {
/**
* 只支持查看模式
*/
long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
long friendId = intent.getLongExtra("friend_id", -1);
if (noteId <= 0 || friendId <= 0) {
Toast.makeText(this, "便签信息错误", Toast.LENGTH_SHORT).show();
finish();
return false;
}
try {
// 查询便签基本信息，包括标题
String[] noteProjection = {
net.micode.notes.data.Notes.NoteColumns.MODIFIED_DATE,
net.micode.notes.data.Notes.NoteColumns.TITLE
};
android.database.Cursor noteCursor = null;
try {
// 使用ContentResolver查询便签基本信息
noteCursor = getContentResolver().query(
android.content.ContentUris.withAppendedId(net.micode.notes.data.Notes.CONTENT_NOTE_URI, noteId),
noteProjection,
null,
null,
null
);
if (noteCursor != null) {
if (noteCursor.moveToFirst()) {
mModifiedDate = noteCursor.getLong(0);
mNoteTitle = noteCursor.getString(1);
}
noteCursor.close();
}
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "查询便签信息失败", Toast.LENGTH_SHORT).show();
}
// 查询便签具体内容，这是必须的，因为完整内容存储在Data表中
String[] dataProjection = {net.micode.notes.data.Notes.DataColumns.CONTENT};
String dataSelection = net.micode.notes.data.Notes.DataColumns.NOTE_ID + " = ? AND " +
net.micode.notes.data.Notes.DataColumns.MIME_TYPE + " = ?";
String[] dataSelectionArgs = {String.valueOf(noteId), net.micode.notes.data.Notes.DataConstants.NOTE};
android.database.Cursor dataCursor = null;
try {
// 使用ContentResolver查询数据
dataCursor = getContentResolver().query(
net.micode.notes.data.Notes.CONTENT_DATA_URI,
dataProjection,
dataSelection,
dataSelectionArgs,
null
);
if (dataCursor != null) {
if (dataCursor.moveToFirst()) {
mNoteContent = dataCursor.getString(0);
}
dataCursor.close();
}
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "查询便签内容失败", Toast.LENGTH_SHORT).show();
} finally {
if (dataCursor != null) {
dataCursor.close();
}
}
// 如果查询失败，尝试使用数据库直接查询
if (mNoteContent == null || mNoteContent.isEmpty()) {
try {
// 直接使用数据库查询，绕过ContentProvider的用户过滤
net.micode.notes.data.NotesDatabaseHelper helper = net.micode.notes.data.NotesDatabaseHelper.getInstance(FriendNoteEditActivity.this);
if (helper != null) {
dataCursor = helper.getReadableDatabase().query(
net.micode.notes.data.NotesDatabaseHelper.TABLE.DATA,
dataProjection,
dataSelection,
dataSelectionArgs,
null,
null,
null
);
if (dataCursor != null) {
if (dataCursor.moveToFirst()) {
mNoteContent = dataCursor.getString(0);
}
dataCursor.close();
}
}
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "直接查询便签内容失败", Toast.LENGTH_SHORT).show();
} finally {
if (dataCursor != null) {
dataCursor.close();
}
}
}
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "初始化便签失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();
finish();
return false;
}
return true;
}
private void initNoteScreen() {
// 显示修改日期
TextView modifiedDateTextView = findViewById(R.id.tv_modified_date);
modifiedDateTextView.setText(android.text.format.DateUtils.formatDateTime(
this, mModifiedDate,
android.text.format.DateUtils.FORMAT_SHOW_DATE |
android.text.format.DateUtils.FORMAT_NUMERIC_DATE |
android.text.format.DateUtils.FORMAT_SHOW_TIME));
// 显示便签标题
if (mNoteTitle != null && !mNoteTitle.isEmpty()) {
mNoteTitleView.setVisibility(View.VISIBLE);
mNoteTitleView.setText(mNoteTitle);
} else {
// 如果没有标题，隐藏标题文本视图
mNoteTitleView.setVisibility(View.GONE);
}
// 显示便签内容，添加调试日志
if (mNoteContent != null && !mNoteContent.isEmpty()) {
mNoteEditor.setText(mNoteContent);
// 设置文本颜色为深色，确保可见
mNoteEditor.setTextColor(getResources().getColor(android.R.color.primary_text_dark));
// 设置背景色为白色，确保可见
mNoteEditor.setBackgroundColor(getResources().getColor(android.R.color.white));
} else {
// 如果内容为空，显示提示文本
mNoteEditor.setText("（空便签）");
mNoteEditor.setTextColor(getResources().getColor(android.R.color.secondary_text_dark));
}
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// 不显示菜单，因为是只读模式
return false;
}
@Override
public boolean onOptionsItemSelected(android.view.MenuItem item) {
switch (item.getItemId()) {
case android.R.id.home:
// 返回上一级活动
finish();
return true;
default:
return super.onOptionsItemSelected(item);
}
}
}

305
src/Notes-master/src/net/micode/notes/ui/FriendNoteListActivity.java
Unescape View File

@ -0,0 +1,305 @@
package net.micode.notes.ui;
import android.app.ActionBar;
import android.app.Activity;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.AdapterView;
import android.widget.BaseAdapter;
import android.widget.ImageView;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.model.WorkingNote;
import java.util.ArrayList;
import java.util.List;
/**
* 好友便签列表活动类
* 显示指定好友的所有公开便签，允许用户查看好友的便签内容
* 作为好友功能的重要组成部分，实现了便签的社交分享功能
*
* 架构设计：
* - 继承自Activity，使用ListView显示便签列表
* - 自定义NoteAdapter适配器处理数据绑定
* - 通过ContentResolver查询好友的公开便签
* - 支持点击查看便签详情
* - 包含错误处理和空状态提示
*
* 核心功能：
* - 显示好友的公开便签列表
* - 按置顶状态和修改时间排序
* - 点击查看便签详情
* - 支持返回上一级活动
* - 显示便签的置顶、锁定和公开状态
*/
public class FriendNoteListActivity extends Activity {
/**
* 便签列表视图
*/
private ListView mNoteListView;
/**
* 便签适配器
*/
private NoteAdapter mNoteAdapter;
/**
* 便签数据列表
*/
private List<Note> mNoteList;
/**
* 好友ID
*/
private long mFriendId;
/**
* 好友用户名
*/
private String mFriendUsername;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_friend_note_list);
// 获取好友信息
mFriendId = getIntent().getLongExtra("friend_id", -1);
mFriendUsername = getIntent().getStringExtra("friend_username");
if (mFriendId == -1 || mFriendUsername == null) {
Toast.makeText(this, "好友信息错误", Toast.LENGTH_SHORT).show();
finish();
return;
}
// 设置ActionBar
ActionBar actionBar = getActionBar();
if (actionBar != null) {
actionBar.setDisplayHomeAsUpEnabled(true);
actionBar.setTitle(mFriendUsername + "的公开便签");
}
// 初始化ListView
mNoteListView = findViewById(R.id.friend_note_list);
mNoteList = new ArrayList<>();
mNoteAdapter = new NoteAdapter(this, mNoteList);
mNoteListView.setAdapter(mNoteAdapter);
// 设置ListView点击事件
mNoteListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
Note note = mNoteList.get(position);
// 启动查看便签详情的活动
Intent intent = new Intent(FriendNoteListActivity.this, FriendNoteEditActivity.class);
intent.putExtra(Intent.EXTRA_UID, note.id);
intent.putExtra("friend_id", mFriendId);
startActivity(intent);
}
});
// 加载好友的公开便签
loadFriendNotes();
}
@Override
protected void onResume() {
super.onResume();
// 重新加载好友便签
loadFriendNotes();
}
/**
* 加载好友的公开便签
*/
private void loadFriendNotes() {
try {
mNoteList.clear();
// 查询好友的所有公开便签
String[] projection = {
NoteColumns.ID,
NoteColumns.TITLE,
NoteColumns.SNIPPET,
NoteColumns.MODIFIED_DATE,
NoteColumns.TYPE,
NoteColumns.PINNED,
NoteColumns.LOCKED,
NoteColumns.PUBLIC
};
String selection = NoteColumns.USER_ID + " = ? AND " + NoteColumns.PUBLIC + " = 1 AND " + NoteColumns.PARENT_ID + " <> " + Notes.ID_TRASH_FOLER;
String[] selectionArgs = {String.valueOf(mFriendId)};
Cursor cursor = null;
try {
cursor = getContentResolver().query(
Notes.CONTENT_NOTE_URI,
projection,
selection,
selectionArgs,
NoteColumns.PINNED + " DESC, " + NoteColumns.MODIFIED_DATE + " DESC"
);
if (cursor != null) {
while (cursor.moveToNext()) {
long id = cursor.getLong(cursor.getColumnIndexOrThrow(NoteColumns.ID));
String title = cursor.getString(cursor.getColumnIndexOrThrow(NoteColumns.TITLE));
String content = cursor.getString(cursor.getColumnIndexOrThrow(NoteColumns.SNIPPET));
long modifiedDate = cursor.getLong(cursor.getColumnIndexOrThrow(NoteColumns.MODIFIED_DATE));
int type = cursor.getInt(cursor.getColumnIndexOrThrow(NoteColumns.TYPE));
int pinned = cursor.getInt(cursor.getColumnIndexOrThrow(NoteColumns.PINNED));
int locked = cursor.getInt(cursor.getColumnIndexOrThrow(NoteColumns.LOCKED));
int isPublic = cursor.getInt(cursor.getColumnIndexOrThrow(NoteColumns.PUBLIC));
mNoteList.add(new Note(id, title, content, modifiedDate, type, pinned, locked, isPublic));
}
}
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "查询好友便签失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();
} finally {
if (cursor != null) {
cursor.close();
}
}
// 通知适配器数据变化
mNoteAdapter.notifyDataSetChanged();
// 如果没有公开便签，显示提示
if (mNoteList.isEmpty()) {
Toast.makeText(this, mFriendUsername + "没有公开的便签", Toast.LENGTH_SHORT).show();
}
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "加载好友便签失败", Toast.LENGTH_SHORT).show();
}
}
/**
* 便签实体类
*/
private static class Note {
long id;
String title;
String content;
long modifiedDate;
int type;
int pinned;
int locked;
int isPublic;
Note(long id, String title, String content, long modifiedDate, int type, int pinned, int locked, int isPublic) {
this.id = id;
this.title = title;
this.content = content;
this.modifiedDate = modifiedDate;
this.type = type;
this.pinned = pinned;
this.locked = locked;
this.isPublic = isPublic;
}
}
/**
* 便签列表适配器
*/
private static class NoteAdapter extends BaseAdapter {
private Activity mActivity;
private List<Note> mNoteList;
private LayoutInflater mInflater;
NoteAdapter(Activity activity, List<Note> noteList) {
mActivity = activity;
mNoteList = noteList;
mInflater = LayoutInflater.from(activity);
}
@Override
public int getCount() {
return mNoteList.size();
}
@Override
public Object getItem(int position) {
return mNoteList.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ViewHolder holder;
if (convertView == null) {
convertView = mInflater.inflate(R.layout.note_item, parent, false);
holder = new ViewHolder();
holder.titleTextView = convertView.findViewById(R.id.tv_title);
holder.modifiedDateTextView = convertView.findViewById(R.id.tv_time);
holder.pinnedImageView = convertView.findViewById(R.id.iv_alert_icon);
holder.lockedImageView = convertView.findViewById(R.id.iv_lock_icon);
holder.publicImageView = convertView.findViewById(R.id.iv_public_icon);
convertView.setTag(holder);
} else {
holder = (ViewHolder) convertView.getTag();
}
Note note = mNoteList.get(position);
// 显示标题，如果标题为空则显示内容摘要
String displayText;
if (note.title != null && !note.title.isEmpty()) {
displayText = note.title;
} else {
displayText = note.content;
}
holder.titleTextView.setText(displayText);
holder.modifiedDateTextView.setText(android.text.format.DateUtils.formatDateTime(
mActivity, note.modifiedDate,
android.text.format.DateUtils.FORMAT_SHOW_DATE |
android.text.format.DateUtils.FORMAT_NUMERIC_DATE |
android.text.format.DateUtils.FORMAT_SHOW_TIME));
// 设置置顶图标
holder.pinnedImageView.setVisibility(note.pinned == 1 ? View.VISIBLE : View.GONE);
// 设置锁定图标
holder.lockedImageView.setVisibility(note.locked == 1 ? View.VISIBLE : View.GONE);
// 设置公开图标
holder.publicImageView.setVisibility(note.isPublic == 1 ? View.VISIBLE : View.GONE);
return convertView;
}
private static class ViewHolder {
TextView titleTextView;
TextView modifiedDateTextView;
ImageView pinnedImageView;
ImageView lockedImageView;
ImageView publicImageView;
}
}
@Override
public boolean onOptionsItemSelected(android.view.MenuItem item) {
switch (item.getItemId()) {
case android.R.id.home:
// 返回上一级活动
finish();
return true;
default:
return super.onOptionsItemSelected(item);
}
}
}

327
src/Notes-master/src/net/micode/notes/ui/LoginActivity.java
Unescape View File

@ -0,0 +1,327 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* 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.
*/
package net.micode.notes.ui;
import android.content.ContentValues;
import android.content.Intent;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;
import androidx.appcompat.app.AlertDialog;
import androidx.appcompat.app.AppCompatActivity;
import net.micode.notes.R;
import net.micode.notes.data.NotesDatabaseHelper;
import net.micode.notes.data.Users;
import net.micode.notes.tool.UserManager;
/**
* 登录活动
* <p>
* 该类负责用户登录、注册和密码修改功能，是用户认证的入口界面。
* 它通过NotesDatabaseHelper操作用户数据表，实现用户的身份验证和管理。
*/
public class LoginActivity extends AppCompatActivity {
private EditText etUsername;
private EditText etPassword;
private NotesDatabaseHelper mDbHelper;
private SQLiteDatabase mDb;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_login);
// 初始化数据库
mDbHelper = NotesDatabaseHelper.getInstance(this);
mDb = mDbHelper.getWritableDatabase();
// 初始化控件
etUsername = findViewById(R.id.et_username);
etPassword = findViewById(R.id.et_password);
}
/**
* 登录按钮点击事件
*/
public void onLoginClick(View view) {
String username = etUsername.getText().toString().trim();
String password = etPassword.getText().toString().trim();
// 验证输入
if (username.isEmpty() || password.isEmpty()) {
Toast.makeText(this, "用户名和密码不能为空", Toast.LENGTH_SHORT).show();
return;
}
// 验证用户名和密码
long userId = validateUser(username, password);
if (userId != -1) {
// 登录成功，保存用户信息
UserManager userManager = UserManager.getInstance(this);
userManager.saveCurrentUser(userId, username);
// 跳转到便签列表
Intent intent = new Intent(this, NotesListActivity.class);
startActivity(intent);
finish();
} else {
// 登录失败，提示错误
Toast.makeText(this, "用户名或密码错误", Toast.LENGTH_SHORT).show();
}
}
/**
* 注册按钮点击事件
*/
public void onRegisterClick(View view) {
showRegisterDialog();
}
/**
* 修改密码按钮点击事件
*/
public void onChangePasswordClick(View view) {
showChangePasswordDialog();
}
/**
* 显示注册对话框
*/
private void showRegisterDialog() {
View dialogView = getLayoutInflater().inflate(R.layout.dialog_register, null);
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setView(dialogView);
final AlertDialog dialog = builder.create();
// 初始化注册对话框控件
final EditText etRegisterUsername = dialogView.findViewById(R.id.et_register_username);
final EditText etRegisterPassword = dialogView.findViewById(R.id.et_register_password);
final EditText etRegisterConfirmPassword = dialogView.findViewById(R.id.et_register_confirm_password);
Button btnRegisterCancel = dialogView.findViewById(R.id.btn_register_cancel);
Button btnRegisterConfirm = dialogView.findViewById(R.id.btn_register_confirm);
// 取消按钮点击事件
btnRegisterCancel.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
dialog.dismiss();
}
});
// 注册按钮点击事件
btnRegisterConfirm.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
String username = etRegisterUsername.getText().toString().trim();
String password = etRegisterPassword.getText().toString().trim();
String confirmPassword = etRegisterConfirmPassword.getText().toString().trim();
// 验证输入
if (username.isEmpty() || password.isEmpty() || confirmPassword.isEmpty()) {
Toast.makeText(LoginActivity.this, "请填写完整信息", Toast.LENGTH_SHORT).show();
return;
}
if (!password.equals(confirmPassword)) {
Toast.makeText(LoginActivity.this, "两次输入的密码不一致", Toast.LENGTH_SHORT).show();
return;
}
// 检查用户名是否已存在
if (isUsernameExists(username)) {
Toast.makeText(LoginActivity.this, "用户名已存在", Toast.LENGTH_SHORT).show();
return;
}
// 注册用户
if (registerUser(username, password)) {
Toast.makeText(LoginActivity.this, "注册成功", Toast.LENGTH_SHORT).show();
dialog.dismiss();
} else {
Toast.makeText(LoginActivity.this, "注册失败，请重试", Toast.LENGTH_SHORT).show();
}
}
});
dialog.show();
}
/**
* 显示修改密码对话框
*/
private void showChangePasswordDialog() {
View dialogView = getLayoutInflater().inflate(R.layout.dialog_change_password, null);
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setView(dialogView);
final AlertDialog dialog = builder.create();
// 初始化修改密码对话框控件
final EditText etChangeUsername = dialogView.findViewById(R.id.et_change_username);
final EditText etCurrentPassword = dialogView.findViewById(R.id.et_current_password);
final EditText etNewPassword = dialogView.findViewById(R.id.et_new_password);
final EditText etConfirmNewPassword = dialogView.findViewById(R.id.et_confirm_new_password);
Button btnChangeCancel = dialogView.findViewById(R.id.btn_change_cancel);
Button btnChangeConfirm = dialogView.findViewById(R.id.btn_change_confirm);
// 取消按钮点击事件
btnChangeCancel.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
dialog.dismiss();
}
});
// 确认修改按钮点击事件
btnChangeConfirm.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
String username = etChangeUsername.getText().toString().trim();
String currentPassword = etCurrentPassword.getText().toString().trim();
String newPassword = etNewPassword.getText().toString().trim();
String confirmNewPassword = etConfirmNewPassword.getText().toString().trim();
// 验证输入
if (username.isEmpty() || currentPassword.isEmpty() || newPassword.isEmpty() || confirmNewPassword.isEmpty()) {
Toast.makeText(LoginActivity.this, "请填写完整信息", Toast.LENGTH_SHORT).show();
return;
}
if (!newPassword.equals(confirmNewPassword)) {
Toast.makeText(LoginActivity.this, "两次输入的新密码不一致", Toast.LENGTH_SHORT).show();
return;
}
// 验证当前密码
if (validateUser(username, currentPassword) == -1) {
Toast.makeText(LoginActivity.this, "用户名或当前密码错误", Toast.LENGTH_SHORT).show();
return;
}
// 修改密码
if (changePassword(username, newPassword)) {
Toast.makeText(LoginActivity.this, "密码修改成功", Toast.LENGTH_SHORT).show();
dialog.dismiss();
} else {
Toast.makeText(LoginActivity.this, "密码修改失败，请重试", Toast.LENGTH_SHORT).show();
}
}
});
dialog.show();
}
/**
* 验证用户名和密码，并返回用户ID
*/
private long validateUser(String username, String password) {
String[] projection = {Users.UserColumns.ID};
String selection = Users.UserColumns.USERNAME + " = ? AND " + Users.UserColumns.PASSWORD + " = ?";
String[] selectionArgs = {username, password};
Cursor cursor = mDb.query(
NotesDatabaseHelper.TABLE.USER,
projection,
selection,
selectionArgs,
null,
null,
null
);
long userId = -1;
if (cursor.moveToFirst()) {
userId = cursor.getLong(cursor.getColumnIndexOrThrow(Users.UserColumns.ID));
}
cursor.close();
return userId;
}
/**
* 检查用户名是否已存在
*/
private boolean isUsernameExists(String username) {
String[] projection = {Users.UserColumns.ID};
String selection = Users.UserColumns.USERNAME + " = ?";
String[] selectionArgs = {username};
Cursor cursor = mDb.query(
NotesDatabaseHelper.TABLE.USER,
projection,
selection,
selectionArgs,
null,
null,
null
);
boolean exists = cursor.getCount() > 0;
cursor.close();
return exists;
}
/**
* 注册用户
*/
private boolean registerUser(String username, String password) {
ContentValues values = new ContentValues();
values.put(Users.UserColumns.USERNAME, username);
values.put(Users.UserColumns.PASSWORD, password);
long result = mDb.insert(NotesDatabaseHelper.TABLE.USER, null, values);
return result != -1;
}
/**
* 修改密码
*/
private boolean changePassword(String username, String newPassword) {
ContentValues values = new ContentValues();
values.put(Users.UserColumns.PASSWORD, newPassword);
values.put(Users.UserColumns.MODIFIED_DATE, System.currentTimeMillis());
String selection = Users.UserColumns.USERNAME + " = ?";
String[] selectionArgs = {username};
int result = mDb.update(
NotesDatabaseHelper.TABLE.USER,
values,
selection,
selectionArgs
);
return result > 0;
}
@Override
protected void onDestroy() {
super.onDestroy();
// 关闭数据库连接
if (mDb != null && mDb.isOpen()) {
mDb.close();
}
}
}

1739
src/Notes-master/src/net/micode/notes/ui/NoteEditActivity.java
View File

File diff suppressed because it is too large Load Diff

446
src/Notes-master/src/net/micode/notes/ui/NoteEditText.java
Unescape View File

@ -14,264 +14,177 @@
* limitations under the License.
*/
// 包声明：归属小米便签的UI模块，该类是便签编辑页的核心自定义输入控件
package net.micode.notes.ui;
// 安卓系统上下文：提供应用运行环境与系统服务访问能力
import android.content.Context;
// 安卓图形矩形类：用于焦点切换时的焦点区域坐标计算与传递
import android.graphics.Color;
import android.graphics.Typeface;
import android.graphics.Rect;
// 安卓文本布局核心类：管理文本的排版、行高、行列定位，核心支撑触摸光标精准定位
import android.text.Layout;
// 安卓文本选择工具类：用于手动设置文本光标位置、选中文本区域
import android.text.Selection;
// 安卓富文本标记接口：标识带格式的文本（如包含链接、颜色的文本），本类核心处理该类型文本
import android.text.Spannable;
import android.text.SpannableStringBuilder;
import android.text.Spanned;
// 安卓文本工具类：提供字符串判空、文本处理等安全高效的工具方法
import android.text.TextPaint;
import android.text.TextUtils;
// 安卓文本链接样式类：封装文本中的超链接数据，包含链接地址与点击事件
import android.text.style.BackgroundColorSpan;
import android.text.style.ClickableSpan;
import android.text.style.ForegroundColorSpan;
import android.text.style.LeadingMarginSpan;
import android.text.style.RelativeSizeSpan;
import android.text.style.StrikethroughSpan;
import android.text.style.StyleSpan;
import android.text.style.TypefaceSpan;
import android.text.style.URLSpan;
// 安卓属性集类：承载布局xml中配置的控件属性，自定义View必备构造参数
import android.text.style.UnderlineSpan;
import android.util.AttributeSet;
// 安卓日志工具类：输出编辑框相关的调试日志，便于问题排查
import android.util.Log;
// 安卓上下文菜单类：构建长按文本弹出的菜单容器
import android.view.ContextMenu;
// 安卓按键事件类：封装物理按键/软键盘按键的事件信息，用于监听回车、删除键
import android.view.KeyEvent;
// 安卓菜单项类：上下文菜单中的单个选项对象
import android.view.MenuItem;
import android.view.MenuItem.OnMenuItemClickListener;
// 安卓触摸事件类：封装屏幕触摸的坐标、动作类型，用于重写触摸定位光标逻辑
import android.view.MotionEvent;
// 安卓原生编辑框：本自定义控件的父类，继承所有原生EditText基础能力
import android.view.inputmethod.InputMethodManager;
import android.widget.EditText;
// 小米便签资源类：引用项目中的字符串、图片等资源文件，此处核心用链接菜单的文本资源
import net.micode.notes.R;
// Java集合类：HashMap存储链接协议与菜单文本的映射关系，实现协议与文案解耦
import java.util.HashMap;
import java.util.Map;
/**
* 小米便签 编辑页核心自定义EditText控件
* 核心定位：继承原生Android EditText，基于便签编辑业务做深度定制扩展，无侵入式修改原生逻辑
* 核心设计原则：重写系统回调方法实现定制化需求，所有扩展逻辑均通过回调接口解耦给上层Activity处理
* 核心扩展能力（六大核心职责）：
* 1. 定制化按键交互：重写回车/删除键逻辑，适配多编辑框联动的核心业务；
* 2. 精准触摸光标定位：修复原生触摸光标偏移问题，优化富文本编辑的触摸体验；
* 3. 富文本链接专属处理：长按识别文本中的链接，弹出自定义上下文菜单并支持一键跳转；
* 4. 焦点状态联动回调：编辑框获焦/失焦时，根据文本是否为空回调上层控制功能按钮显隐；
* 5. 多编辑框索引管理：维护自身在编辑框列表中的索引，支撑增删联动逻辑；
* 6. 完整兼容原生能力：所有重写方法最终都会调用父类实现，保留原生EditText全部功能。
* 富文本编辑框
* <p>
* 该类继承自EditText，实现了富文本编辑的功能，包括加粗、斜体、下划线、删除线、
* 文本颜色、背景颜色、字号大小等功能。它还实现了链接检测和处理功能。
*/
public class NoteEditText extends EditText {
// 日志打印的TAG标识：固定值，便于过滤该控件的所有日志信息
private static final String TAG = "NoteEditText";
// 核心成员变量：当前编辑框在【多编辑框列表】中的索引值
// 作用：用于向Activity回调增删操作时，标识当前操作的编辑框位置，核心支撑多框联动
private int mIndex;
// 核心成员变量：删除键按下瞬间的光标起始位置
// 作用：在onKeyDown中记录、onKeyUp中校验，判断是否触发「删除当前编辑框」的业务逻辑
private int mSelectionStartBeforeDelete;
// ========== 常量区：文本链接的协议头（Scheme）常量 ==========
// 定义安卓原生支持的三大核心链接协议前缀，用于匹配文本中的URLSpan链接类型
private static final String SCHEME_TEL = "tel:"; // 电话链接协议头 → 匹配电话号码链接
private static final String SCHEME_HTTP = "http:"; // 网页链接协议头 → 匹配http/https网页链接
private static final String SCHEME_EMAIL = "mailto:";// 邮箱链接协议头 → 匹配邮件发送链接
private static final String SCHEME_TEL = "tel:" ;
private static final String SCHEME_HTTP = "http:" ;
private static final String SCHEME_EMAIL = "mailto:" ;
/**
* 静态不可变映射表：链接协议头(Scheme) → 上下文菜单文本的资源ID
* 设计模式：静态代码块初始化的常量映射，全局唯一，避免多次创建对象造成内存浪费
* 核心作用：根据识别到的链接协议，自动匹配对应的菜单文本，实现协议与文案的解耦管理
*/
private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
static {
// 初始化映射关系：协议头 → 对应的菜单文本资源ID
sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel); // 电话链接 → 展示「拨打电话」
sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web); // 网页链接 → 展示「打开网页」
sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email); // 邮箱链接 → 展示「发送邮件」
sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);
sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email);
}
/**
* 编辑框状态变化 回调接口【核心解耦设计】
* 设计思想：将所有业务逻辑（增删编辑框、控制显隐）完全抽离到接口中，由上层NoteEditActivity实现
* 核心价值：该控件只负责「触发事件」，不负责「处理事件」，彻底解耦UI控件与业务逻辑，符合单一职责
* Call by the {@link NoteEditActivity} to delete or add edit text
*/
public interface OnTextViewChangeListener {
/**
* 删除当前编辑框的回调方法
* 触发时机：按下删除键 + 光标在文本起始位 + 当前编辑框不是第一个编辑框
* @param index 当前触发删除的编辑框索引
* @param text 当前编辑框中的文本内容，供上层做数据保存
* Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
* and the text is null
*/
void onEditTextDelete(int index, String text);
/**
* 新增编辑框的回调方法
* 触发时机：按下回车键时，自动分割文本并回调上层新增编辑框
* @param index 新增编辑框应该插入的目标索引（当前索引+1）
* @param text 回车光标后的分割文本，作为新增编辑框的初始化内容
* Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
* happen
*/
void onEditTextEnter(int index, String text);
/**
* 文本/焦点状态变化的回调方法
* 触发时机：编辑框获焦/失焦、文本内容变化时
* @param index 当前编辑框的索引
* @param hasText 当前编辑框是否有文本内容 → true显示功能按钮，false隐藏功能按钮
* Hide or show item option when text change
*/
void onTextChange(int index, boolean hasText);
}
// 成员变量：回调接口的实例对象，由上层Activity通过set方法注入
private OnTextViewChangeListener mOnTextViewChangeListener;
/**
* 构造方法一：代码中手动创建控件时调用（无布局属性）
* @param context 应用上下文对象，必传参数
*/
public NoteEditText(Context context) {
super(context, null);
mIndex = 0; // 默认索引为0，代表首个编辑框，后续可通过setIndex重新赋值
mIndex = 0;
}
/**
* 对外提供的设置方法：为当前编辑框绑定在列表中的索引值
* @param index 多编辑框列表中的位置索引
*/
public void setIndex(int index) {
mIndex = index;
}
/**
* 对外提供的设置方法：注入状态变化的回调监听器
* @param listener 实现了OnTextViewChangeListener接口的实例（上层Activity）
*/
public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
mOnTextViewChangeListener = listener;
}
/**
* 构造方法二：布局xml中引用该控件时自动调用（带布局属性）
* 安卓自定义View的标准构造方法，适配布局文件中的属性配置
* @param context 应用上下文
* @param attrs 布局xml中配置的控件属性集
*/
public NoteEditText(Context context, AttributeSet attrs) {
super(context, attrs, android.R.attr.editTextStyle);
}
/**
* 构造方法三：带默认样式的构造方法，适配主题样式定制场景
* 安卓自定义View的完整构造方法，满足所有创建场景，无业务逻辑，仅做父类调用
* @param context 应用上下文
* @param attrs 布局属性集
* @param defStyle 默认样式资源ID
*/
public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
// TODO Auto-generated constructor stub
}
/**
* 重写触摸事件处理方法：核心优化【触摸光标精准定位】
* 原生EditText痛点：触摸文本时光标位置容易偏移，尤其富文本编辑时体验差
* 本方法核心逻辑：将触摸的屏幕坐标，精准转换为文本的行列偏移量，手动设置光标位置
* @param event 触摸事件对象，包含触摸坐标、动作类型等信息
* @return boolean 事件消费标记：返回父类处理结果，不拦截原生触摸逻辑
*/
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN: // 只处理「按下」动作，是触摸的起始事件
// 步骤1：计算触摸点的【文本相对坐标】- 修正内边距与滚动偏移的影响
int x = (int) event.getX();
int y = (int) event.getY();
x -= getTotalPaddingLeft(); // 减去左侧总内边距，得到文本区域内的X坐标
y -= getTotalPaddingTop(); // 减去顶部总内边距，得到文本区域内的Y坐标
x += getScrollX(); // 加上横向滚动偏移，适配文本横向滚动的场景
y += getScrollY(); // 加上纵向滚动偏移，适配文本纵向滚动的场景
// 步骤2：通过文本布局对象，将坐标转换为文本的行列信息
Layout layout = getLayout(); // 获取当前编辑框的文本布局管理器
int line = layout.getLineForVertical(y); // 根据Y坐标获取触摸到的文本行号
int off = layout.getOffsetForHorizontal(line, x); // 根据行号+X坐标获取该行的字符偏移量
// 步骤3：手动设置光标到精准的触摸位置，核心修复原生偏移问题
Selection.setSelection(getText(), off);
break;
// 确保获得焦点，无论是否有内容
if (event.getAction() == MotionEvent.ACTION_DOWN) {
if (!hasFocus()) {
requestFocus();
}
}
// 调用父类方法处理事件
boolean handled = super.onTouchEvent(event);
// 处理点击事件
if (event.getAction() == MotionEvent.ACTION_DOWN) {
// 无论是否有layout，都确保光标在正确位置
setSelection(getText().length());
// 显示软键盘
Context context = getContext();
if (context != null) {
InputMethodManager imm = (InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE);
if (imm != null) {
imm.showSoftInput(this, InputMethodManager.SHOW_IMPLICIT);
}
}
}
// 必须调用父类方法：保留原生的滑动、长按、双击等所有触摸逻辑，只做增量优化
return super.onTouchEvent(event);
return handled;
}
/**
* 重写按键按下事件：预处理核心按键（回车/删除），做事件标记，不做业务逻辑处理
* 核心设计：按键按下时「只记录状态」，按键抬起时「执行业务逻辑」，符合安卓按键事件的处理规范
* 原因：按下事件可能有长按重复触发，抬起事件只会触发一次，保证业务逻辑只执行一次
* @param keyCode 按键码：标识按下的是哪个按键（回车/删除/字母等）
* @param event 按键事件对象，包含按键动作、重复次数等信息
* @return boolean 事件消费标记：false=不消费，交给onKeyUp处理；true=消费，拦截后续处理
*/
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
switch (keyCode) {
case KeyEvent.KEYCODE_ENTER:
// 回车键按下：有监听器则返回false，交给onKeyUp处理分割+新增逻辑，无则走原生逻辑
if (mOnTextViewChangeListener != null) {
return false;
}
break;
case KeyEvent.KEYCODE_DEL:
// 删除键按下：记录此时的光标起始位置，供onKeyUp校验是否触发删除编辑框逻辑
mSelectionStartBeforeDelete = getSelectionStart();
break;
default:
break;
}
// 调用父类方法：处理所有其他按键的原生逻辑，无侵入式修改
return super.onKeyDown(keyCode, event);
}
/**
* 重写按键抬起事件：核心业务逻辑处理入口【重中之重】
* 该方法是本控件的核心，集中处理「回车新增编辑框」「删除当前编辑框」两大核心业务逻辑
* 所有业务逻辑执行完毕后，均调用父类方法，保证原生按键功能不受影响
* @param keyCode 按键码
* @param event 按键事件对象
* @return boolean 事件消费标记：true=已处理业务逻辑，拦截原生行为；false=未处理，走原生逻辑
*/
@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
switch(keyCode) {
case KeyEvent.KEYCODE_DEL:
// ========== 删除键抬起：处理「删除编辑框」核心逻辑 ==========
if (mOnTextViewChangeListener != null) {
// 触发条件【三重校验，缺一不可】：
// 1. 光标在文本的起始位置（0）；2. 当前编辑框不是第一个编辑框（索引≠0）；3. 有回调监听器
if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
// 回调上层Activity：执行删除当前编辑框的逻辑，并传递当前文本内容
mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
return true; // 消费事件，避免原生删除逻辑执行，防止文本内容错乱
return true;
}
} else {
// 无监听器时打印日志，便于调试排查问题
Log.d(TAG, "OnTextViewChangeListener was not seted");
}
break;
case KeyEvent.KEYCODE_ENTER:
// ========== 回车键抬起：处理「分割文本+新增编辑框」核心逻辑 ==========
if (mOnTextViewChangeListener != null) {
int selectionStart = getSelectionStart(); // 获取当前光标位置
// 步骤1：分割文本 → 光标后的内容作为新增编辑框的初始化文本
int selectionStart = getSelectionStart();
String text = getText().subSequence(selectionStart, length()).toString();
// 步骤2：更新当前编辑框文本 → 只保留光标前的内容，完成文本分割
setText(getText().subSequence(0, selectionStart));
// 步骤3：回调上层Activity → 在当前索引+1的位置新增编辑框，并传递分割后的文本
mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);
} else {
Log.d(TAG, "OnTextViewChangeListener was not seted");
@ -280,58 +193,33 @@ public class NoteEditText extends EditText {
default:
break;
}
// 调用父类方法：处理其他按键的原生抬起逻辑，兼容所有原生功能
return super.onKeyUp(keyCode, event);
}
/**
* 重写焦点变化事件：处理「焦点联动功能按钮显隐」的业务逻辑
* 触发时机：编辑框获取焦点/失去焦点时自动调用
* 核心逻辑：失焦时如果文本为空，回调隐藏功能按钮；其他情况回调显示功能按钮
* 设计亮点：只关心「失焦+空文本」的特殊场景，其他场景统一回调显示，逻辑简洁高效
* @param focused 当前是否获取到焦点：true=获焦，false=失焦
* @param direction 焦点变化的方向，系统传递的参数，无实际业务用途
* @param previouslyFocusedRect 上一个焦点控件的矩形区域，系统传递的参数
*/
@Override
protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
if (mOnTextViewChangeListener != null) {
// 核心判断：失焦 并且 文本为空 → 回调隐藏按钮；否则回调显示按钮
if (!focused && TextUtils.isEmpty(getText())) {
mOnTextViewChangeListener.onTextChange(mIndex, false);
} else {
mOnTextViewChangeListener.onTextChange(mIndex, true);
}
}
// 调用父类方法：执行原生的焦点变化逻辑，如光标显示/隐藏、背景色变化等
super.onFocusChanged(focused, direction, previouslyFocusedRect);
}
/**
* 重写上下文菜单创建方法：核心实现「富文本链接的自定义菜单」功能
* 触发时机：长按编辑框中的文本时，系统自动调用该方法创建上下文菜单
* 核心业务逻辑：识别长按区域是否包含链接 → 是则添加自定义链接菜单 → 点击菜单触发链接跳转
* 原生兼容：识别不到链接时，自动调用父类方法创建默认菜单（复制/粘贴/全选等）
* @param menu 系统传入的上下文菜单容器，用于添加自定义菜单项
*/
@Override
protected void onCreateContextMenu(ContextMenu menu) {
// 前置判断：只有文本是【富文本(Spanned)】类型时，才处理链接识别逻辑
if (getText() instanceof Spanned) {
// 步骤1：获取当前光标选中的文本区域，兼容正选/反选两种情况
int selStart = getSelectionStart();
int selEnd = getSelectionEnd();
int min = Math.min(selStart, selEnd); // 选中区域的起始位置
int max = Math.max(selStart, selEnd); // 选中区域的结束位置
// 步骤2：从选中区域中提取所有的URLSpan链接对象
int min = Math.min(selStart, selEnd);
int max = Math.max(selStart, selEnd);
final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
// 步骤3：仅处理「单个链接」的场景，避免多链接冲突，保证菜单的唯一性
if (urls.length == 1) {
int defaultResId = 0; // 初始化菜单文本资源ID
// 步骤4：遍历协议映射表，匹配当前链接的协议类型，获取对应的菜单文本
int defaultResId = 0;
for(String schema: sSchemaActionResMap.keySet()) {
if(urls[0].getURL().indexOf(schema) >= 0) {
defaultResId = sSchemaActionResMap.get(schema);
@ -339,23 +227,217 @@ public class NoteEditText extends EditText {
}
}
// 兜底处理：未匹配到已知协议时，显示「其他链接」的默认文本
if (defaultResId == 0) {
defaultResId = R.string.note_link_other;
}
// 步骤5：向菜单中添加自定义选项，并绑定点击事件
menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
new OnMenuItemClickListener() {
public boolean onMenuItemClick(MenuItem item) {
// 核心逻辑：触发URLSpan原生的点击事件 → 自动跳转对应链接（拨打电话/打开网页/发送邮件）
// goto a new intent
urls[0].onClick(NoteEditText.this);
return true; // 消费菜单点击事件，避免后续处理
return true;
}
});
}
}
// 必须调用父类方法：无链接时创建原生默认菜单（复制、粘贴、剪切、选择全部等），完整兼容原生功能
super.onCreateContextMenu(menu);
}
}
/**
* 设置文字加粗
*/
public void setBold() {
toggleStyle(Typeface.BOLD);
}
/**
* 设置文字斜体
*/
public void setItalic() {
toggleStyle(Typeface.ITALIC);
}
/**
* 设置文字粗斜体
*/
public void setBoldItalic() {
applyStyle(Typeface.BOLD_ITALIC);
}
/**
* 设置文字正常
*/
public void setNormal() {
applyStyle(Typeface.NORMAL);
}
/**
* 切换下划线
*/
public void toggleUnderline() {
toggleSpan(UnderlineSpan.class);
}
/**
* 切换删除线
*/
public void toggleStrikethrough() {
toggleSpan(StrikethroughSpan.class);
}
/**
* 设置文字颜色
*/
public void setTextColor(int color) {
applySpan(new ForegroundColorSpan(color));
}
/**
* 设置文字背景颜色
*/
public void setTextBackgroundColor(int color) {
applySpan(new BackgroundColorSpan(color));
}
/**
* 设置字号大小
*/
public void setTextSize(float size) {
// 将字号稍微放大一些
float adjustedSize = size * 1.1f;
applySpan(new RelativeSizeSpan(adjustedSize));
}
/**
* 设置文字左对齐
*/
public void setAlignLeft() {
setGravity(android.view.Gravity.LEFT);
}
/**
* 设置文字居中对齐
*/
public void setAlignCenter() {
setGravity(android.view.Gravity.CENTER);
}
/**
* 设置文字右对齐
*/
public void setAlignRight() {
setGravity(android.view.Gravity.RIGHT);
}
/**
* 设置文字两端对齐
*/
public void setAlignJustify() {
setGravity(android.view.Gravity.FILL_HORIZONTAL);
}
/**
* 应用样式
*/
private void applyStyle(int style) {
Spannable spannable = getText();
if (spannable == null) return;
int start = getSelectionStart();
int end = getSelectionEnd();
if (start == end) return;
StyleSpan[] spans = spannable.getSpans(start, end, StyleSpan.class);
for (StyleSpan span : spans) {
spannable.removeSpan(span);
}
spannable.setSpan(new StyleSpan(style), start, end, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
setSelection(start, end);
}
/**
* 切换样式
*/
private void toggleStyle(int style) {
Spannable spannable = getText();
if (spannable == null) return;
int start = getSelectionStart();
int end = getSelectionEnd();
if (start == end) return;
// 检查当前样式
boolean hasStyle = false;
StyleSpan[] spans = spannable.getSpans(start, end, StyleSpan.class);
for (StyleSpan span : spans) {
if (span.getStyle() == style) {
hasStyle = true;
spannable.removeSpan(span);
}
}
if (!hasStyle) {
// 没有该样式，添加
spannable.setSpan(new StyleSpan(style), start, end, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
}
setSelection(start, end);
}
/**
* 应用Span
*/
private void applySpan(Object span) {
Spannable spannable = getText();
if (spannable == null) return;
int start = getSelectionStart();
int end = getSelectionEnd();
if (start == end) return;
spannable.setSpan(span, start, end, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
setSelection(start, end);
}
/**
* 切换Span
*/
private void toggleSpan(Class<?> spanClass) {
Spannable spannable = getText();
if (spannable == null) return;
int start = getSelectionStart();
int end = getSelectionEnd();
if (start == end) return;
// 检查当前是否有该Span
boolean hasSpan = false;
try {
Object[] spans = spannable.getSpans(start, end, spanClass);
for (Object span : spans) {
hasSpan = true;
spannable.removeSpan(span);
}
if (!hasSpan) {
// 没有该Span，添加
try {
// 创建该Span的实例
Object newSpan = spanClass.getDeclaredConstructor().newInstance();
spannable.setSpan(newSpan, start, end, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
} catch (Exception e) {
// 捕获所有异常，避免崩溃
e.printStackTrace();
}
}
} catch (Exception e) {
// 捕获所有异常，避免崩溃
e.printStackTrace();
}
setSelection(start, end);
}
}

340
src/Notes-master/src/net/micode/notes/ui/NoteItemData.java
Unescape View File

@ -14,372 +14,258 @@
* limitations under the License.
*/
// 包声明：归属小米便签UI模块，为列表页提供标准化的便签/文件夹数据模型，封装数据库游标解析逻辑
package net.micode.notes.ui;
// 安卓上下文：提供系统服务访问能力，用于联系人查询、内容解析器获取
import android.content.Context;
// 安卓数据库游标：承载数据库查询结果集，是本类核心的数据解析源
import android.database.Cursor;
// 安卓文本工具类：提供字符串判空、文本处理等安全操作方法
import android.text.TextUtils;
// 联系人数据工具类：根据手机号匹配系统通讯录中的联系人姓名
import net.micode.notes.data.Contact;
// 便签核心常量类：定义便签类型、文件夹ID、字段名等全局常量
import net.micode.notes.data.Notes;
// 便签数据库列名常量：数据库表的字段名称枚举，避免硬编码字符串
import net.micode.notes.data.Notes.NoteColumns;
// 便签数据工具类：提供通话记录手机号查询、数据格式化等通用能力
import net.micode.notes.tool.DataUtils;
/**
* 便签列表项核心数据模型类【小米便签核心类】
* 核心定位：MVC架构中的Model层，纯数据载体，无任何UI渲染逻辑
* 核心职责：
* 1. 定义数据库查询的投影字段，精准指定查询列，规避全表查询的性能损耗；
* 2. 从数据库Cursor中解析并封装所有便签/文件夹的业务数据；
* 3. 对通话记录类便签做专属适配，自动关联手机号和联系人名称；
* 4. 智能判断列表项的位置状态，为UI背景样式渲染提供数据支撑；
* 5. 提供只读的getter方法和业务判断方法，对外屏蔽数据细节，保证数据安全；
* 设计原则：单一职责 + 完全封装 + 只读数据 + 业务内聚，解耦性极强
* 便签列表数据传输对象
* <p>
* 该类是专为列表页(NotesListActivity)设计的轻量级数据传输对象，
* 用于从Cursor中提取数据并驱动列表渲染。它包含了便签的基本信息，
* 如ID、类型、内容摘要、修改时间、背景颜色等。
*/
public class NoteItemData {
/**
* 数据库查询投影数组：指定本次查询需要返回的数据库列
* 投影设计原则：按需查询，只获取业务需要的字段，减少内存占用和IO开销
* 字段覆盖：便签/文件夹的基础属性、时间属性、关联属性、扩展属性四大类
*/
static final String[] PROJECTION = new String[]{
NoteColumns.ID, // 0: 便签/文件夹的唯一主键ID
NoteColumns.ALERTED_DATE, // 1: 提醒时间戳（0代表无提醒）
NoteColumns.BG_COLOR_ID, // 2: 背景色ID，用于列表项背景着色
NoteColumns.CREATED_DATE, // 3: 创建时间戳，UTC毫秒值
NoteColumns.HAS_ATTACHMENT, // 4: 是否包含附件 0-无 1-有（图片/音频等）
NoteColumns.MODIFIED_DATE, // 5: 最后修改时间戳，列表页优先展示该时间
NoteColumns.NOTES_COUNT, // 6: 文件夹内包含的便签数量，仅文件夹类型有效
NoteColumns.PARENT_ID, // 7: 父文件夹ID，根目录为Notes.ID_ROOT_FOLDER
NoteColumns.SNIPPET, // 8: 便签内容摘要/文件夹名称，短文本展示用
NoteColumns.TYPE, // 9: 数据类型，区分便签/文件夹/系统项
NoteColumns.WIDGET_ID, // 10: 关联的桌面小部件ID，无效则为默认值
NoteColumns.WIDGET_TYPE // 11: 关联小部件尺寸类型 2x/4x
static final String [] PROJECTION = new String [] {
NoteColumns.ID,
NoteColumns.ALERTED_DATE,
NoteColumns.BG_COLOR_ID,
NoteColumns.CREATED_DATE,
NoteColumns.HAS_ATTACHMENT,
NoteColumns.MODIFIED_DATE,
NoteColumns.NOTES_COUNT,
NoteColumns.PARENT_ID,
NoteColumns.SNIPPET,
NoteColumns.TITLE,
NoteColumns.TYPE,
NoteColumns.WIDGET_ID,
NoteColumns.WIDGET_TYPE,
NoteColumns.PINNED,
NoteColumns.SORT_ORDER,
NoteColumns.LOCKED,
NoteColumns.PUBLIC,
};
/**
* 投影数组列索引常量：与PROJECTION数组字段一一对应
* 设计目的：彻底避免硬编码数字索引，提升代码可读性+可维护性
* 核心价值：修改投影数组字段顺序时，仅需同步修改此处索引，无需改动业务解析代码
*/
private static final int ID_COLUMN = 0;
private static final int ALERTED_DATE_COLUMN = 1;
private static final int BG_COLOR_ID_COLUMN = 2;
private static final int CREATED_DATE_COLUMN = 3;
private static final int HAS_ATTACHMENT_COLUMN = 4;
private static final int MODIFIED_DATE_COLUMN = 5;
private static final int NOTES_COUNT_COLUMN = 6;
private static final int PARENT_ID_COLUMN = 7;
private static final int SNIPPET_COLUMN = 8;
private static final int TYPE_COLUMN = 9;
private static final int WIDGET_ID_COLUMN = 10;
private static final int WIDGET_TYPE_COLUMN = 11;
// ===================== 核心业务数据字段 - 与投影数组一一映射 =====================
// 访问规则：全部私有，仅通过getter方法访问，无setter，数据只读，保证一致性
private long mId; // 便签/文件夹唯一ID，数据库主键
private long mAlertDate; // 提醒时间戳，>0表示该便签设置了提醒
private int mBgColorId; // 背景色ID，对应预设的颜色值，列表项渲染用
private long mCreatedDate; // 便签创建时间戳
private boolean mHasAttachment; // 是否包含附件，数据库int转Java布尔值，贴合业务语义
private long mModifiedDate; // 最后修改时间戳，列表页展示的核心时间字段
private int mNotesCount; // 文件夹内便签数量，仅TYPE_FOLDER类型有效
private long mParentId; // 父文件夹ID，通话记录便签固定为通话记录文件夹ID
private String mSnippet; // 便签纯文本摘要/文件夹名称，已清理勾选标记
private int mType; // 数据类型：Notes.TYPE_NOTE/文件夹/系统项
private int mWidgetId; // 关联桌面小部件ID，无效则为INVALID_APPWIDGET_ID
private int mWidgetType; // 关联小部件尺寸类型，2x/4x两种规格
// ===================== 通话记录专属扩展字段 =====================
private String mName; // 通话记录联系人姓名，无则显示手机号
private String mPhoneNumber; // 通话记录对应的手机号，仅通话便签有值
// ===================== 列表位置状态字段 - 纯UI渲染支撑 =====================
// 作用：标记当前项在列表中的位置，用于适配不同的背景样式（圆角/分割线/边距等）
private boolean mIsLastItem; // 是否为列表最后一条数据
private boolean mIsFirstItem; // 是否为列表第一条数据
private boolean mIsOnlyOneItem; // 是否为列表中唯一的一条数据
private boolean mIsOneNoteFollowingFolder; // 文件夹后的唯一一条便签项
private boolean mIsMultiNotesFollowingFolder;// 文件夹后的第一条便签（后续还有更多项）
/**
* 唯一构造方法：私有化核心初始化逻辑，从Cursor解析所有数据并完成对象初始化
* 设计特点：全参构造，一次性完成所有数据赋值，无空构造，保证对象完整性
* @param context 应用上下文，用于获取内容解析器、查询联系人信息，不可为空
* @param cursor 数据库查询结果游标，已移动到目标行，不可为空/已关闭
*/
public static final int ID_COLUMN = 0;
private static final int ALERTED_DATE_COLUMN = 1;
private static final int BG_COLOR_ID_COLUMN = 2;
private static final int CREATED_DATE_COLUMN = 3;
private static final int HAS_ATTACHMENT_COLUMN = 4;
private static final int MODIFIED_DATE_COLUMN = 5;
private static final int NOTES_COUNT_COLUMN = 6;
private static final int PARENT_ID_COLUMN = 7;
private static final int SNIPPET_COLUMN = 8;
private static final int TITLE_COLUMN = 9;
private static final int TYPE_COLUMN = 10;
private static final int WIDGET_ID_COLUMN = 11;
private static final int WIDGET_TYPE_COLUMN = 12;
private static final int PINNED_COLUMN = 13;
private static final int SORT_ORDER_COLUMN = 14;
private static final int LOCKED_COLUMN = 15;
private static final int PUBLIC_COLUMN = 16;
private long mId;
private long mAlertDate;
private int mBgColorId;
private long mCreatedDate;
private boolean mHasAttachment;
private long mModifiedDate;
private int mNotesCount;
private long mParentId;
private String mSnippet;
private String mTitle;
private int mType;
private int mWidgetId;
private int mWidgetType;
private boolean mPinned;
private int mSortOrder;
private boolean mLocked;
private boolean mPublic;
private String mName;
private String mPhoneNumber;
private boolean mIsLastItem;
private boolean mIsFirstItem;
private boolean mIsOnlyOneItem;
private boolean mIsOneNoteFollowingFolder;
private boolean mIsMultiNotesFollowingFolder;
public NoteItemData(Context context, Cursor cursor) {
// 第一步：解析数据库核心字段，与投影数组索引一一对应，基础数据初始化
mId = cursor.getLong(ID_COLUMN);
mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
// 数据库存储为int(0/1)，转换为业务语义更清晰的boolean类型
mHasAttachment = cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0;
mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;
mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
mParentId = cursor.getLong(PARENT_ID_COLUMN);
// 解析摘要文本，并清理勾选框标记标签，仅保留纯文本内容，优化展示效果
mSnippet = cursor.getString(SNIPPET_COLUMN);
mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
NoteEditActivity.TAG_UNCHECKED, "");
mTitle = cursor.getString(TITLE_COLUMN);
mType = cursor.getInt(TYPE_COLUMN);
mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
mPinned = (cursor.getInt(PINNED_COLUMN) > 0) ? true : false;
mSortOrder = cursor.getInt(SORT_ORDER_COLUMN);
mLocked = (cursor.getInt(LOCKED_COLUMN) > 0) ? true : false;
mPublic = (cursor.getInt(PUBLIC_COLUMN) > 0) ? true : false;
// 第二步：通话记录便签专属解析逻辑，仅父文件夹为通话记录文件夹时触发
mPhoneNumber = "";
if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
// 根据便签ID查询关联的通话手机号
mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
// 手机号非空时，查询系统通讯录匹配联系人姓名
if (!TextUtils.isEmpty(mPhoneNumber)) {
mName = Contact.getContact(context, mPhoneNumber);
// 无匹配联系人时，手机号作为联系人名称兜底展示
if (mName == null) {
mName = mPhoneNumber;
}
}
}
// 第三步：空值兜底处理，防止空指针异常，生产级代码必备容错逻辑
if (mName == null) {
mName = "";
}
// 第四步：自动判断当前项在列表中的位置状态，为UI渲染提供数据支撑
checkPostion(cursor);
}
/**
* 私有核心方法：解析当前Cursor所在行的列表位置状态，初始化位置标记字段
* 核心作用：为列表项的背景样式提供精准的状态标记，不同位置展示不同样式
* 设计亮点：Cursor位置移动后必回位，防止游标位置错乱导致后续解析异常
* @param cursor 数据库游标，已定位到当前数据行
*/
private void checkPostion(Cursor cursor) {
// 初始化基础位置状态：首项、尾项、唯一项
mIsLastItem = cursor.isLast();
mIsFirstItem = cursor.isFirst();
mIsOnlyOneItem = cursor.getCount() == 1;
// 初始化文件夹子项状态为默认值false
mIsLastItem = cursor.isLast() ? true : false;
mIsFirstItem = cursor.isFirst() ? true : false;
mIsOnlyOneItem = (cursor.getCount() == 1);
mIsMultiNotesFollowingFolder = false;
mIsOneNoteFollowingFolder = false;
// 核心业务判断：仅处理【普通便签】且【非列表首项】的场景
if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
// 记录当前游标位置，用于后续回位，防止位置丢失
int currentPosition = cursor.getPosition();
// 游标上移一行，判断上一项是否为【文件夹】或【系统项】
int position = cursor.getPosition();
if (cursor.moveToPrevious()) {
int prevItemType = cursor.getInt(TYPE_COLUMN);
if (prevItemType == Notes.TYPE_FOLDER || prevItemType == Notes.TYPE_SYSTEM) {
// 上一项是文件夹/系统项 → 当前项是文件夹的子项第一条
if (cursor.getCount() > currentPosition + 1) {
// 后续还有更多数据 → 标记为多子项的第一条
if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
|| cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
if (cursor.getCount() > (position + 1)) {
mIsMultiNotesFollowingFolder = true;
} else {
// 后续无数据 → 标记为文件夹后的唯一子项
mIsOneNoteFollowingFolder = true;
}
}
// 游标回位到原位置，必须执行，否则会导致后续数据解析错位
if (!cursor.moveToNext()) {
// 回位失败时主动抛异常，快速定位问题，避免隐性bug
throw new IllegalStateException("cursor move to previous but can't move back");
}
}
}
}
/**
* 业务判断方法：当前项是否为【文件夹后的唯一便签项】
* @return true-是 false-否
*/
public boolean isOneFollowingFolder() {
return mIsOneNoteFollowingFolder;
}
/**
* 业务判断方法：当前项是否为【文件夹后的第一条便签（后续还有项）】
* @return true-是 false-否
*/
public boolean isMultiFollowingFolder() {
return mIsMultiNotesFollowingFolder;
}
/**
* 位置判断方法：当前项是否为列表最后一项
* @return true-是 false-否
*/
public boolean isLast() {
return mIsLastItem;
}
/**
* 数据访问方法：获取通话记录的联系人名称（无则返回手机号）
* @return 联系人姓名/手机号 空则返回空字符串
*/
public String getCallName() {
return mName;
}
/**
* 位置判断方法：当前项是否为列表第一项
* @return true-是 false-否
*/
public boolean isFirst() {
return mIsFirstItem;
}
/**
* 位置判断方法：当前项是否为列表中唯一的一项
* @return true-是 false-否
*/
public boolean isSingle() {
return mIsOnlyOneItem;
}
/**
* 基础数据访问：获取便签/文件夹唯一ID
* @return 数据库主键ID，long类型
*/
public long getId() {
return mId;
}
/**
* 基础数据访问：获取提醒时间戳
* @return 提醒时间UTC毫秒值，0表示无提醒
*/
public long getAlertDate() {
return mAlertDate;
}
/**
* 基础数据访问：获取创建时间戳
* @return 创建时间UTC毫秒值
*/
public long getCreatedDate() {
return mCreatedDate;
}
/**
* 业务判断方法：当前便签是否包含附件（图片/音频等）
* @return true-有附件 false-无附件
*/
public boolean hasAttachment() {
return mHasAttachment;
}
/**
* 基础数据访问：获取最后修改时间戳（列表页优先展示）
* @return 修改时间UTC毫秒值
*/
public long getModifiedDate() {
return mModifiedDate;
}
/**
* 基础数据访问：获取背景色ID
* @return 预设的颜色ID值，用于列表项背景渲染
*/
public int getBgColorId() {
return mBgColorId;
}
/**
* 基础数据访问：获取父文件夹ID
* @return 父文件夹主键ID，通话记录为固定常量ID
*/
public long getParentId() {
return mParentId;
}
/**
* 基础数据访问：获取文件夹内便签数量
* @return 数量值，仅文件夹类型有效，便签类型返回无意义值
*/
public int getNotesCount() {
return mNotesCount;
}
/**
* 兼容适配方法：等价于getParentId()，适配外部旧调用逻辑
* 设计目的：向下兼容，无侵入式修改原有业务代码
* @return 父文件夹主键ID
*/
public long getFolderId() {
public long getFolderId () {
return mParentId;
}
/**
* 基础数据访问：获取数据类型
* @return 类型值：Notes.TYPE_NOTE/文件夹/系统项
*/
public int getType() {
return mType;
}
/**
* 基础数据访问：获取关联小部件类型
* @return 小部件尺寸类型 2x/4x
*/
public int getWidgetType() {
return mWidgetType;
}
/**
* 基础数据访问：获取关联小部件ID
* @return 小部件ID，无效则为INVALID_APPWIDGET_ID
*/
public int getWidgetId() {
return mWidgetId;
}
/**
* 基础数据访问：获取清理后的纯文本摘要/文件夹名称
* @return 无勾选标记的纯文本短内容
*/
public int getWidgetType() {
return mWidgetType;
}
public int getWidgetId() {
return mWidgetId;
}
public String getSnippet() {
return mSnippet;
}
/**
* 核心业务判断方法：当前便签是否设置了提醒
* 封装细节：屏蔽「时间戳判0」的技术细节，对外提供业务语义
* @return true-有提醒 false-无提醒
*/
public boolean hasAlert() {
return mAlertDate > 0;
return (mAlertDate > 0);
}
/**
* 核心业务判断方法：当前项是否为【通话记录便签】
* 判断条件：父文件夹是通话记录文件夹 + 手机号非空，双重校验保证准确性
* @return true-通话记录便签 false-普通便签/文件夹
*/
public boolean isCallRecord() {
return mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber);
return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
}
public boolean isPinned() {
return mPinned;
}
public int getSortOrder() {
return mSortOrder;
}
public boolean isLocked() {
return mLocked;
}
public boolean isPublic() {
return mPublic;
}
public String getTitle() {
return mTitle;
}
/**
* 静态工具方法：无需创建对象，快速从Cursor获取便签类型
* 性能优化点：避免为了单个字段创建完整对象实例，适配列表适配器高频调用场景
* 对外赋能：给外部适配器提供轻量级的类型查询能力
* @param cursor 数据库游标，已定位到目标行
* @return 便签类型值
*/
public static int getNoteType(Cursor cursor) {
return cursor.getInt(TYPE_COLUMN);
}
}
}

2598
src/Notes-master/src/net/micode/notes/ui/NotesListActivity.java
View File

File diff suppressed because it is too large Load Diff

199
src/Notes-master/src/net/micode/notes/ui/NotesListAdapter.java
Unescape View File

@ -14,231 +14,133 @@
* limitations under the License.
*/
// 包声明：小米便签 核心UI模块，该包承载应用所有可视化交互页面及配套适配器，本类为列表页核心数据适配桥梁
package net.micode.notes.ui;
// -------------------------- 安卓系统核心依赖包 - 上下文/数据库/日志/视图/适配器能力 --------------------------
// 安卓应用全局上下文：提供资源访问、视图创建、数据解析等基础能力，适配器必备依赖
import android.content.Context;
// 安卓数据库游标核心类：封装数据库查询结果集，承载便签数据表的查询数据，列表展示的核心数据来源
import android.database.Cursor;
// 安卓系统日志工具类：输出适配器运行的调试/错误日志，便于问题定位与线上排查
import android.util.Log;
// 安卓视图体系核心类：视图创建、视图容器的核心父类，适配列表项的创建与挂载
import android.view.View;
import android.view.ViewGroup;
// 安卓游标适配器基类：专为Cursor数据设计的列表适配器，封装数据绑定、视图复用、数据变化监听等核心能力，本类的核心父类
import android.widget.CursorAdapter;
// -------------------------- 小米便签业务层核心依赖 - 数据常量/集合工具 --------------------------
// 小米便签数据层核心常量类：定义便签/文件夹/小部件的类型、特殊ID、业务状态等全局核心常量
import net.micode.notes.data.Notes;
// Java集合框架相关类：封装选中项状态的存储、遍历、统计，支撑批量选择模式的核心逻辑
import java.util.Collection;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
/**
* 小米便签 列表页核心数据适配器
* 便签列表适配器
* <p>
* 继承安卓系统{CursorAdapter}游标适配器，隶属于MVC架构的UI层适配桥梁，是{NotesListActivity}与数据库/Cursor数据、{NotesListItem}列表项之间的核心纽带；
* 核心设计定位：封装Cursor数据库数据与列表项视图的绑定逻辑，统一管理列表的展示规则、选择模式、数据变化监听，解耦列表页的业务逻辑与数据渲染逻辑；
* 核心业务职责：创建并复用自定义列表项视图、将Cursor数据映射为业务模型并绑定至列表项、完整支撑批量选择模式的所有操作（单选/全选/取消全选/选中状态维护）、
* 统计选中项数据与普通便签总数、提取选中项的小部件关联属性、监听数据库数据变化并实时刷新视图；
* 技术实现特点：基于安卓原生CursorAdapter实现视图复用，提升列表滑动性能；通过HashMap维护选中项状态，保证选择操作的高效性；
* 封装数据统计与业务属性提取逻辑，对外提供简洁的调用接口；自动监听数据库数据变化，保证视图与数据的一致性。
* </p>
* 该类是便签列表的适配器，用于将数据库中的便签数据绑定到列表项视图上。
* 它支持选择模式、搜索高亮和小部件属性管理等功能。
*/
public class NotesListAdapter extends CursorAdapter {
/** 日志常量标签：适配器相关日志的统一标识，便于日志过滤与问题定位 */
private static final String TAG = "NotesListAdapter";
/** 应用上下文对象：用于创建列表项视图、解析业务数据，全局复用避免多次创建 */
private Context mContext;
/** 选中项状态映射容器：核心数据结构，Key=列表项的索引位置，Value=该位置的选中状态，支撑选择模式的核心存储 */
private HashMap<Integer, Boolean> mSelectedIndex;
/** 普通便签数量统计：仅统计{Notes.TYPE_NOTE}类型的项，排除文件夹/通话记录等类型，用于全选状态的判定依据 */
private int mNotesCount;
/** 选择模式状态标记：true=开启批量选择模式（批量操作），false=关闭选择模式（普通浏览），控制列表项勾选框的显隐 */
private boolean mChoiceMode;
private String mSearchQuery;
/**
* 内部静态数据载体类：便签关联的桌面小部件属性封装
* 核心设计目的：批量操作场景下，统一封装选中便签所绑定的桌面小部件核心属性，便于后续同步更新小部件数据，
* 静态类设计减少内存开销，无上下文引用避免内存泄漏
* 小部件属性类
* <p>
* 用于存储小部件的ID和类型信息
*/
public static class AppWidgetAttribute {
/** 小部件系统唯一标识ID：桌面小部件的注册ID，用于精准定位目标小部件 */
public int widgetId;
/** 小部件类型标识：区分2x/4x两种尺寸的便签小部件，对应{Notes.TYPE_WIDGET_2X}/{Notes.TYPE_WIDGET_4X} */
public int widgetType;
};
/**
* 构造方法：适配器的初始化入口，完成核心成员变量的初始化配置
* 核心初始化逻辑：调用父类构造方法完成基础配置、初始化选中状态映射容器、保存上下文引用、重置普通便签统计数，
* 初始无绑定Cursor，后续通过{changeCursor}方法动态绑定数据库查询结果
* @param context 应用上下文对象，传递至父类并全局保存
*/
public NotesListAdapter(Context context) {
// 父类构造：传入上下文+空Cursor，Cursor数据后续动态绑定，保证初始化灵活性
super(context, null);
// 初始化选中项状态映射容器，空HashMap保证初始无选中项
mSelectedIndex = new HashMap<Integer, Boolean>();
// 保存应用上下文引用，供后续视图创建与数据解析使用
mContext = context;
// 重置普通便签统计数量为0，初始无数据状态
mNotesCount = 0;
mSearchQuery = null;
}
// 设置搜索查询
public void setSearchQuery(String query) {
mSearchQuery = query;
notifyDataSetChanged();
}
/**
* 重写父类核心方法：创建新的列表项视图
* 执行时机：列表首次加载、滑动时需要创建新视图的场景，遵循安卓视图复用机制
* 核心逻辑：创建自定义的{NotesListItem}列表项视图并返回，该方法仅负责视图创建，不负责数据绑定
* @param context 应用上下文对象
* @param cursor 当前位置的数据库游标（本方法未使用，仅遵循父类接口规范）
* @param parent 列表项的父容器，即承载所有列表项的ListView
* @return View 创建完成的、未绑定数据的自定义列表项视图
*/
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {
// 创建小米便签自定义列表项视图，作为列表的最小展示单元
return new NotesListItem(context);
}
/**
* 重写父类核心方法：数据与视图的绑定核心实现
* 执行时机：列表首次加载、视图复用、数据变化刷新时调用，是适配器的核心业务方法
* 核心逻辑：将指定位置的Cursor数据库数据，解析为业务数据模型{NoteItemData}，并调用列表项的绑定方法，
* 完成数据渲染、选择模式适配、选中状态赋值，实现「数据→模型→视图」的完整映射
* @param view 待绑定数据的列表项视图，为{NotesListItem}类型，支持视图复用
* @param context 应用上下文对象
* @param cursor 当前列表位置的数据库游标，封装了该位置的完整便签数据
*/
@Override
public void bindView(View view, Context context, Cursor cursor) {
// 类型安全校验：仅处理自定义的NotesListItem视图，防止视图类型错误导致崩溃
if (view instanceof NotesListItem) {
// 将Cursor数据库数据解析为业务数据模型，封装所有展示所需的业务字段
NoteItemData itemData = new NoteItemData(context, cursor);
// 调用列表项的核心绑定方法，完成数据渲染+选择模式适配+选中状态赋值
((NotesListItem) view).bind(context, itemData, mChoiceMode,
isSelectedItem(cursor.getPosition()));
isSelectedItem(cursor.getPosition()), mSearchQuery);
}
}
/**
* 公开业务方法：设置指定位置列表项的选中状态
* 核心作用：单选操作的核心接口，支持选择模式下的单个列表项勾选/取消勾选，
* 更新状态后主动通知列表刷新视图，保证选中状态的实时展示
* @param position 待设置状态的列表项索引位置
* @param checked 目标选中状态，true=勾选，false=取消勾选
*/
public void setCheckedItem(final int position, final boolean checked) {
// 更新选中状态映射容器，保存当前位置的选中状态
mSelectedIndex.put(position, checked);
// 通知列表数据发生变化，触发视图刷新，展示最新的选中状态
notifyDataSetChanged();
}
/**
* 公开查询方法：获取当前列表的选择模式状态
* @return boolean true=处于批量选择模式，false=处于普通浏览模式
*/
public boolean isInChoiceMode() {
return mChoiceMode;
}
/**
* 公开业务方法：开启/关闭列表的批量选择模式
* 核心逻辑：切换模式时自动清空所有选中状态，避免模式切换后残留选中标记，保证视图展示的一致性，
* 是选择模式的总开关接口
* @param mode true=开启选择模式，false=关闭选择模式
*/
public void setChoiceMode(boolean mode) {
// 清空所有选中项状态，重置选择容器为初始状态
mSelectedIndex.clear();
// 更新选择模式标记，控制后续视图绑定的逻辑分支
mChoiceMode = mode;
}
/**
* 公开业务方法：全选/取消全选的批量操作
* 核心规则：仅对{Notes.TYPE_NOTE}类型的普通便签生效，文件夹/通话记录等特殊类型不参与选择，
* 避免用户误操作系统特殊项，保证业务数据的安全性
* @param checked true=执行全选操作，false=执行取消全选操作
*/
public void selectAll(boolean checked) {
// 获取当前绑定的数据库游标，遍历所有列表项数据
Cursor cursor = getCursor();
for (int i = 0; i < getCount(); i++) {
// 移动游标到当前列表项的位置，匹配对应数据
if (cursor.moveToPosition(i)) {
// 仅处理普通便签类型，过滤文件夹等非选择项
if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
// 批量设置当前位置的选中状态
setCheckedItem(i, checked);
}
}
}
}
/**
* 公开业务方法：获取所有选中项的便签ID集合
* 核心作用：批量删除/批量移动等业务操作的核心数据来源，返回去重的选中便签ID，
* 自动过滤根文件夹等无效ID并输出日志提示，保证业务数据的有效性
* @return HashSet<Long> 所有选中便签的ID集合，无选中项则返回空集合
*/
public HashSet<Long> getSelectedItemIds() {
HashSet<Long> itemSet = new HashSet<Long>();
// 遍历所有已记录的选中状态位置
for (Integer position : mSelectedIndex.keySet()) {
// 仅处理选中状态为true的有效项
if (mSelectedIndex.get(position) == true) {
// 获取当前位置对应的便签ID
Long id = getItemId(position);
// 过滤系统根文件夹的无效ID，避免业务操作异常
if (id == Notes.ID_ROOT_FOLDER) {
Log.d(TAG, "Wrong item id, should not happen");
} else {
// 将有效ID添加至结果集合
itemSet.add(id);
Cursor cursor = getCursor();
if (cursor != null) {
for (Integer position : mSelectedIndex.keySet()) {
if (mSelectedIndex.get(position) == true) {
if (cursor.moveToPosition(position)) {
long id = cursor.getLong(NoteItemData.ID_COLUMN);
if (id != Notes.ID_ROOT_FOLDER) {
itemSet.add(id);
}
}
}
}
}
return itemSet;
}
/**
* 公开业务方法：获取所有选中项关联的小部件属性集合
* 核心作用：批量操作后同步更新桌面小部件的核心数据来源，提取选中便签所绑定的小部件ID与类型，
* 自动校验游标有效性，异常时输出错误日志并返回null，保证数据安全性
* @return HashSet<AppWidgetAttribute> 选中项的小部件属性集合，无效数据时返回null
*/
public HashSet<AppWidgetAttribute> getSelectedWidget() {
HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
// 遍历所有已记录的选中状态位置
for (Integer position : mSelectedIndex.keySet()) {
// 仅处理选中状态为true的有效项
if (mSelectedIndex.get(position) == true) {
// 获取当前位置对应的数据库游标
Cursor c = (Cursor) getItem(position);
if (c != null) {
// 创建小部件属性对象，封装核心数据
AppWidgetAttribute widget = new AppWidgetAttribute();
// 将游标数据解析为业务模型，提取小部件关联属性
NoteItemData item = new NoteItemData(mContext, c);
widget.widgetId = item.getWidgetId();
widget.widgetType = item.getWidgetType();
// 添加至结果集合
itemSet.add(widget);
/**
* 重要说明：此处不主动关闭Cursor
* Cursor由CursorAdapter统一管理生命周期，外部关闭会导致列表数据异常、游标越界等崩溃问题
* Don't close cursor here, only the adapter could close it
*/
} else {
// 游标无效时输出错误日志，返回null标记异常状态
Log.e(TAG, "Invalid cursor");
return null;
}
@ -247,18 +149,11 @@ public class NotesListAdapter extends CursorAdapter {
return itemSet;
}
/**
* 公开业务方法：统计当前选中的普通便签数量
* 核心作用：列表页展示选中数量、判定全选状态的核心依据，仅统计选中状态为true的有效项，保证计数准确性
* @return int 选中的普通便签数量，无选中项则返回0
*/
public int getSelectedCount() {
// 获取所有已记录的选中状态值集合
Collection<Boolean> values = mSelectedIndex.values();
if (null == values) {
return 0;
}
// 遍历状态值，统计选中状态为true的项数
Iterator<Boolean> iter = values.iterator();
int count = 0;
while (iter.hasNext()) {
@ -269,80 +164,42 @@ public class NotesListAdapter extends CursorAdapter {
return count;
}
/**
* 公开业务方法：判断当前是否处于「全选」状态
* 核心判定规则：选中数量大于0 且 选中数量等于列表中普通便签的总数，双条件保证判定准确性，
* 避免无数据时误判为全选、选中部分项时误判为全选
* @return boolean true=已全选所有普通便签，false=未全选/无选中项/无普通便签
*/
public boolean isAllSelected() {
int checkedCount = getSelectedCount();
return (checkedCount != 0 && checkedCount == mNotesCount);
}
/**
* 公开查询方法：判断指定位置的列表项是否被选中
* 核心规则：未记录状态的位置默认视为「未选中」，避免空指针异常，保证业务逻辑的健壮性
* @param position 待查询的列表项索引位置
* @return boolean true=该位置已选中，false=该位置未选中/无状态记录
*/
public boolean isSelectedItem(final int position) {
// 状态容器中无该位置记录时，默认返回未选中
if (null == mSelectedIndex.get(position)) {
return false;
}
// 返回该位置的实际选中状态
return mSelectedIndex.get(position);
}
/**
* 重写父类回调方法：监听数据库内容变化的核心回调
* 触发时机：当适配器绑定的数据库表数据发生增/删/改操作时，系统自动调用该方法
* 核心逻辑：执行父类默认刷新逻辑后，重新统计普通便签数量，保证全选状态判定的准确性，
* 是视图与数据库数据一致性的核心保障
*/
@Override
protected void onContentChanged() {
super.onContentChanged();
// 数据变化后重新统计普通便签数量
calcNotesCount();
}
/**
* 重写父类核心方法：更换适配器绑定的游标数据
* 触发时机：列表页切换文件夹、刷新数据、查询条件变更时主动调用
* 核心逻辑：执行父类游标更换逻辑后，重新统计普通便签数量，适配新数据集的全选判定规则
* @param cursor 新的数据库游标，封装了新的查询结果集
*/
@Override
public void changeCursor(Cursor cursor) {
super.changeCursor(cursor);
// 更换游标后重新统计普通便签数量
calcNotesCount();
}
/**
* 私有核心方法：统计列表中普通便签的总数
* 核心业务规则：仅遍历统计{Notes.TYPE_NOTE}类型的项，排除文件夹、通话记录等非便签类型，
* 自动校验游标有效性，异常时终止统计并输出日志，保证计数准确性，是全选功能的核心支撑方法
*/
private void calcNotesCount() {
// 重置计数为0，避免累计统计错误
mNotesCount = 0;
// 遍历适配器绑定的所有列表项数据
for (int i = 0; i < getCount(); i++) {
// 获取当前位置对应的数据库游标
Cursor c = (Cursor) getItem(i);
if (c != null) {
// 仅统计普通便签类型的项
if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
mNotesCount++;
}
} else {
// 游标无效时输出错误日志，终止统计避免数据异常
Log.e(TAG, "Invalid cursor");
return;
}
}
}
}
}

213
src/Notes-master/src/net/micode/notes/ui/NotesListItem.java
Unescape View File

@ -14,88 +14,53 @@
* limitations under the License.
*/
// 包声明：小米便签 核心UI模块，该包承载应用所有可视化交互页面及自定义UI组件，本类为列表页核心子项组件
package net.micode.notes.ui;
// -------------------------- 安卓系统核心依赖包 - 上下文/视图/布局/基础控件能力 --------------------------
// 安卓应用全局上下文：提供资源访问、样式加载、布局渲染等基础能力，自定义控件必备依赖
import android.content.Context;
// 安卓系统时间格式化工具类：提供相对时间格式化能力，将时间戳转为「几分钟前/昨天/上周」等友好展示格式
import android.text.format.DateUtils;
// 安卓视图体系核心父类：控制控件的显示/隐藏、可见性状态、视图属性等核心操作
import android.view.View;
// 安卓复选框控件：列表选择模式下的核心勾选组件，用于便签的批量操作场景
import android.widget.CheckBox;
// 安卓图片展示控件：承载提醒图标、通话记录图标等所有图片类展示内容
import android.widget.ImageView;
// 安卓线性布局容器：本类的父布局，提供横向/纵向的线性控件排列能力，作为列表项的根布局
import android.widget.LinearLayout;
// 安卓文本展示控件：承载所有文本类展示内容，如标题、时间、通话名称等
import android.widget.TextView;
// -------------------------- 小米便签业务层核心依赖 - 资源/数据/工具适配 --------------------------
// 小米便签资源常量类：统一管理布局、字符串、样式、图片等所有本地资源ID引用
import net.micode.notes.R;
// 小米便签数据层核心常量类：定义便签/文件夹的类型、特殊ID、业务状态等全局核心常量
import net.micode.notes.data.Notes;
// 小米便签数据格式化工具类：封装便签摘要文本的格式化处理逻辑，统一文本展示规则
import net.micode.notes.tool.DataUtils;
// 小米便签资源解析工具类：封装便签/文件夹的背景资源适配逻辑，提供不同状态的背景资源获取能力
import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
/**
* 小米便签 列表页核心自定义列表项组件
* 便签列表项视图
* <p>
* 继承安卓系统{LinearLayout}线性布局，隶属于MVC架构的UI层视图组件，是{NotesListActivity}列表页的最小展示单元；
* 核心设计定位：作为便签列表的标准化子项容器，封装所有列表项的UI渲染逻辑、数据绑定逻辑、样式适配逻辑，解耦列表页与子项展示逻辑；
* 核心业务职责：统一承载所有类型便签/文件夹的差异化展示、选择模式的UI适配、提醒状态的图标展示、背景样式的精准适配、通话记录的专属布局；
* 技术实现特点：基于数据驱动视图的设计思想，通过统一的bind方法完成数据与视图的绑定，内置多分支逻辑适配不同业务类型，
* 封装背景设置的复杂逻辑，对外提供简洁的调用与数据获取接口，是列表页高性能展示的核心基础组件。
* </p>
* 该类是便签列表的列表项视图，负责显示单个便签的信息，包括标题、时间、提醒图标、
* 锁定图标、分类标签等。它还包含复杂的背景圆角计算逻辑，根据首项、末项、单项动态设置背景。
*/
public class NotesListItem extends LinearLayout {
/** 功能图标控件：展示闹钟提醒、通话记录等业务类型图标，不同场景展示对应功能标识 */
private ImageView mAlert;
/** 主标题文本控件：核心文本展示区，适配展示便签摘要、文件夹名称+数量、通话记录内容等核心信息 */
private ImageView mLock;
private ImageView mPublic;
private TextView mTitle;
/** 时间文本控件：展示便签/文件夹的最后修改时间，统一格式化为相对友好时间格式 */
private TextView mTime;
/** 通话名称文本控件：通话记录专属展示区，仅通话记录项展示来电/去电的联系人名称，其他场景隐藏 */
private TextView mCallName;
/** 数据模型载体：保存当前列表项绑定的业务数据，用于后续视图刷新与数据获取 */
private TextView mCategory;
private NoteItemData mItemData;
/** 选择复选框控件：批量操作模式专属控件，用于勾选待操作的便签，非选择模式下默认隐藏 */
private CheckBox mCheckBox;
/**
* 构造方法：自定义控件的初始化入口
* 核心初始化逻辑：加载列表项的基础布局文件，完成所有子控件的视图绑定，为后续数据绑定做准备；
* 该方法仅在列表项创建时执行一次，保证控件初始化的性能最优
* @param context 应用上下文对象，用于加载布局资源与查找子控件
*/
public NotesListItem(Context context) {
super(context);
// 加载列表项的基础布局文件，将xml布局解析为当前线性布局的子视图
inflate(context, R.layout.note_item, this);
// 绑定布局内所有子控件，通过ID精准获取并赋值给成员变量
mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
mLock = (ImageView) findViewById(R.id.iv_lock_icon);
mPublic = (ImageView) findViewById(R.id.iv_public_icon);
mTitle = (TextView) findViewById(R.id.tv_title);
mTime = (TextView) findViewById(R.id.tv_time);
mCallName = (TextView) findViewById(R.id.tv_name);
mCategory = (TextView) findViewById(R.id.tv_category);
mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
}
/**
* 核心公开绑定方法：数据与视图的统一绑定入口，列表项所有展示逻辑的核心处理方法
* 核心业务能力：接收业务数据模型，根据数据类型/状态/模式完成所有视图的差异化渲染，包括控件显隐、文本赋值、图标切换、样式适配、勾选状态设置；
* 该方法为列表项的核心对外接口，列表页通过调用此方法完成所有子项的内容展示
* @param context 应用上下文，用于资源加载、样式设置、字符串格式化
* @param data 当前列表项对应的业务数据模型，承载所有展示所需的业务字段
* @param choiceMode 是否开启列表选择模式：true=批量操作模式，false=普通浏览模式
* @param checked 选择模式下当前项的勾选状态：true=已勾选，false=未勾选
*/
public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
// 选择模式适配逻辑：仅普通便签在选择模式下展示勾选框，其他类型/模式均隐藏，防止误操作文件夹
public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked, String searchQuery) {
if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
mCheckBox.setVisibility(View.VISIBLE);
mCheckBox.setChecked(checked);
@ -103,106 +68,146 @@ public class NotesListItem extends LinearLayout {
mCheckBox.setVisibility(View.GONE);
}
// 缓存当前绑定的业务数据模型，供后续背景设置与外部数据获取使用
mItemData = data;
// ===== 分支一：通话记录专属文件夹（系统特殊固定ID），独立的展示样式 =====
if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
mCallName.setVisibility(View.GONE);
mAlert.setVisibility(View.VISIBLE);
mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
// 标题展示规则：固定文件夹名称 + 文件夹内的通话记录数量，格式化展示
mTitle.setText(context.getString(R.string.call_record_folder_name)
+ context.getString(R.string.format_folder_files_count, data.getNotesCount()));
// 展示通话记录专属图标，明确业务类型标识
mAlert.setImageResource(R.drawable.call_record);
}
// ===== 分支二：通话记录子项（归属通话记录文件夹），通话类专属展示样式 =====
else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
} else if (data.getId() == Notes.ID_TRASH_FOLER) {
mCallName.setVisibility(View.GONE);
mAlert.setVisibility(View.VISIBLE);
mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
mTitle.setText("回收站"
+ context.getString(R.string.format_folder_files_count, data.getNotesCount()));
// 使用现有的clock图标作为临时垃圾桶图标
mAlert.setImageResource(R.drawable.clock);
} else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
mCallName.setVisibility(View.VISIBLE);
mCallName.setText(data.getCallName());
mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
// 标题展示格式化后的通话记录摘要内容，保证文本展示的规范性
mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
// 提醒状态适配：有闹钟提醒则展示闹钟图标，无则隐藏
String formattedSnippet = DataUtils.getFormattedSnippet(data.getSnippet());
mTitle.setText(highlightText(formattedSnippet, searchQuery, context));
if (data.hasAlert()) {
mAlert.setImageResource(R.drawable.clock);
mAlert.setVisibility(View.VISIBLE);
} else {
mAlert.setVisibility(View.GONE);
}
}
// ===== 分支三：普通业务类型（普通文件夹/普通便签），通用展示样式 =====
else {
mCallName.setVisibility(View.GONE);
mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
} else {
mCallName.setVisibility(View.GONE);
mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
// 子分支1：普通文件夹类型，展示文件夹名称+包含便签数量
if (data.getType() == Notes.TYPE_FOLDER) {
mTitle.setText(data.getSnippet()
+ context.getString(R.string.format_folder_files_count,
data.getNotesCount()));
mAlert.setVisibility(View.GONE);
}
// 子分支2：普通便签类型，展示便签核心摘要内容
else {
mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
// 提醒状态适配：有闹钟提醒展示闹钟图标，无则隐藏
if (data.hasAlert()) {
mAlert.setImageResource(R.drawable.clock);
mAlert.setVisibility(View.VISIBLE);
} else {
if (data.getType() == Notes.TYPE_FOLDER) {
mTitle.setText(data.getSnippet()
+ context.getString(R.string.format_folder_files_count,
data.getNotesCount()));
mAlert.setVisibility(View.GONE);
} else {
// 显示标题，如果标题为空则显示内容摘要
String displayText;
if (data.getTitle() != null && !data.getTitle().isEmpty()) {
displayText = data.getTitle();
} else {
String formattedSnippet = DataUtils.getFormattedSnippet(data.getSnippet());
displayText = formattedSnippet;
}
mTitle.setText(highlightText(displayText, searchQuery, context));
if (data.hasAlert()) {
mAlert.setImageResource(R.drawable.clock);
mAlert.setVisibility(View.VISIBLE);
} else {
mAlert.setVisibility(View.GONE);
}
}
}
}
// 统一设置最后修改时间：将时间戳转为「几分钟前/昨天」等相对友好的时间格式，提升用户体验
mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
// 根据当前绑定的数据模型，完成列表项背景样式的精准适配
// 设置分类标签，优先使用标题进行分类
String contentForCategory = data.getTitle();
if (contentForCategory == null || contentForCategory.isEmpty()) {
contentForCategory = data.getSnippet();
}
String category = net.micode.notes.tool.CategoryUtil.autoCategorize(contentForCategory);
mCategory.setText(category);
// 处理锁定图标
if (data.isLocked() && data.getType() == Notes.TYPE_NOTE) {
mLock.setVisibility(View.VISIBLE);
mLock.setImageResource(R.drawable.clock); // 使用clock图标作为锁图标
} else {
mLock.setVisibility(View.GONE);
}
// 处理公开图标
if (data.isPublic() && data.getType() == Notes.TYPE_NOTE) {
mPublic.setVisibility(View.VISIBLE);
mPublic.setImageResource(R.drawable.call_record); // 使用call_record图标作为公开图标，与置顶图标区分
} else {
mPublic.setVisibility(View.GONE);
}
// 处理置顶和提醒图标
if (data.isPinned() && data.getType() == Notes.TYPE_NOTE) {
mAlert.setVisibility(View.VISIBLE);
mAlert.setImageResource(R.drawable.selected); // 使用selected图标作为置顶图标
} else if (data.hasAlert() && data.getType() == Notes.TYPE_NOTE) {
mAlert.setVisibility(View.VISIBLE);
mAlert.setImageResource(R.drawable.call_record); // 使用call_record图标作为提醒图标
} else {
mAlert.setVisibility(View.GONE);
}
setBackground(data);
}
/**
* 私有核心方法：列表项背景样式的统一适配处理
* 核心业务逻辑：封装复杂的背景适配规则，区分普通便签与文件夹的不同背景策略；
* 普通便签根据列表中的位置（首项/中项/尾项/单独项）+ 背景色ID，匹配对应的背景资源；
* 文件夹统一使用固定背景，简化适配逻辑，保证列表样式的统一性与美观性
* @param data 当前列表项绑定的业务数据模型，提供背景色ID、类型、列表位置等适配所需字段
*/
private void setBackground(NoteItemData data) {
// 获取当前数据模型的背景色标识ID，作为背景资源匹配的核心依据
int id = data.getBgColorId();
// 普通便签的背景适配逻辑：多场景精准匹配，保证列表连贯的视觉效果
if (data.getType() == Notes.TYPE_NOTE) {
if (data.isSingle() || data.isOneFollowingFolder()) {
// 场景1：列表中唯一项 / 文件夹下的唯一项 → 使用独立完整背景
setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
} else if (data.isLast()) {
// 场景2：列表中的最后一项 → 使用底部收尾样式背景
setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
} else if (data.isFirst() || data.isMultiFollowingFolder()) {
// 场景3：列表中的第一项 / 文件夹下的多项首项 → 使用顶部起始样式背景
setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
} else {
// 场景4：列表中的中间项 → 使用标准连贯样式背景
setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
}
}
// 文件夹类型统一适配逻辑：所有文件夹（含通话记录文件夹）使用固定背景样式
else {
} else {
setBackgroundResource(NoteItemBgResources.getFolderBgRes());
}
}
/**
* 公开数据获取方法：获取当前列表项绑定的业务数据模型
* 核心作用：为列表页提供数据访问接口，列表页可通过该方法获取选中项、点击项的业务数据，完成跳转/删除/编辑等后续操作；
* 是视图组件与业务逻辑之间的核心数据桥梁
* @return NoteItemData 当前列表项绑定的完整业务数据模型
*/
// 高亮匹配的文本
private CharSequence highlightText(String text, String searchQuery, Context context) {
if (text == null || searchQuery == null || searchQuery.isEmpty()) {
return text;
}
android.text.SpannableString spannable = new android.text.SpannableString(text);
try {
String lowerText = text.toLowerCase();
String lowerQuery = searchQuery.toLowerCase();
int startIndex = lowerText.indexOf(lowerQuery);
while (startIndex != -1) {
int endIndex = startIndex + searchQuery.length();
spannable.setSpan(
new android.text.style.BackgroundColorSpan(context.getResources().getColor(R.color.user_query_highlight)),
startIndex, endIndex, android.text.Spanned.SPAN_INCLUSIVE_EXCLUSIVE);
startIndex = lowerText.indexOf(lowerQuery, endIndex);
}
} catch (Exception e) {
// 处理可能的异常，比如空指针或索引越界
return text;
}
return spannable;
}
public NoteItemData getItemData() {
return mItemData;
}
}
}

604
src/Notes-master/src/net/micode/notes/ui/NotesPreferenceActivity.java
Unescape View File

@ -14,176 +14,184 @@
* limitations under the License.
*/
// 包声明：小米便签 核心UI业务模块，承载应用所有可视化交互页面，本类为应用设置页核心实现
package net.micode.notes.ui;
// -------------------------- 安卓系统核心依赖包 - 账号/页面/弹窗/广播/数据存储能力 --------------------------
// 安卓账号体系核心类：封装Google账号的账号名、账号类型等基础信息载体
import android.accounts.Account;
// 安卓账号管理核心服务类：系统级账号管理器，负责设备上所有账号的查询、管理、鉴权等操作
import android.accounts.AccountManager;
// 安卓顶部导航栏核心类：配置页面导航样式、返回按钮、标题等ActionBar相关属性
import android.app.ActionBar;
// 安卓系统弹窗核心类：构建标准化的对话框，承载账号选择、确认提示等交互弹窗
import android.app.AlertDialog;
// 安卓广播核心组件：监听系统/应用内部的广播消息，本类用于监听同步服务状态变更广播
import android.content.BroadcastReceiver;
// 安卓数据封装类：封装键值对数据，用于ContentProvider执行数据库字段更新操作
import android.content.ContentValues;
// 安卓应用全局上下文：提供资源访问、组件通信、偏好设置读写等核心基础能力
import android.content.Context;
// 安卓对话框交互核心接口：监听弹窗选项的点击事件，处理用户选择逻辑
import android.content.DialogInterface;
// 安卓组件通信核心类：封装页面跳转指令、广播指令、参数传递，实现跨组件通信
import android.content.Intent;
// 安卓广播过滤核心类：筛选需要监听的广播动作，精准匹配目标广播消息
import android.content.IntentFilter;
// 安卓轻量级存储核心类：键值对持久化存储，用于保存应用偏好配置，非数据库存储
import android.content.SharedPreferences;
// 安卓页面状态存储类：保存页面销毁重建时的临时数据，保证页面状态不丢失
import android.os.Bundle;
// 安卓系统偏好设置组件：构建设置页面的标准化UI控件，封装设置项的展示与交互逻辑
import android.preference.Preference;
import android.preference.Preference.OnPreferenceClickListener;
import android.preference.PreferenceActivity;
import android.preference.PreferenceCategory;
// 安卓文本工具类：封装字符串判空、内容对比等常用操作，避免空指针与硬编码判断
import android.text.TextUtils;
// 安卓系统日期格式化工具类：标准化格式化时间戳为指定样式的字符串，适配多语言展示
import android.text.format.DateFormat;
// 安卓布局加载核心类：将xml布局文件解析为Java视图对象，加载自定义布局与弹窗样式
import android.view.LayoutInflater;
// 安卓页面菜单核心类：配置ActionBar右侧菜单的创建与点击事件处理
import android.view.Menu;
import android.view.MenuItem;
// 安卓视图体系核心类：操作所有可视化控件的父类，实现控件的点击、赋值、显隐等操作
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
// 安卓轻量级提示组件：展示短时操作结果提示，无焦点不阻塞用户交互
import android.widget.Toast;
// -------------------------- 小米便签业务层核心依赖 - 资源/数据/同步服务 --------------------------
// 小米便签资源常量类：统一管理布局、字符串、颜色、样式等所有本地资源ID引用
import net.micode.notes.R;
// 小米便签数据层核心常量类：定义便签ContentProvider URI、数据表字段、业务常量等核心配置
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
// 小米便签核心同步服务类：封装便签与Google Task的双向同步逻辑，提供同步启停、状态查询等核心能力
import net.micode.notes.gtask.remote.GTaskSyncService;
/**
* 小米便签 应用核心设置页面Activity
* <p>
* 继承安卓系统{PreferenceActivity}，隶属于MVC架构的UI层核心业务页面，是便签应用的全局配置中心；
* 核心设计定位：统一承载应用所有用户可配置项，聚焦「Google账号绑定与GTask云同步」核心能力，兼顾基础偏好配置；
* 核心业务职责：Google账号的绑定/切换/移除管理、手动同步/取消同步操作、同步状态实时展示、同步时间持久化、
* 偏好配置读写、同步服务广播监听、页面导航与交互反馈，是便签应用云同步能力的唯一配置入口；
* 技术实现特点：通过SharedPreferences实现轻量级配置持久化，通过广播接收器实现同步状态实时刷新，
* 通过异步线程处理数据库更新避免主线程阻塞，通过系统账号管理器实现Google账号的标准化管理。
* </p>
* 便签设置活动类
* 负责管理应用的各种设置选项，包括账户同步、密码设置、好友管理和背景更换等功能
* 提供用户界面来配置应用行为和个性化选项
*
* 架构设计：
* - 继承自PreferenceActivity，使用传统偏好设置界面
* - 支持Google账户同步配置
* - 集成密码设置功能，保护用户隐私
* - 提供好友管理入口
* - 支持背景更换功能
*
* 核心功能：
* - 账户同步管理：添加、修改、删除Google账户
* - 密码设置：设置和修改应用密码
* - 好友管理：进入好友管理界面
* - 背景更换：进入背景设置界面
* - 同步状态显示：显示上次同步时间和同步进度
*/
public class NotesPreferenceActivity extends PreferenceActivity {
/**
* 全局常量：SharedPreferences偏好设置存储文件名，应用所有配置项均持久化存储在该文件中，单文件统一管理
* 偏好设置文件名
*/
public static final String PREFERENCE_NAME = "notes_preferences";
/**
* 全局常量：偏好配置存储键 - 当前绑定的Google同步账号名，核心云同步关联标识
* 同步账户名偏好键
*/
public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
/**
* 全局常量：偏好配置存储键 - 最后一次同步成功的时间戳，用于展示同步历史记录
* 上次同步时间偏好键
*/
public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
/**
* 全局常量：偏好配置存储键 - 便签背景色随机展示开关，控制新建便签的背景色展示策略
* 背景颜色设置偏好键
*/
public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
/**
* 私有常量：偏好设置分类标识 - 账号同步相关配置项的分类容器Key，用于页面UI组件定位
* 密码偏好键
*/
private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
public static final String PREFERENCE_PASSWORD_KEY = "pref_key_password";
/**
* 私有常量：系统账号过滤标识 - 添加新账号时的权限过滤关键字，用于精准筛选Google账号类型
* 密码设置状态偏好键
*/
public static final String PREFERENCE_PASSWORD_SET_KEY = "pref_key_password_set";
private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
private static final String PREFERENCE_PASSWORD_SETTING_KEY = "pref_password_setting_key";
private static final String AUTHORITIES_FILTER_KEY = "authorities";
/**
* 页面核心控件：账号同步相关的偏好设置分类容器，承载账号选择配置项的父组件
*/
private PreferenceCategory mAccountCategory;
/**
* 核心广播接收器：监听GTaskSyncService的同步状态广播，实现同步中/同步完成的UI实时刷新
*/
private GTaskReceiver mReceiver;
/**
* 账号缓存数组：存储操作前的设备Google账号列表，用于对比判断是否新增账号
*/
private Account[] mOriAccounts;
/**
* 状态标记位：标记是否触发了系统添加账号的操作，用于页面恢复时的账号自动绑定逻辑
*/
private boolean mHasAddedAccount;
/**
* 重写页面生命周期：页面创建初始化入口方法
* 执行时机：页面第一次被创建时调用，仅执行一次
* 核心初始化逻辑：配置ActionBar导航样式、加载偏好设置页面布局、初始化核心控件、注册同步状态广播接收器、
* 添加页面自定义头部布局，完成页面所有基础初始化工作，为后续交互做准备
* @param icicle 页面状态存储Bundle，恢复重建时的临时数据载体
*/
@Override
protected void onCreate(Bundle icicle) {
super.onCreate(icicle);
/* 配置ActionBar导航：启用左上角返回按钮，跳转回便签列表页 */
/* using the app icon for navigation */
getActionBar().setDisplayHomeAsUpEnabled(true);
// 从xml资源加载设置页面的标准化偏好配置UI结构，页面主体内容初始化
addPreferencesFromResource(R.xml.preferences);
// 根据标识获取账号同步分类容器控件，完成核心控件绑定
mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
// 初始化同步状态广播接收器，注册监听同步服务的状态变更广播
// Add password setting preference
Preference passwordPreference = new Preference(this);
passwordPreference.setTitle(getString(R.string.preferences_password_title));
passwordPreference.setSummary(getString(R.string.preferences_password_summary));
passwordPreference.setOnPreferenceClickListener(new OnPreferenceClickListener() {
public boolean onPreferenceClick(Preference preference) {
showPasswordSettingDialog();
return true;
}
});
// Add friend management preference
Preference friendPreference = new Preference(this);
friendPreference.setTitle("好友");
friendPreference.setSummary("管理和查看好友的公开便签");
friendPreference.setOnPreferenceClickListener(new OnPreferenceClickListener() {
public boolean onPreferenceClick(Preference preference) {
// 启动好友管理活动
Intent intent = new Intent(NotesPreferenceActivity.this, FriendManagementActivity.class);
startActivity(intent);
return true;
}
});
// Add change background preference
Preference changeBackgroundPreference = new Preference(this);
changeBackgroundPreference.setTitle("更换背景");
changeBackgroundPreference.setSummary("更换便签界面的背景图片");
changeBackgroundPreference.setOnPreferenceClickListener(new OnPreferenceClickListener() {
public boolean onPreferenceClick(Preference preference) {
// 直接启动NoteEditActivity并传递更换背景的标志
Intent intent = new Intent(NotesPreferenceActivity.this, NoteEditActivity.class);
intent.putExtra("CHANGE_BACKGROUND", true);
startActivity(intent);
return true;
}
});
PreferenceCategory generalCategory = (PreferenceCategory) getPreferenceScreen().getPreference(1);
generalCategory.addPreference(passwordPreference);
generalCategory.addPreference(friendPreference);
generalCategory.addPreference(changeBackgroundPreference);
mReceiver = new GTaskReceiver();
IntentFilter filter = new IntentFilter();
filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
registerReceiver(mReceiver, filter);
// 初始化账号缓存数组与状态标记位，默认无账号无新增操作
mOriAccounts = null;
mHasAddedAccount = false;
// 加载自定义页面头部布局并添加至列表顶部，丰富页面视觉层级
View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
getListView().addHeaderView(header, null, true);
}
/**
* 重写页面生命周期：页面恢复可见状态回调方法
* 执行时机：页面从后台切回前台、弹窗关闭后、页面创建后首次展示时调用
* 核心业务逻辑：检测是否触发过添加账号操作，若有则自动绑定新增的Google账号；刷新页面所有UI控件状态，
* 保证页面展示的账号信息、同步按钮、同步状态均为最新数据，是页面数据一致性的核心保障
*/
@Override
protected void onResume() {
super.onResume();
// 检测添加账号标记位，处理新增账号的自动绑定逻辑
// need to set sync account automatically if user has added a new
// account
if (mHasAddedAccount) {
Account[] accounts = getGoogleAccounts();
// 对比操作前后的账号数量，判断是否有新账号添加成功
if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
for (Account accountNew : accounts) {
boolean found = false;
// 遍历原始账号列表，过滤已存在的账号
for (Account accountOld : mOriAccounts) {
if (TextUtils.equals(accountOld.name, accountNew.name)) {
found = true;
break;
}
}
// 匹配到新增账号，自动完成绑定并终止遍历
if (!found) {
setSyncAccount(accountNew.name);
break;
@ -192,53 +200,36 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
}
// 统一刷新页面所有UI组件状态，保证数据与视图一致
refreshUI();
}
/**
* 重写页面生命周期：页面销毁回收资源回调方法
* 执行时机：页面退出、被销毁时调用，仅执行一次
* 核心优化逻辑：注销已注册的广播接收器，释放系统资源，防止内存泄漏，是安卓组件开发的必做优化项
*/
@Override
protected void onDestroy() {
// 安全注销广播接收器，判空避免空指针异常
if (mReceiver != null) {
unregisterReceiver(mReceiver);
}
super.onDestroy();
}
/**
* 私有核心方法：加载并初始化账号同步偏好配置项
* 核心业务逻辑：动态构建账号选择配置项，绑定点击事件，实现「未绑定账号展示选择弹窗、已绑定账号展示变更弹窗」的交互逻辑，
* 同步中禁用账号操作防止数据异常，是账号管理能力的核心实现
*/
private void loadAccountPreference() {
// 清空分类容器内原有配置项，避免重复添加导致的UI重复展示问题
mAccountCategory.removeAll();
// 新建账号选择偏好配置项，初始化展示文案与交互行为
Preference accountPref = new Preference(this);
final String defaultAccount = getSyncAccountName(this);
accountPref.setTitle(getString(R.string.preferences_account_title));
accountPref.setSummary(getString(R.string.preferences_account_summary));
// 绑定配置项点击事件，处理账号选择与变更的核心交互逻辑
accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
public boolean onPreferenceClick(Preference preference) {
// 同步中禁止账号操作，防止同步数据与账号信息不一致导致异常
if (!GTaskSyncService.isSyncing()) {
if (TextUtils.isEmpty(defaultAccount)) {
// 未绑定账号：展示账号选择弹窗，供用户选择绑定
// the first time to set account
showSelectAccountAlertDialog();
} else {
// 已绑定账号：展示账号变更确认弹窗，提示风险并提供操作选项
// if the account has already been set, we need to promp
// user about the risk
showChangeAccountConfirmAlertDialog();
}
} else {
// 同步中操作拦截，展示友好的吐司提示
Toast.makeText(NotesPreferenceActivity.this,
R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
.show();
@ -247,23 +238,15 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
});
// 将配置项添加至分类容器，完成UI渲染
mAccountCategory.addPreference(accountPref);
}
/**
* 私有核心方法：加载并初始化同步按钮与同步状态展示控件
* 核心业务逻辑：根据同步服务的运行状态，动态切换按钮文本与点击事件（立即同步/取消同步）；
* 展示同步进度或最后同步时间；无绑定账号时禁用同步按钮，是同步能力的核心交互入口实现
*/
private void loadSyncButton() {
// 获取页面同步按钮与同步状态文本控件，完成视图绑定
Button syncButton = (Button) findViewById(R.id.preference_sync_button);
TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
// 根据同步服务状态，动态配置按钮行为与文本
// set button state
if (GTaskSyncService.isSyncing()) {
// 同步中状态：按钮文本为取消同步，点击触发同步终止逻辑
syncButton.setText(getString(R.string.preferences_button_sync_cancel));
syncButton.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
@ -271,7 +254,6 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
});
} else {
// 未同步状态：按钮文本为立即同步，点击触发同步启动逻辑
syncButton.setText(getString(R.string.preferences_button_sync_immediately));
syncButton.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
@ -279,16 +261,13 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
});
}
// 无绑定账号时禁用同步按钮，避免无账号同步的无效操作
syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
// 配置同步状态文本展示逻辑，区分同步中与历史同步记录
// set last sync time
if (GTaskSyncService.isSyncing()) {
// 同步中：展示实时同步进度文案
lastSyncTimeView.setText(GTaskSyncService.getProgressString());
lastSyncTimeView.setVisibility(View.VISIBLE);
} else {
// 未同步：读取最后同步时间戳，展示格式化的历史同步记录
long lastSyncTime = getLastSyncTime(this);
if (lastSyncTime != 0) {
lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
@ -296,185 +275,137 @@ public class NotesPreferenceActivity extends PreferenceActivity {
lastSyncTime)));
lastSyncTimeView.setVisibility(View.VISIBLE);
} else {
// 无同步记录：隐藏状态文本，简化页面展示
lastSyncTimeView.setVisibility(View.GONE);
}
}
}
/**
* 私有统一刷新方法：页面UI状态刷新总入口
* 核心职责：统一调用账号配置项与同步按钮的加载方法，实现页面所有核心控件的状态刷新，
* 简化多处刷新逻辑的调用成本，保证刷新行为的一致性
*/
private void refreshUI() {
loadAccountPreference();
loadSyncButton();
}
/**
* 私有弹窗方法：展示Google账号选择对话框
* 核心业务逻辑：展示设备上已有的Google账号列表供用户选择绑定；提供添加新账号入口跳转系统设置；
* 选择账号后自动完成绑定并刷新页面，是账号绑定的核心交互弹窗实现
*/
private void showSelectAccountAlertDialog() {
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
// 加载自定义弹窗标题布局，初始化弹窗头部文案
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
dialogBuilder.setCustomTitle(titleView);
dialogBuilder.setPositiveButton(null, null);
// 获取设备上所有Google账号，构建账号选择列表
Account[] accounts = getGoogleAccounts();
String defAccount = getSyncAccountName(this);
// 缓存当前账号列表，用于后续新增账号判断
mOriAccounts = accounts;
mHasAddedAccount = false;
// 存在Google账号时，构建单选列表供用户选择
if (accounts.length > 0) {
CharSequence[] items = new CharSequence[accounts.length];
final CharSequence[] itemMapping = items;
int checkedItem = -1;
int index = 0;
for (Account account : accounts) {
if (TextUtils.equals(account.name, defAccount)) {
checkedItem = index;
}
items[index++] = account.name;
}
// 绑定列表选择事件，选择后完成账号绑定并关闭弹窗
dialogBuilder.setSingleChoiceItems(items, checkedItem,
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
setSyncAccount(itemMapping[which].toString());
dialog.dismiss();
refreshUI();
}
});
}
// 加载添加新账号的自定义视图，提供账号新增入口
View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
dialogBuilder.setView(addAccountView);
// 展示弹窗并绑定添加账号点击事件，跳转系统账号添加页面
final AlertDialog dialog = dialogBuilder.show();
addAccountView.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
mHasAddedAccount = true;
Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
"gmail-ls"
});
startActivityForResult(intent, -1);
dialog.dismiss();
}
});
}
private void showSelectAccountAlertDialog() {
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
/**
* 私有弹窗方法：展示账号变更/移除确认对话框
* 核心业务逻辑：针对已绑定账号的场景，展示风险提示与操作选项（更改账号/移除账号/取消）；
* 处理账号变更与解绑逻辑，是账号管理的核心确认交互弹窗实现
*/
private void showChangeAccountConfirmAlertDialog() {
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
// 加载自定义弹窗标题布局，展示当前绑定账号与风险提示
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
getSyncAccountName(this)));
TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
dialogBuilder.setCustomTitle(titleView);
// 构建弹窗操作选项，绑定点击事件处理不同操作逻辑
CharSequence[] menuItemArray = new CharSequence[] {
getString(R.string.preferences_menu_change_account),
getString(R.string.preferences_menu_remove_account),
getString(R.string.preferences_menu_cancel)
};
dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
if (which == 0) {
// 选择更改账号：跳转账号选择弹窗
showSelectAccountAlertDialog();
} else if (which == 1) {
// 选择移除账号：执行账号解绑逻辑
removeSyncAccount();
refreshUI();
}
}
});
dialogBuilder.show();
}
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
dialogBuilder.setCustomTitle(titleView);
dialogBuilder.setPositiveButton(null, null);
Account[] accounts = getGoogleAccounts();
String defAccount = getSyncAccountName(this);
mOriAccounts = accounts;
mHasAddedAccount = false;
if (accounts.length > 0) {
CharSequence[] items = new CharSequence[accounts.length];
final CharSequence[] itemMapping = items;
int checkedItem = -1;
int index = 0;
for (Account account : accounts) {
if (TextUtils.equals(account.name, defAccount)) {
checkedItem = index;
}
items[index++] = account.name;
}
dialogBuilder.setSingleChoiceItems(items, checkedItem,
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
setSyncAccount(itemMapping[which].toString());
dialog.dismiss();
refreshUI();
}
});
}
View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
dialogBuilder.setView(addAccountView);
final AlertDialog dialog = dialogBuilder.show();
addAccountView.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
mHasAddedAccount = true;
Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
"gmail-ls"
});
startActivityForResult(intent, -1);
dialog.dismiss();
}
});
}
private void showChangeAccountConfirmAlertDialog() {
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
getSyncAccountName(this)));
TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
dialogBuilder.setCustomTitle(titleView);
CharSequence[] menuItemArray = new CharSequence[] {
getString(R.string.preferences_menu_change_account),
getString(R.string.preferences_menu_remove_account),
getString(R.string.preferences_menu_cancel)
};
dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
if (which == 0) {
showSelectAccountAlertDialog();
} else if (which == 1) {
removeSyncAccount();
refreshUI();
}
}
});
dialogBuilder.show();
}
/**
* 私有工具方法：获取设备上所有已登录的Google账号列表
* 核心实现：通过系统账号管理器，根据Google账号类型精准筛选，返回纯净的Google账号数组，
* 是账号管理能力的基础数据来源
* @return Account[] 设备上所有com.google类型的账号数组，无账号则返回空数组
*/
private Account[] getGoogleAccounts() {
AccountManager accountManager = AccountManager.get(this);
return accountManager.getAccountsByType("com.google");
}
/**
* 私有核心方法：设置当前绑定的Google同步账号
* 核心业务逻辑：更新偏好配置中的账号信息、清空历史同步时间、异步清理本地便签的同步关联字段、
* 展示操作成功提示；账号未变化时不执行任何操作，避免无效处理，是账号绑定的核心业务逻辑实现
* @param account 待绑定的Google账号名
*/
private void setSyncAccount(String account) {
// 账号未发生变化时，直接返回避免无效操作
if (!getSyncAccountName(this).equals(account)) {
// 写入偏好配置，持久化存储绑定的账号名
SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
SharedPreferences.Editor editor = settings.edit();
if (account != null) {
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
} else {
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
}
editor.commit();
// 账号变更后清空历史同步时间，保证同步记录的准确性
setLastSyncTime(this, 0);
// 异步线程清理本地便签的同步关联字段，避免主线程阻塞导致页面卡顿
new Thread(new Runnable() {
public void run() {
ContentValues values = new ContentValues();
values.put(NoteColumns.GTASK_ID, "");
values.put(NoteColumns.SYNC_ID, 0);
getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
}
}).start();
// 展示账号绑定成功的友好提示
Toast.makeText(NotesPreferenceActivity.this,
getString(R.string.preferences_toast_success_set_accout, account),
Toast.LENGTH_SHORT).show();
}
}
private void setSyncAccount(String account) {
if (!getSyncAccountName(this).equals(account)) {
SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
SharedPreferences.Editor editor = settings.edit();
if (account != null) {
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
} else {
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
}
editor.commit();
// clean up last sync time
setLastSyncTime(this, 0);
// clean up local gtask related info
new Thread(new Runnable() {
public void run() {
ContentValues values = new ContentValues();
values.put(NoteColumns.GTASK_ID, "");
values.put(NoteColumns.SYNC_ID, 0);
getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
}
}).start();
Toast.makeText(NotesPreferenceActivity.this,
getString(R.string.preferences_toast_success_set_accout, account),
Toast.LENGTH_SHORT).show();
}
}
/**
* 私有核心方法：移除当前绑定的Google同步账号，完成账号解绑
* 核心业务逻辑：清理偏好配置中的账号名与同步时间、异步清理本地便签的同步关联字段，
* 彻底解除本地便签与原账号的云同步关联，是账号解绑的核心业务逻辑实现
*/
private void removeSyncAccount() {
// 读取偏好配置并清理账号与同步时间相关配置项
SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
SharedPreferences.Editor editor = settings.edit();
if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
@ -485,7 +416,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
editor.commit();
// 异步线程清理本地便签的同步关联字段，释放系统资源
// clean up local gtask related info
new Thread(new Runnable() {
public void run() {
ContentValues values = new ContentValues();
@ -496,24 +427,12 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}).start();
}
/**
* 公开静态工具方法：获取当前绑定的Google同步账号名
* 全局通用能力：供应用其他组件调用，获取同步账号信息，解耦配置读取逻辑
* @param context 应用上下文，用于访问偏好配置
* @return String 当前绑定的账号名，无绑定则返回空字符串
*/
public static String getSyncAccountName(Context context) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
}
/**
* 公开静态工具方法：设置最后一次同步的时间戳
* 全局通用能力：供同步服务调用，持久化同步完成时间，解耦配置写入逻辑
* @param context 应用上下文，用于访问偏好配置
* @param time 同步完成的时间戳（毫秒值）
*/
public static void setLastSyncTime(Context context, long time) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
@ -522,37 +441,104 @@ public class NotesPreferenceActivity extends PreferenceActivity {
editor.commit();
}
/**
* 公开静态工具方法：获取最后一次同步的时间戳
* 全局通用能力：供应用其他组件调用，读取同步历史时间，解耦配置读取逻辑
* @param context 应用上下文，用于访问偏好配置
* @return long 最后同步时间戳，无记录则返回0
*/
public static long getLastSyncTime(Context context) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
}
/**
* 内部私有广播接收器类：监听GTask同步服务的状态变更广播
* 核心设计定位：页面与同步服务的通信桥梁，无耦合监听同步状态变化；
* 核心职责：接收同步中/同步完成的广播消息，触发页面UI刷新，展示实时同步进度，
* 是同步状态实时更新的核心实现，生命周期与宿主页面一致
*/
public static boolean isPasswordSet(Context context) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
return settings.getBoolean(PREFERENCE_PASSWORD_SET_KEY, false);
}
public static String getPassword(Context context) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
return settings.getString(PREFERENCE_PASSWORD_KEY, "");
}
private void setPassword(String password) {
SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
SharedPreferences.Editor editor = settings.edit();
editor.putString(PREFERENCE_PASSWORD_KEY, password);
editor.putBoolean(PREFERENCE_PASSWORD_SET_KEY, !TextUtils.isEmpty(password));
editor.commit();
}
private void showPasswordSettingDialog() {
final boolean hasPassword = isPasswordSet(this);
View view = LayoutInflater.from(this).inflate(R.layout.password_setting_dialog, null);
final EditText currentPasswordEdit = (EditText) view.findViewById(R.id.current_password);
final EditText newPasswordEdit = (EditText) view.findViewById(R.id.new_password);
final EditText confirmPasswordEdit = (EditText) view.findViewById(R.id.confirm_password);
final TextView currentPasswordLabel = (TextView) view.findViewById(R.id.current_password_label);
if (!hasPassword) {
currentPasswordLabel.setVisibility(View.GONE);
currentPasswordEdit.setVisibility(View.GONE);
}
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
dialogBuilder.setTitle(hasPassword ? getString(R.string.preferences_password_change_title) : getString(R.string.preferences_password_set_title));
dialogBuilder.setView(view);
dialogBuilder.setPositiveButton(getString(R.string.preferences_button_confirm), new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
String currentPassword = currentPasswordEdit.getText().toString();
String newPassword = newPasswordEdit.getText().toString();
String confirmPassword = confirmPasswordEdit.getText().toString();
if (hasPassword) {
// 验证当前密码
if (!currentPassword.equals(getPassword(NotesPreferenceActivity.this))) {
Toast.makeText(NotesPreferenceActivity.this,
getString(R.string.preferences_password_incorrect),
Toast.LENGTH_SHORT).show();
return;
}
}
// 验证新密码和确认密码
if (TextUtils.isEmpty(newPassword)) {
Toast.makeText(NotesPreferenceActivity.this,
getString(R.string.preferences_password_empty),
Toast.LENGTH_SHORT).show();
return;
}
if (!newPassword.equals(confirmPassword)) {
Toast.makeText(NotesPreferenceActivity.this,
getString(R.string.preferences_password_not_match),
Toast.LENGTH_SHORT).show();
return;
}
// 设置密码
setPassword(newPassword);
Toast.makeText(NotesPreferenceActivity.this,
getString(R.string.preferences_password_set_success),
Toast.LENGTH_SHORT).show();
}
});
dialogBuilder.setNegativeButton(getString(R.string.preferences_button_cancel), new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
dialog.dismiss();
}
});
dialogBuilder.show();
}
private class GTaskReceiver extends BroadcastReceiver {
/**
* 重写广播接收回调方法：处理同步服务的状态广播
* 核心逻辑：接收到广播后立即刷新页面UI，同步中时更新进度文本，保证页面状态与同步服务一致
* @param context 广播上下文对象
* @param intent 携带同步状态与进度的广播意图
*/
@Override
public void onReceive(Context context, Intent intent) {
// 刷新页面所有UI控件，同步最新状态
refreshUI();
// 同步中状态：更新实时同步进度文本
if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
syncStatus.setText(intent
@ -562,17 +548,9 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
}
/**
* 重写ActionBar菜单点击事件处理方法
* 核心业务逻辑：处理左上角返回按钮的点击事件，跳转回便签列表主页面并清除顶部Activity栈，
* 避免返回时重复创建页面，优化用户导航体验，是页面导航的核心实现
* @param item 被点击的菜单项对象
* @return boolean 是否成功处理该点击事件
*/
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case android.R.id.home:
// 构建返回主页面的意图，清除顶部栈保证页面唯一性
Intent intent = new Intent(this, NotesListActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
startActivity(intent);
@ -581,4 +559,4 @@ public class NotesPreferenceActivity extends PreferenceActivity {
return false;
}
}
}
}

62
src/Notes-master/src/net/micode/notes/ui/SplashActivity.java
Unescape View File

@ -0,0 +1,62 @@
package net.micode.notes.ui;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.os.Handler;
import android.view.animation.AlphaAnimation;
import android.view.animation.Animation;
import android.widget.LinearLayout;
import net.micode.notes.R;
/**
* 开机动画活动
* <p>
* 该类负责显示应用启动时的开机动画，使用淡入淡出动画效果展示应用Logo，
* 然后延迟跳转到登录界面。
*/
public class SplashActivity extends Activity {
private static final int SPLASH_DISPLAY_DURATION = 2000; // 2秒
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_splash);
// 找到小米logo容器
LinearLayout miLogo = findViewById(R.id.mi_logo);
// 创建淡入淡出动画
AlphaAnimation animation = new AlphaAnimation(0.0f, 1.0f);
animation.setDuration(1500); // 1.5秒
animation.setAnimationListener(new Animation.AnimationListener() {
@Override
public void onAnimationStart(Animation animation) {
// 动画开始时的回调
}
@Override
public void onAnimationEnd(Animation animation) {
// 动画结束后跳转到主界面
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
Intent mainIntent = new Intent(SplashActivity.this, NotesListActivity.class);
SplashActivity.this.startActivity(mainIntent);
SplashActivity.this.finish();
}
}, 500); // 延迟500毫秒后跳转
}
@Override
public void onAnimationRepeat(Animation animation) {
// 动画重复时的回调
}
});
// 应用动画到小米logo
miLogo.startAnimation(animation);
}
}

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

@ -14,88 +14,61 @@
* limitations under the License.
*/
// 包声明：小米便签 桌面小部件功能模块，该包统管所有小部件基类与不同规格的实现子类
package net.micode.notes.widget;
// -------------------------- 安卓系统核心依赖包 - 桌面小部件基础能力 --------------------------
// 安卓延迟意图类：小部件跨进程点击事件核心载体，桌面进程通过该类触发应用内页面跳转，异步执行意图逻辑
import android.app.PendingIntent;
// 安卓系统桌面小部件核心管理类：负责小部件的创建、更新、销毁、状态维护等全生命周期系统调度
import android.appwidget.AppWidgetManager;
// 安卓系统小部件基类：所有桌面小部件的标准父类，封装系统层小部件生命周期回调方法
import android.appwidget.AppWidgetProvider;
// 安卓数据封装类：封装ContentProvider的更新数据键值对，用于便签数据的字段更新操作
import android.content.ContentValues;
// 安卓应用全局上下文：提供资源访问、ContentResolver获取、系统服务调用等核心能力，小部件核心依赖
import android.content.Context;
// 安卓组件通信核心类：封装页面跳转指令与传递参数，用于小部件点击后的页面跳转逻辑
import android.content.Intent;
// 安卓数据库游标类：承载ContentProvider的查询结果集，按需读取便签数据，用完需手动释放资源
import android.database.Cursor;
// 安卓系统日志工具类：输出调试与异常日志，便于小部件功能的问题定位与线上排查
import android.util.Log;
// 安卓远程视图类：小部件核心UI载体，因小部件运行在桌面系统进程，需通过该类跨进程渲染UI布局与数据
import android.widget.RemoteViews;
// -------------------------- 小米便签业务层核心依赖 - 资源/数据/页面/工具 --------------------------
// 小米便签资源常量类：统一管理布局、字符串、图片、颜色等所有本地资源ID引用
import net.micode.notes.R;
// 小米便签数据层核心常量类：定义便签URI、意图参数、业务状态、小部件类型等全局核心常量，数据层与UI层通用
import net.micode.notes.data.Notes;
// 小米便签数据表字段子类：简化便签数据库表的列名引用，避免硬编码，提升代码可维护性
import net.micode.notes.data.Notes.NoteColumns;
// 小米便签资源解析工具类：封装多规格小部件背景资源的映射适配逻辑，统一提供不同尺寸的背景资源获取能力
import net.micode.notes.tool.ResourceParser;
// 小米便签核心业务页面：便签新建/编辑页面，小部件点击跳转的核心目标页面
import net.micode.notes.ui.NoteEditActivity;
// 小米便签核心业务页面：便签列表展示页面，隐私模式下小部件点击的跳转目标页面
import net.micode.notes.ui.NotesListActivity;
/**
* 小米便签 桌面小部件通用抽象基类
* 便签小部件提供者抽象基类
* <p>
* 继承安卓系统标准基类{AppWidgetProvider}，隶属于MVC架构的UI层核心组件，是所有尺寸规格便签小部件的父类；
* 核心设计理念：采用「模板方法设计模式」，封装所有小部件的通用核心业务逻辑与生命周期管理，下沉共性能力，
* 把与尺寸强相关的差异化适配逻辑抽离为抽象方法，交由子类{NoteWidgetProvider_2x}/{NoteWidgetProvider_4x}实现；
* 统一承载能力：小部件删除时的关联数据清理、小部件更新时的通用数据查询/UI渲染/点击事件绑定、隐私模式适配、资源释放等；
* 本类为抽象类，无法实例化，仅作为子类的标准化模板与能力基座。
* </p>
* 该类是所有便签小部件的基类，定义了小部件的基本行为和抽象方法。
* 它继承自AppWidgetProvider，负责处理小部件的更新、删除等操作。
*/
public abstract class NoteWidgetProvider extends AppWidgetProvider {
/**
* 数据库查询投影数组：指定查询便签表的核心业务字段，按需查询，减少无效字段的内存占用与查询耗时
* 投影字段严格匹配业务需求，仅查询小部件展示所需的核心数据，无冗余字段
* 查询小部件信息的投影列
*/
public static final String [] PROJECTION = new String [] {
NoteColumns.ID, // 便签数据表-主键ID，唯一标识单条便签数据
NoteColumns.BG_COLOR_ID, // 便签数据表-背景色标识ID，用于匹配小部件对应背景资源
NoteColumns.SNIPPET // 便签数据表-内容摘要，小部件UI上展示的核心文本内容
NoteColumns.ID,
NoteColumns.BG_COLOR_ID,
NoteColumns.SNIPPET
};
// 投影数组对应的列索引常量：固化查询结果集的字段下标，简化Cursor取值逻辑，避免硬编码索引值导致的错误
public static final int COLUMN_ID = 0; // 投影数组中-便签ID的列索引
public static final int COLUMN_BG_COLOR_ID = 1; // 投影数组中-背景色ID的列索引
public static final int COLUMN_SNIPPET = 2; // 投影数组中-便签摘要的列索引
/**
* 投影列索引定义
*/
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 应用全局上下文对象，提供ContentResolver数据操作能力
* @param appWidgetIds 被用户删除的小部件ID数组，支持批量删除处理
* 当小部件被删除时调用
* <p>
* 更新数据库中对应小部件的ID为无效值
*
* @param context 上下文对象
* @param appWidgetIds 被删除的小部件ID数组
*/
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
// 构建数据更新载体：封装需要更新的字段与对应值，将关联标识置为系统无效值
ContentValues values = new ContentValues();
values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
// 遍历所有待删除的小部件ID，逐一对关联便签执行数据更新操作
for (int i = 0; i < appWidgetIds.length; i++) {
context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
values,
@ -105,11 +78,13 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
}
/**
* 私有核心工具方法：根据小部件ID，查询其关联的有效便签数据信息
* 核心过滤条件：匹配当前小部件ID + 排除回收站中的便签数据，保证查询结果为有效展示的便签
* @param context 应用上下文，用于获取ContentResolver执行数据查询
* @param widgetId 目标小部件的唯一标识ID
* @return Cursor 匹配条件的便签数据结果集，无匹配数据时返回null；结果集需调用方手动关闭释放资源
* 获取小部件关联的便签信息
* <p>
* 通过ContentResolver查询数据库，获取与指定小部件ID关联的便签信息
*
* @param context 上下文对象
* @param widgetId 小部件ID
* @return 查询结果游标
*/
private Cursor getNoteWidgetInfo(Context context, int widgetId) {
return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
@ -120,125 +95,105 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
}
/**
* 受保护的重载更新方法：对外暴露的小部件通用更新入口
* 业务适配：默认以【非隐私模式】执行小部件的UI渲染与数据绑定，为子类提供极简的调用入口
* @param context 应用全局上下文
* @param appWidgetManager 系统小部件管理器，负责最终的UI更新调度
* @param appWidgetIds 需要执行更新操作的小部件ID数组，支持批量更新
* 更新小部件
* <p>
* 调用带privacyMode参数的update方法，默认privacyMode为false
*
* @param context 上下文对象
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
update(context, appWidgetManager, appWidgetIds, false);
}
/**
* 私有核心业务方法：小部件通用更新逻辑的总入口，封装所有规格小部件的完整更新流程
* 核心职责：统一实现 数据查询 → 数据解析 → 视图初始化 → 内容赋值 → 点击事件绑定 → UI刷新 全链路逻辑，
* 兼容普通模式/隐私模式双场景，处理有无关联便签的分支逻辑，是整个小部件的核心业务实现方法
* @param context 应用全局上下文，支撑资源访问与数据操作
* @param appWidgetManager 系统小部件管理器，提供小部件UI更新的核心能力
* @param appWidgetIds 需要更新的小部件ID数组，支持多实例批量处理
* @param privacyMode 是否启用隐私模式：true=隐私模式(隐藏内容)，false=普通模式(展示内容)
* 更新小部件
* <p>
* 遍历所有需要更新的小部件，根据小部件ID获取关联的便签信息，
* 然后更新小部件的显示内容和点击事件
*
* @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++) {
// 过滤无效的小部件ID，跳过无意义的更新操作，提升执行效率
if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
// 初始化默认背景ID：从资源工具类获取应用全局默认的便签背景标识
int bgId = ResourceParser.getDefaultBgId(context);
// 初始化便签摘要：默认空字符串，防止空指针异常
String snippet = "";
// 构建默认跳转意图：无关联便签时，跳转至便签编辑页执行新建操作
Intent intent = new Intent(context, NoteEditActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP); // 启动模式：栈顶复用，避免重复创建页面实例
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]); // 携带小部件ID参数，供编辑页关联使用
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType()); // 携带小部件类型，由子类实现差异化适配
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;
}
// 从结果集中解析业务数据，赋值给本地变量用于后续视图渲染
snippet = c.getString(COLUMN_SNIPPET);
bgId = c.getInt(COLUMN_BG_COLOR_ID);
// 携带便签ID参数，跳转编辑页时直接定位到当前关联的便签内容
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);
}
// 安全关闭游标，释放数据库连接资源，防止内存泄漏
if (c != null) {
c.close();
}
// 创建远程视图实例：加载子类实现的规格专属布局，完成跨进程UI初始化
RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
// 为远程视图设置背景资源：加载子类实现的规格专属背景，完成尺寸与背景的精准适配
rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
// 携带背景ID参数，跳转编辑页时同步使用当前小部件的背景样式
intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
/**
* 构建小部件点击的延迟意图：区分隐私模式与普通模式，实现差异化的交互逻辑
* PendingIntent为跨进程意图载体，是小部件点击事件的核心实现方式，保证桌面进程能触发应用内逻辑
* 生成启动便签编辑活动的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);
// 通过系统管理器完成最终的UI刷新，将渲染完成的远程视图同步至桌面小部件
appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
}
}
}
/**
* 抽象方法：获取小部件规格专属的背景资源ID
* 由子类根据自身尺寸规格实现，完成背景资源与小部件尺寸的精准适配，避免背景拉伸/变形
* @param bgId 便签数据表中定义的背景色标识ID，为全局统一的背景风格常量
* @return int 对应尺寸规格的背景Drawable资源ID
* 获取背景资源ID
* <p>
* 根据背景颜色ID获取对应的背景资源ID
*
* @param bgId 背景颜色ID
* @return 背景资源ID
*/
protected abstract int getBgResourceId(int bgId);
/**
* 抽象方法：获取小部件规格专属的布局资源ID
* 由子类根据自身尺寸规格实现，加载与桌面占位大小匹配的专属布局，保证UI展示效果
* @return int 对应尺寸规格的布局资源ID
* 获取布局ID
*
* @return 布局资源ID
*/
protected abstract int getLayoutId();
/**
* 抽象方法：获取小部件的标准化业务类型标识
* 由子类根据自身尺寸规格实现，返回数据层统一定义的类型常量；
* 该标识是数据层识别小部件规格的核心依据，用于数据关联、筛选与同步，保证数据与视图的一致性
* @return int 小部件业务类型常量，取值为Notes.TYPE_WIDGET_2X / Notes.TYPE_WIDGET_4X
* 获取小部件类型
*
* @return 小部件类型
*/
protected abstract int getWidgetType();
}
}

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

@ -14,7 +14,6 @@
* limitations under the License.
*/
// 包声明：小米便签 桌面小部件功能模块，该包下统管所有尺寸规格的便签桌面小组件实现类
package net.micode.notes.widget;
import android.appwidget.AppWidgetManager;
@ -24,20 +23,22 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
/**
* 小米便签 2X规格桌面小部件提供者核心实现类
* 继承抽象基类NoteWidgetProvider，作为MVC架构中UI层的桌面可视化组件，仅负责2X规格专属适配逻辑；
* 核心职责：实现基类抽象方法，为2X尺寸小部件提供专属布局、匹配的背景资源、标准化业务类型标识；
* 设计原则：通用的小部件生命周期管理、数据更新、视图渲染逻辑完全复用父类，子类只做规格差异化实现，解耦通用逻辑与尺寸适配逻辑。
* 2x2 大小的便签小部件提供者
* <p>
* 该类继承自NoteWidgetProvider，实现了2x2大小的便签小部件。
* 它提供了小部件的布局、背景资源和类型等信息。
*/
public class NoteWidgetProvider_2x extends NoteWidgetProvider {
/**
* 重写系统小部件生命周期的更新回调方法
* 触发场景：小部件首次添加至桌面、系统触发定时刷新、便签数据变更主动同步时调用
* 方法逻辑：无差异化业务处理，直接调用父类统一的update核心方法，完成2X小部件的视图刷新与便签数据绑定
* @param context 全局上下文对象，提供系统服务调用、应用资源访问的基础能力
* @param appWidgetManager 系统桌面小部件管理器，负责小部件的创建、更新、销毁等全生命周期调度
* @param appWidgetIds 待更新的2X规格小部件ID数组，支持多实例批量更新操作
* 当小部件需要更新时调用
* <p>
* 调用父类的update方法更新小部件
*
* @param context 上下文对象
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
@ -45,9 +46,11 @@ public class NoteWidgetProvider_2x extends NoteWidgetProvider {
}
/**
* 重写父类抽象方法，获取2X规格小部件的专属布局资源ID
* 布局文件为固定尺寸适配，与2X桌面占位大小完全匹配，保证便签内容在该规格下的完整展示
* @return int 2X小部件专属布局资源ID，对应布局文件：R.layout.widget_2x
* 获取布局ID
* <p>
* 返回2x2小部件的布局资源ID
*
* @return 布局资源ID
*/
@Override
protected int getLayoutId() {
@ -55,11 +58,12 @@ public class NoteWidgetProvider_2x extends NoteWidgetProvider {
}
/**
* 重写父类抽象方法，获取2X规格小部件对应的背景资源ID
* 核心适配说明：不同尺寸的小部件背景资源为独立资源文件，需根据背景主题ID精准匹配对应规格的背景；
* 避免因尺寸不一致导致的背景拉伸、变形等UI兼容问题，通过工具类封装所有背景资源的映射关系，统一管理。
* @param bgId 背景主题标识ID，为Notes模块统一定义的背景风格常量，与具体尺寸解耦
* @return int 适配2X规格的背景Drawable资源ID
* 获取背景资源ID
* <p>
* 根据背景颜色ID获取对应的2x2小部件背景资源ID
*
* @param bgId 背景颜色ID
* @return 背景资源ID
*/
@Override
protected int getBgResourceId(int bgId) {
@ -67,13 +71,14 @@ public class NoteWidgetProvider_2x extends NoteWidgetProvider {
}
/**
* 重写父类抽象方法，获取当前小部件的标准化业务类型标识
* 该标识为数据层核心常量，用于NotesProvider数据持久化、便签数据同步、小部件类型筛选的核心依据；
* 保证数据层能精准识别当前小部件的尺寸规格，返回对应规格的便签数据，实现「数据-视图」的规格一致性适配。
* @return int 2X规格小部件的业务类型常量，定值：Notes.TYPE_WIDGET_2X
* 获取小部件类型
* <p>
* 返回2x2小部件的类型
*
* @return 小部件类型
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_2X;
}
}
}

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

@ -14,35 +14,31 @@
* limitations under the License.
*/
// 包声明：小米便签 桌面小部件功能模块，该包统一承载所有尺寸规格的便签桌面小组件实现类
package net.micode.notes.widget;
// 安卓系统核心依赖：桌面小部件全生命周期调度的核心管理类，负责小部件的创建、更新、销毁等系统操作
import android.appwidget.AppWidgetManager;
// 安卓系统核心依赖：应用全局上下文，提供资源访问、系统服务调用、组件通信的基础能力，小部件初始化必备
import android.content.Context;
// 小米便签业务依赖：应用资源常量类，统一管理所有布局、样式等资源ID引用
import net.micode.notes.R;
// 小米便签业务依赖：数据层核心常量类，定义便签及小部件的类型、状态等全局业务枚举常量
import net.micode.notes.data.Notes;
// 小米便签业务依赖：资源解析工具类，封装多规格小部件背景资源的映射适配逻辑，统一提供背景资源获取能力
import net.micode.notes.tool.ResourceParser;
/**
* 小米便签 4X规格桌面小部件提供者核心实现类
* 继承抽象基类NoteWidgetProvider，隶属于MVC架构的UI层桌面可视化组件，专注4X规格的差异化适配；
* 核心设计职责：实现基类定义的抽象方法，为4X尺寸小部件提供专属的布局资源、匹配的背景样式资源、标准化业务类型标识；
* 设计思想遵循：父类封装所有小部件通用的生命周期、数据更新、视图渲染核心逻辑，子类仅实现当前规格的差异化配置，解耦通用逻辑与尺寸适配逻辑，提升扩展性。
* 4x4 大小的便签小部件提供者
* <p>
* 该类继承自NoteWidgetProvider，实现了4x4大小的便签小部件。
* 它提供了小部件的布局、背景资源和类型等信息。
*/
public class NoteWidgetProvider_4x extends NoteWidgetProvider {
/**
* 重写系统小部件生命周期的更新回调方法
* 触发场景：4X小部件首次添加至桌面、系统执行定时刷新任务、便签数据变更触发主动同步时调用
* 方法核心逻辑：无4X规格的差异化业务处理，直接复用父类统一的update核心方法，完成4X小部件的视图刷新与最新便签数据绑定
* @param context 应用全局上下文对象，支撑小部件的资源访问与系统服务调用
* @param appWidgetManager 系统桌面小部件管理器，统一调度所有小部件实例的更新操作
* @param appWidgetIds 待执行更新的4X规格小部件ID数组，原生支持多小部件实例的批量更新
* 当小部件需要更新时调用
* <p>
* 调用父类的update方法更新小部件
*
* @param context 上下文对象
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
@ -50,20 +46,24 @@ public class NoteWidgetProvider_4x extends NoteWidgetProvider {
}
/**
* 实现父类抽象方法：获取4X规格小部件的专属布局资源ID
* 该布局为小米便签定制化的4X尺寸UI布局，与桌面4格占位大小精准匹配，保障便签内容完整展示无适配问题
* @return int 4X小部件专属布局资源ID，对应固定布局文件：R.layout.widget_4x
* 获取布局ID
* <p>
* 返回4x4小部件的布局资源ID
*
* @return 布局资源ID
*/
@Override
protected int getLayoutId() {
return R.layout.widget_4x;
}
/**
* 重写父类抽象方法：根据背景主题标识ID，获取4X规格小部件的专属背景资源ID
* 核心适配逻辑：不同尺寸规格的小部件对应独立的背景资源文件，避免尺寸不匹配导致的背景拉伸、变形等UI兼容问题；
* 背景资源的映射关系由工具类统一封装管理，实现业务逻辑与资源适配的解耦，便于后续扩展新的背景样式。
* @param bgId 背景主题枚举标识ID，为项目统一定义的小部件背景风格常量，与具体尺寸规格解耦
* @return int 精准匹配4X规格的背景Drawable资源ID
* 获取背景资源ID
* <p>
* 根据背景颜色ID获取对应的4x4小部件背景资源ID
*
* @param bgId 背景颜色ID
* @return 背景资源ID
*/
@Override
protected int getBgResourceId(int bgId) {
@ -71,13 +71,14 @@ public class NoteWidgetProvider_4x extends NoteWidgetProvider {
}
/**
* 重写父类抽象方法：获取当前4X规格小部件的标准化业务类型标识
* 该标识为数据层核心业务常量，是NotesProvider数据持久化、便签数据同步、小部件类型筛选的核心依据；
* 作用是让数据层能够精准识别当前小部件的尺寸规格，返回对应规格的适配数据，实现「业务数据-桌面视图」的规格一致性闭环。
* @return int 4X规格小部件的业务类型常量，定值：Notes.TYPE_WIDGET_4X
* 获取小部件类型
* <p>
* 返回4x4小部件的类型
*
* @return 小部件类型
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_4X;
}
}
}

Write Preview
Loading…
Cancel
Save