前言：

本文总结了Android客户端与服务器进行交互时，采用RESTful API +Json的交互方式，针对不同的数据形式以及不同的解析方法，如有不足之处，欢迎指正。

温馨提示：本文适合有一定Android开发经验的人阅读，如有疑问，欢迎留言讨论。

先了解一下相关的基本概念。

1. Android客户端与服务器端通信方式

通信方式主要有HTTP和Socket。

小结：HTTP和Socket都是基于TCP协议的。使用两种通信方式的情况是：

​ 1.使用HTTP的情况：双方不需要时刻保持连接在线，比如客户端资源的获取、文件上传等。

​ 2.使用UDP的情况：大部分即时通讯应用(QQ、微信)、聊天室、苹果APNs等。

2. Android客户端与服务器的数据交互方式

主要有三种：

从web服务器响应到手机终端的数据 一般打包在一个字节数组中，这个字节数据中包含了不同的数据类型，客端端采取Java数据流和过虑流的方式从字节数组中取出各种类型的数据。

这种交互方式我在学习Android之初用过，实际项目中并没有发现哪家公司在用。这种方式了扩展了Android平台在访问Web服务器进行交互时的解析数据能力，仅供研究学习。

Webservice的标准数据格式。

Protocol Buffers 是一种轻便高效的结构化数据存储格式，支持跨平台。它很适合做数据存储或 RPC 数据交换格式。比 JSON 最大的优点就是传输的时候数据体积可以压缩很小，传输效率比较高。本人在这个在项目中没有用到过。

JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。 易于人阅读和编写。同时也易于机器解析和生成。毫无疑问，大家最常用。

本文重点会介绍关于json数据格式 的常用格式。

json数据格式 的采用，根据业务情况，一般是团队中的共识。技术的迭代更新，到后期基本都会考虑多个平台的通用性、可移植性和可读性。比如 我们开发团队，有移动端开发（Android、iOS)、前端开发（H5开发）和后台开发（golang开发）。

关于服务器的开发规范，我们先来了解一下。

服务器开发规范 我们采用的是 RESTful，RESTful是目前最流流行的 API设计规范，用于web数据接口的设计。

3. 为什么要使⽤RESTful API

它的核心原则是定义用少量方法就能操作的命名资源。资源和方法可视为API的名词和动词。

4. http请求方式

项目搭建之始，客户端和服务器一般用 Get 和Post的方式来交互，随着业务的演进和技术的规范迭代，到后期我们都得按规范来。于是 我们采用了上述几种方式来设计服务器接口，相应地，移动端的请求方式也得与之对应。

至此，不在赘述RESTful API的设计规范，可自行百度了解更多。

5. Json交互数据类型实际中的运用

接口的数据一般都采用JSON格式进行传输，不过，需要注意的是，JSON的值只有六种数据类型：

传输的数据类型不能超过这六种数据类型,不能用Date数据类型，不同的解析库解析方式不同，可能会导致异常，如果遇到日期的数据，最好的方式就是使用毫秒数表示日期。

5.1 String的数据类型

使用场景：如用户退出登录时，只需要得到返回状态和提示信息即可，不需要返回任何数据。

 {
   "code": 1000,"message": "成功"
  }

数据解析工具类：

abstract class BaseStringCallback: BaseCallback() {

  override fun onSuccess(data: String) {
    val responseData = JSONObject(data)
    val code = responseData.getInt("code")
    val message = responseData.getString("message")

    if (code == 1000) {
      success(message)
    } else {
      //其他状态
    }
  }

  abstract fun success(msg: String)
}

调用时（伪代码）：

