/** * 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.LocalDate; public class ConferenceReader extends Reader<Conference> { private String pathAccountSid; private LocalDate absoluteDateCreated; private Range<LocalDate> rangeDateCreated; private LocalDate absoluteDateUpdated; private Range<LocalDate> rangeDateUpdated; private String friendlyName; private Conference.Status status; /** * Construct a new ConferenceReader. */ public ConferenceReader() { } /** * Construct a new ConferenceReader. * * @param pathAccountSid The account_sid */ public ConferenceReader(final String pathAccountSid) { this.pathAccountSid = pathAccountSid; } /** * Only show conferences that started on this date, given as YYYY-MM-DD. You can * also specify inequality such as DateCreated<=YYYY-MM-DD. * * @param absoluteDateCreated Filter by date created * @return this */ public ConferenceReader setDateCreated(final LocalDate absoluteDateCreated) { this.rangeDateCreated = null; this.absoluteDateCreated = absoluteDateCreated; return this; } /** * Only show conferences that started on this date, given as YYYY-MM-DD. You can * also specify inequality such as DateCreated<=YYYY-MM-DD. * * @param rangeDateCreated Filter by date created * @return this */ public ConferenceReader setDateCreated(final Range<LocalDate> rangeDateCreated) { this.absoluteDateCreated = null; this.rangeDateCreated = rangeDateCreated; return this; } /** * Only show conferences that were last updated on this date, given as * YYYY-MM-DD. You can also specify inequality such as * DateUpdated>=YYYY-MM-DD. * * @param absoluteDateUpdated Filter by date updated * @return this */ public ConferenceReader setDateUpdated(final LocalDate absoluteDateUpdated) { this.rangeDateUpdated = null; this.absoluteDateUpdated = absoluteDateUpdated; return this; } /** * Only show conferences that were last updated on this date, given as * YYYY-MM-DD. You can also specify inequality such as * DateUpdated>=YYYY-MM-DD. * * @param rangeDateUpdated Filter by date updated * @return this */ public ConferenceReader setDateUpdated(final Range<LocalDate> rangeDateUpdated) { this.absoluteDateUpdated = null; this.rangeDateUpdated = rangeDateUpdated; return this; } /** * Only show results who's friendly name exactly matches the string. * * @param friendlyName Filter by friendly name * @return this */ public ConferenceReader setFriendlyName(final String friendlyName) { this.friendlyName = friendlyName; return this; } /** * A string representing the status of the conference. May be `init`, * `in-progress`, or `completed`.. * * @param status The status of the conference * @return this */ public ConferenceReader setStatus(final Conference.Status status) { this.status = status; return this; } /** * Make the request to the Twilio API to perform the read. * * @param client TwilioRestClient with which to make the request * @return Conference ResourceSet */ @Override public ResourceSet<Conference> 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 Conference ResourceSet */ @Override @SuppressWarnings("checkstyle:linelength") public Page<Conference> 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 + "/Conferences.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<Conference> nextPage(final Page<Conference> 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 Conference 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<Conference> pageForRequest(final TwilioRestClient client, final Request request) { Response response = client.request(request); if (response == null) { throw new ApiConnectionException("Conference 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( "conferences", response.getContent(), Conference.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_FORMAT)); } else if (rangeDateCreated != null) { request.addQueryDateRange("DateCreated", rangeDateCreated); } if (absoluteDateUpdated != null) { request.addQueryParam("DateUpdated", absoluteDateUpdated.toString(Request.QUERY_STRING_DATE_FORMAT)); } else if (rangeDateUpdated != null) { request.addQueryDateRange("DateUpdated", rangeDateUpdated); } if (friendlyName != null) { request.addQueryParam("FriendlyName", friendlyName); } if (status != null) { request.addQueryParam("Status", status.toString()); } if (getPageSize() != null) { request.addQueryParam("PageSize", Integer.toString(getPageSize())); } } }