com.mailsend.sdk.emailverification.EmailVerification Maven / Gradle / Ivy

Go to download
/*************************************************
 * MailerSend Java SDK
 * https://github.com/mailersend/mailersend-java
 * 
 * @author MailerSend 
 * https://mailersend.com
 **************************************************/
package com.mailsend.sdk.emailverification;

import java.util.ArrayList;

import com.mailersend.sdk.MailerSend;
import com.mailersend.sdk.MailerSendApi;
import com.mailersend.sdk.exceptions.MailerSendException;

/**
 * EmailVerification class.
 *
 * @author mailersend
 * @version $Id: $Id
 */
public class EmailVerification {
    private MailerSend apiObjectReference;
    
    private int pageFilter = 1;
    private int limitFilter = 25;
    
    private EmailVerificationBuilder builder;
    
    /**
     * Constructor for EmailVerification.
     *
     * @param ref a {@link com.mailersend.sdk.MailerSend} object.
     */
    public EmailVerification(MailerSend ref) {
    	apiObjectReference = ref;
    	builder = new EmailVerificationBuilder(ref);
    }
    
    /**
     * page.
     *
     * @param page a int.
     * @return a {@link com.mailsend.sdk.emailverification.EmailVerification} object.
     */
    public EmailVerification page(int page) {
    	pageFilter = page;
    	return this;
    }
    
    /**
     * limit.
     *
     * @param limit a int.
     * @return a {@link com.mailsend.sdk.emailverification.EmailVerification} object.
     */
    public EmailVerification limit(int limit) {
    	limitFilter = limit;
    	return this;
    }
    
    /**
     * builder.
     *
     * @return a {@link com.mailsend.sdk.emailverification.EmailVerificationBuilder} object.
     */
    public EmailVerificationBuilder builder() {
    	return builder;
    }
    
    /**
     * newBuilder.
     *
     * @return a {@link com.mailsend.sdk.emailverification.EmailVerificationBuilder} object.
     */
    public EmailVerificationBuilder newBuilder() {
    	return new EmailVerificationBuilder(apiObjectReference);
    }
    
    /**
     * getLists.
     *
     * @return a {@link com.mailsend.sdk.emailverification.EmailVerificationLists} object.
     * @throws com.mailersend.sdk.exceptions.MailerSendException if any.
     */
    public EmailVerificationLists getLists() throws MailerSendException {
    	String endpoint = "/email-verification".concat(prepareParamsUrl());
    	
        MailerSendApi api = new MailerSendApi();
        api.setToken(apiObjectReference.getToken());
        
        EmailVerificationLists lists = api.getRequest(endpoint, EmailVerificationLists.class);
        
        for (EmailVerificationList l : lists.lists) {
        	l.postDeserialize();
        }
        
        return lists;
    }
    
    /**
     * getList.
     *
     * @param emailVerificationId a {@link java.lang.String} object.
     * @return a {@link com.mailsend.sdk.emailverification.EmailVerificationList} object.
     * @throws com.mailersend.sdk.exceptions.MailerSendException if any.
     */
    public EmailVerificationList getList(String emailVerificationId) throws MailerSendException {
    	String endpoint = "/email-verification/".concat(emailVerificationId);
    	
    	MailerSendApi api = new MailerSendApi();
        api.setToken(apiObjectReference.getToken());
        
        SingleEmailVerificationListResponse response = api.getRequest(endpoint, SingleEmailVerificationListResponse.class);
        
        response.list.postDeserialize();
        
        return response.list;
    }
    
    /**
     * verifyList.
     *
     * @param listId a {@link java.lang.String} object.
     * @return a {@link com.mailsend.sdk.emailverification.EmailVerificationList} object.
     * @throws com.mailersend.sdk.exceptions.MailerSendException if any.
     */
    public EmailVerificationList verifyList(String listId) throws MailerSendException {
    	String endpoint = "/email-verification/".concat(listId).concat("/verify");
    	
    	MailerSendApi api = new MailerSendApi();
        api.setToken(apiObjectReference.getToken());
        
        SingleEmailVerificationListResponse response = api.getRequest(endpoint, SingleEmailVerificationListResponse.class);
        
        response.list.postDeserialize();
        
        return response.list;
    }
    
    /**
     * verificationResults.
     *
     * @param listId a {@link java.lang.String} object.
     * @return a {@link com.mailsend.sdk.emailverification.ListVerificationResults} object.
     * @throws com.mailersend.sdk.exceptions.MailerSendException if any.
     */
    public ListVerificationResults verificationResults(String listId) throws MailerSendException {
    	String endpoint = "/email-verification/".concat(listId).concat("/results");
    	
    	MailerSendApi api = new MailerSendApi();
        api.setToken(apiObjectReference.getToken());
        
        ListVerificationResults response = api.getRequest(endpoint, ListVerificationResults.class);
        
        return response;
    }
    
    /**
     * Prepares the query part of the request url
     * @return
     */
    private String prepareParamsUrl() {
        
        // prepare the request parameters
        ArrayList params = new ArrayList();

        params.add("page=".concat(String.valueOf(pageFilter)));
        
        params.add("limit=".concat(String.valueOf(limitFilter)));
        
        String requestParams = "";
        for (int i = 0; i < params.size(); i++) {
            
            String attrSep = "&";
            
            if (i == 0) {
                
                attrSep = "?";
            }
            
            requestParams = requestParams.concat(attrSep).concat(params.get(i));
        }
        
        return requestParams;
    }
}