com.smartystreets.api.international_autocomplete.Client Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of smartystreets-java-sdk Show documentation

A library to help Java developers easily access the SmartyStreets APIs.

There is a newer version: 3.18.3

Show newest version

package com.smartystreets.api.international_autocomplete;

import com.smartystreets.api.*;
import com.smartystreets.api.exceptions.SmartyException;

import java.io.IOException;
import java.util.Objects;

/**
 * This client sends lookups to the SmartyStreets US Autocomplete API, 

 *     and attaches the results to the appropriate Lookup objects.
 */
public class Client {
    private final Sender sender;
    private final Serializer serializer;

    public Client(Sender sender, Serializer serializer) {
        this.sender = sender;
        this.serializer = serializer;
    }

    public Candidate[] send(Lookup lookup) throws SmartyException, IOException, InterruptedException {
        if (lookup == null || lookup.getSearch() == null || (lookup.getSearch().isEmpty() && lookup.getAddressID().isEmpty()))
            throw new SmartyException("Send() must be passed a Lookup with the prefix field set.");

        Request request = this.buildRequest(lookup);

        Response response = this.sender.send(request);

        Result result = this.serializer.deserialize(response.getPayload(), Result.class);
        Candidate[] candidates = result.getCandidates();
        lookup.setResult(candidates);

        return candidates;
    }

    private Request buildRequest(Lookup lookup) {
        Request request = new Request();

        if(lookup.getAddressID() != null && !lookup.getAddressID().isEmpty()) {
            request.setUrlPrefix("/" + lookup.getAddressID());
        }

        request.putParameter("country", lookup.getCountry());
        request.putParameter("search", lookup.getSearch());
        request.putParameter("max_results", String.valueOf(lookup.getMaxResults()));
        request.putParameter("include_only_locality", lookup.getLocality());
        request.putParameter("include_only_postal_code", lookup.getPostalCode());

        return request;
    }
}