io.netty.util

Class DomainNameMappingBuilder<V>

java.lang.Object

io.netty.util.DomainNameMappingBuilder<V>

Type Parameters:

V - concrete type of value objects

public final class DomainNameMappingBuilder<V>
extends Object

Builder for immutable DomainNameMapping instances.

Constructor Summary

Constructors

Constructor and Description
DomainNameMappingBuilder(int initialCapacity, V defaultValue) Constructor with initial capacity of the map holding the mappings
DomainNameMappingBuilder(V defaultValue) Constructor with default initial capacity of the map holding the mappings

Method Summary

Modifier and Type	Method and Description
DomainNameMappingBuilder<V>	add(String hostname, V output) Adds a mapping that maps the specified (optionally wildcard) host name to the specified output value.
DomainNameMapping<V>	build() Creates a new instance of immutable DomainNameMapping Attempts to add new mappings to the result object will cause UnsupportedOperationException to be thrown

Methods inherited from class java.lang.Object

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

Constructor Detail

DomainNameMappingBuilder

public DomainNameMappingBuilder(V defaultValue)

Constructor with default initial capacity of the map holding the mappings

Parameters:

defaultValue - the default value for DomainNameMapping.map(String) to return when nothing matches the input

DomainNameMappingBuilder

public DomainNameMappingBuilder(int initialCapacity,
                                V defaultValue)

Constructor with initial capacity of the map holding the mappings

Parameters:

initialCapacity - initial capacity for the internal map

defaultValue - the default value for DomainNameMapping.map(String) to return when nothing matches the input

Method Detail

add

public DomainNameMappingBuilder<V> add(String hostname,
                                       V output)

Adds a mapping that maps the specified (optionally wildcard) host name to the specified output value. Null values are forbidden for both hostnames and values.

DNS wildcard is supported as hostname. For example, you can use *.netty.io to match netty.io and downloads.netty.io.

Parameters:

hostname - the host name (optionally wildcard)

output - the output value that will be returned by DomainNameMapping.map(String) when the specified host name matches the specified input host name

build

public DomainNameMapping<V> build()

Creates a new instance of immutable DomainNameMapping Attempts to add new mappings to the result object will cause UnsupportedOperationException to be thrown

Returns:

new DomainNameMapping instance