logoutApi.execute(object : BaseStringCallback() {
          override fun success(msg: String) {
   //处理数据
          }）

5.2 Object数据类型

识别标示为：{}

使用场景：如获取当前用户信息，返回owner实体类，这个类我们可以直接用Gson的工具类转换为owner实体类。

{
   "code": 1000,"message": "成功","resp": {
    "owner": {
     "id": 58180,"name": "张三","idCert": "","certType": 1,"modifier": "jun5753","updateTime": 1567127656436
    },}
  }

Json数据转换为实体类工具类：

abstract class BaSEObjectCallback<T>(private val clazz: Class<T>) : BaseCallback() {

  override fun onSuccess(data: String) {
    val responseData = JSONObject(data)
    val code = responseData.getInt("code")
    val message = responseData.getString("message")

    if (code == 1000) {
      val disposable = Observable.just(responseData)
          .map { it.getJSONObject("resp").toString() }
          .map { JsonUtil.parSEObject(it,clazz)!! }
          .applyScheduler()
          .subscribe(
              {
                success(it)
              },{
                //异常时处理
              })

    } else {
     //其他状态时处理
    }
  }

  abstract fun success(data: T)
}

调用时（伪代码）：

LaunchApi.getOwerInfo.execute(object : BaSEObjectCallback<OwnerEntity>(OwnerEntity::class.java) {
   override fun success(data: OwnerEntity) {
     //处理数据
   })

5.3. Array数据类型

识别标示为：[]

使用场景：如获取联系人列表，返回的数据是contact列表，如 ArrayList<contact >。

{
   "code": 1000,"resp": {
    "contact": [
     {
      "id": 5819,"name": "来啦","phone": "","address": "哈哈哈","province": "湖南省","city": "长沙市","area": "芙蓉区","isOwner": 0,"updateTime": 1566461377761
     },{
      "id": 5835,"name": "小六","phone": "13908258239","address": "天安门","province": "北京市","city": "北京市","area": "东城区","updateTime": 1567150580553
     }
    ]
   }
  }

Json数据转换为实体类列表工具类：

abstract class BaseArrayCallback<T>(private val clazz: Class<T>) :BaseCallback() {

  override fun onSuccess(data: String) {
    val responseData = JSONObject(data)
    val code = responseData.getInt("code")
    val message = responseData.getString("message")

    if (code == 1000) {
      val disposable = Observable.just(responseData)
          .map { it.getJSONArray("resp").toString() }
          .map { JsonUtil.parseArray(it,{
                //异常时处理
              })
    } else {
  //其他状态时处理
    }
  }
  abstract fun success(data: ArrayList<T>)
}

调用时(伪代码):

LaunchApi.getContactList.execute(object : BaseArrayCallback<ContactEntity>(ContactEntity::class.java) {
   override fun success(data: ArrayList<ContactEntity>) {
     //处理数据
   })

5.4 复杂数据格式

使用场景：如用户的筛选数据需要上传到服务器,每次进入筛选界面时先从服务器获取最新数据信息。

返回的筛选json数据如下所示：

{
   "code": 1000,"resp": {
    "filterdata": [
     321,671
    ],}

此时的数据 不同于上面提到的几种Json数据类型,返回的列表中 数据没有key,只有value值 。并不是以键值对(key-value)返回的。

解析方法：

声明实体类

class FilterEntity {

  /** 筛选的数据：解析数组对象 为Int 型数据 ArrayList<Int> */
  var filterdata = ArrayList<Int>()
}

调用方法（伪代码）：

HomeApi.getFilterData()
        .execute(object : CJJObjectCallback<FilterEntity>(FilterEntity::class.java) {
          override fun success(data: FilterEntity) {
          //处理数据
          }
        })

当用户选择筛选数据后，需要上传到服务器,伪代码如下：

//上传json示例为：[0,1,2,3,4]
val filterList = ArrayList<Int>()
//添加int数据
 filterList.add(321)
 filterList.add(671)
val jsonData = JsonUtil.toJson(filterList)
//上传服务器
 HttpTool.put(FILTER_DATA).param("data",jsonData)

//Gson转换方法
 fun toJson(object: Any): String {
    var str = ""
    try {
      str = gson.toJson(object)
    } catch (e: Exception) {

    }
    return str
  }

更多地，如果想要 上传多种数据类型，如key-value形式的数据到服务器，伪代码如下：

//json数据示例：{"group":[22,23,24],"brand":[1,4]}

// 客户分组筛选
val customerGroupJsonArray = ArrayList<Int>()

 val map = ArrayMap<String,ArrayList<Int>>()
  customerGroupList.forEach {
    customerGroupJsonArray.add(it.id)
   }
  map["group"] = customerGroupJsonArray

  // 品牌筛选
  val vehicleBrandJsonArray = ArrayList<Int>()
  vehicleBrandList.forEach {
    vehicleBrandJsonArray.add(it.brandId)
  }
  map["brand"] = vehicleBrandJsonArray

 //将map类型的数据转换为json数据
  val jsonData = JsonUtil.toJson(map)

 //上传服务器
  HttpTool.put(FILTER_DATA).param("data",jsonData)

6.总结

本文总结了Android与服务器的交互方式和数据类型，并总结了在实际项目的简单运用，数据格式的运用场景远不止上面提到的几种场景，后期会持续完善，如有不足之处，欢迎指出。

参考资料：

1.Android手机访问服务器的一种数据交互方法

2.App架构设计经验谈:接口的设计

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。