Retrofit + Gson解析数据容错处理

使用Retrofit+Gson 处理网络数据，后台数据返回不规范，因为种种原因后台无法修改，直接解析会报错JsonSyntaxException，有时需要我们做容错处理
（当然可以解析时传String,这时就需要我们手动解析每个数据结构，比较麻烦）

数据不规范的奇葩问题

问题1:

int类型为空时，返回了“”，这时会报错 java.lang.NumberFormatException: empty String

问题2:

原始字段原来为String,后期修改为其他数据类型，但是未通知客户端
（在解析数据的时候，无用字段最好去除）

问题3:

有数据时返回对象，无数据时返回字符串 “”

有数据
{
"code": "0",
"message": "",
"result": {
"age":10
},

}
无数据
{
"code": "0",
"message": "",
"result": ""

}

问题4 同一个字段名字，code 不同，返回不同的类型

这个没有什么好办法，只能用object接收，根据code 手动解析

为了解决这几个问题，我们需要了解retrofit 和gson的解析原理，找到正确位置来添加我们的容错代码

当前分析的Gson版本号为2.8.5

 Gson gson = new Gson();
 gson.fromJson(str,BaseTest.class);

首先，创建gson初始化时，会添加解析TypeAdapterFactory，后面主要使用它来解析数据


企业微信截图_97bec518-e658-4398-87ab-645ae2c79165.png

下面步入正题，看Gson.formJson()内部，最终调用
public <T> T fromJson(JsonReader reader, Type typeOfT)

