javastrava.api.v3.auth.impl.retrofit.TokenServiceImpl Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of javastrava-api Show documentation

Java implementation of the Strava API

There is a newer version: 1.0.3.6

package javastrava.api.v3.auth.impl.retrofit;

import javastrava.api.v3.auth.TokenManager;
import javastrava.api.v3.auth.TokenService;
import javastrava.api.v3.auth.model.Token;
import javastrava.api.v3.auth.model.TokenResponse;
import javastrava.api.v3.service.StravaService;
import javastrava.api.v3.service.exception.UnauthorizedException;
import javastrava.api.v3.service.impl.StravaServiceImpl;

/**
 * @author Dan Shannon
 *
 */
public class TokenServiceImpl extends StravaServiceImpl implements TokenService {
	/**
	 * 
	 * Returns an instance of {@link TokenService token services}
	 * 
	 *
	 * 
	 * Instances are cached so that if 2 requests are made for the same token, the same instance is returned
	 * 
	 *
	 * @param token
	 *            The Strava access token to be used in requests to the Strava API
	 * @return An instance of the token services
	 * @throws UnauthorizedException
	 *             If the token used to create the service is invalid
	 */
	public static TokenService instance(final Token token) throws UnauthorizedException {
		TokenService restService = token.getService(TokenService.class);
		if (restService == null) {
			restService = new TokenServiceImpl(token);

			// Store the service for later retrieval so that there's only one
			// service per token
			token.addService(TokenService.class, restService);

		}
		return restService;
	}

	/**
	 * 
	 * Private constructor allows for the {@link #instance} method to only be given access to a single instance per {@link Token}
	 * 
	 * @param token The token to use for this token service
	 */
	private TokenServiceImpl(final Token token) {
		super(token);
	}

	/**
	 * @see javastrava.api.v3.service.StravaService#clearCache()
	 */
	@Override
	public void clearCache() {
		// Nothing to do - there is no cache
	}

	/**
	 * @see TokenService#deauthorise(Token)
	 */
	@Override
	public TokenResponse deauthorise(final Token token) throws UnauthorizedException {
		final TokenResponse response = this.api.deauthoriseToken(token.getAccessToken());
		for (final StravaService service : token.getServices().values()) {
			service.clearCache();
		}
		TokenManager.instance().revokeToken(token);
		return response;
	}

}