org.craftercms.commons.lang.UrlUtils Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of crafter-commons-utilities Show documentation
Crafter Commons Utilities
There is a newer version: 4.1.8
Show newest version
/*
 * Copyright (C) 2007-2017 Crafter Software Corporation.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see .
 */
package org.craftercms.commons.lang;

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;

import org.apache.commons.lang3.ArrayUtils;
import org.apache.commons.lang3.StringUtils;

/**
 * Utility methods for paths and URLs.
 *
 * @author avasquez
 */
public class UrlUtils {

    private UrlUtils() {
    }

    /**
     * Concats two urls, adding any "/" needed between them.
     *
     * @param mainUrl      the main url
     * @param relativeUrl  the relative url
     *
     * @return mainPath + relativeUrl
     */
    public static String concat(String mainUrl, String relativeUrl) {
        if (StringUtils.isEmpty(mainUrl)) {
            return relativeUrl;
        } else if (StringUtils.isEmpty(relativeUrl)) {
            return mainUrl;
        } else {
            StringBuilder joinedUrl = new StringBuilder(mainUrl);

            if (mainUrl.endsWith("/") && relativeUrl.startsWith("/")) {
                relativeUrl = StringUtils.stripStart(relativeUrl, "/");
            } else if (!mainUrl.endsWith("/") && !relativeUrl.startsWith("/")) {
                joinedUrl.append("/");
            }

            joinedUrl.append(relativeUrl);

            return joinedUrl.toString();
        }
    }


    /**
     * Concats two or more urls, adding any "/" needed between them.
     *
     * @param mainUrl       the main url
     * @param relativeUrls  the array of relative urls
     *
     * @return mainPath + relativeUrls...
     */
    public static String concat(String mainUrl, String... relativeUrls) {
        String concatenatedUrl = mainUrl;

        if (ArrayUtils.isNotEmpty(relativeUrls)) {
            for (String relativeUrl : relativeUrls) {
                concatenatedUrl = concat(concatenatedUrl, relativeUrl);
            }
        }

        return concatenatedUrl;
    }

    /**
     * Adds a query string param to the URL, adding a '?' if there's no query string yet.
     *
     * @param url       the URL
     * @param name      the name of the param
     * @param value     the value of the param
     * @param charset   the charset to encode the param key/value with
     *
     * @return the URL with the query string param appended
     */
    public static String addParam(String url, String name, String value,
                                  String charset) throws UnsupportedEncodingException {
        StringBuilder newUrl = new StringBuilder(url);

        if (!url.endsWith("?") && !url.endsWith("&")) {
            if (url.contains("?")) {
                newUrl.append('&');
            } else {
                newUrl.append('?');
            }
        }

        newUrl.append(URLEncoder.encode(name, charset));
        newUrl.append('=');
        newUrl.append(URLEncoder.encode(value, charset));

        return newUrl.toString();
    }

    /**
     * Adds a query string fragment to the URL, adding a '?' if there's no query string yet.
     *
     * @param url       the URL
     * @param fragment  the query string fragment
     *
     * @return the URL with the query string fragment appended
     */
    public static String addQueryStringFragment(String url, String fragment) {
        StringBuilder newUrl = new StringBuilder(url);

        if (fragment.startsWith("?") || fragment.startsWith("&")) {
            fragment = fragment.substring(1);
        }

        if (!url.endsWith("?") && !url.endsWith("&")) {
            if (url.contains("?")) {
                newUrl.append('&');
            } else {
                newUrl.append('?');
            }
        }

        return newUrl.append(fragment).toString();
    }


}