response.go

package httpclient

import (
	"encoding/json"
	"encoding/xml"
	"io"
	"io/ioutil"
	"net/http"
)

// Response contains the raw http.Response reference OR any error that took
// place while performing the request
type Response struct{ res *http.Response }

// Body returns the io Readcloser body on the Responses http Response
func (r *Response) Body() io.ReadCloser { return r.res.Body }

// ContentType returns the content-type header found on the response
func (r *Response) ContentType() string {
	return r.Header().Get("Content-Type")
}

// Header returns the Header on the Responses http Response
func (r *Response) Header() http.Header { return r.res.Header }

// Close closes the response body on the Responses http Response
func (r *Response) Close() error { return r.res.Body.Close() }

// Response returns the http Response reference that is on the Response
func (r *Response) Response() *http.Response { return r.res }

// Status returns the status message on the Response
func (r *Response) Status() string { return r.res.Status }

// StatusCode returns the status code found on the Response
func (r *Response) StatusCode() int { return r.res.StatusCode }

// String attempts to return the decoded response as a string
func (r *Response) String() (string, error) {
	bytes, err := r.Bytes()
	if err != nil {
		return "", err
	}
	return string(bytes), nil
}

// Bytes attempts to return the decoded response as bytes
func (r *Response) Bytes() ([]byte, error) {
	return ioutil.ReadAll(r.res.Body)
}

// JSON attempts to JSON decode the response body into the passed interface
func (r *Response) JSON(out interface{}) error {
	return json.NewDecoder(r.res.Body).Decode(out)
}

// XML attempts to XML decode the response body into the passed interface
func (r *Response) XML(out interface{}) error {
	return xml.NewDecoder(r.res.Body).Decode(out)
}