SwaggerBundleConfiguration.java

/**
 * Copyright (C) 2014 Federico Recio
 *
 * 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 io.federecio.dropwizard.swagger;

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;

import java.util.HashSet;
import java.util.List;
import java.util.Objects;

/**
 * For the meaning of all these properties please refer to Swagger documentation or {@link io.swagger.jaxrs.config.BeanConfig}
 *
 * @author Tristan Burch
 * @author Federico Recio
 */
@JsonIgnoreProperties(ignoreUnknown = true)
public class SwaggerBundleConfiguration {

    /**
     * This is the only property that is required for Swagger to work correctly.
     * <p/>
     * It is a comma separated list of the all the packages that contain the {@link io.swagger.annotations.Api}
     * annoted resources
     */
    @JsonProperty
    private String resourcePackage;

    @JsonProperty
    private String title;

    @JsonProperty
    private String version;

    @JsonProperty
    private String description;

    @JsonProperty
    private String termsOfServiceUrl;

    @JsonProperty
    private String contact;

    @JsonProperty
    private String license;

    @JsonProperty
    private String licenseUrl;

    @JsonProperty
    private List<SecurityConfiguration> securityConfigurations;

    /**
     * For most of the scenarios this property is not needed.
     * this will be added to application path and rootPath before adding "/swagger" suffix
     */
    @JsonProperty
    private String uriPrefix = "/";

    /**
     * Values used for api listing filtering
     */
    @JsonProperty
    private HashSet<String> apiListingFilters = new HashSet<>();

    @JsonProperty
    private String host;

    public String getResourcePackage() {
        return resourcePackage;
    }

    public void setResourcePackage(String resourcePackage) {
        this.resourcePackage = resourcePackage;
    }

    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    public String getVersion() {
        return version;
    }

    public void setVersion(String version) {
        this.version = version;
    }

    public String getDescription() {
        return description;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    public String getTermsOfServiceUrl() {
        return termsOfServiceUrl;
    }

    public void setTermsOfServiceUrl(String termsOfServiceUrl) {
        this.termsOfServiceUrl = termsOfServiceUrl;
    }

    public String getContact() {
        return contact;
    }

    public void setContact(String contact) {
        this.contact = contact;
    }

    public String getLicense() {
        return license;
    }

    public void setLicense(String license) {
        this.license = license;
    }

    public String getLicenseUrl() {
        return licenseUrl;
    }

    public void setLicenseUrl(String licenseUrl) {
        this.licenseUrl = licenseUrl;
    }

    public String getUriPrefix() {
        return uriPrefix;
    }

    public void setUriPrefix(String uriPrefix) {
        this.uriPrefix = uriPrefix;
    }

    public List<SecurityConfiguration> getSecurityConfigurations() {
        return securityConfigurations;
    }

    public void setSecurityConfigurations(List<SecurityConfiguration> securityConfigurations) {
        this.securityConfigurations = securityConfigurations;
    }

    public HashSet<String> getApiListingFilters() {
        return apiListingFilters;
    }

    public void setApiListingFilters(HashSet<String> apiListingFilters) {
        this.apiListingFilters = apiListingFilters;
    }

    public String getHost() {
        return host;
    }

    public void setHost(String host) {
        this.host = host;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        SwaggerBundleConfiguration that = (SwaggerBundleConfiguration) o;
        return Objects.equals(resourcePackage, that.resourcePackage) &&
                Objects.equals(title, that.title) &&
                Objects.equals(version, that.version) &&
                Objects.equals(description, that.description) &&
                Objects.equals(termsOfServiceUrl, that.termsOfServiceUrl) &&
                Objects.equals(contact, that.contact) &&
                Objects.equals(license, that.license) &&
                Objects.equals(licenseUrl, that.licenseUrl) &&
                Objects.equals(securityConfigurations, that.securityConfigurations) &&
                Objects.equals(host, that.host) &&
                Objects.equals(uriPrefix, that.uriPrefix) &&
                Objects.equals(apiListingFilters, that.apiListingFilters);
    }

    @Override
    public int hashCode() {
        return Objects.hash(resourcePackage, title, version, description, termsOfServiceUrl, contact, license, licenseUrl, securityConfigurations, host, uriPrefix, apiListingFilters);
    }

    @Override
    public String toString() {
        return "SwaggerBundleConfiguration{" +
                "resourcePackage='" + resourcePackage + '\'' +
                ", title='" + title + '\'' +
                ", version='" + version + '\'' +
                ", description='" + description + '\'' +
                ", termsOfServiceUrl='" + termsOfServiceUrl + '\'' +
                ", contact='" + contact + '\'' +
                ", license='" + license + '\'' +
                ", licenseUrl='" + licenseUrl + '\'' +
                ", securityConfigurations=" + securityConfigurations +
                ", host='" + host + '\'' +
                ", uriPrefix='" + uriPrefix + '\'' +
                ", apiListingFilters=" + apiListingFilters +
                '}';
    }
}