android - Retrofit2 POST 正文作为原始 JSON

Question

我正在尝试使用 Microsoft translator API 翻译一些文本.我正在使用 Retrofit 2。这是代码:

 public RestClient() {
    final OkHttpClient httpClient = new OkHttpClient.Builder()
            .addNetworkInterceptor(new Interceptor() {
                @Override
                public Response intercept(Chain chain) throws IOException {
                    final Request originalRequest = chain.request();
                    Request newRequest;

                    newRequest = originalRequest.newBuilder()
                            .header("Content-Type", "application/json")
                            .header("Ocp-Apim-Subscription-Key", "KEY")
                            .header("X-ClientTraceId", java.util.UUID.randomUUID().toString())
                            .build();
                    return chain.proceed(newRequest);
                }
            })
            .addNetworkInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY))
            .build();


    // Build the retrofit config from our http client
    final Retrofit retrofit = new Retrofit.Builder()
            .baseUrl("https://api.cognitive.microsofttranslator.com/")
            .client(httpClient)
            .addConverterFactory(GsonConverterFactory.create())
            .build();

    // Build api instance from retrofit config
    api = retrofit.create(RestApi.class);
}


public interface RestApi {

    @POST("translate?api-version=3.0&from=en&to=zh-Latn")
    Call<TranslationResultDTO> getTranslation(@Body final RequestBody Text);
}


 public void getTranslation(final String text, final RestCallback<TranslationResultDTO> translationResultCallback) {
    final JsonObject jsonBody = new JsonObject();
    jsonBody.addProperty("Text", text);
    RequestBody textToTranslateBody = RequestBody.create(MediaType.parse("application/json"), jsonBody.toString());

    Call<TranslationResultDTO> call = api.getTranslation(textToTranslateBody);

    call.enqueue(new Callback<TranslationResultDTO>() {
        @Override
        public void onResponse(Call<TranslationResultDTO> call, retrofit2.Response<TranslationResultDTO> response) {
            final int responseCode = response.code();
            ....
        }

        @Override
        public void onFailure(Call<TranslationResultDTO> call, Throwable t) {
            ....
        }
    });
}

我从服务器收到一个错误。该错误表明正文不是有效的 JSON。

有人知道问题出在哪里吗？提前致谢!

更新

这是我也尝试过的另一种解决方案的代码。此解决方案使用 POJO 类:

public class Data {

@SerializedName("Text")
private String text;

public Data(String text) {
    this.text = text;
}

public String getText() {
    return text;
}

public void setText(String text) {
    this.text = text;
}

@POST("translate?api-version=3.0&from=en&to=zh-Latn")
Call<TranslationResultDTO> getTranslation(@Body final Data Text);


 Data data = new Data("text value to translate");
    Call<TranslationResultDTO> call = api.getTranslation(data);

同样的错误:/

Answer 1

The error says that the body in not a valid JSON.

这是服务器的预期响应。假设下面是您要发送的 JSON 正文，

{
    "key_1" : "value 1",
    "key_2" : "value 2",
}

当您使用 JsonObject#toString() 时，就会变成这样

{\"key_1\" : \"value 1\", \"key_2\" : \"value 2\"}

如果您将上述 JSON 数据/正文发送到服务器，服务器会将其视为普通字符串。

您仍然需要使用 toString()这里是因为MediaType#parse()不接受 JsonObject参数。

解决方案是什么？

正如 Ishan Fernando 在他的 comment 中提到的那样您需要创建自定义 POJO 类来为请求准备 JSON 正文。或者使用 HashMap准备 body 。

像下面这样创建POJO

import com.google.gson.annotations.SerializedName;

public class Data {

    @SerializedName("Text")
    private String text;

    public Data(String text) {
        this.text = text;
    }

    // getter and setter methods
}

并使用它

Data data = new Data("text value to translate"); // construct object
Call<TranslationResultDTO> call = api.getTranslation(data); // change method parameter

并且还调整了API接口(interface)中的方法参数

Call<TranslationResultDTO> getTranslation(@Body final Data text); // change method parameter

编辑 1

我查看了您问题所附的文档。我犯了一个小错误。 JSON 正文应包含 JSONArray，而不是 JSONObject。如下图

[
    {
        "Text" : "text to translate"
    }
]

将方法参数更改为 List<Data>在API接口(interface)中

Call<TranslationResultDTO> getTranslation(@Body final List<Data> text); // change method parameter

像下面这样使用

Data data = new Data("text value to translate"); // construct object
List<Data> objList = new ArrayList<>();
objList.add(data);
Call<TranslationResultDTO> call = api.getTranslation(objList);  // change method parameter

编辑2

API 也将响应 JSONArray。示例响应

[
    {
        "detectedLanguage": {
        "language": "en",
        "score": 1.0
        },
        "translations": [
        {
            "text": "Hallo Welt!",
            "to": "de"
        },
        {
            "text": "Salve, mondo!",
            "to": "it"
            }
        ]
    }
]

创建以下 POJO 类以正确解析 JSON 响应

翻译.java

import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;

public class Translation {

    @SerializedName("text")
    @Expose
    private String text;
    @SerializedName("to")
    @Expose
    private String to;

    // constructors, getter and setter methods

}

检测语言.java

import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;

public class DetectedLanguage {

    @SerializedName("language")
    @Expose
    private String language;
    @SerializedName("score")
    @Expose
    private float score;

    // constructors, getter and setter methods

}

最后，像下面这样调整 TranslationResultDTO.java 类。

import java.util.List;
import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;

public class TranslationResultDTO {

    @SerializedName("detectedLanguage")
    @Expose
    private DetectedLanguage detectedLanguage;
    @SerializedName("translations")
    @Expose
    private List<Translation> translations = null;

    // constructors, getter and setter methods

}

接口(interface)类

Call<List<TranslationResultDTO>> call = api.getTranslation(objList);    // change method parameter