|
|
/*
|
|
|
* 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.Context;
|
|
|
import android.database.Cursor;
|
|
|
import android.util.Log;
|
|
|
import android.view.View;
|
|
|
import android.view.ViewGroup;
|
|
|
import android.widget.CursorAdapter;
|
|
|
|
|
|
import net.micode.notes.data.Notes;
|
|
|
|
|
|
import java.util.Collection;
|
|
|
import java.util.HashMap;
|
|
|
import java.util.HashSet;
|
|
|
import java.util.Iterator;
|
|
|
|
|
|
// NotesListAdapter类继承自CursorAdapter，用于适配数据库游标数据到视图，以便在列表等控件中展示笔记相关的数据
|
|
|
public class NotesListAdapter extends CursorAdapter {
|
|
|
// 用于日志记录的标签，方便在日志输出中识别该类相关的日志信息
|
|
|
private static final String TAG = "NotesListAdapter";
|
|
|
// 保存上下文信息，用于后续创建视图、获取资源等操作
|
|
|
private Context mContext;
|
|
|
// 使用HashMap来记录每个位置（索引）对应的选中状态，键为位置索引（整数），值为是否选中（布尔值）
|
|
|
private HashMap<Integer, Boolean> mSelectedIndex;
|
|
|
// 记录笔记的数量，用于一些判断和统计相关操作
|
|
|
private int mNotesCount;
|
|
|
// 表示当前是否处于选择模式（例如多选模式等），true表示处于选择模式，false表示不在选择模式
|
|
|
private boolean mChoiceMode;
|
|
|
|
|
|
// 内部静态类，用于封装桌面小部件（App Widget）的相关属性，这里包含小部件的ID和类型两个属性
|
|
|
public static class AppWidgetAttribute {
|
|
|
public int widgetId;
|
|
|
public int widgetType;
|
|
|
};
|
|
|
|
|
|
// 构造函数，用于初始化NotesListAdapter实例
|
|
|
public NotesListAdapter(Context context) {
|
|
|
// 调用父类（CursorAdapter）的构造函数，传入上下文和初始游标（这里传入null，可能后续会通过其他方法设置游标）
|
|
|
super(context, null);
|
|
|
// 初始化mSelectedIndex，创建一个新的HashMap用于记录选中状态
|
|
|
mSelectedIndex = new HashMap<Integer, Boolean>();
|
|
|
// 保存传入的上下文信息
|
|
|
mContext = context;
|
|
|
// 初始化笔记数量为0
|
|
|
mNotesCount = 0;
|
|
|
}
|
|
|
|
|
|
// 该方法用于创建一个新的视图（View），在列表中每个数据项对应的视图需要通过此方法创建，这里返回一个NotesListItem类型的新视图实例，传入当前上下文作为参数来创建视图
|
|
|
@Override
|
|
|
public View newView(Context context, Cursor cursor, ViewGroup parent) {
|
|
|
return new NotesListItem(context);
|
|
|
}
|
|
|
|
|
|
// 该方法用于将游标中的数据绑定到已创建的视图上，使得视图能够展示对应的数据内容
|
|
|
@Override
|
|
|
public void bindView(View view, Context context, Cursor cursor) {
|
|
|
// 如果视图是NotesListItem类型的实例
|
|
|
if (view instanceof NotesListItem) {
|
|
|
// 根据传入的上下文和游标数据创建一个NoteItemData实例，用于获取和解析具体的数据信息
|
|
|
NoteItemData itemData = new NoteItemData(context, cursor);
|
|
|
// 调用NotesListItem的bind方法，将相关数据和状态传递给视图进行绑定展示，包括上下文、笔记数据项、是否处于选择模式以及当前位置对应的选中状态等信息
|
|
|
((NotesListItem) view).bind(context, itemData, mChoiceMode,
|
|
|
isSelectedItem(cursor.getPosition()));
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 用于设置指定位置的选中状态，将指定位置和对应的选中状态存入mSelectedIndex中，并通知数据集已发生改变，使得视图能够根据新的选中状态进行更新显示
|
|
|
public void setCheckedItem(final int position, final boolean checked) {
|
|
|
mSelectedIndex.put(position, checked);
|
|
|
notifyDataSetChanged();
|
|
|
}
|
|
|
|
|
|
// 用于判断当前是否处于选择模式，返回mChoiceMode的值，true表示处于选择模式，false表示不在选择模式
|
|
|
public boolean isInChoiceMode() {
|
|
|
return mChoiceMode;
|
|
|
}
|
|
|
|
|
|
// 用于设置选择模式的开关，当设置为选择模式时（传入参数mode为true），先清空之前的选中状态记录（mSelectedIndex），然后更新mChoiceMode的值
|
|
|
public void setChoiceMode(boolean mode) {
|
|
|
mSelectedIndex.clear();
|
|
|
mChoiceMode = mode;
|
|
|
}
|
|
|
|
|
|
// 用于全选或全不选所有笔记数据项（根据传入的checked参数决定），遍历游标中的所有数据项，对于类型为笔记（Notes.TYPE_NOTE）的数据项，调用setCheckedItem方法设置其选中状态
|
|
|
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集合，创建一个HashSet用于存储Long类型的ID，遍历mSelectedIndex中所有已选中的位置（键），通过getItemId方法获取对应的数据项ID，并添加到HashSet中，同时对根文件夹ID（Notes.ID_ROOT_FOLDER）进行特殊判断和日志记录（如果出现则认为是错误情况）
|
|
|
public HashSet<Long> getSelectedItemIds() {
|
|
|
HashSet<Long> itemSet = new HashSet<Long>();
|
|
|
for (Integer position : mSelectedIndex.keySet()) {
|
|
|
if (mSelectedIndex.get(position) == true) {
|
|
|
Long id = getItemId(position);
|
|
|
if (id == Notes.ID_ROOT_FOLDER) {
|
|
|
Log.d(TAG, "Wrong item id, should not happen");
|
|
|
} else {
|
|
|
itemSet.add(id);
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
return itemSet;
|
|
|
}
|
|
|
|
|
|
// 用于获取所有已选中的桌面小部件（App Widget）相关属性的集合，创建一个HashSet用于存储AppWidgetAttribute实例，遍历mSelectedIndex中所有已选中的位置（键），通过getItem方法获取对应的数据项游标（Cursor），然后从中解析出小部件的ID和类型信息，封装成AppWidgetAttribute实例添加到HashSet中，同时对无效游标情况进行日志记录和错误处理（如果游标为null则返回null）
|
|
|
public HashSet<AppWidgetAttribute> getSelectedWidget() {
|
|
|
HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
|
|
|
for (Integer position : mSelectedIndex.keySet()) {
|
|
|
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);
|
|
|
/**
|
|
|
* Don't close cursor here, only the adapter could close it
|
|
|
*/
|
|
|
} else {
|
|
|
Log.e(TAG, "Invalid cursor");
|
|
|
return null;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
return itemSet;
|
|
|
}
|
|
|
|
|
|
// 用于获取已选中的数据项的数量，获取mSelectedIndex中所有值（布尔值，表示选中状态）的集合，通过迭代器遍历该集合，统计值为true（即选中）的数量并返回
|
|
|
public int getSelectedCount() {
|
|
|
Collection<Boolean> values = mSelectedIndex.values();
|
|
|
if (null == values) {
|
|
|
return 0;
|
|
|
}
|
|
|
Iterator<Boolean> iter = values.iterator();
|
|
|
int count = 0;
|
|
|
while (iter.hasNext()) {
|
|
|
if (true == iter.next()) {
|
|
|
count++;
|
|
|
}
|
|
|
}
|
|
|
return count;
|
|
|
}
|
|
|
|
|
|
// 用于判断是否所有的数据项都已被选中，通过比较已选中的数据项数量（getSelectedCount方法获取）和总笔记数量（mNotesCount）来判断，当已选中数量不为0且等于总笔记数量时，返回true，表示全选状态，否则返回false
|
|
|
public boolean isAllSelected() {
|
|
|
int checkedCount = getSelectedCount();
|
|
|
return (checkedCount!= 0 && checkedCount == mNotesCount);
|
|
|
}
|
|
|
|
|
|
// 用于判断指定位置的数据项是否被选中，根据mSelectedIndex中对应位置的键值（布尔值）来判断，如果对应位置的值为null，则返回false，表示未选中，否则返回该位置对应的实际选中状态值
|
|
|
public boolean isSelectedItem(final int position) {
|
|
|
if (null == mSelectedIndex.get(position)) {
|
|
|
return false;
|
|
|
}
|
|
|
return mSelectedIndex.get(position);
|
|
|
}
|
|
|
|
|
|
// 当数据集内容发生改变时触发的回调方法，这里先调用父类的onContentChanged方法执行默认操作，然后调用calcNotesCount方法重新计算笔记的数量
|
|
|
@Override
|
|
|
protected void onContentChanged() {
|
|
|
super.onContentChanged();
|
|
|
calcNotesCount();
|
|
|
}
|
|
|
|
|
|
// 当游标（Cursor）发生改变时触发的回调方法，这里先调用父类的changeCursor方法执行默认操作，然后调用calcNotesCount方法重新计算笔记的数量
|
|
|
@Override
|
|
|
public void changeCursor(Cursor cursor) {
|
|
|
super.changeCursor(cursor);
|
|
|
calcNotesCount();
|
|
|
}
|
|
|
|
|
|
// 私有方法，用于计算笔记的数量，先将mNotesCount重置为0，然后遍历所有数据项（通过getCount方法获取数量），获取对应位置的数据项游标，判断其数据类型是否为笔记（Notes.TYPE_NOTE），如果是则数量加1，同时对无效游标情况进行日志记录和错误处理（如果游标为null则直接返回）
|
|
|
private void calcNotesCount() {
|
|
|
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;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
} |
