创建一个标准的 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 是个处理大量的 ImageRequests 的协调类。例 如，当在 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.