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(String key, String value) Adds a context to this set.
void	addAll(ContextSet contextSet) Adds of of the contexts in another ContextSet to this set.
void	addAll(Iterable<? extends Map.Entry<String,String>> iterable) Adds the contexts contained in the given Iterable to this set.
void	addAll(Map<String,String> map) Adds the contexts contained in the given Map to this set.
void	addAll(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(String key) Returns if the ContextSet contains at least one value for the given key.
protected void	copyTo(SetMultimap<String,String> other)
static MutableContextSet	create() Creates a new empty MutableContextSet.
boolean	equals(Object o)
static MutableContextSet	fromEntries(Iterable<? extends Map.Entry<String,String>> iterable) Creates a MutableContextSet from an existing Iterable of Map.Entrys.
static MutableContextSet	fromMap(Map<String,String> map) Creates a MutableContextSet from an existing Map.
static MutableContextSet	fromMultimap(Multimap<String,String> multimap) Creates a MutableContextSet from an existing Multimap.
static MutableContextSet	fromSet(ContextSet contextSet) Creates a new MutableContextSet from an existing Set.
Set<String>	getValues(String key) Returns a Set of the values mapped to the given key.
boolean	has(String key, 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.
Iterator<Map.Entry<String,String>>	iterator() Returns an Iterator over each of the context pairs in this set.
ImmutableContextSet	makeImmutable() Returns an immutable representation of this ContextSet.
MutableContextSet	mutableCopy() Creates a mutable copy of this ContextSet.
static MutableContextSet	of(String key1, String value1, String key2, String value2) Creates a MutableContextSet from two context pairs.
void	remove(String key, String value) Removes a context from this set.
void	removeAll(String key) Removes all contexts from this set with the given key.
static MutableContextSet	singleton(String key, 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()
Map<String,String>	toMap() Deprecated.
Multimap<String,String>	toMultimap() Returns a Multimap representing the current state of this ContextSet.
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

@Nonnull
public static 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

@Nonnull
public static 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

@Nonnull
public static 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

@Nonnull
public static 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

@Nonnull
public static 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

@Nonnull
public static 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

@Nonnull
public static 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

@Nonnull
public 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

@Nonnull
public 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

@Nonnull
public 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

@Nonnull
 @Deprecated
public 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

@Nonnull
public 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

@Nonnull
public 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(@Nonnull
                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

@Nonnull
public 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