Class AbstractOAuthService

Method Details

• validate

  protected static void validate(String clientID, String clientSecret, String... scopes)

  Validates the clientID, clientSecret and scopes.

  Parameters:

  clientID - The Client ID.

  clientSecret - The Client Secret.

  scopes - The list of scopes as an array, or null for default scopes.

  Throws:

  NullPointerException - If clientID, clientSecret or any of the scopes values are null is null.

  IllegalArgumentException - If clientID, clientSecret or any of the scopes values is empty.

• createServiceBuilder

  protected static com.github.scribejava.core.builder.ServiceBuilder createServiceBuilder(String clientID, String clientSecret)

  Creates a ServiceBuilder that is initialized for debugging or not.

  Parameters:

  clientID - The Client ID.

  clientSecret - The Client Secret.

  Returns:

  ServiceBuilder The service builder instance.

  Throws:

  NullPointerException - If clientID or clientSecret is null.

  IllegalArgumentException - If clientID or clientSecret is empty String.

• getDebugOutputStream

  protected static OutputStream getDebugOutputStream()

  Gets the output stream for debugging.

  Returns:

  The output stream when debugging, or {code null} when not debugging.

• getRequestAdditionalTime

  protected long getRequestAdditionalTime()

  The default additional required time in milliseconds to process a request, i.e. to see if an access token is still valid.

  Subclasses override this method to return another value.

  Returns:

  The default value of 20_000 milliseconds (20 seconds).

• getLogoutURL

  public abstract String getLogoutURL()

  Returns the logout URL for the OAuth service. It is not the same as invalidating an access URL.

  Subclasses must override this method and implement a return value.

  Returns:

  The logout URL, or null if none exists.

• disposeBlocked

  public void disposeBlocked()

  Disposes of the session because of a blocked pop-up window. The listener is notified, if any.

  Specified by:

  disposeBlocked in interface IOAuthService

• disposeUserCancel

  public void disposeUserCancel()

  Disposes of the session because of a user cancel action.

  Specified by:

  disposeUserCancel in interface IOAuthService

• dispose

  public final void dispose()

  Disposes of the session, i.e. can e.g. close an asynchronous client in progress.

  Specified by:

  dispose in interface IOAuthService

• doAuthenticate

  public void doAuthenticate(IOAuthListener listener) throws IOException, InterruptedException, ExecutionException

  Throws:

  IOException

  InterruptedException

  ExecutionException

• getAccessToken

  protected final AccessToken getAccessToken() throws IOException, InterruptedException, ExecutionException

  Gets an access token, perhaps by means of refresh.

  Returns:

  The AccessToken instance.

  Throws:

  IllegalStateException - If the authentication has not completed successfully.

  IOException - For I/O errors.

  ExecutionException - If execution failed when requesting the token.

  InterruptedException - If thread was interrupted while waiting for the token.

• invalidateAccessToken

  public boolean invalidateAccessToken() throws ExecutionException, InterruptedException, IOException

  Invalidates the current Access Token that may be valid for quite some time.

  The last access token is revoked and this might lead to IOException's.

  For OAuth 1.0, this method just clears the Access Token so it has to be retrieved again and just returns false for failure.

  Returns:

  true for success, false for failure (no token to invalidate), or the service is of OAuth 1.0a type.

  Throws:

  ExecutionException - For execution errors.

  InterruptedException - If the revocation action was interrupted.

  IOException - For I/O errors.

• getAccessToken2

  public final com.github.scribejava.core.model.OAuth2AccessToken getAccessToken2() throws IOException, InterruptedException, ExecutionException

  Gets the current, refreshes or get a new OAuth 2.0 Access Token.

  Returns:

  The OAuth 2.0 Access Token instance.

  Throws:

  IllegalStateException - If the authentication has not completed successfully.

  IOException - For I/O errors.

  ExecutionException - If execution failed when requesting the token.

  InterruptedException - If thread was interrupted while waiting for the token.

• getAccessToken1

  public final com.github.scribejava.core.model.OAuth1AccessToken getAccessToken1() throws IOException, InterruptedException, ExecutionException

  Gets the current, refreshes or get a new OAuth 1.0a Access Token.

  Returns:

  The OAuth 1.0a Access Token instance.

  Throws:

  IllegalStateException - If the authentication has not completed successfully.

  IOException - For I/O errors.

  ExecutionException - If execution failed when requesting the token.

  InterruptedException - If thread was interrupted while waiting for the token.

• getUserProfileInfo

  public abstract UserProfileInfo getUserProfileInfo() throws IOException, InterruptedException, ExecutionException

  Gets the UserProfileInformation from this service.

  This will cause the user to have to authenticate with the service, unless not already done.

  All fields available for this service that are possible to set and available will be initialized. Other values will be left null, unknown or undefined.

  Returns:

  The UserProfileInfo instance.

  Throws:

  ExecutionException - For execution errors.

  InterruptedException - If the revocation action was interrupted.

  IOException - For I/O errors.