转换器

转换器是把服务器的响应转换为本地预期的结果的一个工具，在Kalle中Converter可以被配置为全局的，也可以为单个Request指定。

Converter的作用是将服务器返回的数据转换为本地数据，或者说将服务器返回的结果转换为本地结果，同时可以包装业务的成功与否的结果。带来的好处是不用在主线程解析数据和也不用在主线程做复杂的业务判断。开发者可以参考示例和业务封装。

Converter是一个接口，只需要把Response的响应体读出来，并转化为指定的类型对象，包装成SimpleResponse对象返回即可。

public interface Converter {
    <S, F> SimpleResponse<S, F> convert(Type succeed, Type failed,
            Response response, boolean fromCache) throws Exception;
}

参数释义

• 泛型S和参数succeed
  用来限定业务成功时的数据类型。例如开发者请求用户信息时，S的类型可能是UserInfo，succeed的值就是UserInfo.class。
• 泛型F和参数failed
  用来限定业务失败时的数据类型。例如开发者请求用户信息时服务端找不到指定用户信息，返回的业务数据肯定和UserInfo对不上，此时我们需要返回业务错误时的数据，比如返回一段提示用户不存在...，那么S的类型就是String，faield对应的值就是String.class。
• 参数Response
  请求对应的响应，里面包涵了响应码code，响应头headers，相应包体body。
• 参数fromCache
  请求的响应是否来自缓存。

全局配置和单独使用

如果开发者的所有请求的返回结果都是有规则且规则相同，那么Converter可以配置成全局转换器，避免在每一个请求都需要配置一个Converter的麻烦。

Converter converter = ...;

KalleConfig config = KalleConfig.newBuilder()
    ...
    .converter(converter)
    .build();

如果只有某几个请求的结果和不符合全局转换器的规则，那么可以单独指定某个请求的转换器。

Converter newConverter = ...;

Kalle.post("http://www.example.com")
    .param("name", "kalle")
    .converter(newConverter)
    .perform(...);

注：所有没单独指定转换器的请求将自动使用配置的转换器，如果单独指定则仅仅使用单独指定的转换器。

响应转换为String

Response已经提供了String的转换，可以直接把ResponseBody转换为String。

public class StringConverter implements Converter {

    public <S, F> SimpelResponse<S, F> convert(Type succeed, Type failed,
            Response response, boolean fromCache) throws Exception {
        S succeedData = (S) response.body().string();
        return SimpleResponse.<S, F>newBuilder()
                .code(response.code())
                .headers(response.headers())
                .fromCache(fromCache)
                .succeed(succeedData)
                .build();
    }
}

JSON转化为Java对象

其实只要拿到String了，转化为其它对象就非常简单啦，这里我们分别以Gson为例。

/**
 * Base on gson.
 */
public class GsonConverter implements Converter {

    private static final Gson GSON = new Gson();

    public <S, F> SimpelResponse<S, F> convert(Type succeed, Type failed,
            Response response, boolean fromCache) throws Exception {
        String jsonStrig = response.body().string();
        S succeedData = GSON.fromJson(response.body().string(), succeed);

        return SimpleResponse.<S, F>newBuilder()
                .code(response.code())
                .headers(response.headers())
                .fromCache(fromCache)
                .succeed(succeedData)
                .build();
    }
};

结合业务的封装请参考业务封装。