de.otto.edison.status.domain.Datasource Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of edison-core Show documentation
Core library for all Edison libraries.
There is a newer version: 3.3.3
package de.otto.edison.status.domain;

import com.fasterxml.jackson.annotation.JsonCreator;
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
import de.otto.edison.annotations.Beta;

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

import static java.lang.Integer.valueOf;
import static java.util.Arrays.stream;
import static java.util.Collections.singletonList;
import static java.util.stream.Collectors.toList;

/**
 * A datasource used in {@link DatasourceDependency datasource dependencies} to describe databases, queues, etc.
 *
 * @since 1.1.0
 */
@Beta
@JsonSerialize(using = ToStringSerializer.class)
public final class Datasource {

    /**
     * The node (host name) of the datasource.
     */
    public final String node;
    /**
     * The port used to access the datasource. If the port is -1, no port is configured.
     */
    public final int port;
    /**
     * The Datasource resource accessed by the service.
     *
     * 
     * Examples are Database, Collection, Topic...
     * 
     */
    public final String resource;

    private Datasource(final String node,
                       final int port,
                       final String resource) {
        this.node = node;
        this.port = port;
        this.resource = resource;
    }

    /**
     * Parses the comma-separated datasources string into a list of Datasource objects.
     * 
     *     The format is <node>:<port>/<resource>,<node>:<port>/<resource>, ...
     * 
     *
     * @param ds comma-separated list of datasources
     * @return list of Datasources
     */
    public static List datasources(final String ds) {
        if (ds.contains(",")) {
            return stream(ds.split(",")).map(Datasource::datasource).collect(toList());
        } else {
            return singletonList(datasource(ds));
        }
    }

    /**
     * Parses the datasource string into node, port and resource and returns a Datasource instance for these parts.
     * 
     *     The format is <node>:<port>/<resource>
     * 
     *
     * @param ds datasource string
     * @return Datasource
     */
    @JsonCreator
    public static Datasource datasource(final String ds) {
        int colonPos = ds.indexOf(":");
        int slashPos = ds.indexOf("/");

        String nodeAndPort = ds;
        String node;
        int port = -1;
        String resource = "";

        if (slashPos != -1) {
            nodeAndPort = ds.substring(0, slashPos);
            resource = ds.substring(slashPos+1);
        }
        if (colonPos != -1) {
            node = nodeAndPort.substring(0, colonPos);
            port = valueOf(nodeAndPort.substring(colonPos+1));
            return datasource(node, port, resource);
        } else {
            return datasource(nodeAndPort, -1, resource);
        }
    }

    /**
     * Creates a Datasource from node, port and resource descriptors.
     *
     * @param node the node of the datasource
     * @param port the port used to access the datasource
     * @param resource the resource accessed at the datasource
     *
     * @return Datasource
     */
    public static Datasource datasource(final String node,
                                        final int port,
                                        final String resource) {
        return new Datasource(node, port, resource);
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (!(o instanceof Datasource that)) return false;
        return port == that.port &&
                Objects.equals(node, that.node) &&
                Objects.equals(resource, that.resource);
    }

    @Override
    public int hashCode() {
        return Objects.hash(node, port, resource);
    }

    @Override
    public String toString() {
        final StringBuilder sb = new StringBuilder(node);
        if (port != -1) {
            sb.append(":" + port);
        }
        if (!resource.isEmpty()) {
            sb.append("/" + resource);
        }
        return sb.toString();
    }
}