com.atlassian.oauth2.client.api.lib.token

Interface TokenService

public interface TokenService

Service for obtaining and refreshing ClientToken.

Method Summary

Modifier and Type	Method and Description
ClientToken	forceRefresh(ClientConfiguration config, ClientToken token) Refreshes provided token.
boolean	isRefreshNeeded(ClientToken token, Duration margin) Deprecated. this logic is no longer part of the public API. Use TokenHandler.getRefreshedToken(String, Duration)
ClientToken	refreshIfNeeded(ClientConfiguration config, ClientToken token, Duration margin) Deprecated. use TokenHandler.getRefreshedToken(String, Duration)

Method Detail

forceRefresh

ClientToken forceRefresh(ClientConfiguration config,
                         ClientToken token)
                  throws TokenServiceException,
                         IllegalArgumentException

Refreshes provided token.

Parameters:

config - OAuth client config for the given token

token - original token

Returns:

refreshed token

Throws:

TokenServiceException - if there was an error while calling token endpoint

IllegalArgumentException - if token has no refresh token when it's required

See Also:

GrantType

refreshIfNeeded

@Deprecated
ClientToken refreshIfNeeded(ClientConfiguration config,
                                        ClientToken token,
                                        Duration margin)
                                 throws TokenServiceException

Deprecated. use TokenHandler.getRefreshedToken(String, Duration)

Refreshes provided token if needed. For tokens without refresh token original token will be returned, depending on the GrantType

Parameters:

config - OAuth client config for the given token

token - original token

margin - max lifetime of the token that should be refreshed

Returns:

refreshed token or original token (if refresh wasn't needed)

Throws:

TokenServiceException

See Also:

GrantType

isRefreshNeeded

@Deprecated
boolean isRefreshNeeded(ClientToken token,
                                    Duration margin)

Deprecated. this logic is no longer part of the public API. Use TokenHandler.getRefreshedToken(String, Duration)

Provides check to see if refresh is needed. For token with no refresh token, this method will always return false.

Parameters:

token - original token

margin - max lifetime of the token that should be refreshed

Returns:

whether a refresh is required