SubResource[T].cs

Go to the documentation of this file.

using System;
using System.Collections.Generic;
using System.IO;
using RestSharp;
 
namespace AnalyzeRe.APITypes
{
    public class SubResource<T> : SubResourceEndpoint
    {
        public int? DefaultTimeout { get; set; } = null;
 
        #region Constructors
        public SubResource(IEndpoint owner, string relativePath)
            : base(owner, relativePath) { }
        #endregion Constructors
 
        #region Implicit Operators
        public static implicit operator T(SubResource<T> value)
        {
            return value.Get(timeout: value.DefaultTimeout);
        }
        #endregion Implicit Operators
 
        #region REST Methods
        public IRestResponse Head(IEnumerable<Parameter> parameters = null, int? timeout = null)
        {
            ValidateOwnerHasId();
            return API.RequestAndParse<IRestResponse>(Path, Method.HEAD, parameters, timeout ?? DefaultTimeout);
        }
 
        public T Get(IEnumerable<Parameter> parameters = null, int? timeout = null)
        {
            ValidateOwnerHasId();
            return API.RequestAndParse<T>(Path, Method.GET, parameters, timeout ?? DefaultTimeout);
        }
 
        public IRestResponse GetStream(Action<Stream> consumeStream,
            IEnumerable<Parameter> parameters = null, int? timeout = null)
        {
            ValidateOwnerHasId();
            IRestResponse response = API.ExecuteRestRequest(Path, Method.GET, parameters,
                timeout ?? DefaultTimeout, false, consumeStream);
            if (response.IsSuccessful())
                return response;
            throw new APIRequestException("The request failed with the status: " +
                response.StatusCode + ". The response stream likely contains an error message " +
                "from the API, rather than the expected requested data. Please check the data " +
                "returned to the 'consumeStream' delegate for details.");
        }
        #endregion REST Methods
    }
}