com.ning.http.client
Class FluentStringsMap

java.lang.Object
  com.ning.http.client.FluentStringsMap

All Implemented Interfaces:

Iterable<Map.Entry<String,List<String>>>, Map<String,List<String>>

public class FluentStringsMap
extends Object
implements Map<String,List<String>>, Iterable<Map.Entry<String,List<String>>>

An implementation of a String -> List<String> map that adds a fluent interface, i.e. methods that return this instance.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

FluentStringsMap()

FluentStringsMap(FluentStringsMap src)

FluentStringsMap(Map<String,Collection<String>> src)

Method Summary

FluentStringsMap	add(String key, Collection<String> values) Adds the specified values and returns this object.
FluentStringsMap	add(String key, String... values) Adds the specified values and returns this object.
FluentStringsMap	addAll(FluentStringsMap src) Adds all key-values pairs from the given object to this object and returns this object.
FluentStringsMap	addAll(Map<String,Collection<String>> src) Adds all key-values pairs from the given map to this object and returns this object.
void	clear()
boolean	containsKey(Object key)
boolean	containsValue(Object value)
FluentStringsMap	delete(String key) Removes the values for the given key if present and returns this object.
FluentStringsMap	deleteAll(Collection<String> keys) Removes the values for the given keys if present and returns this object.
FluentStringsMap	deleteAll(String... keys) Removes the values for the given keys if present and returns this object.
Set<Map.Entry<String,List<String>>>	entrySet()
boolean	equals(Object obj)
List<String>	get(Object key)
String	getFirstValue(String key) Returns the value for the given key.
String	getJoinedValue(String key, String delimiter) Returns the values for the given key joined into a single string using the given delimiter.
int	hashCode()
boolean	isEmpty()
Iterator<Map.Entry<String,List<String>>>	iterator()
Set<String>	keySet()
List<String>	put(String key, List<String> value)
void	putAll(Map<? extends String,? extends List<String>> values)
List<String>	remove(Object key)
FluentStringsMap	replace(String key, Collection<String> values) Replaces the values for the given key with the given values.
FluentStringsMap	replace(String key, String... values) Replaces the values for the given key with the given values.
FluentStringsMap	replaceAll(FluentStringsMap src) Replace the values for all keys from the given map that are also present in this object, with the values from the given map.
FluentStringsMap	replaceAll(Map<? extends String,? extends Collection<String>> src) Replace the values for all keys from the given map that are also present in this object, with the values from the given map.
int	size()
String	toString()
Collection<List<String>>	values()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

FluentStringsMap

public FluentStringsMap()

FluentStringsMap

public FluentStringsMap(FluentStringsMap src)

FluentStringsMap

public FluentStringsMap(Map<String,Collection<String>> src)

Method Detail

add

public FluentStringsMap add(String key,
                            String... values)

Adds the specified values and returns this object.

Parameters:

key - The key

values - The value(s); if null then this method has no effect. Use the empty string to generate an empty value

Returns:

This object

add

public FluentStringsMap add(String key,
                            Collection<String> values)

Adds the specified values and returns this object.

Parameters:

key - The key

values - The value(s); if null then this method has no effect. Use an empty collection to generate an empty value

Returns:

This object

addAll

public FluentStringsMap addAll(FluentStringsMap src)

Adds all key-values pairs from the given object to this object and returns this object.

Parameters:

src - The source object

Returns:

This object

addAll

public FluentStringsMap addAll(Map<String,Collection<String>> src)

Adds all key-values pairs from the given map to this object and returns this object.

Parameters:

src - The source map

Returns:

This object

replace

public FluentStringsMap replace(String key,
                                String... values)

Replaces the values for the given key with the given values.

Parameters:

key - The key

values - The new values

Returns:

This object

replace

public FluentStringsMap replace(String key,
                                Collection<String> values)

Replaces the values for the given key with the given values.

Parameters:

key - The key

values - The new values

Returns:

This object

replaceAll

public FluentStringsMap replaceAll(FluentStringsMap src)

Replace the values for all keys from the given map that are also present in this object, with the values from the given map. All key-values from the given object that are not present in this object, will be added to it.

Parameters:

src - The source object

Returns:

This object

replaceAll

public FluentStringsMap replaceAll(Map<? extends String,? extends Collection<String>> src)

Replace the values for all keys from the given map that are also present in this object, with the values from the given map. All key-values from the given object that are not present in this object, will be added to it.

Parameters:

src - The source map

Returns:

This object

put

public List<String> put(String key,
                        List<String> value)

Specified by:

put in interface Map<String,List<String>>

putAll

public void putAll(Map<? extends String,? extends List<String>> values)

Specified by:

putAll in interface Map<String,List<String>>

delete

public FluentStringsMap delete(String key)

Removes the values for the given key if present and returns this object.

Parameters:

key - The key

Returns:

This object

deleteAll

public FluentStringsMap deleteAll(String... keys)

Removes the values for the given keys if present and returns this object.

Parameters:

keys - The keys

Returns:

This object

deleteAll

public FluentStringsMap deleteAll(Collection<String> keys)

Removes the values for the given keys if present and returns this object.

Parameters:

keys - The keys

Returns:

This object

remove

public List<String> remove(Object key)

Specified by:

remove in interface Map<String,List<String>>

clear

public void clear()

Specified by:

clear in interface Map<String,List<String>>

iterator

public Iterator<Map.Entry<String,List<String>>> iterator()

Specified by:

iterator in interface Iterable<Map.Entry<String,List<String>>>

keySet

public Set<String> keySet()

Specified by:

keySet in interface Map<String,List<String>>

entrySet

public Set<Map.Entry<String,List<String>>> entrySet()

Specified by:

entrySet in interface Map<String,List<String>>

size

public int size()

Specified by:

size in interface Map<String,List<String>>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<String,List<String>>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<String,List<String>>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<String,List<String>>

getFirstValue

public String getFirstValue(String key)

Returns the value for the given key. If there are multiple values for this key, then only the first one will be returned.

Parameters:

key - The key

Returns:

The first value

getJoinedValue

public String getJoinedValue(String key,
                             String delimiter)

Returns the values for the given key joined into a single string using the given delimiter.

Parameters:

key - The key

Returns:

The value as a single string

get

public List<String> get(Object key)

Specified by:

get in interface Map<String,List<String>>

values

public Collection<List<String>> values()

Specified by:

values in interface Map<String,List<String>>

equals

public boolean equals(Object obj)

Specified by:

equals in interface Map<String,List<String>>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Map<String,List<String>>

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object