me.lucko.luckperms.api.context

Class MutableContextSet

java.lang.Object

me.lucko.luckperms.api.context.MutableContextSet

All Implemented Interfaces:

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

public final class MutableContextSet
extends Object
implements ContextSet

A mutable implementation of ContextSet.

Since:

2.16

Constructor Summary

Constructors

Constructor and Description
MutableContextSet()

Method Summary

Modifier and Type	Method and Description
void	add(Map.Entry<String,String> entry) Adds a context to this set.
void	add(@NonNull String key, @NonNull String value) Adds a context to this set.
void	addAll(@NonNull ContextSet contextSet) Adds of of the contexts in another ContextSet to this set.
void	addAll(@NonNull Iterable<? extends Map.Entry<String,String>> iterable) Adds the contexts contained in the given Iterable to this set.
void	addAll(@NonNull Map<String,String> map) Adds the contexts contained in the given Map to this set.
void	addAll(@NonNull Multimap<String,String> multimap) Adds the contexts contained in the given Multimap to this set.
protected SetMultimap<String,String>	backing()
void	clear() Removes all contexts from the set.
boolean	containsKey(@NonNull String key) Returns if the ContextSet contains at least one value for the given key.
protected void	copyTo(SetMultimap<String,String> other)
static @NonNull MutableContextSet	create() Creates a new empty MutableContextSet.
boolean	equals(Object o)
static @NonNull MutableContextSet	fromEntries(@NonNull Iterable<? extends Map.Entry<String,String>> iterable) Creates a MutableContextSet from an existing Iterable of Map.Entrys.
static @NonNull MutableContextSet	fromMap(@NonNull Map<String,String> map) Creates a MutableContextSet from an existing Map.
static @NonNull MutableContextSet	fromMultimap(@NonNull Multimap<String,String> multimap) Creates a MutableContextSet from an existing Multimap.
static @NonNull MutableContextSet	fromSet(@NonNull ContextSet contextSet) Creates a new MutableContextSet from an existing Set.
@NonNull Set<String>	getValues(@NonNull String key) Returns a Set of the values mapped to the given key.
boolean	has(@NonNull String key, @NonNull String value) Returns if the ContextSet contains a given context pairing.
int	hashCode()
boolean	isEmpty() Returns if the ContextSet is empty.
boolean	isImmutable() Gets if this ContextSet is immutable.
@NonNull Iterator<Map.Entry<String,String>>	iterator() Returns an Iterator over each of the context pairs in this set.
@NonNull ImmutableContextSet	makeImmutable() Returns an immutable representation of this ContextSet.
@NonNull MutableContextSet	mutableCopy() Creates a mutable copy of this ContextSet.
static @NonNull MutableContextSet	of(@NonNull String key1, @NonNull String value1, @NonNull String key2, @NonNull String value2) Creates a MutableContextSet from two context pairs.
void	remove(@NonNull String key, @NonNull String value) Removes a context from this set.
void	removeAll(@NonNull String key) Removes all contexts from this set with the given key.
static @NonNull MutableContextSet	singleton(@NonNull String key, @NonNull String value) Creates a MutableContextSet from a context pair.
int	size() Gets the number of context pairs in the ContextSet.
Spliterator<Map.Entry<String,String>>	spliterator()
@NonNull Map<String,String>	toMap() Deprecated.
@NonNull Multimap<String,String>	toMultimap() Returns a Multimap representing the current state of this ContextSet.
@NonNull Set<Map.Entry<String,String>>	toSet() Returns a Set of Map.Entrys representing the current state of this ContextSet.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface me.lucko.luckperms.api.context.ContextSet

containsKey, empty, getAnyValue, getValues, has, has, isEmpty, isSatisfiedBy, size

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

MutableContextSet

public MutableContextSet()

Method Detail

singleton

public static @NonNull MutableContextSet singleton(@NonNull String key,
                                                   @NonNull String value)

Creates a MutableContextSet from a context pair.

Specified by:

singleton in interface ContextSet

