Google Volley自定义请求实现指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00701/article/details/148577933

Google Volley自定义请求实现指南

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

前言

在Android网络编程中，Google Volley是一个强大且灵活的HTTP库。虽然Volley已经为常见数据类型（如字符串、图片和JSON）提供了内置支持，但在实际开发中，我们经常需要处理自定义数据类型或特殊协议。本文将深入讲解如何在Volley中实现自定义请求类型。

为什么需要自定义请求

Volley默认提供了以下几种标准请求：

StringRequest：处理字符串响应
ImageRequest：处理图片响应
JsonObjectRequest/JsonArrayRequest：处理JSON响应

但当遇到以下场景时，我们需要自定义请求：

需要解析特殊格式的数据（如Protocol Buffers、XML等）
需要实现特定的缓存逻辑
需要处理自定义的HTTP协议
需要将响应数据转换为特定的Java/Kotlin对象

自定义请求实现步骤

1. 继承Request类

自定义请求的核心是继承Request<T>抽象类，其中泛型参数T代表你期望的响应类型。例如，如果你希望响应被解析为自定义的User对象，则应继承Request<User>。

class CustomRequest<T>(
    method: Int,
    url: String,
    private val clazz: Class<T>,
    private val listener: Response.Listener<T>,
    errorListener: Response.ErrorListener
) : Request<T>(method, url, errorListener) {
    // 实现抽象方法
}

2. 实现parseNetworkResponse方法

这是自定义请求的核心方法，它在工作线程中被调用，负责将原始网络响应转换为你的目标类型。

关键点：

参数NetworkResponse包含：原始字节数据、HTTP状态码和响应头
必须返回Response<T>对象，包含解析后的数据或错误信息
应正确处理字符编码和缓存头信息

示例实现（Kotlin）：

override fun parseNetworkResponse(response: NetworkResponse?): Response<T> {
    return try {
        val json = String(
            response?.data ?: ByteArray(0),
            Charset.forName(HttpHeaderParser.parseCharset(response?.headers))
        )
        Response.success(
            gson.fromJson(json, clazz),
            HttpHeaderParser.parseCacheHeaders(response)
        )
    } catch (e: Exception) {
        Response.error(ParseError(e))
    }
}

3. 实现deliverResponse方法

此方法在主线程中被调用，负责将解析后的结果传递给监听器。

示例实现：

override fun deliverResponse(response: T) {
    listener.onResponse(response)
}

实战案例：GsonRequest完整实现

下面展示一个完整的自定义请求实现，它使用Gson库将JSON响应自动转换为Java/Kotlin对象：

class GsonRequest<T>(
    method: Int,
    url: String,
    private val clazz: Class<T>,
    private val headers: Map<String, String>?,
    private val requestBody: String?,
    private val listener: Response.Listener<T>,
    errorListener: Response.ErrorListener
) : Request<T>(method, url, errorListener) {
    
    private val gson = Gson()

    // 处理请求头
    override fun getHeaders(): Map<String, String> {
        return headers ?: super.getHeaders()
    }

    // 处理POST请求体
    override fun getBody(): ByteArray {
        return requestBody?.toByteArray() ?: super.getBody()
    }

    // 解析网络响应
    override fun parseNetworkResponse(response: NetworkResponse?): Response<T> {
        return try {
            val json = String(
                response?.data ?: ByteArray(0),
                Charset.forName(HttpHeaderParser.parseCharset(response?.headers))
            Response.success(
                gson.fromJson(json, clazz),
                HttpHeaderParser.parseCacheHeaders(response))
        } catch (e: UnsupportedEncodingException) {
            Response.error(ParseError(e))
        } catch (e: JsonSyntaxException) {
            Response.error(ParseError(e))
        }
    }

    // 传递响应结果
    override fun deliverResponse(response: T) {
        listener.onResponse(response)
    }
}