实时文件夹概述:
实时文件夹是在SDK1.5中引入的，支持开发人员在设备的默认打开屏幕（我们将其称为设备的主页）上公开 ContentProvider，如联系人信息、笔记和媒体。将ContentProvider(比如Android的 contactsContentProvider)在主页上公开为活动文件夹之后，在联系人数据库中添加、删除或修改联系人时，此实时文件夹能够刷新自身所包含的内容。
Android中的实时文件夹对ContentProvider的作用就相当于RSS阅读器对发布网站的作用。ContentProvider也是类似于根据URI提供信息的网站。随着网站的迅速增加，每个网站都会以独特的方式发布自己的信息，这就需要集中多个网站的信息，以便用户可以通过单一阅读器了解最新发展动态。为此，RSS应运而生。RSS强制在不同的信息集之间提供一种通用的使用模式。有了通用模式，你只需设计一次阅读器，就可以使用它阅读任何内容，只要该内容具有统一的结构即可。
实时文件夹在概念上也没有什么不同。就像 RSS阅读器为所发布的网站内容提桶通用的接口一样，实时文件夹也为Android中的 ContentProvider定义一种通用接口。只要 ContentProvider遵守此协议，Android就能够在设备的主页上创建活动文件夹图标来表示该 ContentProvider。当用户单击此活动文件夹图标时，系统将联系 ContentProvider。ContentProvider 应该会返回一个游标。根据活动文件夹契约，此游标必须具有一组预定义的列。此游标通过ListView 或 GridView直观地显示出来。
android实时文件夹android LiveFolder, 为什么说它是实时的，因为它可以根据我们后台数据库的变化更新自身 更新UI 这样无论什么时候显示的内容都是最新的。 比如 我们删除了一条联系人信息，我们的 Live Foler马上也会 更新。是马上 而且你也不用做任何操作 它自己会更新
用户如何使用活动文件夹:
(1) 打开android模拟器 来到主页 (默认屏幕)
(2) 转到主页的上下文菜单。通过在主页的空白处进行长单击(按住不撒手 大约2秒钟)，就可以看到上下文菜单了。
(3) 找到一个名为 Folders(中文名就叫文件夹) 的上下文菜单选项，单击可以查看可能可用的活动文件夹。
(4) 从列表中选择并单击希望在主页上公开的活动文件夹名称。这会在主页上创建一个图标来表示所选的活动文件夹。
(5) 单击在第4步中设置的活动文件夹图标，调出 ListView或GridView中的信息(该活动文件夹表示的数据)行。
(6) 单击一行以调用知道如何显示该行数据的应用程序。
(7) 使用该应用程序显示的更多菜单选项查看或操作目标选项。也可以使用应用程序的菜单选项创建它支持的任何新项。
(8) 请注意，活动文件夹显示区域会自动反应对一个或多个项所做的更改。
Eg:
通过代码构建实时文件夹(LiveFolder):
要构建活动文件夹，需要两样东西：一个活动和一个专门的ContentProvider。Android使用此活动的标签来填充可用活动文件夹列表。Android还调用此活动来获得一个URI，这个URI将被调用来显示一组行。
活动提供的URI 应该指向负责返回行的专门的ContentProvider。该ContentProvider通过一个定义良好的游标返回这些行。我们要求游标定义良好 , 因为游标应该具有一组已知的预定义列名称。
Eg:
1. AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="xiaohang.zhimeng" android:versionCode="1" android:versionName="1.0">
<uses-sdk android:minSdkVersion="10" />
<application android:icon="@drawable/icon" android:label="@string/app_name">
<activity android:name=".SimpleActivity" android:label="@string/app_name">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!-- LIVE FOLDERS -->
<activity android:name=".AllContactsLiveFolderCreatorActivity"
android:label="My live folder" android:icon="@drawable/contacts">
<intent-filter>
<span style="color:#FF0000;"><action android:name="android.intent.action.CREATE_LIVE_FOLDER" /></span>
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
<provider android:authorities="com.ai.livefolders.contacts"
android:multiprocess="true" android:name=".MyContactsProvider" />
</application>
<span style="color:#FF0000;"><uses-permission android:name="android.permission.READ_CONTACTS" /></span>
</manifest>
2. 根据活动文件夹协议，CREATE_LIVE_FOLDER Intent 允许主页的上下文菜单将
AllContactsLiveFolderCreatorActivity 显示为一个标题为My live foler的选项。单击此菜单选项将在主页上创建一个图标。AllContactsLiveFolderCreatorActivity 负责定义此图标，其中将包含一个图像和一个标签。在本例子中，AllContactsLiveFolderCreatorActivity 中的代码将此标签指定为 Contacts LF。下面让我们看看创建活动文件夹的类AllContactsLiveFolderCreatorActivity:
package xiaohang.zhimeng;
import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.provider.LiveFolders;
public class AllContactsLiveFolderCreatorActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
final Intent intent = getIntent();
final String action = intent.getAction();
System.out.println("action is " + action);
if (LiveFolders.ACTION_CREATE_LIVE_FOLDER.equals(action)) {
// 设置本Activity返回的结果
setResult(
RESULT_OK,
createLiveFolder(MyContactsProvider.CONTACTS_URI,
"Contacts LF", R.drawable.contacts));
} else {
setResult(RESULT_CANCELED);
}
finish();
}
private Intent createLiveFolder(Uri uri, String name, int icon) {
final Intent intent = new Intent();
intent.setData(uri);
// 设置LiveFolder 的Name（这个名字是显示在手机的主页上的）
intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_NAME, name);
// 设置LiveFolder 的图标
intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_ICON,
Intent.ShortcutIconResource.fromContext(this, icon));
// 指定LiveFolder 显示的模式 这里用List以列表的形式显示
intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_DISPLAY_MODE,
LiveFolders.DISPLAY_MODE_LIST);
return intent;
}
}
AllContactsLiveFolderCreatorActivity 类只有一个功能：担当活动文件夹的生成程序或创建程序。可以将它视为活动文件夹的模板。每次单击此活动(通过主页上下文菜单的Folers选项)时，它都会在主页上生成一个活动文件夹。此活动告诉调用方(在这个例子中为主页或LiveFolder框架) 活动文件夹名称、为活动文件夹图标使用的图像、提供可用数据的 URI，以及显示模式 (列表或网格)。然后，活动文件夹框架负责在主页上创建活动文件夹的图标。
createLiveFoler() 方法主要设置调用它的Intent的值。当此 Intent返回到调用方时，调用方将知道以下信息。
活动文件夹的名称
活动文件夹所使用的图标
显示模式：列表或网格
数据或为数据调用的内容URI
3.MyContactsProvider: 当用户单击活动文件夹的图标时，系统将调用 URI 来检索数据。此 URI 所标识的 ContentProvider提供了标准化的游标:
package xiaohang.zhimeng;
import android.content.ContentProvider;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.MatrixCursor;
import android.net.Uri;
import android.provider.BaseColumns;
import android.provider.ContactsContract;
import android.provider.LiveFolders;
import android.util.Log;
public class MyContactsProvider extends ContentProvider {
public static final String AUTHORITY = "com.ai.livefolders.contacts";
// Uri that goes as input to the live-folder creation
public static final Uri CONTACTS_URI = Uri.parse("content://" + AUTHORITY
+ "/contacts");
// To distinguish this URI
private static final int TYPE_MY_URI = 0;
private static final UriMatcher URI_MATCHER;
static {
URI_MATCHER = new UriMatcher(UriMatcher.NO_MATCH);
URI_MATCHER.addURI(AUTHORITY, "contacts", TYPE_MY_URI);
}
@Override
public boolean onCreate() {
return true;
}
@Override
public int bulkInsert(Uri uri, ContentValues[] values) {
return 0;
}
// Set of columns needed by a live folder
// This is the live-folder contract
private static final String[] CURSOR_COLUMNS = new String[] {
BaseColumns._ID, LiveFolders.NAME, LiveFolders.DESCRIPTION,
LiveFolders.INTENT, LiveFolders.ICON_PACKAGE,
LiveFolders.ICON_RESOURCE };
// In case there are no rows
// use this stand-in as an error message
// Notice it has the same set of columns of a live folder
private static final String[] CURSOR_ERROR_COLUMNS = new String[] {
BaseColumns._ID, LiveFolders.NAME, LiveFolders.DESCRIPTION };
// The error message row
private static final Object[] ERROR_MESSAGE_ROW = new Object[] { -1, // id
"No contacts found", // name
"Check your contacts database" // description
};
// The error cursor to use
private static MatrixCursor sErrorCursor = new MatrixCursor(
CURSOR_ERROR_COLUMNS);
static {
// 为 CURSOR_ERROR_COLUMNS 添加给定的列值
sErrorCursor.addRow(ERROR_MESSAGE_ROW);
}
// Columns to be retrieved from the contacts database
private static final String[] CONTACTS_COLUMN_NAMES = new String[] {
ContactsContract.PhoneLookup._ID,
ContactsContract.PhoneLookup.DISPLAY_NAME,
ContactsContract.PhoneLookup.TIMES_CONTACTED,
ContactsContract.PhoneLookup.STARRED,
ContactsContract.PhoneLookup.PHOTO_ID };
@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
// Figure out the uri and return error if not matching
int type = URI_MATCHER.match(uri);
if (type == UriMatcher.NO_MATCH) {
// 如果URI 匹配出错则返回错误信息
return sErrorCursor;
}
Log.i("ss", "query called");
try {
// 调用 loadNewData方法进行查询 返回 匹配好的MatrixCursor对象
MatrixCursor mc = loadNewData(this);
// setNotificationUri方法用来指定一个Uri以观察它的变化
// 参数一：需要一个ContentResolver对象,从上下文对象获得
// 参数二：要监视的URI
mc.setNotificationUri(getContext().getContentResolver(),
Uri.parse("content://com.android.contacts/contacts/"));
MyCursor wmc = new MyCursor(mc, this);
return wmc;
} catch (Exception e) {
System.out.println("Print yi chang ");
// 返回我们的错误对象
return sErrorCursor;
}
}
public static MatrixCursor loadNewData(ContentProvider cp) {
//
MatrixCursor mc = new MatrixCursor(CURSOR_COLUMNS);
Cursor allContacts = null;
try {
// 说一下query方法的参数
/*
* 参数一：要查询的URI 我们查询的完整URI 为"content://com.android.contacts/contacts"
* 也就是所有的联系人参数二：都要查询那些列 上边我们已经定义好参数三：本质上就是一个WHERE子句，它以SQL
* WHERE子句(不包含WHERE本身) 的格式声明要返回的行 传递null将返回给定URI 的所有行
* 参数四：用来替换where子句中的？号参数五：指定排序的方式
*/
allContacts = cp
.getContext()
.getContentResolver()
.query(ContactsContract.Contacts.CONTENT_URI,
CONTACTS_COLUMN_NAMES, null, null,
ContactsContract.PhoneLookup.DISPLAY_NAME);
while (allContacts.moveToNext()) {
// 返回第二列的值 也就是 ContactsContract.PhoneLookup.TIMES_CONTACTED的值
// the zero-based index
String timesContacted = "Times contacted: "
+ allContacts.getInt(2);
Object[] rowObject = new Object[] {
allContacts.getLong(0), // id
allContacts.getString(1), // name
timesContacted, // description
Uri.parse("content://com.android.contacts/contacts/"
+ allContacts.getLong(0)), // intent uri
cp.getContext().getPackageName(), // package 返回应用程序的包名称
R.drawable.contacts // 返回我们LiveFolder的图标
};
// 给我们的 MatrixCursor 对象mc 添加给定的列值
mc.addRow(rowObject);
}
// 返回MatrixCursor对象
return mc;
} finally {
// 关闭Cursor对象， 并释放所有资源并使其无效
allContacts.close();
}
}
// 如果有自定义类型，必须实现此方法 这里我们 用的是 系统定义好的类型
@Override
public String getType(Uri uri) {
// indicates the MIME type for a given URI
// targeted for this wrapper provier
// This usually looks like
// "vnd.android.cursor.dir/vnd.google.note"
return ContactsContract.Contacts.CONTENT_TYPE;
}
@Override
public Uri insert(Uri uri, ContentValues values) {
throw new UnsupportedOperationException(
"no insert as this is just a wrapper");
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
throw new UnsupportedOperationException(
"no delete as this is just a wrapper");
}
@Override
public int update(Uri uri, ContentValues values, String selection,
String[] selectionArgs) {
throw new UnsupportedOperationException(
"no update as this is just a wrapper");
}
}
先说一下 timesContacted,它是用来记录 我们的联系人呼叫我我们几次 比如你电话存着 女朋友的电话 timesContacted就记录着你女朋友给你打了几个电话，或者说呼叫了你几次,还有就连这个也可以时时更新，所以说还是比较强大的。
INTENT 字段实际上是一个字符串，指向 ContentProvider 中该项的URL。在用户单击该项时，Android将使用此URL 来调用VIEW操作。此字符串字段称为 INTENT 字段是因为，在内部，Android会从字符串 URI 派生 INTENT。
方法 loadNewData() 从联系人提供程序获取一组联系人并创建 MatrixCursor，MatrixCursor对象包含我们需要的列。这段代码然后告诉 MatrixCursor 向 ContentResolver 注册自身，以便在URI (content://com.android.contacts/contacts/) 所指向的数据以任何形式发生变化时，ContentResolver能够提醒游标也就是我们的Cursor对象
MyCursor对象是我们自己定义的一个Cursor对象，这里要理解为什么需要包装游标，需要了解视图如何更新更改的内容。ContentProvider(比如Contacts)通常通过将一个URI 注册为 query方法实现的一部分，告诉游标它需要监视更改。这是通过 cursor.setNotificationUri完成的。游标然后将向 ContentProvider 注册此URI 及它的所有子URI。然后，当在 ContentProvider 上发生插入或删除操作时，插入或删除操作的代码需要发出一个事件，表示特定URI 所标识的行中的数据发生了更改。
这将出发游标通过 requery进行更新，视图也将相应更新。遗憾的是， MatrixCursor不适用此 requery。SQLiteCursor适用于它，但我们无法在这里使用 SQLiteCursor,因为我们已将这些列映射到了一组新列。
为了解决这一限制，我们将MatrixCursor包装到一个游标包装器中，并重写 requery 方法以丢弃内部的 MatrixCursor，并使用更新的数据创建一个新游标。更明确的讲，每次数据更改时，我们都希望获得新的 MatrixCursor。但我们仅向 Android活动文件夹框架返回所包装的外部游标。这将告诉活动文件夹框架只有一个游标，但在后台，当数据更改时我们会创建新游标，我们下面来说说这两个类。
4. MyCursor.java
MyCursor最开始使用一个 MatrixCursor进行初始化。在requery上， MyCursor 将回调提供程序来返回一个 MatrixCursor。然后，新 MatrixCursor 将使用 set 方法替代旧 MatrixCursor。
说明：可以通过重写 MatrixCursor的requery来完成此任务，但该类无法清除数据并重新启动。所以这是一种合理的解决办法。
package xiaohang.zhimeng;
import android.content.ContentProvider;
import android.database.MatrixCursor;
public class MyCursor extends BetterCursorWrapper {
private ContentProvider mcp = null;
public MyCursor(MatrixCursor mc, ContentProvider inCp) {
super(mc);
mcp = inCp;
}
@Override
public boolean requery() {
MatrixCursor mc = MyContactsProvider.loadNewData(mcp);
this.setInternalCursor(mc);
return super.requery();
}
}
5.BetterCursorWrapper.java
BetterCursorWrapper类 非常类似于 Android数据库框架中的 CursorWrapper类。但我们还需要 CursorWrapper 所缺少的另外两项功能。首先，它没有提供 set方法来替换 requery 方法中的内部游标。其次， CursorWrapper 不是CrossProcessCursor。活动文件夹需要 CrossProcessCursor,而不是普通游标，因为活动文件夹会跨进程边界进行工作。
BetterCursorWrapper源代码:
package xiaohang.zhimeng;
import android.content.ContentResolver;
import android.database.CharArrayBuffer;
import android.database.ContentObserver;
import android.database.CrossProcessCursor;
import android.database.CursorWindow;
import android.database.DataSetObserver;
import android.net.Uri;
import android.os.Bundle;
public class BetterCursorWrapper implements CrossProcessCursor {
// Holds the internal cursor to delegate methods to
protected CrossProcessCursor internalCursor;
public CursorWindow getWindow() {
return internalCursor.getWindow();
}
public boolean onMove(int oldPosition, int newPosition) {
return internalCursor.onMove(oldPosition, newPosition);
}
public int getCount() {
return internalCursor.getCount();
}
public int getPosition() {
return internalCursor.getPosition();
}
public boolean move(int offset) {
return internalCursor.move(offset);
}
public boolean moveToPosition(int position) {
return internalCursor.moveToPosition(position);
}
public boolean moveToFirst() {
return internalCursor.moveToFirst();
}
public boolean moveToLast() {
return internalCursor.moveToLast();
}
public boolean moveToNext() {
return internalCursor.moveToNext();
}
public boolean moveToPrevious() {
return internalCursor.moveToPrevious();
}
public boolean isFirst() {
return internalCursor.isFirst();
}
public boolean isLast() {
return internalCursor.isLast();
}
public boolean isBeforeFirst() {
return internalCursor.isBeforeFirst();
}
public boolean isAfterLast() {
return internalCursor.isAfterLast();
}
public int getColumnIndex(String columnName) {
return internalCursor.getColumnIndex(columnName);
}
public int getColumnIndexOrThrow(String columnName)
throws IllegalArgumentException {
return internalCursor.getColumnIndexOrThrow(columnName);
}
public String getColumnName(int columnIndex) {
return internalCursor.getColumnName(columnIndex);
}
public String[] getColumnNames() {
return internalCursor.getColumnNames();
}
public int getColumnCount() {
return internalCursor.getColumnCount();
}
public byte[] getBlob(int columnIndex) {
return internalCursor.getBlob(columnIndex);
}
public String getString(int columnIndex) {
return internalCursor.getString(columnIndex);
}
public void copyStringToBuffer(int columnIndex, CharArrayBuffer buffer) {
internalCursor.copyStringToBuffer(columnIndex, buffer);
}
public short getShort(int columnIndex) {
return internalCursor.getShort(columnIndex);
}
public int getInt(int columnIndex) {
return internalCursor.getInt(columnIndex);
}
public long getLong(int columnIndex) {
return internalCursor.getLong(columnIndex);
}
public float getFloat(int columnIndex) {
return internalCursor.getFloat(columnIndex);
}
public double getDouble(int columnIndex) {
return internalCursor.getDouble(columnIndex);
}
public boolean isNull(int columnIndex) {
return internalCursor.isNull(columnIndex);
}
public void deactivate() {
internalCursor.deactivate();
}
public boolean requery() {
return internalCursor.requery();
}
public void close() {
internalCursor.close();
}
public boolean isClosed() {
return internalCursor.isClosed();
}
public void registerContentObserver(ContentObserver observer) {
internalCursor.registerContentObserver(observer);
}
public void unregisterContentObserver(ContentObserver observer) {
internalCursor.unregisterContentObserver(observer);
}
public void registerDataSetObserver(DataSetObserver observer) {
internalCursor.registerDataSetObserver(observer);
}
public void unregisterDataSetObserver(DataSetObserver observer) {
internalCursor.unregisterDataSetObserver(observer);
}
public void setNotificationUri(ContentResolver cr, Uri uri) {
internalCursor.setNotificationUri(cr, uri);
}
public boolean getWantsAllOnMoveCalls() {
return internalCursor.getWantsAllOnMoveCalls();
}
public Bundle getExtras() {
return internalCursor.getExtras();
}
public Bundle respond(Bundle extras) {
return internalCursor.respond(extras);
}
// Constructor takes a crossprocesscursor as an input
public BetterCursorWrapper(CrossProcessCursor inCursor) {
this.setInternalCursor(inCursor);
}
// You can reset in one of the derived class's method
public void setInternalCursor(CrossProcessCursor inCursor) {
internalCursor = inCursor;
}
@Override
public void fillWindow(int pos, CursorWindow winow) {
internalCursor.fillWindow(pos, winow);
}
}
大家看前几个方法就行了，后边方法都没有用到 实现CrossProcessCursor这个接口就会实现这些方法。大家也可以用 Eclipse 自动生成一下，将光标放在 internalCursor上。用鼠标右键单击并选择 Source---》GenerateDelegate Methods。Eclipse随后将填充该类剩余部分。现在看一下完成此示例需要的一个简单activity.
6 .SimpleActivity.java:
SimpleActivity.java 不是活动文件夹必须的类，但在项目中包含它可以为所有项目提供一种通用模式。此外，它支持在通过 Eclipse调试时，部署应用程序并在屏幕上查看它。
package xiaohang.zhimeng;
import android.app.Activity;
import android.os.Bundle;
public class SimpleActivity extends Activity {
/** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
}
}
XML 布局文件:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="fill_parent"
android:layout_height="fill_parent">
<TextView android:layout_width="fill_parent"
android:layout_height="wrap_content" android:text="Live Folder Example" />
</LinearLayout>
完成这些就可以进行部署条数了.刚打开会打开一个Activity 就是我们上边的那个SimpleActivity 然后我们切换到主页 按照我们 最开始 介绍的步骤就可以建立 活动文件夹了
