/**
* This code was generated by
* \ / _ _ _| _ _
* | (_)\/(_)(_|\/| |(/_ v1.0.0
* / /
*/
package com.twilio.rest.api.v2010.account;
import com.google.common.collect.Range;
import com.twilio.base.Page;
import com.twilio.base.Reader;
import com.twilio.base.ResourceSet;
import com.twilio.converter.DateConverter;
import com.twilio.exception.ApiConnectionException;
import com.twilio.exception.ApiException;
import com.twilio.exception.RestException;
import com.twilio.http.HttpMethod;
import com.twilio.http.Request;
import com.twilio.http.Response;
import com.twilio.http.TwilioRestClient;
import com.twilio.rest.Domains;
import org.joda.time.DateTime;
public class RecordingReader extends Reader<Recording> {
private String pathAccountSid;
private DateTime absoluteDateCreated;
private Range<DateTime> rangeDateCreated;
private String callSid;
/**
* Construct a new RecordingReader.
*/
public RecordingReader() {
}
/**
* Construct a new RecordingReader.
*
* @param pathAccountSid The account_sid
*/
public RecordingReader(final String pathAccountSid) {
this.pathAccountSid = pathAccountSid;
}
/**
* Only show recordings on the given date. Should be formatted as YYYY-MM-DD.
* You can also specify inequalities.
*
* @param absoluteDateCreated Filter by date created
* @return this
*/
public RecordingReader setDateCreated(final DateTime absoluteDateCreated) {
this.rangeDateCreated = null;
this.absoluteDateCreated = absoluteDateCreated;
return this;
}
/**
* Only show recordings on the given date. Should be formatted as YYYY-MM-DD.
* You can also specify inequalities.
*
* @param rangeDateCreated Filter by date created
* @return this
*/
public RecordingReader setDateCreated(final Range<DateTime> rangeDateCreated) {
this.absoluteDateCreated = null;
this.rangeDateCreated = rangeDateCreated;
return this;
}
/**
* Only show recordings made during the call given by the indicated sid.
*
* @param callSid Filter by call_sid
* @return this
*/
public RecordingReader setCallSid(final String callSid) {
this.callSid = callSid;
return this;
}
/**
* Make the request to the Twilio API to perform the read.
*
* @param client TwilioRestClient with which to make the request
* @return Recording ResourceSet
*/
@Override
public ResourceSet<Recording> read(final TwilioRestClient client) {
return new ResourceSet<>(this, client, firstPage(client));
}
/**
* Make the request to the Twilio API to perform the read.
*
* @param client TwilioRestClient with which to make the request
* @return Recording ResourceSet
*/
@Override
@SuppressWarnings("checkstyle:linelength")
public Page<Recording> firstPage(final TwilioRestClient client) {
this.pathAccountSid = this.pathAccountSid == null ? client.getAccountSid() : this.pathAccountSid;
Request request = new Request(
HttpMethod.GET,
Domains.API.toString(),
"/2010-04-01/Accounts/" + this.pathAccountSid + "/Recordings.json",
client.getRegion()
);
addQueryParams(request);
return pageForRequest(client, request);
}
/**
* Retrieve the next page from the Twilio API.
*
* @param page current page
* @param client TwilioRestClient with which to make the request
* @return Next Page
*/
@Override
public Page<Recording> nextPage(final Page<Recording> page,
final TwilioRestClient client) {
Request request = new Request(
HttpMethod.GET,
page.getNextPageUrl(
Domains.API.toString(),
client.getRegion()
)
);
return pageForRequest(client, request);
}
/**
* Generate a Page of Recording Resources for a given request.
*
* @param client TwilioRestClient with which to make the request
* @param request Request to generate a page for
* @return Page for the Request
*/
private Page<Recording> pageForRequest(final TwilioRestClient client, final Request request) {
Response response = client.request(request);
if (response == null) {
throw new ApiConnectionException("Recording read failed: Unable to connect to server");
} else if (!TwilioRestClient.SUCCESS.apply(response.getStatusCode())) {
RestException restException = RestException.fromJson(response.getStream(), client.getObjectMapper());
if (restException == null) {
throw new ApiException("Server Error, no content");
}
throw new ApiException(
restException.getMessage(),
restException.getCode(),
restException.getMoreInfo(),
restException.getStatus(),
null
);
}
return Page.fromJson(
"recordings",
response.getContent(),
Recording.class,
client.getObjectMapper()
);
}
/**
* Add the requested query string arguments to the Request.
*
* @param request Request to add query string arguments to
*/
private void addQueryParams(final Request request) {
if (absoluteDateCreated != null) {
request.addQueryParam("DateCreated", absoluteDateCreated.toString(Request.QUERY_STRING_DATE_TIME_FORMAT));
} else if (rangeDateCreated != null) {
request.addQueryDateTimeRange("DateCreated", rangeDateCreated);
}
if (callSid != null) {
request.addQueryParam("CallSid", callSid);
}
if (getPageSize() != null) {
request.addQueryParam("PageSize", Integer.toString(getPageSize()));
}
}
}