com.atlassian.oauth2.client.api.lib.flow

Interface FlowRequestService

@PublicApi
public interface FlowRequestService

Enables clients to start flow requests and to get their results.

Method Summary

Modifier and Type	Method and Description
FlowRequest	createFlowRequest(javax.servlet.http.HttpSession session, ClientConfiguration clientConfiguration, Function<String,String> clientCallbackUrl) Creates the flow request
FlowResult	getFlowResult(javax.servlet.http.HttpSession session, String flowRequestId) Returns stored flow result.

Method Detail

createFlowRequest

@Nonnull
FlowRequest createFlowRequest(@Nonnull
                                       javax.servlet.http.HttpSession session,
                                       @Nonnull
                                       ClientConfiguration clientConfiguration,
                                       @Nonnull
                                       Function<String,String> clientCallbackUrl)
                                throws IllegalArgumentException,
                                       IllegalStateException

Creates the flow request

Parameters:

session - session, in which the data will be stored

clientConfiguration - endpoints to hit and required credentials

clientCallbackUrl - function that, based on id, will produce url that the flow will be redirected to after obtaining the token;

Returns:

The FlowRequest contains the redirect url and id

Throws:

IllegalArgumentException - thrown if the provided arguments are invalid, e.g. clientConfiguration endpoints are not https

IllegalStateException - thrown if the session is invalidated, or base URL is not https (TODO: update this doc depending on the decision from go/j/KRAK-3359)

getFlowResult

@Nonnull
FlowResult getFlowResult(@Nonnull
                                  javax.servlet.http.HttpSession session,
                                  @Nonnull
                                  String flowRequestId)
                           throws IllegalArgumentException

Returns stored flow result. This method should be called only once for the given flowRequestId - subsequent calls will fail.

Parameters:

session - session to fetch the result from; has to be the same session as provided to {createFlowRequest(HttpSession, ClientConfiguration, Function)}

flowRequestId - the id of the FlowRequest from {createFlowRequest(HttpSession, ClientConfiguration, Function)}

Returns:

an FlowResult containing either ClientToken or FlowRequestError if error occurred

Throws:

IllegalArgumentException - if there is no result for corresponding flowRequestId