io.github.primelib.jira4j.restv3.JiraRESTV3FactorySpec Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jira4j-rest-v3 Show documentation
A Java Wrapper for the Jira REST API
The newest version!
package io.github.primelib.jira4j.restv3;

import java.util.ArrayList;
import java.util.List;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import javax.annotation.processing.Generated;
import lombok.EqualsAndHashCode;

import io.github.primelib.jira4j.restv3.api.JiraRESTV3Api;
import io.github.primelib.jira4j.restv3.auth.BasicAuthSpec;
import io.github.primelib.jira4j.restv3.auth.BearerAuthSpec;
import lombok.AccessLevel;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.Accessors;

import io.micrometer.core.instrument.MeterRegistry;
import io.micrometer.core.instrument.composite.CompositeMeterRegistry;

import io.github.primelib.primecodegenlib.java.feign.common.api.AuthMethod;
import io.github.primelib.primecodegenlib.java.feign.common.config.FeignModuleSpec;

import java.util.Objects;
import java.util.function.Consumer;

/**
 * A specification to construct a {@link JiraRESTV3Api} instance.
 */
@Data
@EqualsAndHashCode(callSuper = true)
@Accessors(fluent = true)
@NoArgsConstructor(access = AccessLevel.PRIVATE, force = true)
@Generated(value = "io.github.primelib.primecodegen.javafeign.JavaFeignGenerator")
public final class JiraRESTV3FactorySpec extends FeignModuleSpec> {

    /**
     * The name of the backend to use
     */
    @NotNull
    private String backendName = "jira4j-rest-v3";

    /**
     * The API interface to use
     */
    @NotNull
    private Class api;

    /**
     * The api base URL
     */
    @NotNull
    private String baseUrl = "https://your-domain.atlassian.net";

    /**
     * The authentication methods to use
     */
    @Nullable
    private List auth = new ArrayList<>(5);

    /**
     * MeterRegistry to use for metrics
     */
    @NotNull
    private MeterRegistry meterRegistry = new CompositeMeterRegistry();

    /**
     * the feign log level
     * 
     * Defaults to {@code none}.
     * Allowed values are: {@code none}, {@code basic}, {@code headers}, {@code full}
     */
    @NotNull
    private String logLevel = "none";

    /**
     * Constructs a validated implementation of {@link JiraRESTV3Api}.
     *
     * @param spec the specification to process
     */
    @NotNull
    public JiraRESTV3FactorySpec(@NotNull Consumer> spec) {
        spec.accept(this);
        validate();
    }

    /**
     * Ensures the configured specification is valid.
     *
     * @throws NullPointerException
     */
    public void validate() {
        Objects.requireNonNull(backendName, "backendName must not be null");
        Objects.requireNonNull(api, "api must not be null");
        Objects.requireNonNull(baseUrl, "baseUrl must not be null");
        if (baseUrl.isEmpty()) {
            throw new IllegalArgumentException("baseUrl must not be empty");
        }
        Objects.requireNonNull(logLevel, "logLevel must not be null");
    }

    public BasicAuthSpec basicAuth(Consumer spec) {
        BasicAuthSpec method = new BasicAuthSpec(spec);
        auth.add(method);
        return method;
    }

    public BearerAuthSpec bearerAuth(Consumer spec) {
        BearerAuthSpec method = new BearerAuthSpec(spec);
        auth.add(method);
        return method;
    }

    public void applySpec(JiraRESTV3FactorySpec spec) {
        backendName(spec.backendName());
        baseUrl(spec.baseUrl());
        auth(spec.auth());
        proxy = spec.proxy();
        meterRegistry(spec.meterRegistry());
    }
}