com.github.dockerjava.api.model.PortBinding Maven / Gradle / Ivy
package com.github.dockerjava.api.model;
import com.github.dockerjava.api.model.Ports.Binding;
import lombok.EqualsAndHashCode;
import lombok.ToString;
import java.io.Serializable;
/**
* In a {@link PortBinding}, a network socket on the Docker host, expressed as a {@link Binding}, is bound to an {@link ExposedPort} of a
* container. A {@link PortBinding} corresponds to the --publish (-p) option of the docker run (and
* similar) CLI command for adding port bindings to a container.
*
* Note: This is an abstraction used for creating new port bindings. It is not to be confused with the abstraction used for querying
* existing port bindings from a container configuration in {@link NetworkSettings#getPorts()} and {@link HostConfig#getPortBindings()}. In
* that context, a Map<ExposedPort, Binding[]> is used.
*/
@EqualsAndHashCode
@ToString
public class PortBinding extends DockerObject implements Serializable {
private static final long serialVersionUID = 1L;
private final Binding binding;
private final ExposedPort exposedPort;
public PortBinding(Binding binding, ExposedPort exposedPort) {
this.binding = binding;
this.exposedPort = exposedPort;
}
public Binding getBinding() {
return binding;
}
public ExposedPort getExposedPort() {
return exposedPort;
}
public static PortBinding parse(String serialized) throws IllegalArgumentException {
try {
String[] parts = serialized.split(":");
switch (parts.length) {
case 3:
// 127.0.0.1:80:8080/tcp
return createFromSubstrings(parts[0] + ":" + parts[1], parts[2]);
case 2:
// 80:8080 // 127.0.0.1::8080
return createFromSubstrings(parts[0], parts[1]);
case 1:
// 8080
return createFromSubstrings("", parts[0]);
default:
throw new IllegalArgumentException();
}
} catch (Exception e) {
throw new IllegalArgumentException("Error parsing PortBinding '" + serialized + "'", e);
}
}
private static PortBinding createFromSubstrings(String binding, String exposedPort) throws IllegalArgumentException {
return new PortBinding(Binding.parse(binding), ExposedPort.parse(exposedPort));
}
}