简介：

Netroid是一个基于Volley 实现的Android Http库。提供异步执行网络请求、缓存返回结果、批量图片加载、大文件断点下载的常见Http交互功能。致力于避免每个项目重复开发基础Http功能，实现显著地缩短开发周期的愿景。

实现原理：

Netroid自启动后创建由开发者指定的线程数目，每个线程由 BlockingQueue 进行阻塞。当有新的请求进入队列时，其中一个线程将被唤醒并获得请求对象，然后开始执行，执行完成后线程重新回到阻塞状态，等待下一次唤醒。Netroid实现了强大的状态回调接口在请求执行过程中进行通知，包括开始、完成、成功、重试、失败、取消、执行网络操作、应用缓存、下载进度九种状态回调，开发者可方便地获取请求的执行情况，对用户进行友好提醒。

使用方法

Netroid库的主入口是RequestQueue，通常情况下在Application.onCreate()方法中初始化，作为全局单例对象存放：

Network network = new BasicNetwork(new HurlStack(Const.USER_AGENT, null), HTTP.UTF_8);
// RequestQueue在创建时可指定使用HttpURLConnection还是HttpClient来执行请求，同时可指定硬盘缓存的目录位置及上限大小
RequestQueue mQueue = new RequestQueue(network, 4,
    new DiskCache(new File(ctx.getCacheDir(), Const.HTTP_DISK_CACHE_DIR_NAME), Const.HTTP_DISK_CACHE_SIZE));
mQueue.start();

在需要发起Http请求时，只需要创建一个Request实例，添加入RequestQueue即可，Netroid会部署并在线程允许的情况下执行，并通过Listener的各个接口回调执行结果到主线程：

StringRequest request = new StringRequest(url, new Listener<String>() {
    ProgressDialog mPrgsDialog;

    @Override
    public void onPreExecute() {
        mPrgsDialog = ProgressDialog.show(Activity.this, null, "loading...", true, true);
    }

    // cancel the dialog with onFinish() callback
    @Override
    public void onFinish() {
        mPrgsDialog.cancel();
    }

    @Override
    public void onSuccess(String response) {
        Toast.makeText(Activity.this, "response is ： " + response, 2000).show();
    }

    @Override
    public void onError(NetroidError error) {
        Toast.makeText(Activity.this, error.getMessage(), 2000).show();
    }

    @Override
    public void onCancel() {
        Toast.makeText(Activity.this, "request was cancel", 2000).show();
    }
});

// add the request to RequestQueue, will execute quickly if has idle thread
mQueue.add(request);

图片加载

使用Netroid提供的ImageLoader可以非常方便地实现图片加载功能，ImageLoader需要在初始化RequestQueue时创建，因为其作为Netroid的一个组件，依赖于Netroid的请求调用机制：

// ImageLoader在创建时可指定图片的内存缓存方案
ImageLoader mImageLoader = new SelfImageLoader(
        mRequestQueue, new BitmapImageCache(Const.HTTP_MEMORY_CACHE_SIZE));

在需要加载图片的地方，只需要调用ImageLoader的方法即可：

ImageLoader.ImageListener listener = ImageLoader.getImageListener(imageView, 0, 0);
mImageLoader.get(url, listener, 0, 0);

Netroid提供了继承自ImageView的NetworkImageView来专门处理ListView、GridView图片频繁刷新加载的问题：

...Inner Adapter
@Override
public View getView(int position, View convertView, ViewGroup parent) {
    NetworkImageView imvCover = (NetworkImageView) convertView.findViewById(R.id.imvCover);
    imvCover.setImageUrl(book.getImageUrl(), mImageLoader);
}
...

大文件下载

Netroid实现的 FileDownloader 对断点续传方式的大文件下载提供了支持，其内部维护一个下载队列，所以在创建时需要指定最大并行任务数，超出限制的任务将自动进入等待队列。在设置最大并行任务数后，开发者只需要往队列中不断添加任务，其它的事情均由 FileDownloader 完成。

FileDownloader的使用方法跟ImageLoader相同，在Application中创建一个单例的对象，在需要使用的地方调用接口：

FileDownloader mFileDownloader = new FileDownloader(mRequestQueue, 1);

FileDownloader将在任务添加成功时返回 DownloadController 实例对象，这个对象提供了查看任务执行状态、暂停、继续、取消四项必需的操作功能，开发者只需要持有这个对象，即可随时掌控任务的所有情况。

public static FileDownloader.DownloadController addFileDownload(String storeFilePath, String url, Listener<Void> listener) {
    return mFileDownloader.add(storeFilePath, url, listener);
}

关于项目

Netroid开源于Github，提供完善的中文文档指引，所有更新都会第一时间发布于项目主页内，大家在使用过程中发现问题时或有不明白的地方，可以反馈到github，交流以促进项目功能的完善。

为了让开发者快速了解Netroid的所有功能点，可以下载演示程序先行查看效果。

来源：oschina

链接：https://my.oschina.net/u/232231/blog/261893

标签

Netroid

volley

android

http

Netroid:强大、快速、易用、可扩展基于Volley实现的Android Http库

简介：

实现原理：

使用方法

图片加载

大文件下载

关于项目