me.xhsun.guildwars2wrapper.GuildWars2 Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gw2wrapper Show documentation
Guild Wars 2 API wrapper for Android
There is a newer version: 1.3.2
package me.xhsun.guildwars2wrapper;

import me.xhsun.guildwars2wrapper.error.ErrorCode;
import me.xhsun.guildwars2wrapper.error.GuildWars2Exception;
import okhttp3.Cache;
import okhttp3.OkHttpClient;
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

/**
 * For more Info on GW2 API Version 2 go here

 * Guild Wars 2 API Wrapper uses {@link Retrofit} to connect to Guild wars 2 API server

 * This class provides two ways user can get and process data from the server:

 *  1) use methods provided by {@link SynchronousRequest} to get data synchronously

 *  2) use methods provided by {@link AsynchronousRequest} to get/process data asynchronously
 *
 * TODO language selection(en - english, de - german, es - spanish, fr - french), default english
 * @author xhsun
 * @since 2017-02-06
 */

public class GuildWars2 {
	private static final String API = "https://api.guildwars2.com";
	private static volatile GuildWars2 instance = null;
	private volatile GuildWars2API gw2API;
	private volatile SynchronousRequest synchronous;
	private volatile AsynchronousRequest asynchronous;

	/**
	 * You need to call {@link #setInstance(Cache)} to create instance with custom caching

	 * If you don't call {@link #setInstance(Cache)}, this method will create a new instance without custom caching
	 *
	 * @return {@link GuildWars2}
	 */
	public static GuildWars2 getInstance() {
		if (instance == null) instance = new GuildWars2();
		return instance;
	}

	/**
	 * Use this to initialize instance with custom cache
	 *
	 * @param cache {@link Cache}
	 * @throws GuildWars2Exception instance already exist
	 */
	public static void setInstance(Cache cache) throws GuildWars2Exception {
		if (instance != null)
			throw new GuildWars2Exception(ErrorCode.Other, "Instance already initialized");
		instance = new GuildWars2(cache);
	}

	//constructor
	private GuildWars2() {
		Retrofit retrofit = new Retrofit.Builder()
				.baseUrl(API)
				.addConverterFactory(GsonConverterFactory.create())
				.build();
		gw2API = retrofit.create(GuildWars2API.class);
	}

	private GuildWars2(Cache cache) {
		Retrofit retrofit = new Retrofit.Builder()
				.baseUrl(API)
				.client(new OkHttpClient.Builder().cache(cache).build())
				.addConverterFactory(GsonConverterFactory.create())
				.build();
		gw2API = retrofit.create(GuildWars2API.class);
	}

	public SynchronousRequest getSynchronous() {
		if (synchronous == null) synchronous = new SynchronousRequest(gw2API);
		return synchronous;
	}

	public AsynchronousRequest getAsynchronous() {
		if (asynchronous == null) asynchronous = new AsynchronousRequest(gw2API);
		return asynchronous;
	}
}