创建一个标准的 Request
创建一个标准的 Request
这节课描述了如何使用 Volley 支持的普通类型的 request:
-
StringRequest
,指定一个 URL 然后接收一个原始的 string,看这里的例子 Setting Up a Request Queue -
ImageRequest
,指定一个 URL 然后接收一个图片响应 -
JsonObjectRequest
和JsonArrayRequest
(两着都是JsonRequest
的子类),指定一个 URL 然后获取一个 JSON 对象 或者 JSON 数组响应
如果你期望的响应是这些类型,你可能不需要实现一个自定义 request,这节课描述如何使用这些标准的 request 类型,更多如何实现一个自定义 request 的信息,查看 Implementing a Custom Request。
请求一张图片
Volley 提供了一下类来实现图片 request,这些不同层级的类支持不同等级的处理图片:
-
ImageRequest
-一个可以通过给定 URL 获取图片并且回调返回一个 解码后的 bitmap,同时也提供了便利方法比如指定一个尺寸大小来调 整接收到的图片。最主要的好处是 Volley 的线程计划确保那些图片操 作(解码,调整大小)在 worker thread 中进行。 -
ImageLoader
- 一个从远程 URLs 加载和缓存图片的助手类,ImageLoader
是个处理大量的ImageRequest
s 的协调类。例 如,当在 ListView 中填充多个缩略图时,ImageLoader
提 供一个在正常的 Volley cache 之前的 memory cache,这样能够 有效防止闪烁。这使得实现一个 cache hit 不需要阻塞或者推迟 main thread,这在使用磁盘 I/O 时所不能实现的。ImageLoader
也提供了响应合并特性,不需要每次使得 response 处理类来设置 bitmap 到一个 view 导致整个视图数的从新布局,合并 response 使得能够同时传递多个响应从而提高性能。 -
NetworkImageView
-建立在ImageLoader
上,在那种从网络中加载图片的情况下可以有效取代 ImageView,NetworkImageView
也可以自动管理取消 pending requests(待处理 request) 如果那个 view 已经从视图层级当中分离出去时。
使用 ImageRequest
这里有一个使用 ImageRequest
的例子,它从指定 URL 中加载图片任何显示在 App 中,注意的代码片段需要和一个通过单例类来获取 RequestQueue
配合演示(查看 Setting Up a Request Queue 获取描述此话题的详情)
ImageView mImageView;
String url = "http://i.imgur.com/7spzG.png";
mImageView = (ImageView) findViewById(R.id.myImage);
...
// Retrieves an image specified by the URL, displays it in the UI.
ImageRequest request = new ImageRequest(url,
new Response.Listener<Bitmap>() {
@Override
public void onResponse(Bitmap bitmap) {
mImageView.setImageBitmap(bitmap);
}
}, 0, 0, null,
new Response.ErrorListener() {
public void onErrorResponse(VolleyError error) {
mImageView.setImageResource(R.drawable.image_load_error);
}
});
// Access the RequestQueue through your singleton class.
MySingleton.getInstance(this).addToRequestQueue(request);
使用 ImageLoader 和 NetworkImageView
你可以组合使用 ImageLoader
和 NetworkImageView
有效地管理显示多张图片,例如在 ListView 中,在你的布局 XML 文件中,你可以像使用 ImageView 一样使用 NetworkImageView
,例如:
<com.android.volley.toolbox.NetworkImageView
android:id="@+id/networkImageView"
android:layout_width="150dp"
android:layout_height="170dp"
android:layout_centerHorizontal="true" />
你可以单独使用 ImageLoader
来加载显示一张图片,例如:
ImageLoader mImageLoader;
ImageView mImageView;
// The URL for the image that is being loaded.
private static final String IMAGE_URL =
"http://developer.android.com/images/training/system-ui.png";
...
mImageView = (ImageView) findViewById(R.id.regularImageView);
// Get the ImageLoader through your singleton class.
mImageLoader = MySingleton.getInstance(this).getImageLoader();
mImageLoader.get(IMAGE_URL, ImageLoader.getImageListener(mImageView,
R.drawable.def_image, R.drawable.err_image));
但是,NetworkImageView
能够帮你做这些工作如果你做的是填充一个 ImageView,例如:
ImageLoader mImageLoader;
NetworkImageView mNetworkImageView;
private static final String IMAGE_URL =
"http://developer.android.com/images/training/system-ui.png";
...
// Get the NetworkImageView that will display the image.
mNetworkImageView = (NetworkImageView) findViewById(R.id.networkImageView);
// Get the ImageLoader through your singleton class.
mImageLoader = MySingleton.getInstance(this).getImageLoader();
// Set the URL of the image that should be loaded into this view, and
// specify the ImageLoader that will be used to make the request.
mNetworkImageView.setImageUrl(IMAGE_URL, mImageLoader);
上面的代码片段通过一个单例类来访问 RequestQueue
和 ImageLoader
就像 Setting Up a Request Queue 描述的那样,这种方式能够确保你的 app 为这些类创建能够持续整个 App 生命周期的单个实例,这个对于 ImageLoader
(处理加载和缓存图片的助手类)在 in-memory cache(内存缓存) 这个主要的功能特性上能够在非闪烁的情况下旋转屏幕。使用单例模式能够独立于 activity 来缓存 bitmap,如果你在一个 activity 上创建一个 ImageLoader
,当用户每次旋转屏幕时,ImageLoader
都会随 activity 的重建而重建,这可能导致闪烁问题(没有在 manifest XML 文件指定该 activity 的 configChanges 属性)
LRU cache 例子:
Volley 工具盒提供 DiskBasedCache
类实现了一个标准的 cache,这个类缓存在指定的目录下直接缓存文件,但是在使用 ImageLoader
时,你应该提供一个自定义的实现 ImageLoader.ImageCache
接口实现 in-memory LRU bitmap cache(LRU 内存位图缓存),你可能想要配置你的 cache 为一个单例,查看 Setting Up a Request Queue 了解更多信息
这里有一个实现内存缓存的 LruBitmaoCache
类,它继承 LruCache 类并实现了 ImageLoader.ImageCache
接口:
import android.graphics.Bitmap;
import android.support.v4.util.LruCache;
import android.util.DisplayMetrics;
import com.android.volley.toolbox.ImageLoader.ImageCache;
public class LruBitmapCache extends LruCache<String, Bitmap>
implements ImageCache {
public LruBitmapCache(int maxSize) {
super(maxSize);
}
public LruBitmapCache(Context ctx) {
this(getCacheSize(ctx));
}
@Override
protected int sizeOf(String key, Bitmap value) {
return value.getRowBytes() * value.getHeight();
}
@Override
public Bitmap getBitmap(String url) {
return get(url);
}
@Override
public void putBitmap(String url, Bitmap bitmap) {
put(url, bitmap);
}
// Returns a cache size equal to approximately three screens worth of images.
public static int getCacheSize(Context ctx) {
final DisplayMetrics displayMetrics = ctx.getResources().
getDisplayMetrics();
final int screenWidth = displayMetrics.widthPixels;
final int screenHeight = displayMetrics.heightPixels;
// 4 bytes per pixel
final int screenBytes = screenWidth * screenHeight * 4;
return screenBytes * 3;
}
}
这里有一个如何使用这个 cache 来实例化一个 ImageLoader
例子:
RequestQueue mRequestQueue; // assume this exists.
ImageLoader mImageLoader = new ImageLoader(mRequestQueue, new LruBitmapCache(
LruBitmapCache.getCacheSize()));
请求一个 JSON
Volley 提供下面这些类来实现 JSON 请求
-
JsonArrayRequest
-一个根据指定 URL 请求和检索一个 JSONArray 响应实体 -
JsonObjectRequest
- 一个根据指定 URL 请求和检索一个 JSONObject 响应实体,允许传入一个可选的 JSONObject 作为请求实体
这两个类都是基于普通的基类 JsonRequest
,你可以使用以下基本模式来使用其他类型的 request,例如,下面的代码片段获取 JSON 并以文本形式显示在 UI 上:
TextView mTxtDisplay;
ImageView mImageView;
mTxtDisplay = (TextView) findViewById(R.id.txtDisplay);
String url = "http://my-json-feed";
JsonObjectRequest jsObjRequest = new JsonObjectRequest
(Request.Method.GET, url, null, new Response.Listener<JSONObject>() {
@Override
public void onResponse(JSONObject response) {
mTxtDisplay.setText("Response: " + response.toString());
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
// TODO Auto-generated method stub
}
});
// Access the RequestQueue through your singleton class.
MySingleton.getInstance(this).addToRequestQueue(jsObjRequest);
要实现一个自定义 JSON 请求基于 Gson,查看下节课程,Implementing a Custom Request.