安卓第九夜 狂风
我们经常需要在安卓应用中包含简易的网页显示功能。我将在这一讲中实现网页的显示。
《狂风》，来自小Willem，荷兰画派黄金时代的作品。作为当时海上马车夫的荷兰，对航海题材的画情有独钟。 这种倾斜的船身，是当时的画家常用的手法，用于表现很强的风。
描述
上一讲实现了一个类别条目页面。现在，我希望点击某个类别后，能再次以条目的方式显示所有的联系人。在这个新的条目页面中，点击某个联系人后，能显示该联系人的URL指向的页面。相关的安卓知识点为：
- Intent和Bundle。传递数据。
- WebView。用于显示一个网页。
新的数据库查询方法
我将增加一个条目页面，用于显示某个类别下的所有联系人。在数据层面上，我需要从数据库中取出某个类别下的所有联系人。在上一讲中，我创建了ContactsManager类，用于和数据库交互。但之前的CRUD方法无法满足我的需求。我将为该类增加新的方法，以便从数据库中取出某个类别下的所有联系人。这个方法如下：
// Getting all contacts of a category
public List<Contact> getContactsByCategoryId(int categoryId) {
List<Contact> contacts = new LinkedList<Contact>();
SQLiteDatabase db = this.getReadableDatabase();
Cursor cursor = db.query(TABLE_CONTACTS, new String[] { KEY_ID,
KEY_NAME, KEY_URL, KEY_CATEGORY_ID }, KEY_CATEGORY_ID + "=?",
new String[] { String.valueOf(categoryId) }, null, null, null, null);
// iterate over all retrieved rows
Contact contact = null;
if (cursor.moveToFirst()) {
do {
contact = new Contact();
contact.setId(Integer.parseInt(cursor.getString(0)));
contact.setName(cursor.getString(1));
contact.setUrl(cursor.getString(2));
Category category = getCategory(Integer.parseInt(cursor.getString(3)));
contact.setCategory(category);
// Add contact to contacts
contacts.add(contact);
} while (cursor.moveToNext());
}
// return contacts
return contacts;
}上面方法中查询了数据库的TABLE_CONTACTS表格。我在数据库的query()方法中规定，在数据库查询时，将只保留符合KEY_CATEGORY_ID等于categoryId条件的数据记录。该方法将返回某个categoryId下的所有Contact数据，也就是某个目录下的所有联系人信息。
我将在后面使用这一新增方法。
在Intent放入附加数据
我希望点击类别后，能够进入显示该类别所有联系人，即启动一个新的联系人条目页面。由于类别的数目是动态变化的，我不可能为每个类别创建一个下游页面（而且这样也太麻烦了）。然而，我可以把类别信息传递给同一个下游页面，让该下游页面根据类别，进行不同的处理。这个数据传递的任务，将由Intent完成。从概念漫游（上）中，我们已经知道，Intent就像传令兵。现在，我要让传令兵夹带一点“私货”了。
package me.vamei.vamei;
import java.util.List;
import me.vamei.vamei.model.Category;
import me.vamei.vamei.model.ContactsManager;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ListView;
public class CategoryActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_category);
ListView listview = (ListView) findViewById(R.id.categoryList);
ContactsManager cm = new ContactsManager(this);
final List<Category> categories = cm.getAllCategories();
CategoryAdapter adapter = new CategoryAdapter(this,
R.layout.list_category, categories);
listview.setAdapter(adapter);
listview.setOnItemClickListener(new OnItemClickListener() {
public void onItemClick(AdapterView<?> parent, View view,int position, long id) {
Intent intent = new Intent(CategoryActivity.this, ContactListActivity.class);
// put extra data into intent
// the data will be passed along with the intent, as a key-value pair
intent.putExtra("CATEGORY_ID", categories.get(position).getId());
startActivity(intent);
}
});
}
}putExtra()方法在Intent中放入一个键值对。"CATEGORY_ID"是“键”，而点击条目对应Category的ID是“值”。
putExtra()方法会先创建一个Bundle对象，再传递这个Bundle对象。在安卓中，一个Bundle对象即一个键值对。键是一个字符串，值是任意可以打包的对象(parcelable object)。Bundle在安卓中的用途非常广泛。
我可以用下面的语句，等效的代替上面的putExtra()：
Bundle extra = new Bundle();
extra.putString("CATEGORY_ID", categories.get(position).getId());
intent.putExtra(extra);即手动创建Bundle对象，再利用putExtra()将Bundle对象附加在Intent对象上。
提取Intent中的附加数据
在下游的Activity中，我可以通过Context的getIntent()方法来获取Intent对象。下游Activity是新建的ContactListActivity。它将以条目的方式，显示类别下所有联系人：
package me.vamei.vamei;
import java.util.List;
import me.vamei.vamei.model.Contact;
import me.vamei.vamei.model.ContactsManager;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ListView;
public class ContactListActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_contact_list);
// Get extra data from the Intent
// i.e., category id
Intent intent = getIntent();
int cat_id = intent.getIntExtra("CATEGORY_ID", -1);
ContactsManager cm = new ContactsManager(this);
final List<Contact> contacts = cm.getContactsByCategoryId(cat_id);
ListView listview = (ListView) findViewById(R.id.contactList);
ContactAdapter adapter = new ContactAdapter(this,
R.layout.list_contact, contacts);
listview.setAdapter(adapter);
listview.setOnItemClickListener(new OnItemClickListener() {
public void onItemClick(AdapterView<?> parent, View view,int position, long id) {
Intent intent = new Intent(ContactListActivity.this, BlogActivity.class);
// Put extra data into the Intent, which is a URL
intent.putExtra("BLOG_URL", contacts.get(position).getUrl());
startActivity(intent);
}
});
}
}我在第一部分编写的数据库交互方法getContactsByCategoryId()，在上面的Activity中登场。提取出的Contact表，通过ListView和ContactAdapter，显示为联系人的条目页面。在点击条目后，URL信息放入Intent中，并启动下游的BlogActivity。BlogActivity根据Intent中的URL，来打开联系人的网页。
练习 参考安卓第八夜 玛丽莲梦露，增加ContactAdapter，activity_category_list.xml和list_contact.xml，以完整的实现联系人条目页面。
练习 根据之前提到的adb shell，为数据库增加Category和Contact记录。
联系人条目
使用WebView
下面我要添加BlogActivity。它使用了WebView视图元素来显示Web页面。我将增加一个布局文件activity_blog.xml，这个文件包含一个简单的WebView视图元素：
<WebView xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/web"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/hello_world" />通过操纵该视图元素，我可以把网页加载入这个视图元素。
下面，我将创建对应的BlogActivity。它将从Intent中提取URL地址。WebView的loadUrl()方法，用于加载URL所指向的网页：
package me.vamei.vamei;
import android.annotation.SuppressLint;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.webkit.WebView;
@SuppressLint("SetJavaScriptEnabled")
public class BlogActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_blog);
// Receive the URL from the upstream activity
Intent intent = getIntent();
String url = intent.getStringExtra("BLOG_URL");
WebView webView = (WebView) findViewById(R.id.web);
// Enable JavaScript
webView.getSettings().setJavaScriptEnabled(true);
// Load the web page of the URL
webView.loadUrl(url);
}
}注意上面的getSettings()方法将返回一个WebSettings对象，包含了WebView的设置功能。该对象的setJavaScriptEnabled()方法，将允许WebView运行网页上的JavaScript脚本。
为了WebView正常运行，我需要赋予应用访问互联网的权限，在AndroidManifest.xml中增加uses-permission标签：
<manifest ...>
...
<uses-permission android:name="android.permission.INTERNET" />
...
</manifest>
总结
putExtra(), getIntent(), getIntExtra()
WebView, getSettings(), loadUrl()