/* * 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.ContentProviderOperation; import android.content.ContentProviderResult; import android.content.ContentResolver; import android.content.ContentUris; import android.content.ContentValues; import android.content.OperationApplicationException; import android.database.Cursor; import android.os.RemoteException; import android.util.Log; //导入android 包content、database等 import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.CallNote; import net.micode.notes.data.Notes.NoteColumns; import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute; //导入net-micode包下数据 import java.util.ArrayList; import java.util.HashSet; //导入JAVA ArrayList和HashSet类 public class DataUtils {// 对DataUtils类进行定义 public static final String TAG = "DataUtils";// 定义静态不可变字TAG符串常量"DataUtils" public static boolean batchDeleteNotes(ContentResolver resolver, HashSet ids) { if (ids == null) { Log.d(TAG, "the ids is null"); return true; } if (ids.size() == 0) { Log.d(TAG, "no id is in the hashset"); return true; } // 定义批量删除笔记。若ids参数为null,输出"the ids is null"并返回true;若ids参数为0,输出"no id is in the // hashset"并返回true ArrayList operationList = new ArrayList(); // 定义操作列表,存储ContentProviderOperation对象 for (long id : ids) {// 遍历id列表 if (id == Notes.ID_ROOT_FOLDER) { Log.e(TAG, "Don't delete system folder root"); continue; } // 如果id为系统根目录,打印"不要删除系统根目录"并进行下一次循环 ContentProviderOperation.Builder builder = ContentProviderOperation .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id)); operationList.add(builder.build());// 创造builder对象,删除指定id的ContentProviderOperation } try {// 调用applybatch 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; } return true;// 若返回为空或第一个结果为null,输出删除失败返回false,否则返回true } catch (RemoteException e) { Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); } catch (OperationApplicationException e) { Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); } // 若remoteexeption或operationapplicationexception异常,返回false return false; } public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) { ContentValues values = new ContentValues();// 创建contentValues对象 values.put(NoteColumns.PARENT_ID, desFolderId);// 移动笔记至目标文件夹 values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId);// 更新笔记的原始父类文件夹id values.put(NoteColumns.LOCAL_MODIFIED, 1); resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null); // 更新笔记 } public static boolean batchMoveToFolder(ContentResolver resolver, HashSet ids, long folderId) {// 若ids为空,打印log并返回true if (ids == null) { Log.d(TAG, "the ids is null"); return true; } // 用于批量移动笔记至文件夹 ArrayList operationList = new ArrayList(); for (long id : ids) {// 遍历笔记id集合 ContentProviderOperation.Builder builder = ContentProviderOperation .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id)); builder.withValue(NoteColumns.PARENT_ID, folderId);// 移动笔记至目标文件夹 builder.withValue(NoteColumns.LOCAL_MODIFIED, 1);// 添加键值对,表示本地有效 operationList.add(builder.build());// 添加操作至操作列表 } try { ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);// 应用操作列表 if (results == null || results.length == 0 || results[0] == null) {// 如果结果为空或者第一个结果为空,打印log并返回false Log.d(TAG, "delete notes failed, ids:" + ids.toString()); return false; } return true;// true表示操作成功 } catch (RemoteException e) {// 捕获远程异常 Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); } catch (OperationApplicationException e) {// 捕获操作异常 Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); } return false;// false表示操作失败 } /** * Get the all folder count except system folders {@link Notes#TYPE_SYSTEM}} */ public static int getUserFolderCount(ContentResolver resolver) { Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, new String[] { "COUNT(*)" }, NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?", new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER) }, null); int count = 0; if (cursor != null) { if (cursor.moveToFirst()) { try { count = cursor.getInt(0); } catch (IndexOutOfBoundsException e) { Log.e(TAG, "get folder count failed:" + e.toString()); } finally { cursor.close(); } } } return count; }// 检查笔记是否在数据库中可见,若不可见输出"get folder count failed:" public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) { Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null, NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER, new String[] { String.valueOf(type) }, null); boolean exist = false; if (cursor != null) { if (cursor.getCount() > 0) { exist = true; } cursor.close(); } return exist; } // 检查数据是否在数据库中存在 public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) { 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) { exist = true; } cursor.close(); } return exist; } // 检查文件名称是否可见 public static boolean existInDataDatabase(ContentResolver resolver, long dataId) { 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) { exist = true; } cursor.close(); } return exist; } public static boolean checkVisibleFolderName(ContentResolver resolver, String name) { 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 + "=?", new String[] { name }, null); boolean exist = false; if (cursor != null) { if (cursor.getCount() > 0) { exist = true; } cursor.close(); } return exist; } public static HashSet getFolderNoteWidget(ContentResolver resolver, long folderId) { // 查询文件夹中所有小部件id和类型 Cursor c = resolver.query(Notes.CONTENT_NOTE_URI, new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE }, NoteColumns.PARENT_ID + "=?", new String[] { String.valueOf(folderId) }, null); HashSet set = null; if (c != null) { if (c.moveToFirst()) { set = new HashSet(); // 遍历查询结果,将小部件id和类型存入hashSET中 do { try { AppWidgetAttribute widget = new AppWidgetAttribute(); widget.widgetId = c.getInt(0); widget.widgetType = c.getInt(1); set.add(widget); } catch (IndexOutOfBoundsException e) { Log.e(TAG, e.toString()); } } while (c.moveToNext()); } c.close(); } // 返回文件夹中所有小部件HashSet集合 return set; } public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {// 获取一段笔记的getCallNumberByNoteId Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI, new String[] { CallNote.PHONE_NUMBER }, CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?", new String[] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE }, null); if (cursor != null && cursor.moveToFirst()) { try { return cursor.getString(0); } catch (IndexOutOfBoundsException e) {// 如果查询结果不为空且有数据,则返回该行的电话号码 Log.e(TAG, "Get call number fails " + e.toString());// 如果获取电话号码失败,则打印错误日志 } finally { cursor.close(); } // 关闭游标,释放资源 } return "";// 如果没有查询结果,则返回空串 } public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) { // 使用ContentResover对象来查询数据,并返回Cursor对象 Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI, // 查询Note id字段 new String[] { CallNote.NOTE_ID }, // 通过童话日期,电话号码扽给查询 CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL(" + 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); } catch (IndexOutOfBoundsException e) { Log.e(TAG, "Get call note id fails " + e.toString()); } } cursor.close(); } return 0; } public static String getSnippetById(ContentResolver resolver, long noteId) {// 使用ContentResovler对象查询数据,返回Cursor对象 Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, // 查询snippet字段 new String[] { NoteColumns.SNIPPET }, NoteColumns.ID + "=?", new String[] { String.valueOf(noteId) }, null); if (cursor != null) { String snippet = ""; if (cursor.moveToFirst()) {// 获取查询结果中第0列的值,即snippet字段值 snippet = cursor.getString(0); } cursor.close(); return snippet; } throw new IllegalArgumentException("Note is not found with id: " + noteId); }// 通过noteld获取信息,返回字符串 public static String getFormattedSnippet(String snippet) { if (snippet != null) { snippet = snippet.trim(); int index = snippet.indexOf('\n'); if (index != -1) { snippet = snippet.substring(0, index); } } return snippet; } }