com.twilio.rest.sync.v1.ServiceCreator Maven / Gradle / Ivy
/**
* This code was generated by
* \ / _ _ _| _ _
* | (_)\/(_)(_|\/| |(/_ v1.0.0
* / /
*/
package com.twilio.rest.sync.v1;
import com.twilio.base.Creator;
import com.twilio.converter.Promoter;
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 java.net.URI;
/**
* PLEASE NOTE that this class contains beta products that are subject to
* change. Use them with caution.
*/
public class ServiceCreator extends Creator {
private String friendlyName;
private URI webhookUrl;
private Boolean reachabilityWebhooksEnabled;
private Boolean aclEnabled;
/**
* Human-readable name for this service instance.
*
* @param friendlyName Human-readable name for this service instance
* @return this
*/
public ServiceCreator setFriendlyName(final String friendlyName) {
this.friendlyName = friendlyName;
return this;
}
/**
* A URL that will receive event updates when objects are manipulated..
*
* @param webhookUrl A URL that will receive event updates when objects are
* manipulated.
* @return this
*/
public ServiceCreator setWebhookUrl(final URI webhookUrl) {
this.webhookUrl = webhookUrl;
return this;
}
/**
* A URL that will receive event updates when objects are manipulated..
*
* @param webhookUrl A URL that will receive event updates when objects are
* manipulated.
* @return this
*/
public ServiceCreator setWebhookUrl(final String webhookUrl) {
return setWebhookUrl(Promoter.uriFromString(webhookUrl));
}
/**
* `true` or `false` - controls whether this instance fires webhooks when client
* endpoints connect to Sync Defaults to false..
*
* @param reachabilityWebhooksEnabled true or false - controls whether this
* instance fires webhooks when client
* endpoints connect to Sync
* @return this
*/
public ServiceCreator setReachabilityWebhooksEnabled(final Boolean reachabilityWebhooksEnabled) {
this.reachabilityWebhooksEnabled = reachabilityWebhooksEnabled;
return this;
}
/**
* `true` or `false` - determines whether token identities must be granted
* access to Sync objects via the [Permissions
* API](https://www.twilio.com/docs/api/sync/rest/sync-rest-api-permissions) in
* this Service..
*
* @param aclEnabled true or false - determines whether token identities must
* be granted access to Sync objects via the Permissions API
* in this Service.
* @return this
*/
public ServiceCreator setAclEnabled(final Boolean aclEnabled) {
this.aclEnabled = aclEnabled;
return this;
}
/**
* Make the request to the Twilio API to perform the create.
*
* @param client TwilioRestClient with which to make the request
* @return Created Service
*/
@Override
@SuppressWarnings("checkstyle:linelength")
public Service create(final TwilioRestClient client) {
Request request = new Request(
HttpMethod.POST,
Domains.SYNC.toString(),
"/v1/Services",
client.getRegion()
);
addPostParams(request);
Response response = client.request(request);
if (response == null) {
throw new ApiConnectionException("Service 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 Service.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 (friendlyName != null) {
request.addPostParam("FriendlyName", friendlyName);
}
if (webhookUrl != null) {
request.addPostParam("WebhookUrl", webhookUrl.toString());
}
if (reachabilityWebhooksEnabled != null) {
request.addPostParam("ReachabilityWebhooksEnabled", reachabilityWebhooksEnabled.toString());
}
if (aclEnabled != null) {
request.addPostParam("AclEnabled", aclEnabled.toString());
}
}
}