All Downloads are FREE. Search and download functionalities are using the official Maven repository.

tech.sirwellington.alchemy.http.Step3Impl Maven / Gradle / Ivy

Go to download

Part of the Alchemy Collection. REST without the MESS. Makes it dead-easy to call RESTful Web Services in Java. It is designed for interactions with APIs written in REST and JSON.

There is a newer version: 3.4.1
Show newest version
/*
 * Copyright 2015 SirWellington Tech.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package tech.sirwellington.alchemy.http;

import com.google.common.base.Strings;
import com.google.common.collect.Maps;
import java.net.URL;
import java.util.Map;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import tech.sirwellington.alchemy.annotations.designs.StepMachineDesign;
import tech.sirwellington.alchemy.http.exceptions.AlchemyHttpException;

import static tech.sirwellington.alchemy.annotations.designs.StepMachineDesign.Role.STEP;
import static tech.sirwellington.alchemy.arguments.Arguments.checkThat;
import static tech.sirwellington.alchemy.arguments.assertions.Assertions.notNull;
import static tech.sirwellington.alchemy.arguments.assertions.NumberAssertions.greaterThanOrEqualTo;
import static tech.sirwellington.alchemy.arguments.assertions.StringAssertions.nonEmptyString;
import static tech.sirwellington.alchemy.http.HttpAssertions.validResponseClass;

/**
 *
 * @author SirWellington
 */
@StepMachineDesign(role = STEP)
final class Step3Impl implements AlchemyRequest.Step3
{

    private final static Logger LOG = LoggerFactory.getLogger(Step3Impl.class);

    private HttpRequest request;
    private final AlchemyHttpStateMachine stateMachine;

    Step3Impl(AlchemyHttpStateMachine stateMachine, HttpRequest request)
    {
        checkThat(stateMachine, request)
                .are(notNull());

        this.stateMachine = stateMachine;
        this.request = request;
    }

    @Override
    public AlchemyRequest.Step3 usingHeader(String key, String value) throws IllegalArgumentException
    {
        checkThat(key)
                .usingMessage("missing key")
                .is(nonEmptyString());

        //Value of an HTTP Header can be empty ?
        value = Strings.nullToEmpty(value);

        Map requestHeaders = Maps.newHashMap();

        //Keep existing headers
        if (request.getRequestHeaders() != null)
        {
            requestHeaders.putAll(request.getRequestHeaders());
        }

        requestHeaders.put(key, value);

        this.request = HttpRequest.Builder.from(request)
                .usingRequestHeaders(requestHeaders)
                .build();

        return this;
    }

    @Override
    public AlchemyRequest.Step3 usingQueryParam(String name, String value) throws IllegalArgumentException
    {
        checkThat(name, value)
                .usingMessage("missing name or value")
                .are(nonEmptyString());

        Map queryParams = Maps.newHashMap();

        //Keep existing Query Params
        if (request.getQueryParams() != null)
        {
            queryParams.putAll(request.getQueryParams());
        }

        queryParams.put(name, value);

        request = HttpRequest.Builder.from(request)
                .usingQueryParams(queryParams)
                .build();

        return this;
    }

    @Override
    public AlchemyRequest.Step3 followRedirects(int maxNumberOfTimes) throws IllegalArgumentException
    {
        checkThat(maxNumberOfTimes).is(greaterThanOrEqualTo(1));
        //TODO:
        //Not doing anything with this yet.
        return this;
    }

    @Override
    public HttpResponse at(URL url) throws AlchemyHttpException
    {
        checkThat(url).is(notNull());

        //Ready to do a sync request
        HttpRequest requestCopy = HttpRequest.Builder.from(request)
                .usingUrl(url)
                .build();

        //Tell the Step Machine to perform a Sync Request
        return stateMachine.executeSync(requestCopy);
    }

    @Override
    public AlchemyRequest.Step5 onSuccess(AlchemyRequest.OnSuccess onSuccessCallback)
    {
        checkThat(onSuccessCallback)
                .usingMessage("callback cannot be null")
                .is(notNull());

        return stateMachine.jumpToStep5(request, HttpResponse.class, onSuccessCallback);
    }

    @Override
    public  AlchemyRequest.Step4 expecting(Class classOfResponseType) throws IllegalArgumentException
    {
        checkThat(classOfResponseType)
                .is(validResponseClass());

        return stateMachine.jumpToStep4(request, classOfResponseType);
    }

    @Override
    public String toString()
    {
        return "Step3Impl{" + "request=" + request + ", stateMachine=" + stateMachine + '}';
    }

}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy