com.twilio.rest.sync.v1.service.SyncMapCreator Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of twilio Show documentation
Show all versions of twilio Show documentation
Twilio Java Helper Library
/**
* This code was generated by
* \ / _ _ _| _ _
* | (_)\/(_)(_|\/| |(/_ v1.0.0
* / /
*/
package com.twilio.rest.sync.v1.service;
import com.twilio.base.Creator;
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;
/**
* PLEASE NOTE that this class contains beta products that are subject to
* change. Use them with caution.
*/
public class SyncMapCreator extends Creator {
private final String pathServiceSid;
private String uniqueName;
private Integer ttl;
/**
* Construct a new SyncMapCreator.
*
* @param pathServiceSid The service_sid
*/
public SyncMapCreator(final String pathServiceSid) {
this.pathServiceSid = pathServiceSid;
}
/**
* Human-readable name for this map.
*
* @param uniqueName Human-readable name for this map
* @return this
*/
public SyncMapCreator setUniqueName(final String uniqueName) {
this.uniqueName = uniqueName;
return this;
}
/**
* Time-to-live of this Map in seconds, defaults to no expiration. In the range
* [1, 31 536 000 (1 year)], or 0 for infinity..
*
* @param ttl Time-to-live of this Map in seconds, defaults to no expiration.
* @return this
*/
public SyncMapCreator setTtl(final Integer ttl) {
this.ttl = ttl;
return this;
}
/**
* Make the request to the Twilio API to perform the create.
*
* @param client TwilioRestClient with which to make the request
* @return Created SyncMap
*/
@Override
@SuppressWarnings("checkstyle:linelength")
public SyncMap create(final TwilioRestClient client) {
Request request = new Request(
HttpMethod.POST,
Domains.SYNC.toString(),
"/v1/Services/" + this.pathServiceSid + "/Maps",
client.getRegion()
);
addPostParams(request);
Response response = client.request(request);
if (response == null) {
throw new ApiConnectionException("SyncMap creation 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 SyncMap.fromJson(response.getStream(), client.getObjectMapper());
}
/**
* Add the requested post parameters to the Request.
*
* @param request Request to add post params to
*/
private void addPostParams(final Request request) {
if (uniqueName != null) {
request.addPostParam("UniqueName", uniqueName);
}
if (ttl != null) {
request.addPostParam("Ttl", ttl.toString());
}
}
}