開発者用の OAuth 2.0 との連携

jira.projectkey.warning = testwarning
jira.projectkey.description = testdescription
... 
atlassian.oauth2.client.unrecoverable.token.failing.period.days = 7

final ClientConfigurationEntity savedEntity = clientConfigStorageService.save(ClientConfigurationEntity.builder()
    .name(---)                                    // (Required)
    .providerType(ProviderType.GENERIC)           // or ProviderType.MICROSOFT, or ProviderType.GOOGLE (Required)
    .description(---)                             // (Optional)
    .clientId(---)                                // (Required)
    .clientSecret(---)                            // (Required)
    .authorizationEndpoint(---)                   // (Required)
    .tokenEndpoint(---)                           // (Required)
    .scopes(---)                                  // (Required)
    .build()
);

final ClientConfigurationEntity fetchedEntityById = clientConfigStorageService.getByIdOrFail(savedEntity.getId());
final ClientConfigurationEntity fetchedEntityByName = clientConfigStorageService.getByName(savedEntity.getName());
final List<ClientConfigurationEntity> fetchedEntities = clientConfigStorageService.list();
clientConfigStorageService.delete(savedEntity.getId());

final ClientConfigurationEntity clientConfiguration = clientConfigStorageService.getByIdOrFail(id); // id of a saved configuration
final FlowRequest flowRequest = flowRequestService.create(
    session,                                          // HttpSession of current request
    clientConfiguration,
    id -> pluginPage + "/" + id                       // pluginPage here will describe a landing page after completing the FlowRequest
);

... Complete flow on UI

final FlowResult flowResult = flowRequestService.getFlowRequest(
    session, // HttpSession from same user as above
    flowRequest.getId()
);
if (flowResult.indicatesSuccess()) {                  // true if the FlowRequest was successful
    final ClientTokenEntity clientToken = clientTokenStorageService.save(
        ClientTokenEntity.builder(flowResult.toSuccessResult())
            .configId(clientConfiguration.getId())    // config id used above
            .build()
    );
} else {
    final FlowResultError flowResultError = flowResult.toErrorResult();
    // Handle FlowResultError...
}

final ClientTokenEntity clientToken = clientTokenStorageService.getByIdOrFail(id); // using saved client token id from FlowResult
clientTokenStorageService.save(ClientTokenEntity.builder(clientToken)
    .configId(---)                  // (Required)
    .accessToken(---)               // (Required)
    .accessTokenExpiration(---)     // (Required)
    .refreshToken(---)              // (Required)
    .refreshTokenExpiration(---)    // (Required)
    .build()
);
clientTokenStorageService.delete(clientToken.getId());

// This will automatically refresh and save the client token if required
final T result = tokenHandler.execute(
    clientTokenId, // id of saved client token
    clientToken -> // ... execute code that uses token. Can return T.
);
// This will automatically refresh, save, and return the most up to date client token
final ClientToken refreshedToken = tokenHandler.getRefreshedToken(clientTokenId);

final ClientTokenEntity clientToken = clientTokenStorageService.getByIdOrFail(clientTokenId);
final ClientConfigurationEntity clientConfiguration = clientConfigStorageService.findByIdOrFail(clientToken.getConfigId());

// Will refresh and return the token. Note this will not save it.
final ClientToken forceRefreshClientToken = tokenService.forceRefresh(clientConfiguration, clientToken);
// Will refresh if the expiry + margin is after the current system time. Note this will not save if refreshed.
final ClientToken marginRefreshClientToken = tokenService.refreshIfNeeded(clientConfiguration, clientToken, Duration.ofDays(1));