com.twilio.rest.ipmessaging.v1.service.channel.MemberCreator 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 MemberCreator extends Creator {
private final String pathServiceSid;
private final String pathChannelSid;
private final String identity;
private String roleSid;
/**
* Construct a new MemberCreator.
*
* @param pathServiceSid The SID of the Service to create the resource under
* @param pathChannelSid The unique ID of the channel the new member belongs to
* @param identity The `identity` value that identifies the new resource's User
*/
public MemberCreator(final String pathServiceSid,
final String pathChannelSid,
final String identity) {
this.pathServiceSid = pathServiceSid;
this.pathChannelSid = pathChannelSid;
this.identity = identity;
}
/**
* The SID of the Role to assign to
* the member. The default roles are those specified on the Service..
*
* @param roleSid The SID of the Role to assign to the member
* @return this
*/
public MemberCreator setRoleSid(final String roleSid) {
this.roleSid = roleSid;
return this;
}
/**
* Make the request to the Twilio API to perform the create.
*
* @param client TwilioRestClient with which to make the request
* @return Created Member
*/
@Override
@SuppressWarnings("checkstyle:linelength")
public Member create(final TwilioRestClient client) {
Request request = new Request(
HttpMethod.POST,
Domains.IPMESSAGING.toString(),
"/v1/Services/" + this.pathServiceSid + "/Channels/" + this.pathChannelSid + "/Members"
);
addPostParams(request);
Response response = client.request(request);
if (response == null) {
throw new ApiConnectionException("Member 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 Member.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 (identity != null) {
request.addPostParam("Identity", identity);
}
if (roleSid != null) {
request.addPostParam("RoleSid", roleSid);
}
}
}