net.rithms.util

Class RiotApiUtil

java.lang.Object

net.rithms.util.RiotApiUtil

public final class RiotApiUtil
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
RiotApiUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	joinString(java.lang.CharSequence delimiter, java.lang.CharSequence... elements) Returns a new String composed of copies of the elements joined together with a copy of the specified delimiter.
static java.lang.String	joinString(java.lang.CharSequence delimiter, java.lang.Object... elements) Returns a new String composed of copies of the elements joined together with a copy of the specified delimiter.
static java.lang.String	normalizeSummonerName(java.lang.String summonerName) Normalizes and returns a summoner name.
static <T> java.util.Map<java.lang.String,T>	normalizeSummonerNames(java.util.Map<java.lang.String,T> summonerNames) Normalizes and returns a map with summoner name keys.
static java.lang.String[]	normalizeSummonerNames(java.lang.String... summonerNames) Normalizes and returns an array of summoner names.
static java.lang.String	requireValidSummonerName(java.lang.String summonerName) Checks that the specified String is not an invalid summoner name.

Methods inherited from class java.lang.Object

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

Constructor Detail

RiotApiUtil

public RiotApiUtil()

Method Detail

normalizeSummonerName

public static java.lang.String normalizeSummonerName(java.lang.String summonerName)

Normalizes and returns a summoner name. Specifically, this casts String summonerName to lower case and strips any whitespaces.

Parameters:

summonerName - summoner name

Returns:

Normalized summoner name

Throws:

java.lang.NullPointerException - If summonerName is null

normalizeSummonerNames

public static java.lang.String[] normalizeSummonerNames(java.lang.String... summonerNames)

Normalizes and returns an array of summoner names. Specifically, this casts each of String[] summonerNames to lower case and strips any whitespaces.

Parameters:

summonerNames - summoner names

Returns:

Normalized summoner names

Throws:

java.lang.NullPointerException - If summonerNames is null

normalizeSummonerNames

public static <T> java.util.Map<java.lang.String,T> normalizeSummonerNames(java.util.Map<java.lang.String,T> summonerNames)

Normalizes and returns a map with summoner name keys. This casts each of the keys of Map<String, T> map to lower case and strips any whitespaces.

Parameters:

summonerNames - map with summoner name keys

Returns:

Normalized map with summoner name keys

Throws:

java.lang.NullPointerException - If summonerNames is null

joinString

public static java.lang.String joinString(java.lang.CharSequence delimiter,
                                          java.lang.Object... elements)

Returns a new String composed of copies of the elements joined together with a copy of the specified delimiter. Note that if an element is null, then "null" is added.

Parameters:

delimiter - the delimiter that separates each element

elements - the elements to join together

Returns:

a new String that is composed of the elements separated by the delimiter

Throws:

java.lang.NullPointerException - If delimiter or elements is null

joinString

public static java.lang.String joinString(java.lang.CharSequence delimiter,
                                          java.lang.CharSequence... elements)

Returns a new String composed of copies of the elements joined together with a copy of the specified delimiter. Note that if an element is null, then "null" is added.

Parameters:

delimiter - the delimiter that separates each element

elements - the elements to join together

Returns:

a new String that is composed of the elements separated by the delimiter

Throws:

java.lang.NullPointerException - If delimiter or elements is null

requireValidSummonerName

public static java.lang.String requireValidSummonerName(java.lang.String summonerName)
                                                 throws java.lang.IllegalArgumentException

Checks that the specified String is not an invalid summoner name. This method is designed primarily to be called by the RiotApi to check the validity of a summoner name before firing a request to the Riot Api.

Parameters:

summonerName - The summoner name to to check for validity

Returns:

summonerName if not invalid

Throws:

java.lang.IllegalArgumentException - If summonerName is not valid