com.ionic.sdk.agent.request.base.AgentResponseBase Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of ionic-sdk Show documentation
The Ionic Java SDK provides an easy-to-use interface to the Ionic Platform.
There is a newer version: 2.9.0
package com.ionic.sdk.agent.request.base;

import com.ionic.sdk.core.value.Value;

import javax.json.JsonObject;

/**
 * The base class for server responses to agent requests, which encapsulate the server response to an http request made
 * to the Ionic server infrastructure (if any).
 */
public class AgentResponseBase {

    /**
     * The HTTP server status code from the response.
     */
    private int httpResponseCode;

    /**
     * The json object representation of the server response.
     */
    private JsonObject jsonPayload;

    /**
     * The Ionic server error code (if any) from the response.
     */
    private int serverErrorCode;

    /**
     * The Ionic server error text (if any) from the response.
     */
    private String serverErrorMessage;

    /**
     * The Ionic server error json (if any) from the response.
     */
    private String serverErrorDataJson;

    /**
     * The Ionic conversation ID (supplied by the client in the corresponding request), used for correlation and
     * transaction integrity.
     */
    private String cid;

    /**
     * Constructor.
     */
    public AgentResponseBase() {
        this.cid = "";
    }

    /**
     * @return the HTTP status code from the corresponding server response
     */
    public final int getHttpResponseCode() {
        return httpResponseCode;
    }

    /**
     * Set the HTTP status code from the corresponding server response.
     *
     * @param httpResponseCode the server status code
     */
    public final void setHttpResponseCode(final int httpResponseCode) {
        this.httpResponseCode = httpResponseCode;
    }

    /**
     * @return the json object representation of the server response
     */
    public final JsonObject getJsonPayload() {
        return jsonPayload;
    }

    /**
     * Set the json object representation of the server response.
     *
     * @param jsonPayload the json response object
     */
    public final void setJsonPayload(final JsonObject jsonPayload) {
        this.jsonPayload = jsonPayload;
    }

    /**
     * @return the Ionic error code from the corresponding server response
     */
    public final int getServerErrorCode() {
        return serverErrorCode;
    }

    /**
     * Set the Ionic error code from the corresponding server response.
     *
     * @param serverErrorCode the Ionic error code
     */
    public final void setServerErrorCode(final int serverErrorCode) {
        this.serverErrorCode = serverErrorCode;
    }

    /**
     * @return the Ionic server error text from the corresponding server response
     */
    public final String getServerErrorMessage() {
        return serverErrorMessage;
    }

    /**
     * Set the Ionic server error text from the corresponding server response.
     *
     * @param serverErrorMessage the Ionic error text
     */
    public final void setServerErrorMessage(final String serverErrorMessage) {
        this.serverErrorMessage = serverErrorMessage;
    }

    /**
     * @return the Ionic server error json (if any) from the corresponding server response
     */
    public final String getServerErrorDataJson() {
        return serverErrorDataJson;
    }

    /**
     * Set the Ionic server error json (if any) from the corresponding server response.
     *
     * @param serverErrorDataJson the Ionic error json (text)
     */
    public final void setServerErrorDataJson(final String serverErrorDataJson) {
        this.serverErrorDataJson = serverErrorDataJson;
    }

    /**
     * @return the Ionic conversation ID from the server response
     */
    public final String getConversationId() {
        return cid;
    }

    /**
     * Set the Ionic conversation ID from the server response.
     *
     * @param cid the Ionic conversation ID
     */
    public final void setConversationId(final String cid) {
        this.cid = Value.defaultOnEmpty(cid, "");
    }

    /**
     * @return whether server response payload requires a "data" component
     */
    protected boolean isDataRequired() {
        return true;
    }
}