org.zalando.riptide.UrlResolution Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of riptide-core Show documentation

Client side response routing

There is a newer version: 4.0.0

package org.zalando.riptide;

import org.apiguardian.api.API;
import org.springframework.web.util.UriComponentsBuilder;

import javax.annotation.Nullable;
import java.net.URI;

import static com.google.common.base.Strings.nullToEmpty;
import static org.apiguardian.api.API.Status.EXPERIMENTAL;

@API(status = EXPERIMENTAL)
public enum UrlResolution {

    /**
     * Resolves a given relativce URI by following the rules defined in RFC 3986.
     *
     * @see RFC 3986
     * @see URI#resolve(URI)
     */
    RFC {
        @Override
        URI resolve(final URI baseUrl, final URI uri) {
            return baseUrl.resolve(uri);
        }
    },

    /**
     * Resolves a given relative URI by appending its path to and merging its query parameters with the given base URL.
     *
     * @see UriComponentsBuilder#pathSegment(String...)
     */
    APPEND {
        @Override
        URI resolve(final URI baseUrl, final URI uri) {
            final UriComponentsBuilder builder = UriComponentsBuilder.fromUri(baseUrl);

            @Nullable final String path = uri.getRawPath();

            if (!nullToEmpty(path).isEmpty()) {
                builder.path("/").path(path);
            }

            return builder
                    .replaceQuery(uri.getRawQuery())
                    .build()
                    .toUri();
        }
    };

    /**
     *
     * @param baseUrl absolute, non-empty base URL
     * @param uri non-absolute
     * @return the resolved, absolute request URI
     */
    abstract URI resolve(final URI baseUrl, final URI uri);

}