play.libs.typedmap

Class TypedMap

java.lang.Object

play.libs.typedmap.TypedMap

public final class TypedMap
extends java.lang.Object

A TypedMap is an immutable map containing typed values. Each entry is associated with a TypedKey that can be used to look up the value. A TypedKey also defines the type of the value, e.g. a TypedKey<String> would be associated with a String value.

Instances of this class are created with the empty() method.

The elements inside TypedMaps cannot be enumerated. This is a decision designed to enforce modularity. It's not possible to accidentally or intentionally access a value in a TypedMap without holding the corresponding TypedKey.

Constructor Summary

Constructors

Constructor and Description
TypedMap(play.api.libs.typedmap.TypedMap underlying)

Method Summary

Modifier and Type	Method and Description
play.api.libs.typedmap.TypedMap	asScala()
boolean	containsKey(TypedKey<?> key) Check if the map contains a value with the given key.
static TypedMap	create(TypedEntry<?>... entries)
static TypedMap	empty()
<A> A	get(TypedKey<A> key) Get a value from the map, throwing an exception if it is not present.
<A> java.util.Optional<A>	getOptional(TypedKey<A> key) Get a value from the map, returning an empty Optional if it is not present.
<A> TypedMap	put(TypedKey<A> key, A value) Update the map with the given key and value, returning a new instance of the map.
TypedMap	putAll(TypedEntry<?>... entries) Update the map with several entries, returning a new instance of the map.
TypedMap	remove(TypedKey<?>... keys) Removes keys from the map, returning a new instance of the map.
java.lang.String	toString()
play.api.libs.typedmap.TypedMap	underlying() Deprecated. As of release 2.6.8. Use asScala()

Methods inherited from class java.lang.Object

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

Constructor Detail

TypedMap

public TypedMap(play.api.libs.typedmap.TypedMap underlying)

Method Detail

underlying

@Deprecated
public play.api.libs.typedmap.TypedMap underlying()

Deprecated. As of release 2.6.8. Use asScala()

Returns:

the underlying Scala TypedMap which this instance wraps.

asScala

public play.api.libs.typedmap.TypedMap asScala()

Returns:

the underlying Scala TypedMap which this instance wraps.

get

public <A> A get(TypedKey<A> key)

Get a value from the map, throwing an exception if it is not present.

Type Parameters:

A - The type of value to retrieve.

Parameters:

key - The key for the value to retrieve.

Returns:

The value, if it is present in the map.

Throws:

java.util.NoSuchElementException - If the value isn't present in the map.

getOptional

public <A> java.util.Optional<A> getOptional(TypedKey<A> key)

Get a value from the map, returning an empty Optional if it is not present.

Type Parameters:

A - The type of value to retrieve.

Parameters:

key - The key for the value to retrieve.

Returns:

An Optional, with the value present if it is in the map.

containsKey

public boolean containsKey(TypedKey<?> key)

Check if the map contains a value with the given key.

Parameters:

key - The key to check for.

Returns:

True if the value is present, false otherwise.

put

public <A> TypedMap put(TypedKey<A> key,
                        A value)

Update the map with the given key and value, returning a new instance of the map.

Type Parameters:

A - The type of value.

Parameters:

key - The key to set.

value - The value to use.

Returns:

A new instance of the map with the new entry added.

putAll

public TypedMap putAll(TypedEntry<?>... entries)

Update the map with several entries, returning a new instance of the map.

Parameters:

entries - The new entries to add to the map.

Returns:

A new instance of the map with the new entries added.

remove

public TypedMap remove(TypedKey<?>... keys)

Removes keys from the map, returning a new instance of the map.

Parameters:

keys - The keys to remove.

Returns:

A new instance of the map with the entries removed.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

empty

public static TypedMap empty()

Returns:

the empty TypedMap instance.

create

public static TypedMap create(TypedEntry<?>... entries)

Parameters:

entries - the list of typed entries

Returns:

a newly built TypedMap from a list of keys and values.