com.codelanx.codelanxlib.util.auth

Class UUIDFetcher

java.lang.Object

com.codelanx.codelanxlib.util.auth.UUIDFetcher

All Implemented Interfaces:

Callable<Map<String,UUID>>

public class UUIDFetcher
extends Object
implements Callable<Map<String,UUID>>

All credit to evilmidget38! A small bit of cleanup for Java 8. This class can dynamically retrieve the relevant UUIDs for one or multiple players on the server

Since:

0.0.1

Version:

0.1.0

Author:

evilmidget38, 1Rogue (Cleanup / Documentation)

Constructor Summary

Constructors

Constructor and Description
UUIDFetcher(List<String> names) Passes the names to the other constructor, and true for rate limiting
UUIDFetcher(List<String> names, boolean rateLimiting) Makes a copy of the names to be retrieved

Method Summary

Modifier and Type	Method and Description
Map<String,UUID>	call() Makes a request to mojang's servers of a sublist of at most 100 player's names.
Map<String,UserInfo>	callFromOldNames(boolean output, Logger log, Predicate<? super Integer> doOutput) Calls each supplied name individually to Mojang's servers, treating them as previously used names which henceforth were changed.
Map<String,UUID>	callWithProgessOutput(boolean output, Logger log, Predicate<? super Integer> doOutput) Makes a request to mojang's servers of a sublist of at most 100 player's names.
static UUID	fromBytes(byte[] array) Returns a UUID from a byte array
static UUID	getUUIDOf(String name) Returns the UUID of a player's username.
static byte[]	toBytes(UUID uuid) Converts a UUID into bytes

Methods inherited from class java.lang.Object

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

Constructor Detail

UUIDFetcher

public UUIDFetcher(List<String> names,
                   boolean rateLimiting)

Makes a copy of the names to be retrieved

Parameters:

names - The player names to retrieve

rateLimiting - Whether or not to rate limit requests to Mojang

Since:

0.0.1

UUIDFetcher

public UUIDFetcher(List<String> names)

Passes the names to the other constructor, and true for rate limiting

Parameters:

names - The names to convert

Since:

0.0.1

See Also:

UUIDFetcher(List, boolean)

Method Detail

call

public Map<String,UUID> call()
                      throws IOException,
                             org.json.simple.parser.ParseException,
                             InterruptedException

Makes a request to mojang's servers of a sublist of at most 100 player's names.

Specified by:

call in interface Callable<Map<String,UUID>>

Returns:

A Map of player names to their UUIDs

Throws:

IOException - If there's a problem sending or receiving the request

org.json.simple.parser.ParseException - If the request response cannot be read

InterruptedException - If the thread is interrupted while sleeping

Since:

0.0.1

callWithProgessOutput

public Map<String,UUID> callWithProgessOutput(boolean output,
                                              Logger log,
                                              Predicate<? super Integer> doOutput)
                                       throws IOException,
                                              org.json.simple.parser.ParseException,
                                              InterruptedException

Makes a request to mojang's servers of a sublist of at most 100 player's names. Additionally can provide progress outputs

Parameters:

output - Whether or not to print output

log - The Logger to print to

doOutput - A Predicate representing when to output a number

Returns:

A Map of player names to their UUIDs

Throws:

IOException - If there's a problem sending or receiving the request

org.json.simple.parser.ParseException - If the request response cannot be read

InterruptedException - If the thread is interrupted while sleeping

Since:

0.0.1

callFromOldNames

public Map<String,UserInfo> callFromOldNames(boolean output,
                                             Logger log,
                                             Predicate<? super Integer> doOutput)
                                      throws IOException,
                                             org.json.simple.parser.ParseException,
                                             InterruptedException

Calls each supplied name individually to Mojang's servers, treating them as previously used names which henceforth were changed. This method is much slower than the other call methods, and should only be used if there is a need to retrieve names which are now changed

Parameters:

output - Whether or not to print output

log - The Logger to print to

doOutput - A Predicate representing when to output a number

Returns:

A Map of supplied names to relevant UserInfo. Note that this map will contain the supplied names even if they are invalid or not actual usernames (in which case, they will be mapped to null). Note names that have never been changed before will be mapped as invalid per this method

Throws:

IOException - If there's a problem sending or receiving the request

org.json.simple.parser.ParseException - If the request response cannot be read

InterruptedException - If the thread is interrupted while sleeping

Since:

0.1.0

toBytes

public static byte[] toBytes(UUID uuid)

Converts a UUID into bytes

Parameters:

uuid - The UUID to convert

Returns:

The new byte array

Since:

0.0.1

fromBytes

public static UUID fromBytes(byte[] array)

Returns a UUID from a byte array

Parameters:

array - The byte array to convert

Returns:

The new UUID object

Throws:

IllegalArgumentException - if the array length is not 16

Since:

0.0.1

getUUIDOf

public static UUID getUUIDOf(String name)
                      throws IOException,
                             org.json.simple.parser.ParseException,
                             InterruptedException

Returns the UUID of a player's username. Note that this is a blocking method

Parameters:

name - The username of the player to fetch a UUID for

Returns:

The UUID of the player name that is passed

Throws:

IOException - If there's a problem sending or receiving the request

org.json.simple.parser.ParseException - If the request response cannot be read

InterruptedException - If the thread is interrupted while sleeping

Since:

0.0.1