Android中的volley_2_类Volley

demo下载：http://download.csdn.net/detail/vvzhouruifeng/8747599

volley一共有四十多个类，而类Volley可以说是一个工具类，也是使用volley的入口类。该类的主要作用就是创建请求队列。

直接源码：

package com.android.volley.toolbox;

import android.content.Context;
import android.content.pm.PackageInfo;
import android.content.pm.PackageManager.NameNotFoundException;
import android.net.http.AndroidHttpClient;
import android.os.Build;

import com.android.volley.Network;
import com.android.volley.RequestQueue;

import java.io.File;

/**
 * Volley 是 Google 推出的 Android 异步网络请求框架和图片加载框架。 特别适合数据量小，通信频繁的网络操作
 * Volley内部大量使用了接口（比如缓存、请求、响应、网络请求的执行等），扩展性非常好，可以用默认的也可以自己进行定制
 * 类Volley是一个工具类，主要用于创建请求队列。
 * 
 * 涉及的主要的类：
 * 1.HttpStack 是定义网络请求的接口，其实现类有HttpClientStack和HurlStack.  HttpClientStack是使用HttpClient实现的 ，HurlStack是使用HttpUrlConnection实现的
 * 2.NetWork 是一个接口，利用HttpStack执行网络请求，并将返回值进行传递。创建请求队列时需要传入
 * 3.BasicNetwork该类实现了NetWork  是具体执行的类
 * 4.RequestQueue 请求队列，这是Volley的核心类，所有的网络请求都需要添加到该队列中，然后使用缓存调度线程和网络调度线程进行处理。在一个应用中最好保持该请求队列的唯一性。
 * 5.DiskBasedCache  缓存的实现类
 * 
 * Volley类提供了三个静态方法：都是用于创建请求队列的
 * 1.public static RequestQueue newRequestQueueInDisk(Context context,String dir, HttpStack stack)，这个方法让开发者可以自己定制缓存目录和网络请求的方式。
 * 2.public static RequestQueue newRequestQueue(Context context, HttpStack stack) 使用默认的缓存目录，但是需要传入定制的网络请求
 * 3.public static RequestQueue newRequestQueue(Context context) 使用默认的缓存和默认的网络请求   通常没有特殊需要的话，可以使用这个方法
 */
public class Volley {

	/** Default on-disk cache directory. */
	private static final String DEFAULT_CACHE_DIR = "volley";

	/**
	 * Creates a default instance of the worker pool and calls
	 * {@link RequestQueue#start()} on it.
	 * 
	 * @param context
	 *            A {@link Context} to use for creating the cache dir.
	 * @param stack
	 *            An {@link HttpStack} to use for the network, or null for
	 *            default.网络请求的接口，其实现类用HttpClient或HttpUrlconnection来实现
	 * @return A started {@link RequestQueue} instance. 一个请求队列，所有的请求都要先添加到该请求队列中来
	 */
	public static RequestQueue newRequestQueue(Context context, HttpStack stack) {
		//默认的缓存文件路径
		File cacheDir = new File(context.getCacheDir(), DEFAULT_CACHE_DIR);

		String userAgent = "volley/0";
		try {
			String packageName = context.getPackageName();
			PackageInfo info = context.getPackageManager().getPackageInfo(
					packageName, 0);
			userAgent = packageName + "/" + info.versionCode;
		} catch (NameNotFoundException e) {
		}
		// 默认 Android2.3 及以上基于 HttpURLConnection，2.3 以下基于 HttpClient 实现
		if (stack == null) {
			if (Build.VERSION.SDK_INT >= 9) {
				//基于HttpURLConnection
				stack = new HurlStack();
			} else {
				// Prior to Gingerbread, HttpUrlConnection was unreliable.
				// See:
				// http://android-developers.blogspot.com/2011/09/androids-http-clients.html
				//基于HttpClient实现
				stack = new HttpClientStack(
						AndroidHttpClient.newInstance(userAgent));
			}
		}
		//具体执行网络请求的类
		Network network = new BasicNetwork(stack);
		//创建一个请求队列，参数一位缓存请求及响应结果的缓存，参数二为网络请求类
		RequestQueue queue = new RequestQueue(new DiskBasedCache(cacheDir),
				network);
		//请求队列start  其实就是开启了缓存调度线程和网络调度线程
		queue.start();

		return queue;
	}

	/**
	 * context dir sdcard's root dire null
	 * */
	public static RequestQueue newRequestQueueInDisk(Context context,
			String dir, HttpStack stack) {
		File cacheDir = new File(dir, DEFAULT_CACHE_DIR);

		String userAgent = "volley/0";
		try {
			String packageName = context.getPackageName();
			PackageInfo info = context.getPackageManager().getPackageInfo(
					packageName, 0);
			userAgent = packageName + "/" + info.versionCode;
		} catch (NameNotFoundException e) {
		}

		if (stack == null) {
			// 默认 Android2.3 及以上基于 HttpURLConnection，2.3 以下基于 HttpClient 实现
			if (Build.VERSION.SDK_INT >= 9) {
				stack = new HurlStack();
			} else {
				// Prior to Gingerbread, HttpUrlConnection was unreliable.
				// See:
				// http://android-developers.blogspot.com/2011/09/androids-http-clients.html
				stack = new HttpClientStack(
						AndroidHttpClient.newInstance(userAgent));
			}
		}

		Network network = new BasicNetwork(stack);

		RequestQueue queue = new RequestQueue(new DiskBasedCache(cacheDir),
				network);
		queue.start();

		return queue;
	}

	/**
	 * Creates a default instance of the worker pool and calls 创建一个请求队列，以后所有的请求都需要先添加到该队列中来然后才能进行处理
	 * {@link RequestQueue#start()} on it.
	 * 
	 * @param context
	 *            A {@link Context} to use for creating the cache dir.
	 * @return A started {@link RequestQueue} instance.
	 */
	public static RequestQueue newRequestQueue(Context context) {
		//第二个参数为null，表示让系统自己根据Android版本选择使用哪种网络请求
		return newRequestQueue(context, null);
	}
}