io.fabric8.maven.docker.access

Class PortMapping

java.lang.Object

io.fabric8.maven.docker.access.PortMapping

public class PortMapping
extends Object

Entity holding port mappings which can be set through the configuration.

Since:

04.04.14

Author:

roland

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PortMapping.PropertyWriteHelper

Constructor Summary

Constructors

Constructor and Description
PortMapping(List<String> portMappings, Properties projProperties) Create the mapping from a configuration.

Method Summary

Modifier and Type	Method and Description
boolean	containsDynamicHostIps()
boolean	containsDynamicPorts() Whether this mapping contains dynamically assigned ports
Set<String>	getContainerPorts()
Map<String,Integer>	getContainerPortToHostPortMap()
void	updateVariablesWithDynamicPorts(Map<String,Container.PortBinding> dockerObtainedDynamicPorts) Update variable-to-port mappings with dynamically obtained ports.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PortMapping

public PortMapping(List<String> portMappings,
                   Properties projProperties)

Create the mapping from a configuration. The configuation is list of port mapping specifications which has the format used by docker for port mapping (i.e. host_ip:host_port:container_port)

• The "host_ip" part is optional. If not given, the all interfaces are used
• If "host_port" is non numeric it is taken as a variable name. If this variable is given as value in variables, this number is used as host port. If no numeric value is given, it is considered to be filled with the real, dynamically created port value when updateVariablesWithDynamicPorts(Map) is called

Parameters:

portMappings - a list of configuration strings where each string hast the format host_ip:host_port:container_port. If the host-port is non-numeric it is assumed to be a variable (which later might be filled in with the dynamically created port).

projProperties - project properties

Throws:

IllegalArgumentException - if the format doesn't fit

Method Detail

containsDynamicHostIps

public boolean containsDynamicHostIps()

containsDynamicPorts

public boolean containsDynamicPorts()

Whether this mapping contains dynamically assigned ports

Returns:

dynamically assigned ports

getContainerPorts

public Set<String> getContainerPorts()

Returns:

Set of all mapped container ports

getContainerPortToHostPortMap

public Map<String,Integer> getContainerPortToHostPortMap()

updateVariablesWithDynamicPorts

public void updateVariablesWithDynamicPorts(Map<String,Container.PortBinding> dockerObtainedDynamicPorts)

Update variable-to-port mappings with dynamically obtained ports. This should only be called once after the dynamic ports could be obtained.

Parameters:

dockerObtainedDynamicPorts - keys are the container ports, values are the dynamically mapped host ports,