Parameters:

key - the key

value - the value

Returns:

a new MutableContextSet containing one context pair

Throws:

NullPointerException - if key or value is null

of

public static @NonNull MutableContextSet of(@NonNull String key1,
                                            @NonNull String value1,
                                            @NonNull String key2,
                                            @NonNull String value2)

Creates a MutableContextSet from two context pairs.

Specified by:

of in interface ContextSet

Parameters:

key1 - the first key

value1 - the first value

key2 - the second key

value2 - the second value

Returns:

a new MutableContextSet containing the two pairs

Throws:

NullPointerException - if any of the keys or values are null

Since:

3.1

fromEntries

public static @NonNull MutableContextSet fromEntries(@NonNull Iterable<? extends Map.Entry<String,String>> iterable)

Creates a MutableContextSet from an existing Iterable of Map.Entrys.

Specified by:

fromEntries in interface ContextSet

Parameters:

iterable - the iterable to copy from

Returns:

a new MutableContextSet representing the pairs in the iterable

Throws:

NullPointerException - if the iterable is null

fromMap

public static @NonNull MutableContextSet fromMap(@NonNull Map<String,String> map)

Creates a MutableContextSet from an existing Map.

Specified by:

fromMap in interface ContextSet

Parameters:

map - the map to copy from

Returns:

a new MutableContextSet representing the pairs from the map

Throws:

NullPointerException - if the map is null

fromMultimap

public static @NonNull MutableContextSet fromMultimap(@NonNull Multimap<String,String> multimap)

Creates a MutableContextSet from an existing Multimap.

Specified by:

fromMultimap in interface ContextSet

Parameters:

multimap - the multimap to copy from

Returns:

a new MutableContextSet representing the pairs in the multimap

Throws:

NullPointerException - if the multimap is null

Since:

2.16

fromSet

public static @NonNull MutableContextSet fromSet(@NonNull ContextSet contextSet)

Creates a new MutableContextSet from an existing Set.

Only really useful for converting between mutable and immutable types.

Specified by:

fromSet in interface ContextSet

Parameters:

contextSet - the context set to copy from

Returns:

a new MutableContextSet with the same content and the one provided

Throws:

NullPointerException - if contextSet is null

create

public static @NonNull MutableContextSet create()

Creates a new empty MutableContextSet.

Returns:

a new MutableContextSet

backing

protected SetMultimap<String,String> backing()

copyTo

protected void copyTo(SetMultimap<String,String> other)

isImmutable

public boolean isImmutable()

Description copied from interface: ContextSet

Gets if this ContextSet is immutable.

The state of immutable instances will never change.

Specified by:

isImmutable in interface ContextSet

Returns:

true if the set is immutable

makeImmutable

public @NonNull ImmutableContextSet makeImmutable()

Description copied from interface: ContextSet

Returns an immutable representation of this ContextSet.

If the set is already immutable, the same object will be returned. If the set is mutable, an immutable copy will be made.

Specified by:

makeImmutable in interface ContextSet

Returns:

an immutable representation of this set

mutableCopy

public @NonNull MutableContextSet mutableCopy()

Description copied from interface: ContextSet

Creates a mutable copy of this ContextSet.

A new copy is returned regardless of the mutability of this set.

Specified by:

mutableCopy in interface ContextSet

Returns:

a mutable ContextSet

toSet

public @NonNull Set<Map.Entry<String,String>> toSet()

Description copied from interface: ContextSet

Returns a Set of Map.Entrys representing the current state of this ContextSet.

The returned set is immutable, and is a copy of the current set. (will not update live)

Specified by:

toSet in interface ContextSet

Returns:

an immutable set

toMap

@Deprecated
public @NonNull Map<String,String> toMap()

Deprecated.

Description copied from interface: ContextSet

Returns a Map loosely representing the current state of this ContextSet.

The returned map is immutable, and is a copy of the current set. (will not update live)

As a single context key can be mapped to multiple values, this method may not be a true representation of the set.

