com.twilio.rest.supersim.v1.CommandCreator 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.supersim.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 preview products that are subject to
* change. Use them with caution. If you currently do not have developer preview
* access, please contact [email protected].
*/
public class CommandCreator extends Creator {
private final String sim;
private final String command;
private HttpMethod callbackMethod;
private URI callbackUrl;
/**
* Construct a new CommandCreator.
*
* @param sim The sid or unique_name of the SIM to send the Command to
* @param command The message body of the command
*/
public CommandCreator(final String sim,
final String command) {
this.sim = sim;
this.command = command;
}
/**
* The HTTP method we should use to call `callback_url`. Can be: `GET` or `POST`
* and the default is POST..
*
* @param callbackMethod The HTTP method we should use to call callback_url
* @return this
*/
public CommandCreator setCallbackMethod(final HttpMethod callbackMethod) {
this.callbackMethod = callbackMethod;
return this;
}
/**
* The URL we should call using the `callback_method` after we have sent the
* command..
*
* @param callbackUrl The URL we should call after we have sent the command
* @return this
*/
public CommandCreator setCallbackUrl(final URI callbackUrl) {
this.callbackUrl = callbackUrl;
return this;
}
/**
* The URL we should call using the `callback_method` after we have sent the
* command..
*
* @param callbackUrl The URL we should call after we have sent the command
* @return this
*/
public CommandCreator setCallbackUrl(final String callbackUrl) {
return setCallbackUrl(Promoter.uriFromString(callbackUrl));
}
/**
* Make the request to the Twilio API to perform the create.
*
* @param client TwilioRestClient with which to make the request
* @return Created Command
*/
@Override
@SuppressWarnings("checkstyle:linelength")
public Command create(final TwilioRestClient client) {
Request request = new Request(
HttpMethod.POST,
Domains.SUPERSIM.toString(),
"/v1/Commands"
);
addPostParams(request);
Response response = client.request(request);
if (response == null) {
throw new ApiConnectionException("Command creation failed: Unable to connect to server");
} else if (!TwilioRestClient.SUCCESS.test(response.getStatusCode())) {
RestException restException = RestException.fromJson(response.getStream(), client.getObjectMapper());
if (restException == null) {
throw new ApiException("Server Error, no content");
}
throw new ApiException(restException);
}
return Command.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 (sim != null) {
request.addPostParam("Sim", sim);
}
if (command != null) {
request.addPostParam("Command", command);
}
if (callbackMethod != null) {
request.addPostParam("CallbackMethod", callbackMethod.toString());
}
if (callbackUrl != null) {
request.addPostParam("CallbackUrl", callbackUrl.toString());
}
}
}