Google Volley网络请求框架入门指南：发送简单请求

董瑾红William

于 2025-06-11 09:15:34 发布

阅读量371

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00596/article/details/148578005

版权

Google Volley网络请求框架入门指南：发送简单请求

volley 项目地址: https://gitcode.com/gh_mirrors/volley/volley

前言

Google Volley是Android平台上轻量级的网络通信库，特别适合处理高频但数据量不大的网络请求。本文将详细介绍如何使用Volley发送简单的网络请求，这是Volley框架最基础也是最重要的功能。

Volley工作原理概述

Volley的核心工作机制基于"请求队列(RequestQueue)"模型，主要包含以下组件：

RequestQueue：请求队列，负责管理工作线程和请求分发
Request：具体的请求对象，封装了请求参数和响应处理逻辑
CacheDispatcher：缓存调度线程，处理可缓存的请求
NetworkDispatcher：网络调度线程，处理需要网络访问的请求

Volley的巧妙之处在于它自动管理线程池和请求优先级，开发者只需关注请求本身和响应处理。

准备工作

添加网络权限

在AndroidManifest.xml中添加网络权限是使用Volley的前提条件：

<uses-permission android:name="android.permission.INTERNET" />

没有此权限，应用将无法进行任何网络通信。

创建请求队列

Volley提供了便捷方法来创建默认配置的请求队列：

Kotlin实现

// 创建请求队列
val queue = Volley.newRequestQueue(context)

Java实现

// 创建请求队列
RequestQueue queue = Volley.newRequestQueue(this);

newRequestQueue方法会创建一个带有默认配置的请求队列，包括：

默认的缓存目录
基于HttpURLConnection的网络实现
默认的线程池配置（通常4个网络线程）

构建并发送请求

Volley支持多种类型的请求，最基本的字符串请求(StringRequest)示例如下：

Kotlin示例

val url = "https://api.example.com/data"

val stringRequest = StringRequest(
    Request.Method.GET, url,
    { response ->
        // 成功响应处理
        textView.text = "响应内容: ${response.substring(0, 500)}"
    },
    { error ->
        // 错误处理
        textView.text = "请求失败: ${error.message}"
    }
)

// 将请求加入队列
queue.add(stringRequest)

Java示例

String url = "https://api.example.com/data";

StringRequest stringRequest = new StringRequest(
    Request.Method.GET, url,
    new Response.Listener<String>() {
        @Override
        public void onResponse(String response) {
            textView.setText("响应内容: " + response.substring(0, 500));
        }
    },
    new Response.ErrorListener() {
        @Override
        public void onErrorResponse(VolleyError error) {
            textView.setText("请求失败: " + error.getMessage());
        }
    }
);

queue.add(stringRequest);

关键点说明

响应线程：Volley自动将响应回调切换到主线程，可以直接更新UI
请求方法：支持GET、POST、PUT、DELETE等HTTP方法
回调分离：成功和失败回调分开处理，代码更清晰

请求生命周期管理

请求处理流程

请求被添加到队列
缓存线程检查是否有有效缓存
- 有缓存且未过期：直接返回缓存数据
- 无缓存或已过期：进入网络队列
网络线程执行实际网络请求
响应被解析并缓存（如果可缓存）
结果通过主线程Handler传递到UI线程

请求取消机制

合理取消请求是良好应用实践的重要部分，特别是在Activity生命周期结束时：

// 为请求设置标签
request.tag = "ACTIVITY_REQUEST"

// 在Activity的onStop中取消所有该标签的请求
override fun onStop() {
    super.onStop()
    requestQueue?.cancelAll("ACTIVITY_REQUEST")
}

// 设置请求标签
request.setTag("ACTIVITY_REQUEST");

// 取消请求
@Override
protected void onStop() {
    super.onStop();
    if (requestQueue != null) {
        requestQueue.cancelAll("ACTIVITY_REQUEST");
    }
}

取消请求的最佳实践：