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,UUID>	callWithProgessOutput(boolean output, Logger log, java.util.function.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,
                                              java.util.function.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

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