If you need a representation of the set in a Java collection instance, use ContextSet.toSet() or ContextSet.toMultimap() followed by Multimap.asMap().

Specified by:

toMap in interface ContextSet

Returns:

an immutable map

toMultimap

public @NonNull Multimap<String,String> toMultimap()

Description copied from interface: ContextSet

Returns a Multimap representing the current state of this ContextSet.

The returned multimap is immutable, and is a copy of the current set. (will not update live)

Specified by:

toMultimap in interface ContextSet

Returns:

a multimap

iterator

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

Description copied from interface: ContextSet

Returns an Iterator over each of the context pairs in this set.

The returned iterator represents the state of the set at the time of creation. It is not updated as the set changes.

The iterator does not support Iterator.remove() calls.

Specified by:

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

Specified by:

iterator in interface ContextSet

Returns:

an iterator

spliterator

public Spliterator<Map.Entry<String,String>> spliterator()

Specified by:

spliterator in interface Iterable<Map.Entry<String,String>>

add

public void add(@NonNull String key,
                @NonNull String value)

Adds a context to this set.

Parameters:

key - the key to add

value - the value to add

Throws:

NullPointerException - if the key or value is null

add

public void add(Map.Entry<String,String> entry)

Adds a context to this set.

Parameters:

entry - the entry to add

Throws:

NullPointerException - if the entry is null

addAll

public void addAll(@NonNull Iterable<? extends Map.Entry<String,String>> iterable)

Adds the contexts contained in the given Iterable to this set.

Parameters:

iterable - an iterable of key value context pairs

Throws:

NullPointerException - if iterable is null

addAll

public void addAll(@NonNull Map<String,String> map)

Adds the contexts contained in the given Map to this set.

Parameters:

map - the map to add from

Throws:

NullPointerException - if the map is null

addAll

public void addAll(@NonNull Multimap<String,String> multimap)

Adds the contexts contained in the given Multimap to this set.

Parameters:

multimap - the multimap to add from

Throws:

NullPointerException - if the map is null

Since:

3.4

addAll

public void addAll(@NonNull ContextSet contextSet)

Adds of of the contexts in another ContextSet to this set.

Parameters:

contextSet - the set to add from

Throws:

NullPointerException - if the contextSet is null

remove

public void remove(@NonNull String key,
                   @NonNull String value)

Removes a context from this set.

Parameters:

key - the key to remove

value - the value to remove

Throws:

NullPointerException - if the key or value is null

removeAll

public void removeAll(@NonNull String key)

Removes all contexts from this set with the given key.

Parameters:

key - the key to remove

Throws:

NullPointerException - if the key is null

clear

public void clear()

Removes all contexts from the set.

toString

public String toString()

Overrides:

toString in class Object

containsKey

public boolean containsKey(@NonNull String key)

Description copied from interface: ContextSet

Returns if the ContextSet contains at least one value for the given key.

Specified by:

containsKey in interface ContextSet

Parameters:

key - the key to check for

Returns:

true if the set contains a value for the key

getValues

public @NonNull Set<String> getValues(@NonNull String key)

Description copied from interface: ContextSet

Returns a Set of the values mapped to the given key.

The returned set is immutable, and only represents the current state of the ContextSet. (will not update live)

Specified by:

getValues in interface ContextSet

Parameters:

key - the key to get values for

Returns:

a set of values

has

public boolean has(@NonNull String key,
                   @NonNull String value)

Description copied from interface: ContextSet

Returns if the ContextSet contains a given context pairing.

Specified by:

has in interface ContextSet

Parameters:

key - the key to look for

value - the value to look for

Returns:

true if the set contains the context pair

isEmpty

public boolean isEmpty()

Description copied from interface: ContextSet

Returns if the ContextSet is empty.

Specified by:

isEmpty in interface ContextSet

Returns:

true if the set is empty

size

public int size()

Description copied from interface: ContextSet

Gets the number of context pairs in the ContextSet.

Specified by:

size in interface ContextSet

Returns:

the size of the set

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object