com.twilio.rest.sync.v1.ServiceCreator 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;
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());
}
}
}