com.day.cq.mcm.campaign.CallResults Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of aem-sdk-api Show documentation

The Adobe Experience Manager SDK

There is a newer version: 2024.11.18598.20241113T125352Z-241000

/*************************************************************************
 *
 * ADOBE CONFIDENTIAL
 * __________________
 *
 *  Copyright 2014 Adobe Systems Incorporated
 *  All Rights Reserved.
 *
 * NOTICE:  All information contained herein is, and remains
 * the property of Adobe Systems Incorporated and its suppliers,
 * if any.  The intellectual and technical concepts contained
 * herein are proprietary to Adobe Systems Incorporated and its
 * suppliers and are protected by trade secret or copyright law.
 * Dissemination of this information or reproduction of this material
 * is strictly forbidden unless prior written permission is obtained
 * from Adobe Systems Incorporated.
 **************************************************************************/

package com.day.cq.mcm.campaign;

import java.io.IOException;
import java.io.InputStream;
import java.util.Map;

/**
 * Represents the results of a call to a Adobe Campaign instance.
 *
 * Instances of this class are considered to be consumed by a single thread, so the
 * implementation should not be considered threadsafe.
 */
public interface CallResults {

    /**
     * Returns the (HTTP-) status of the call.
     *
     * @return The (HTTP-) status
     */
    int getStatus();

    /**
     * Retrieve a Map of the response headers.
     *
     * @return The response headers
     */
    Map getResponseHeaders();

    /**
     * Returns the body of the response as a stream.
     *
     * Caller is responsible for closing the stream.
     *
     * @return The stream to access the body of the response
     */
    InputStream bodyAsStream() throws IOException;

    /**
     * Returns the body of the response as a String.
     *
     * @return The body of the response
     */
    String bodyAsString() throws IOException;

    /**
     * Should be called after the results have been completely consumed by the client to
     * ensure resources are properly cleaned up
     */
    void destroy();

    /**
     * Returns the complete URL of the originating request (debugging purposes only!).
     *
     * @return The complete URL
     */
    String getCompleteURL();

}