public <T> T fromJson(JsonReader reader, Type typeOfT) throws JsonIOException, JsonSyntaxException {
   ...
    try {
      reader.peek();
      isEmpty = false;
      TypeToken<T> typeToken = (TypeToken<T>) TypeToken.get(typeOfT);
      TypeAdapter<T> typeAdapter = getAdapter(typeToken);
      T object = typeAdapter.read(reader);
      return object;
    } catch (EOFException e) {
     ...
  }

根据typeToken获取解析的adapter (gson初始化是默认添加的TypeAdapterFactory获取)

  public <T> TypeAdapter<T> getAdapter(TypeToken<T> type) {
    TypeAdapter<?> cached = typeTokenCache.get(type == null ? NULL_KEY_SURROGATE : type);
  ...

    try {
     ...
      for (TypeAdapterFactory factory : factories) {
        TypeAdapter<T> candidate = factory.create(this, type);
        if (candidate != null) {
          call.setDelegate(candidate);
          typeTokenCache.put(type, candidate);
          return candidate;
        }
      }
      throw new IllegalArgumentException("GSON (" + GsonBuildConfig.VERSION + ") cannot handle " + type);
    } finally {
     ...
    }
  }

常用factory生成类：TypeAdapters 各种基础解析器（int String...）
其中自定义类factory 为ReflectiveTypeAdapterFactory
会解析整个类，拿到具体数据类型，进而调用上一步的方法gson. getAdapter（）解析基础类型

gson提供了自定义解析器的方法
方法1: 直接定义factoty

  Gson gson = new Gson().newBuilder()
.registerTypeAdapterFactory(new MyTypeAdapterFactory<Test>()).create();

   public class MyTypeAdapterFactory<T> implements TypeAdapterFactory {
        @SuppressWarnings("unchecked")
        public <T> TypeAdapter<T> create(Gson gson, TypeToken<T> type) {
            Class<T> rawType = (Class<T>) type.getRawType();
            if (rawType == String.class) {
                return (TypeAdapter<T>) new MyAdapter();
            }if(rawType == int.class){
                return (TypeAdapter<T>)IntTypeAdapter;
            }
            return null;
        }
    }

方法2： 定义adapter

 gson = new GsonBuilder()
                .setLenient()
                .registerTypeAdapter(long.class, LongTypeAdapter)
                .registerTypeAdapter(Long.class, LongTypeAdapter)
                .registerTypeAdapter(int.class, IntTypeAdapter)
                .registerTypeAdapter(Integer.class, IntTypeAdapter)
                .registerTypeAdapter(String.class,StringTypeAdapter)
         .create();

到此，我们可以解决 问题1 问题2

  1. int 字端，但后台返回“”，这时会报错 java.lang.NumberFormatException: empty String
    private  TypeAdapter<Number> IntTypeAdapter = new TypeAdapter<Number>() {
        @Override
        public void write(JsonWriter out, Number value) throws IOException {
            out.value(value);
        }

        @Override
        public Number read(JsonReader in) throws IOException {
            if (in.peek() == JsonToken.NULL) {
                in.nextNull();
                return null;
            }
            try {
                String result = in.nextString();
                if ("".equals(result)) {
                    return null;
                }
                return Integer.parseInt(result);
            } catch (NumberFormatException e) {
                throw new JsonSyntaxException(e);
            }
        }
    };
  1. String 字端，但后台返回了对象
    private TypeAdapter<String> StringTypeAdapter = new TypeAdapter<String>() {
        @Override
        public void write(JsonWriter out, String value) throws IOException {
            LogUtils.e("write");
            out.value(value);
        }

        @Override
        public String read(JsonReader in) throws IOException {
           // LogUtils.e("read");
            if (in.peek() == JsonToken.NULL) {
                in.nextNull();
                return null;
            }

            // number类的也会执行这个方法，但是number返回null 会报错，所以把Number排除
            if(in.peek() != JsonToken.STRING && in.peek() != JsonToken.NUMBER){
               // LogUtils.e("typeAdapter","stringTypeAdapter 不是String = "+in.peek());
           //不是String，直接跳过，不解析
                in.skipValue();
                return null;
            }
            String result = in.nextString();

           // LogUtils.e("typeAdapter","stringTypeAdapter ="+result);
            return result;
    }};

问题3 通过自定义一个 ReflectiveTypeAdapterFactory可能也可以实现，但是比较麻烦

代码中使用retrofit+gson,查看报错位置

解析过程中okhttpCall ---> callback.onFailure(OkHttpCall.this, e);
java.lang.IllegalStateException: Expected STRING but was BEGIN_OBJECT at line 1 column 353 path $.data....

下面看一下retrofit+gson实现解析的过程
当前分析的retrofit版本号为2.6.0

首先retrofit 入口处

 Retrofit.Builder builder = new Retrofit.Builder();
      ...
//自定义解析器
  builder.addConverterFactory(GsonConverterFactory.create(gson));
  retrofitsingleton = builder.build();
  return retrofitsingleton.create(clazz);

Retrofit.create()方法动态代理

  public <T> T create(final Class<T> service) {
   ...
    return (T) Proxy.newProxyInstance(service.getClassLoader(), new Class<?>[] { service },
        new InvocationHandler() {
          private final Platform platform = Platform.get();
          private final Object[] emptyArgs = new Object[0];

          @Override public @Nullable Object invoke(Object proxy, Method method,
              @Nullable Object[] args) throws Throwable {
               ...
            return loadServiceMethod(method).invoke(args != null ? args : emptyArgs);
          }
        });
  }

继续跟进 loadServiceMethod(method).invoke()方法
ServiceMethod ---HttpServiceMethod.invoke()

@Override final @Nullable ReturnT invoke(Object[] args) {
    Call<ResponseT> call = new OkHttpCall<>(requestFactory, args, callFactory, responseConverter);
    return adapt(call, args);
  }

Call adapt(call args) 最终返回的是okhttpCall
最终调用 okhttpCall.enqueue（），可以看到解析数据位置

  @Override public void enqueue(final Callback<T> callback) {
  
    call.enqueue(new okhttp3.Callback() {
      @Override public void onResponse(okhttp3.Call call, okhttp3.Response rawResponse) {
        Response<T> response;
        try {
       //***********************
        //***解析数据位置
       //***********************
          response = parseResponse(rawResponse);
        } catch (Throwable e) {
          throwIfFatal(e);
        //***********************
        //***失败调用callback.onFailure(OkHttpCall.this, e);
       //***********************
          callFailure(e);
          return;
        }

        try {
          callback.onResponse(OkHttpCall.this, response);
        } catch (Throwable t) {
          throwIfFatal(t);
          t.printStackTrace(); // TODO this is not great
        }
      }

      @Override public void onFailure(okhttp3.Call call, IOException e) {
        callFailure(e);
      }

      private void callFailure(Throwable e) {
        try {
          callback.onFailure(OkHttpCall.this, e);
        } catch (Throwable t) {
          throwIfFatal(t);
          t.printStackTrace(); // TODO this is not great
        }
      }
    });
  }

接下来看具体解析过程 response=parseResponse(rawResponse)

Converter<ResponseBody, T> responseConverter;
  Response<T> parseResponse(okhttp3.Response rawResponse) throws IOException {
    ResponseBody rawBody = rawResponse.body();
 ...
  T body = responseConverter.convert(catchingBody);
      return Response.success(body, rawResponse);
···
  }

可以看到解析为 Converter<ResponseBody, T> responseConverter;
responseConverter 在 Retrofit build时初始化 （BuiltInConverters）
retrofit提供了自定义方法：
public Builder addConverterFactory(Converter.Factory factory) {
需要我们自定义ConverterFactory
可以参考 api 'com.squareup.retrofit2:converter-gson:2.6.0'中
GsonConverterFactory

下面通过自定义ConverterFactory，解决第三个问题

3.有数据时返回的是对象，无数据的时候返回了“”
{
"code": "0",
"message": "",
"result": [{
"age":10
}],

}
{
"code": "0",
"message": "",
"result": ""

}

简单处理，当获取数据为“”修改为 result = null

package com.nucarf.base.retrofit.gson;

import com.google.gson.Gson;
import com.google.gson.TypeAdapter;
import com.google.gson.reflect.TypeToken;

import java.lang.annotation.Annotation;
import java.lang.reflect.Type;

import okhttp3.RequestBody;
import okhttp3.ResponseBody;
import retrofit2.Converter;
import retrofit2.Retrofit;

public final class GsonConverterFactory extends Converter.Factory {
    /**
     * Create an instance using a default {@link Gson} instance for conversion. Encoding to JSON and
     * decoding from JSON (when no charset is specified by a header) will use UTF-8.
     */
    public static GsonConverterFactory create() {
        return create(new Gson());
    }

    /**
     * Create an instance using {@code gson} for conversion. Encoding to JSON and
     * decoding from JSON (when no charset is specified by a header) will use UTF-8.
     */
    @SuppressWarnings("ConstantConditions") // Guarding public API nullability.
    public static GsonConverterFactory create(Gson gson) {
        if (gson == null) throw new NullPointerException("gson == null");
        return new GsonConverterFactory(gson);
    }

    private final Gson gson;

    private GsonConverterFactory(Gson gson) {
        this.gson = gson;
    }

    @Override
    public Converter<ResponseBody, ?> responseBodyConverter(Type type, Annotation[] annotations,
                                                            Retrofit retrofit) {
        TypeAdapter<?> adapter = gson.getAdapter(TypeToken.get(type));
        return new GsonResponseBodyConverter<>(gson, adapter);
    }

    @Override
    public Converter<?, RequestBody> requestBodyConverter(Type type,
                                                          Annotation[] parameterAnnotations, Annotation[] methodAnnotations, Retrofit retrofit) {
        TypeAdapter<?> adapter = gson.getAdapter(TypeToken.get(type));
        return new GsonRequestBodyConverter<>(gson, adapter);
    }
}



package com.nucarf.base.retrofit.gson;

import com.google.gson.Gson;
import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonWriter;

import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.nio.charset.Charset;

import okhttp3.MediaType;
import okhttp3.RequestBody;
import okio.Buffer;
import retrofit2.Converter;

/**
 * author : li
 * date   : 2020/10/13/1:43 PM
 */
final class GsonRequestBodyConverter<T> implements Converter<T, RequestBody> {
    private static final MediaType MEDIA_TYPE = MediaType.get("application/json; charset=UTF-8");
    private static final Charset UTF_8 = Charset.forName("UTF-8");

    private final Gson gson;
    private final TypeAdapter<T> adapter;

    GsonRequestBodyConverter(Gson gson, TypeAdapter<T> adapter) {
        this.gson = gson;
        this.adapter = adapter;
    }

    @Override public RequestBody convert(T value) throws IOException {
        Buffer buffer = new Buffer();
        Writer writer = new OutputStreamWriter(buffer.outputStream(), UTF_8);
        JsonWriter jsonWriter = gson.newJsonWriter(writer);
        adapter.write(jsonWriter, value);
        jsonWriter.close();
        return RequestBody.create(MEDIA_TYPE, buffer.readByteString());
    }
}


package com.nucarf.base.utils;

import com.google.gson.Gson;
import com.google.gson.JsonIOException;
import com.google.gson.JsonSyntaxException;
import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonToken;

import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStreamReader;

import okhttp3.ResponseBody;
import retrofit2.Converter;

package com.nucarf.base.utils;

import com.google.gson.Gson;
import com.google.gson.JsonIOException;
import com.google.gson.JsonSyntaxException;
import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonToken;

import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStreamReader;

import okhttp3.ResponseBody;
import retrofit2.Converter;

/**
 * author : li
 * date   : 2020/10/13/1:42 PM
 */
final class GsonResponseBodyConverter<T> implements Converter<ResponseBody, T> {
    private final Gson gson;
    private final TypeAdapter<T> adapter;

    GsonResponseBodyConverter(Gson gson, TypeAdapter<T> adapter) {
        this.gson = gson;
        this.adapter = adapter;
    }

    @Override public T convert(ResponseBody value) throws IOException {
        JsonReader jsonReader = gson.newJsonReader(value.charStream());
        try {
            T result = adapter.read(jsonReader);
            if (jsonReader.peek() != JsonToken.END_DOCUMENT) {
                throw new JsonIOException("JSON document was not fully consumed.");
            }
            return result;
        } catch (JsonSyntaxException e) {//当catch到这个错误说明gson解析错误
            return null;
        } finally {
            value.close();
        }
    }

}



  Retrofit.Builder builder = new Retrofit.Builder();
      ...
  //调用
   builder.addConverterFactory(GsonConverterFactory.create(gson));
   return  builder.build().create(clazz);

问题4 同一个字段名字，code 不同，返回不同的类型

只能用object接收，可以在baseresult中 解析

public class BaseResult<T> {
    private String code;
    private T result;
    private Object message;//字段名字，code 不同返回不同的类型

    public Object getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.msg = message;
    }

    //手动解析
    public boolean isSuccessed() {
        try {
            if (code.equals(RetrofitConfig.STATUS_NCARF_SUCCESS)||code.equals(RetrofitConfig.STATUS_NCARF_DEVIC_ERROR)) {
                if (getMessage() instanceof LinkedTreeMap) {
                    Gson gson = new Gson();
                    String json = gson.toJson(getMessage());
                    MessageBean messageBean = gson.fromJson(json,MessageBean.class);
                    ···            
    }
                return true;
            }  else {
                if (getMessage() instanceof String && !TextUtils.isEmpty(getMessage().toString())) {
                    ToastUtils.show_middle_pic(R.mipmap.icon_toast_error, getMessage() + "", 0);
                }
                ···
                return false;
            }
        } catch (Exception e) {
            ToastUtils.show_middle_pic(R.mipmap.icon_toast_error, "网络错误", 0);

            return false;
        }
    }
}

参考
https://blog.csdn.net/u012422440/article/details/48860893
https://www.jianshu.com/p/f723a5ac6e37
https://blog.csdn.net/u013064618/article/details/53486604?utm_medium=distribute.pc_relevant_t0.none-task-blog-BlogCommendFromMachineLearnPai2-1.channel_param&depth_1-utm_source=distribute.pc_relevant_t0.none-task-blog-BlogCommendFromMachineLearnPai2-1.channel_param

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 194,524评论 5赞 460
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 81,869评论 2赞 371
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 141,813评论 0赞 320
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 52,210评论 1赞 263
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 61,085评论 4赞 355
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 46,117评论 1赞 272
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 36,533评论 3赞 381
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 35,219评论 0赞 253
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 39,487评论 1赞 290
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,582评论 2赞 309
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,362评论 1赞 326
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 32,218评论 3赞 312
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 37,589评论 3赞 299
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,899评论 0赞 17
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,176评论 1赞 250
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 41,503评论 2赞 341
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 40,707评论 2赞 335