Package net.dv8tion.jda.api.utils.cache

Interface UnifiedMemberCacheView

All Superinterfaces:

CacheView<Member>, java.lang.Iterable<Member>

public interface UnifiedMemberCacheView
extends CacheView<Member>

CacheView implementation specifically to combine Member cache views.

This is done because Members do not implement ISnowflake as they are not globally unique but only unique per Guild!

See Also:

CacheView for details on Efficient Memory Usage

Nested Class Summary

Nested classes/interfaces inherited from interface net.dv8tion.jda.api.utils.cache.CacheView

CacheView.SimpleCacheView<T>

Method Summary

Modifier and Type	Method	Description
java.util.List<Member>	getElementsById(long id)	Retrieves all member represented by the provided ID.
default java.util.List<Member>	getElementsById(java.lang.String id)	Retrieves all member represented by the provided ID.
default java.util.List<Member>	getElementsByNickname(java.lang.String name)	Creates an immutable list of all members matching the given nickname.
java.util.List<Member>	getElementsByNickname(java.lang.String name, boolean ignoreCase)	Creates an immutable list of all members matching the given nickname.
default java.util.List<Member>	getElementsByUsername(java.lang.String name)	Creates an immutable list of all members matching the given username.
java.util.List<Member>	getElementsByUsername(java.lang.String name, boolean ignoreCase)	Creates an immutable list of all members matching the given username.
java.util.List<Member>	getElementsWithRoles(java.util.Collection<Role> roles)	Creates an immutable list of all members that hold all of the provided roles.
java.util.List<Member>	getElementsWithRoles(Role... roles)	Creates an immutable list of all members that hold all of the provided roles.

Methods inherited from interface net.dv8tion.jda.api.utils.cache.CacheView

acceptStream, applyStream, asList, asSet, collect, forEachUnordered, getElementsByName, getElementsByName, isEmpty, lockedIterator, parallelStream, size, stream

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Method Detail

getElementsById

@Nonnull
java.util.List<Member> getElementsById(long id)

Retrieves all member represented by the provided ID.

Parameters:

id - The ID of the members

Returns:

Possibly-empty unmodifiable list of member for the specified ID

getElementsById

@Nonnull
default java.util.List<Member> getElementsById(@Nonnull
                                               java.lang.String id)

Retrieves all member represented by the provided ID.

Parameters:

id - The ID of the members

Returns:

Possibly-empty unmodifiable list of member for the specified ID

Throws:

java.lang.NumberFormatException - If the provided String is null or cannot be resolved to an unsigned long id

getElementsByUsername

@Nonnull
java.util.List<Member> getElementsByUsername(@Nonnull
                                             java.lang.String name,
                                             boolean ignoreCase)

Creates an immutable list of all members matching the given username.
This will check the name of the wrapped user.

Parameters:

name - The name to check

ignoreCase - Whether to ignore case when comparing usernames

Returns:

Immutable list of members with the given username

Throws:

java.lang.IllegalArgumentException - If the provided name is null

getElementsByUsername

@Nonnull
default java.util.List<Member> getElementsByUsername(@Nonnull
                                                     java.lang.String name)

Creates an immutable list of all members matching the given username.
This will check the name of the wrapped user.

Parameters:

name - The name to check

Returns:

Immutable list of members with the given username

Throws:

java.lang.IllegalArgumentException - If the provided name is null

getElementsByNickname

@Nonnull
java.util.List<Member> getElementsByNickname(@Nullable
                                             java.lang.String name,
                                             boolean ignoreCase)

Creates an immutable list of all members matching the given nickname.
This will check the nickname of the member. If provided with null this will check for members that have no nickname set.

Parameters:

name - The nullable nickname to check

ignoreCase - Whether to ignore case when comparing nicknames

Returns:

Immutable list of members with the given nickname

getElementsByNickname

@Nonnull
default java.util.List<Member> getElementsByNickname(@Nullable
                                                     java.lang.String name)

Creates an immutable list of all members matching the given nickname.
This will check the nickname of the member. If provided with null this will check for members that have no nickname set.

Parameters:

name - The nullable nickname to check

Returns:

Immutable list of members with the given nickname

getElementsWithRoles

@Nonnull
java.util.List<Member> getElementsWithRoles(@Nonnull
                                            Role... roles)

Creates an immutable list of all members that hold all of the provided roles.

Parameters:

roles - Roles the members should have

Returns:

Immutable list of members with the given roles

Throws:

java.lang.IllegalArgumentException - If provided with null

getElementsWithRoles

@Nonnull
java.util.List<Member> getElementsWithRoles(@Nonnull
                                            java.util.Collection<Role> roles)

Creates an immutable list of all members that hold all of the provided roles.

Parameters:

roles - Roles the members should have

Returns:

Immutable list of members with the given roles

Throws:

java.lang.IllegalArgumentException - If provided with null