com.fitbur.github.dockerjava.api.model.Link Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of external-docker-java Show documentation
There is a newer version: 1.0.0
package com.fitbur.github.dockerjava.api.model;

import com.fitbur.apache.com.fitburmons.lang.builder.EqualsBuilder;
import com.fitbur.apache.com.fitburmons.lang.builder.HashCodeBuilder;

/**
 * Represents a network link between two Docker containers. The container with the name {@link #getName()} is made
 * available in the target container with the aliased name {@link #getAlias()}. This involves creating an entry in
 * /etc/hosts and some environment variables in the target container as well as creating a network bridge
 * between both containers.
 */
public class Link {

    private final String name;

    private final String alias;

    /**
     * Creates a {@link Link} for the container with the given name and an aliased name for use in the target container.
     * 
     * @param name
     *            the name of the container that you want to link into the target container
     * @param alias
     *            the aliased name under which the linked container will be available in the target container
     */
    public Link(final String name, final String alias) {
        this.name = name;
        this.alias = alias;
    }

    /**
     * @return the name of the container that is linked into the target container
     */
    public String getName() {
        return name;
    }

    /**
     * @return the aliased name under which the linked container will be available in the target container
     */
    public String getAlias() {
        return alias;
    }

    /**
     * Parses a textual link specification (as used by the Docker CLI) to a {@link Link}.
     * 
     * @param serialized
     *            the specification, e.g. name:alias or /name1:/name2/alias
     * @return a {@link Link} matching the specification
     * @throws IllegalArgumentException
     *             if the specification cannot be parsed
     */
    public static Link parse(final String serialized) throws IllegalArgumentException {
        try {
            final String[] parts = serialized.split(":");
            switch (parts.length) {
            case 2: {
                String[] nameSplit = parts[0].split("/");
                String[] aliasSplit = parts[1].split("/");
                return new Link(nameSplit[nameSplit.length - 1], aliasSplit[aliasSplit.length - 1]);
            }
            com.fitburfault: {
                throw new IllegalArgumentException();
            }
            }
        } catch (final Exception e) {
            throw new IllegalArgumentException("Error parsing Link '" + serialized + "'");
        }
    }

    @Override
    public boolean equals(final Object obj) {
        if (obj instanceof Link) {
            final Link other = (Link) obj;
            return new EqualsBuilder().append(name, other.getName()).append(alias, other.getAlias()).isEquals();
        } else
            return super.equals(obj);
    }

    @Override
    public int hashCode() {
        return new HashCodeBuilder().append(name).append(alias).toHashCode();
    }

    /**
     * Returns a string representation of this {@link Link} suitable for inclusion in a JSON message. The format is
     * name:alias, like the argument in {@link #parse(String)}.
     * 
     * @return a string representation of this {@link Link}
     */
    @Override
    public String toString() {
        return name + ":" + alias;
    }

}