android自带例子autoComplete的学习

失业中，没有事情做。研究下google的android，说不定以后有前途。
昨天把apiDemo中的autoComplete看了下，做了点笔记，就这样写出来以免以后忘记。

这个例子是自动完成名单中的联系人。

public class AutoComplete4 extends Activity {

@Override

protected void onCreate(Bundle icicle) {

super.onCreate(icicle);

setContentView(R.layout.autocomplete_4);

ContentResolver content = getContentResolver();

Cursor cursor = content.query(Contacts.People.CONTENT_URI,

PEOPLE_PROJECTION, null, null, Contacts.People.DEFAULT_SORT_ORDER);

ContactListAdapter adapter = new ContactListAdapter(cursor, this);

AutoCompleteTextView textView = (AutoCompleteTextView)

findViewById(R.id.edit);

textView.setAdapter(adapter);

}

public static class ContactListAdapter

extends CursorAdapter{

public ContactListAdapter(Cursor c, Context context) {

super(c, context);

mContent = context.getContentResolver();

}

@Override

public View newView(Context context, Cursor cursor, ViewGroup parent) {

TextView view = new TextView(context);

view.setText(cursor, 5);

return view;

}

@Override

public void bindView(View view, Context context, Cursor cursor) {

((TextView) view).setText(cursor, 5);

}

@Override

protected String convertToString(Cursor cursor) {

return cursor.getString(5);

}

@Override

protected Cursor runQuery(CharSequence constraint) {

StringBuilder buffer = null;

String[] args = null;

if (constraint != null) {

buffer = new StringBuilder();

buffer.append("UPPER(");

buffer.append(Contacts.ContactMethods.NAME);

buffer.append(") GLOB ?");

args = new String[] { constraint.toString().toUpperCase() + "*" };

}

return mContent.query(Contacts.People.CONTENT_URI, PEOPLE_PROJECTION,

buffer == null ? null : buffer.toString(), args,

Contacts.People.DEFAULT_SORT_ORDER);

}

private ContentResolver mContent;

}

private static final String[] PEOPLE_PROJECTION = new String[] {

Contacts.People._ID,

Contacts.People.PREFERRED_PHONE_ID,

Contacts.People.TYPE,

Contacts.People.NUMBER,

Contacts.People.LABEL,

Contacts.People.NAME,

Contacts.People.COMPANY

};

}

这个例子是自动完成名单中的联系人。

用到了下面几个类：

android.widget.CursorAdapter

文档是这样描述的：从一个Cursor暴露数据给一个ListView的配适器。这个Cursor必须包含'' _id'列''否则这个类是不会工作的。

在这个例子中，有一个内部类继承了该类，并且实现了两个抽象方法，重写了两个方法。他们分别是：

抽象方法1 View newView(Context context, Cursor cursor, ViewGroup parent) .

此方法似乎是每当游标指针下滚（或者是其他什么动作）时CursorAdapter显示的View。

该方法中的

TextView view = new TextView(context);

view.setText(cursor, 5);

指出了一中通过游标得到内容的方法

抽象方法2 void bindView(View view, Context context, Cursor cursor) .

这第二个方法很诡异，因为在前面一个方法里已经新建了一个View，并且已经赋值不知道在此处 一句 ((TextView) view).setText(cursor, 5)有什么作用。

覆盖方法1 String convertToString(Cursor cursor)

这个方法也很诡异，我把它注释掉了，结果证明他没有任何作用：程序照常运行。

覆盖方法2 Cursor runQuery(CharSequence constraint)

这个方法很关键，是根据提示进行查询的。

android.database.Cursor

文档是这样描述的：该接口提供随机的读写访问数据库查询的结果集。

类似java.sql .ResultSet，是一个游标。

android.provider.Contracts

文档是这样描述的：Contracts提供储存关于联系人的所有信息。

android.content.ContentReslover

文档是这样描述的：该类提供应用程序访问content即存储在设备上的内容。

该类的实例是通过Context的getContentReslover()方法得到。在该程序中主要用到ContentReslover的

public final Cursor query(ContentURI uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)方法。其中uri是该数据的地址，projection是返回的格式，类似select xxx,xxx,xxx from table

selection为查询条件，即SQL中的WHERE，selectionArgs为查询参数，即WHERE中的''?''，sortOrder是排序，即SQL中的ORDER BY。

android.widget.Filterable

文档是这样描述的：定义一个过滤行为。一个filterable类能让他的数据符合过滤的约束。Filterable通常被用在实现Adapter。在这个例子中ContactListAdapter虽然声明为这个接口的实现，但是实际上并没有用到。

程序运行下发现没有权限，看了下文档。在manifest文件里声明权限
<uses-permission id="android.permission.READ_CONTACTS" />

那么，这个程序算是完成了。