Riot Api Java Versions Save

WARNING!

This update may break existing code. Methods and/or parameters have been changed in this release. Please update any existing code to satisfy these new changes.

---

Updated JavaDocs

• Every method now has updated, detailed JavaDoc descriptions You can check it out here.

New Methods

The following methods have been added to allow summonerId input as String instead of long.

• getTeamsBySummonerId(Region, String)
• getTeamsBySummonerId(String)
• getCurrentGameInfo(PlatformId, String)
• getRecentGames(Region, String)
• getRecentGames(String)

Renamed Methods

The following methods have been renamed for clarity.

• getChallengerLeagues() methods have been renamed to getChallengerLeague()
• getMasterLeagues() methods have been renamed to getMasterLeague()

Internal Code Optimizations

If interested in more details read about the changes here https://github.com/rithms/riot-api-java/pull/37

---

Thanks to Linnun for these changes!

New

Added current season constant: Season.CURRENT

Bug Fixes

• NullPointerExceptions caused by IOExceptions when making requests has been fixed. When an IOException occurs, RiotApiException.IOEXCEPTION will be thrown, rather than returning null.
• API methods will no longer return null, and will now throw a RiotApiException.PARSE_FAILURE exception anytime GSON parsing results in null, rather than only throwing an exception when there is a JsonSyntaxException.
• The regional endpoint for the PBE has been updated to fit the documentation on this page
• The status shard endpoint now supports the PBE server, and will no longer return a forbidden response.

Clean up

Removed all related code for deprecated Match History endpoint.

Contributors

~ Thanks to Linnun for these changes

Added BySummoner and ByTeam versions of methods

By popular request - Added BySummoner and ByTeam versions of some methods that already exist. For example, you can now use getLeagueBySummoner, instead of getLeagueBySummoners and passing in one summoner. This allows you to not have to deal with data structures (Maps, Sets) with only one entry, and instead, just get the single entry directly.

The following methods, and their equivalent overloaded versions have been added:

• getLeagueBySummoner(Region region, long summonerId)
• getLeagueEntryBySummoner(Region region, long summonerId)
• getLeagueBySummoner(Region region, String summonerId)
• getLeagueEntryBySummoner(Region region, String summonerId)
• getLeagueByTeam(Region region, String teamId)
• getLeagueEntryByTeam(Region region, String teamId)
• getMasteryPages(Region region, long summonerId)
• getRunePages(Region region, long summonerId)
• getTeamsBySummonerId(Region region, long summonerId)

Bug fixes

Methods allowing teamId parameters to be passed as a long value have been removed, since teamIds are always Strings, and are not similar to summonerIds in their structure. Sorry for the oversight if this caused anyone confusion or issues.

MatchList Endpoint

• Methods for the matchlist-v2.2 endpoint have been added.

MatchHistory Deprecation

• Methods for the matchhistory-v2.2 endpoint have been deprecated and replaced by the new matchlist-v2.2 methods.

MatchHistory endpoint will no longer be officially supported. Deadline for removal is September 22nd, 2015

For more information regarding these changes to the official API, read the official annoucement found here.

Bilgewater game mode now supported

• Added Bilgewater queues to queueType.
• Added Bilgewater to subTypes.
• Added Bilgewater to playerStatSummaryTypes.

Bugfix

• Fixed Nemesis gameQueueConfigId.
• Nemesis mode is no longer missing from playerStatSummaryTypes.

League-v2.5

Bug fix getMasterLeagues() method. (Thanks Linnun)

Summoner-v1.4 Method Updates

• getSummonerByName() methods now return a Summoner object rather than a Map<String, Summoner> with one entry.
• getSummonerById() methods now return a Summoner object rather than a Map<String, Summoner> with one entry.
• getSummonerName() methods now return a String of the summoner name rather than a Map<String, String> with one entry.

Note - getSummonersByName(), getSummonersById, and getSummonerNames() remain unchanged.

Added support for Master leagues endpoint

Methods: getMasterLeagues() getMasterLeagues(Region region) getMasterLeagues(Region region, QueueType queueType) getMasterLeagues(QueueType queueType)

Return Type: League

For more information about this new endpoint, see the official Riot Games API documentation

Hotfix

• dto.Static.Stats now implements Serializable.

Fixed a couple static method bugs relating to multiple and null data constant parameters.

getItemData(...) should now properly return additional requested data.