com.twilio.rest.ipmessaging.v1.service.channel.MessageCreator 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.ipmessaging.v1.service.channel;
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;
public class MessageCreator extends Creator {
private final String pathServiceSid;
private final String pathChannelSid;
private final String body;
private String from;
private String attributes;
/**
* Construct a new MessageCreator.
*
* @param pathServiceSid The SID of the Service to create the resource under
* @param pathChannelSid The unique ID of the channel the new resource belongs
* to
* @param body The message to send to the channel
*/
public MessageCreator(final String pathServiceSid,
final String pathChannelSid,
final String body) {
this.pathServiceSid = pathServiceSid;
this.pathChannelSid = pathChannelSid;
this.body = body;
}
/**
* The identity of
* the new message's author. The default value is `system`..
*
* @param from The identity of the new message's author
* @return this
*/
public MessageCreator setFrom(final String from) {
this.from = from;
return this;
}
/**
* A valid JSON string that contains application-specific data..
*
* @param attributes A valid JSON string that contains application-specific data
* @return this
*/
public MessageCreator setAttributes(final String attributes) {
this.attributes = attributes;
return this;
}
/**
* Make the request to the Twilio API to perform the create.
*
* @param client TwilioRestClient with which to make the request
* @return Created Message
*/
@Override
@SuppressWarnings("checkstyle:linelength")
public Message create(final TwilioRestClient client) {
Request request = new Request(
HttpMethod.POST,
Domains.IPMESSAGING.toString(),
"/v1/Services/" + this.pathServiceSid + "/Channels/" + this.pathChannelSid + "/Messages"
);
addPostParams(request);
Response response = client.request(request);
if (response == null) {
throw new ApiConnectionException("Message 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 Message.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 (body != null) {
request.addPostParam("Body", body);
}
if (from != null) {
request.addPostParam("From", from);
}
if (attributes != null) {
request.addPostParam("Attributes", attributes);
}
}
}