com.landawn.abacus.util.AddrUtil Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of abacus-common Show documentation
A general programming library in Java/Android. It's easy to learn and simple to use with concise and powerful APIs.
The newest version!
/**
 * Copyright (C) 2006-2009 Dustin Sallings
 * Copyright (C) 2009-2011 Couchbase, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALING
 * IN THE SOFTWARE.
 */

package com.landawn.abacus.util;

import java.net.InetSocketAddress;
import java.net.URL;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;

public final class AddrUtil {

    private static final String URL_SEPARATOR = "(?:\\s|,)+"; //NOSONAR

    private static final Splitter URL_SPLITTER = Splitter.pattern(URL_SEPARATOR).omitEmptyStrings().trimResults();

    private AddrUtil() {
        // singleton
    }

    /**
     * Split a string containing whitespace or comma separated host or IP addresses and port numbers of the form
     * "host:port host2:port" or "host:port, host2:port" into a List of server.
     *
     * @param servers
     * @return
     */
    public static List getServerList(final String servers) {
        final List serverList = URL_SPLITTER.split(servers);

        if (N.isEmpty(serverList)) {
            throw new IllegalArgumentException("Invalid serverUrl: " + servers);
        }

        return serverList;
    }

    /**
     * Split a string containing whitespace or comma separated host or IP addresses and port numbers of the form
     * "host:port host2:port" or "host:port, host2:port" into a List of InetSocketAddress instances suitable for
     * instantiating a MemcachedClient.
     *
     * Note that colon-delimited IPv6 is also supported. For example: ::1:11211
     *
     * @param servers
     * @return
     */
    public static List getAddressList(final String servers) {
        if (Strings.isEmpty(servers)) {
            throw new IllegalArgumentException("Null or empty host list");
        }

        final String[] hoststuffs = servers.split(URL_SEPARATOR); // NOSONAR

        if (N.isEmpty(hoststuffs)) {
            throw new IllegalArgumentException("Invalid addresses: " + servers);
        }

        final List addrs = new ArrayList<>();

        for (final String hoststuff : hoststuffs) {
            if (hoststuff.isEmpty()) {
                continue;
            }

            final String[] strs = hoststuff.split(":");

            if (strs.length < 1) {
                throw new IllegalArgumentException("Invalid server '" + hoststuff + "' in list:  " + servers);
            }

            final String hostPart = strs[0];
            final String portNum = strs[1];

            addrs.add(new InetSocketAddress(hostPart, Integer.parseInt(portNum)));
        }
        assert !addrs.isEmpty() : "No addrs found";

        return addrs;
    }

    /**
     * Converts the collection of server addresses in the form of Strings into a list of InetSocketAddress instances.
     * Each string in the collection should be in the format "host:port".
     *
     * @param servers A collection of server addresses in the format "host:port".
     * @return A list of InetSocketAddress instances corresponding to the server addresses.
     * @throws IllegalArgumentException If a server address is invalid or if the collection is empty.
     */
    public static List getAddressList(final Collection servers) {
        final List addrs = new ArrayList<>(servers.size());

        for (final String url : servers) {
            final String[] strs = url.split(":");

            if (strs.length < 1) {
                throw new IllegalArgumentException("Invalid server '" + url + "' in list:  " + servers);
            }

            final String hostPart = strs[0];
            final String portNum = strs[1];

            addrs.add(new InetSocketAddress(hostPart, Integer.parseInt(portNum)));
        }

        if (addrs.isEmpty()) {
            throw new IllegalArgumentException("servers cannot be empty");
        }

        return addrs;
    }

    /**
     * Returns an InetSocketAddress instance corresponding to the host and port of the URL.
     *
     * @param url A URL from which the host and port are to be extracted.
     * @return An InetSocketAddress instance corresponding to the host and port of the URL.
     * @throws IllegalArgumentException If the URL is {@code null}.
     */
    public static InetSocketAddress getAddressFromURL(final URL url) {
        return new InetSocketAddress(url.getHost(), url.getPort());
    }

    /**
     * Converts a collection of URLs into a list of InetSocketAddress instances.
     * Each URL in the collection is converted into an InetSocketAddress using the host and port of the URL.
     *
     * @param urls A collection of URLs to be converted.
     * @return A list of InetSocketAddress instances corresponding to the URLs.
     */
    public static List getAddressListFromURL(final Collection urls) {
        if (N.isEmpty(urls)) {
            return new ArrayList<>();
        }

        final List addrs = new ArrayList<>(urls.size());

        for (final URL server : urls) {
            addrs.add(new InetSocketAddress(server.getHost(), server.getPort()));
        }

        return addrs;
    }
}