本系列的最后一篇譯文

集成轉換器

Define XML Converter

Define Gradle Dependency

Retrofit已經為我們提供了一個XML轉換器，在build.graddle中添加依賴即可：

compile 'com.squareup.retrofit2:converter-simplexml:2.1.0'

現在為Retrofit添加SimpleXMLConverter作為轉換器。

Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl(API_BASE_URL)
    .client(new OkHttpClient())
    .addConverterFactory(SimpleXmlConverterFactory.create())
    .build();

注意添加的順序

無論你使用哪個XML轉換器，Retrofit都會將它轉換為Java對象。我們需要為這個對象添加標簽屬性的注解。
下面是一個例子將Task類對應到tasks.xml文件。

task.xml

<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">  
    <task>
        <id link="http://url-to-link.com/task-id">1</id>
        <title>Retrofit XML Converter Blog Post</title>
        <description>Write blog post: XML Converter with Retrofit</description>
        <language>de-de</language>
    </task>
</rss> 

Task.class

@Root(name = "task")
public class Task {  
    @Element(name = "id")
    private long id;

    @Element(name = "title")
    private String title;

    @Element(name = "description")
    private String description;

    @Attribute(required = false)
    private String link;

    public Task() {}
}

定義你自己的Json轉換器

Retrofit為我們提供了許多現成的轉換器，但是我們仍可以自定義轉換器。

第一步，集成依賴

repositories {  
    maven { url "http://repository.codehaus.org/org/codehaus" }
}

dependencies {  
    compile 'com.fasterxml.jackson.core:jackson-databind:2.4.3'
}

第二部，實現自定義JSON轉換器

自定義類繼承Convert接口，實現fromBody和toBody方法：

public class JacksonConverter implements Converter {  
    private ObjectMapper mapper = new ObjectMapper();

    @Override
    public Object fromBody(TypedInput body, Type type) throws ConversionException {
        JavaType javaType = mapper.getTypeFactory().constructType(type);

        try {
            return mapper.readValue(body.in(), javaType);
        } catch (IOException e) {
            throw new ConversionException(e);
        }
    }

    @Override
    public TypedOutput toBody(Object object) {
        try {
            String charset = "UTF-8";
            String json = mapper.writeValueAsString(object);
            return new JsonTypedOutput(json.getBytes(charset));
        } catch (IOException e) {
            throw new AssertionError(e);
        }
    }

    private static class JsonTypedOutput implements TypedOutput {
        private final byte[] jsonBytes;

        JsonTypedOutput(byte[] jsonBytes) { this.jsonBytes = jsonBytes; }

        @Override public String fileName() { return null; }
        @Override public String mimeType() { return "application/json; charset=UTF-8"; }
        @Override public long length() { return jsonBytes.length; }
        @Override public void writeTo(OutputStream out) throws IOException { out.write(jsonBytes); }
}

然后在你的Retrofit添加這個轉化器就可以了。