com.azure.cosmos.implementation.IDocumentClientRetryPolicy Maven / Gradle / Ivy

Go to download
// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.
package com.azure.cosmos.implementation;

import reactor.core.publisher.Mono;

/**
 * While this class is public, but it is not part of our published public APIs.
 * This is meant to be internally used only by our sdk.
 */
public interface IDocumentClientRetryPolicy extends IRetryPolicy {

    // TODO: this is just a place holder for now. As .Net has this method.
    // I have to spend more time figure out what's the right pattern for this (if method needed)

    /// 
    /// Method that is called before a request is sent to allow the retry policy implementation
    /// to modify the state of the request.
    /// 
    /// The request being sent to the service.
    /// 
    /// Currently only read operations will invoke this method. There is no scenario for write
    /// operations to modify requests before retrying.
    /// 

    // TODO: I need to investigate what's the right contract here and/or if/how this is useful
    void onBeforeSendRequest(RxDocumentServiceRequest request);


    class NoRetry implements IDocumentClientRetryPolicy {

        private static NoRetry instance = new NoRetry();

        private NoRetry() {}

        public static NoRetry getInstance() {
            return instance;
        }

        @Override
        public void onBeforeSendRequest(RxDocumentServiceRequest request) {
            // no op
        }

        @Override
        public Mono shouldRetry(Exception e) {
            return Mono.just(ShouldRetryResult.error(e));
        }
    }
}