Orianna

A Java adaptation of the Riot Games League of Legends API (https://developer.riotgames.com/).

Orianna is the sister library to Cassiopeia (Python). It's been designed with usability in mind - making sure all the bookkeeping is done right so you can focus on getting the data you need and building your application.

Orianna is licensed under the MIT License.

Documentation & Examples

The full JavaDoc for Orianna is available here. More detailed documentation about the project is coming soon! Examples of using Orianna can be found here.

Features

Orianna is designed to make the lives of Riot API developers as easy as possible. Here are some of the ways we do it:

• An enhanced user interface that makes using the Riot API easy and fun
  • Restructured and renamed API data for maximum clarity
  • Fluent APIs for requesting data
  • Automatic conversion of foreign keys into the objects they specify (e.g player.getChampion() instead of player.getChampionId())
• Rate limits handled automatically with optimal usage of your API key
• Configurable handling of API errors (e.g. automatic retry on 500 errors)
• Built-in automatic caching, ready out of the box.
• DataDragon support
• A highly configurable pipeline for requesting and caching Riot API data
  • Allows flexibility in what database(s) you want to use to cache your data
  • Off-the-shelf support for many popular databases under construction here
  • Extensible to seamlessly integrate other data types and APIs, such as the ChampionGG API (ChampionGG support coming soon!)

How to get it

Orianna is distributed through the releases page and through Maven Central. The easiest way to get it is by using Maven or Gradle.

Maven

To add the latest Orianna release version to your maven project, add the dependency to your pom.xml dependencies section:

<dependencies>
  <dependency>
    <groupId>com.merakianalytics.orianna</groupId>
    <artifactId>orianna</artifactId>
    <version>3.0.2</version>
    <!-- or, for Android: -->
    <artifactId>orianna-android</artifactId>
    <version>3.0.2</version>
  </dependency>
</dependencies>

Or, if you want to get the latest development version, add the Sonaype Snapshot Repository to your pom.xml as well:

<dependencies>
  <dependency>
    <groupId>com.merakianalytics.orianna</groupId>
    <artifactId>orianna</artifactId>
    <version>3.0.3-SNAPSHOT</version>
    <!-- or, for Android: -->
    <artifactId>orianna-android</artifactId>
    <version>3.0.3-SNAPSHOT</version>
  </dependency>
</dependencies>

<repositories>
  <repository>
    <id>snapshots-repo</id>
    <url>https://oss.sonatype.org/content/repositories/snapshots</url>
    <releases>
      <enabled>false</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

Gradle

To add the latest Orianna release version to your gradle project, add the Maven Central repository to your build.gradle repositories section, and add the dependency to your build.gradle dependencies section:

repositories {
  mavenCentral()
}

dependencies {
  compile "com.merakianalytics.orianna:orianna:3.0.2"
  // or, for Android:
  compile "com.merakianalytics.orianna:orianna-android:3.0.2"
}

Or, if you want to get the latest development version, add the Sonaype Snapshot Repository to your build.gradle instead:

repositories {
  maven { url "https://oss.sonatype.org/content/repositories/snapshots" }
}

dependencies {
  compile "com.merakianalytics.orianna:orianna:3.0.3-SNAPSHOT"
  // or, for Android:
  compile "com.merakianalytics.orianna:orianna-android:3.0.3-SNAPSHOT"
}

Using the release JAR directly

Grab the latest JAR from the releases page and add it to your project dependencies. JARs are provide both with and without Orianna's dependencies included. The jar-with-dependencies version will get you up & running faster, but can cause version conflicts if your project has other dependencies.

If you're using the JAR without dependencies inlcuded, Orianna depends on the following libraries which will also need to be added as dependencies:

• slf4j-api (version 1.7.25)
• datapipelines (version 1.0.2)
• hipster4j (version 1.0.1)
• guava (version 20.0)
• okhttp (version 3.9.1)
• jackson-databind (version 2.9.4)
• jackson-dataformat-msgpack (version 0.8.14)
• joda-time (version 2.9.9)
• jackson-datatype-joda (version 2.9.3)
• cache2k (version 1.0.2.Final)

Example

Check out a basic example of Orianna in action. More examples are available here.

import com.merakianalytics.orianna.Orianna;
import com.merakianalytics.orianna.types.common.Queue;
import com.merakianalytics.orianna.types.common.Region;
import com.merakianalytics.orianna.types.core.league.League;
import com.merakianalytics.orianna.types.core.staticdata.Champion;
import com.merakianalytics.orianna.types.core.staticdata.Champions;
import com.merakianalytics.orianna.types.core.summoner.Summoner;

public class Example {
    public static void main(String[] args) {
        Orianna.setRiotAPIKey("YOUR-API-KEY");
        Orianna.setDefaultRegion(Region.NORTH_AMERICA);

        Summoner summoner = Orianna.summonerNamed("FatalElement").get();
        System.out.println(summoner.getName() + " is level " + summoner.getLevel() + " on the " + summoner.getRegion() + " server.");

        Champions champions = Orianna.getChampions();
        Champion randomChampion = champions.get((int)(Math.random() * champions.size()));
        System.out.println("He enjoys playing champions such as " + randomChampion.getName());

        League challengerLeague = Orianna.challengerLeagueInQueue(Queue.RANKED_SOLO_5x5).get();
        Summoner bestNA = challengerLeague.get(0).getSummoner();
        System.out.println("He's not as good as " + bestNA.getName() + " at League, but probably a better Java programmer!");
    }
}

Configuring Orianna

Orianna ships with a default configuration designed to get new users going as quickly as possible. However, you may find you want to take advantage of some of the configuration options Orianna supports by replacing that configuration with your own.

Orianna is able to automatically load your Riot API Key from your environment variables on startup. To take advantage of this, set your RIOT_API_KEY environment variable to your Riot API Key.

For more complex configuration, just download the default configuration, make the changes you'd like, and load the new configuration file when your program starts. Documentation describing the full range of configuration options available with Orianna is coming soon.

Orianna.loadConfiguration(new File("/path/to/your/configuration-file.json"));

Alternatively, Orianna can automatically load your configuration file on startup if you set your ORIANNA_CONFIGURATION_PATH environment variable to the path of your configuration file.

Questions & Contributions

Feel free to send pull requests or to contact us via GitHub or Discord. We also hang around the Riot API Discord, so come by and say hello. We love to hear what people are building with Orianna! If you would like to help us maintain Orianna, let us know on our Discord.

Bugs

If you find bugs please let us know via a pull request or issue.

Disclaimer

Orianna isn't endorsed by Riot Games and doesn't reflect the views or opinions of Riot Games or anyone officially involved in producing or managing League of Legends. League of Legends and Riot Games are trademarks or registered trademarks of Riot Games, Inc. League of Legends © Riot Games, Inc.