| <?xml version='1.0' encoding='UTF-8' standalone='no'?> |
| <doxygen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="compound.xsd" version="1.9.8" xml:lang="en-US"> |
| <compounddef id="retry__util_8h" kind="file" language="C++"> |
| <compoundname>retry_util.h</compoundname> |
| <includes local="no">chrono</includes> |
| <includes local="no">concepts</includes> |
| <includes local="no">cstdint</includes> |
| <includes local="no">functional</includes> |
| <includes local="no">initializer_list</includes> |
| <includes local="no">optional</includes> |
| <includes local="no">type_traits</includes> |
| <includes local="no">utility</includes> |
| <includes local="no">vector</includes> |
| <includes refid="iceberg__export_8h" local="yes">iceberg/iceberg_export.h</includes> |
| <includes refid="result_8h" local="yes">iceberg/result.h</includes> |
| <includedby refid="retry__util__test_8cc" local="yes">iceberg/test/retry_util_test.cc</includedby> |
| <includedby refid="transaction_8cc" local="yes">iceberg/transaction.cc</includedby> |
| <includedby refid="retry__util_8cc" local="yes">iceberg/util/retry_util.cc</includedby> |
| <incdepgraph> |
| <node id="11"> |
| <label>iceberg/iceberg_export.h</label> |
| <link refid="iceberg__export_8h_source"/> |
| </node> |
| <node id="12"> |
| <label>iceberg/result.h</label> |
| <link refid="result_8h_source"/> |
| <childnode refid="13" relation="include"> |
| </childnode> |
| <childnode refid="14" relation="include"> |
| </childnode> |
| <childnode refid="15" relation="include"> |
| </childnode> |
| <childnode refid="11" relation="include"> |
| </childnode> |
| </node> |
| <node id="1"> |
| <label>iceberg/util/retry_util.h</label> |
| <link refid="retry__util_8h"/> |
| <childnode refid="2" relation="include"> |
| </childnode> |
| <childnode refid="3" relation="include"> |
| </childnode> |
| <childnode refid="4" relation="include"> |
| </childnode> |
| <childnode refid="5" relation="include"> |
| </childnode> |
| <childnode refid="6" relation="include"> |
| </childnode> |
| <childnode refid="7" relation="include"> |
| </childnode> |
| <childnode refid="8" relation="include"> |
| </childnode> |
| <childnode refid="9" relation="include"> |
| </childnode> |
| <childnode refid="10" relation="include"> |
| </childnode> |
| <childnode refid="11" relation="include"> |
| </childnode> |
| <childnode refid="12" relation="include"> |
| </childnode> |
| </node> |
| <node id="2"> |
| <label>chrono</label> |
| </node> |
| <node id="3"> |
| <label>concepts</label> |
| </node> |
| <node id="4"> |
| <label>cstdint</label> |
| </node> |
| <node id="13"> |
| <label>expected</label> |
| </node> |
| <node id="14"> |
| <label>format</label> |
| </node> |
| <node id="5"> |
| <label>functional</label> |
| </node> |
| <node id="6"> |
| <label>initializer_list</label> |
| </node> |
| <node id="7"> |
| <label>optional</label> |
| </node> |
| <node id="15"> |
| <label>string</label> |
| </node> |
| <node id="8"> |
| <label>type_traits</label> |
| </node> |
| <node id="9"> |
| <label>utility</label> |
| </node> |
| <node id="10"> |
| <label>vector</label> |
| </node> |
| </incdepgraph> |
| <innerclass refid="structiceberg_1_1detail_1_1IsResult" prot="public">iceberg::detail::IsResult</innerclass> |
| <innerclass refid="structiceberg_1_1detail_1_1IsResult_3_01Result_3_01T_01_4_01_4" prot="public">iceberg::detail::IsResult< Result< T > ></innerclass> |
| <innerclass refid="structiceberg_1_1RetryConfig" prot="public">iceberg::RetryConfig</innerclass> |
| <innerclass refid="classiceberg_1_1RetryRunner" prot="public">iceberg::RetryRunner</innerclass> |
| <innernamespace refid="namespaceiceberg">iceberg</innernamespace> |
| <innernamespace refid="namespaceiceberg_1_1detail">iceberg::detail</innernamespace> |
| <briefdescription> |
| </briefdescription> |
| <detaileddescription> |
| </detaileddescription> |
| <programlisting> |
| <codeline lineno="1"><highlight class="comment">/*</highlight></codeline> |
| <codeline lineno="2"><highlight class="comment"><sp/>*<sp/>Licensed<sp/>to<sp/>the<sp/>Apache<sp/>Software<sp/>Foundation<sp/>(ASF)<sp/>under<sp/>one</highlight></codeline> |
| <codeline lineno="3"><highlight class="comment"><sp/>*<sp/>or<sp/>more<sp/>contributor<sp/>license<sp/>agreements.<sp/><sp/>See<sp/>the<sp/>NOTICE<sp/>file</highlight></codeline> |
| <codeline lineno="4"><highlight class="comment"><sp/>*<sp/>distributed<sp/>with<sp/>this<sp/>work<sp/>for<sp/>additional<sp/>information</highlight></codeline> |
| <codeline lineno="5"><highlight class="comment"><sp/>*<sp/>regarding<sp/>copyright<sp/>ownership.<sp/><sp/>The<sp/>ASF<sp/>licenses<sp/>this<sp/>file</highlight></codeline> |
| <codeline lineno="6"><highlight class="comment"><sp/>*<sp/>to<sp/>you<sp/>under<sp/>the<sp/>Apache<sp/>License,<sp/>Version<sp/>2.0<sp/>(the</highlight></codeline> |
| <codeline lineno="7"><highlight class="comment"><sp/>*<sp/>"License");<sp/>you<sp/>may<sp/>not<sp/>use<sp/>this<sp/>file<sp/>except<sp/>in<sp/>compliance</highlight></codeline> |
| <codeline lineno="8"><highlight class="comment"><sp/>*<sp/>with<sp/>the<sp/>License.<sp/><sp/>You<sp/>may<sp/>obtain<sp/>a<sp/>copy<sp/>of<sp/>the<sp/>License<sp/>at</highlight></codeline> |
| <codeline lineno="9"><highlight class="comment"><sp/>*</highlight></codeline> |
| <codeline lineno="10"><highlight class="comment"><sp/>*<sp/><sp/><sp/>http://www.apache.org/licenses/LICENSE-2.0</highlight></codeline> |
| <codeline lineno="11"><highlight class="comment"><sp/>*</highlight></codeline> |
| <codeline lineno="12"><highlight class="comment"><sp/>*<sp/>Unless<sp/>required<sp/>by<sp/>applicable<sp/>law<sp/>or<sp/>agreed<sp/>to<sp/>in<sp/>writing,</highlight></codeline> |
| <codeline lineno="13"><highlight class="comment"><sp/>*<sp/>software<sp/>distributed<sp/>under<sp/>the<sp/>License<sp/>is<sp/>distributed<sp/>on<sp/>an</highlight></codeline> |
| <codeline lineno="14"><highlight class="comment"><sp/>*<sp/>"AS<sp/>IS"<sp/>BASIS,<sp/>WITHOUT<sp/>WARRANTIES<sp/>OR<sp/>CONDITIONS<sp/>OF<sp/>ANY</highlight></codeline> |
| <codeline lineno="15"><highlight class="comment"><sp/>*<sp/>KIND,<sp/>either<sp/>express<sp/>or<sp/>implied.<sp/><sp/>See<sp/>the<sp/>License<sp/>for<sp/>the</highlight></codeline> |
| <codeline lineno="16"><highlight class="comment"><sp/>*<sp/>specific<sp/>language<sp/>governing<sp/>permissions<sp/>and<sp/>limitations</highlight></codeline> |
| <codeline lineno="17"><highlight class="comment"><sp/>*<sp/>under<sp/>the<sp/>License.</highlight></codeline> |
| <codeline lineno="18"><highlight class="comment"><sp/>*/</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="19"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="20"><highlight class="normal"></highlight><highlight class="preprocessor">#pragma<sp/>once</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="21"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="22"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><chrono></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="23"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><concepts></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="24"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><cstdint></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="25"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><functional></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="26"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><initializer_list></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="27"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><optional></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="28"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><type_traits></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="29"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><utility></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="30"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/><vector></highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="31"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="32"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/>"iceberg/iceberg_export.h"</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="33"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/>"iceberg/result.h"</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="34"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="35"><highlight class="normal"></highlight><highlight class="keyword">namespace<sp/></highlight><highlight class="normal">iceberg<sp/>{</highlight></codeline> |
| <codeline lineno="36"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="37"><highlight class="normal"></highlight><highlight class="keyword">namespace<sp/></highlight><highlight class="normal">detail<sp/>{</highlight></codeline> |
| <codeline lineno="38"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="39"><highlight class="normal"></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/><</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>T></highlight></codeline> |
| <codeline lineno="40" refid="structiceberg_1_1detail_1_1IsResult" refkind="compound"><highlight class="normal"></highlight><highlight class="keyword">struct<sp/></highlight><highlight class="normal"><ref refid="structiceberg_1_1detail_1_1IsResult" kindref="compound">IsResult</ref><sp/>:<sp/>std::false_type<sp/>{};</highlight></codeline> |
| <codeline lineno="41"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="42"><highlight class="normal"></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/><</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>T></highlight></codeline> |
| <codeline lineno="43" refid="structiceberg_1_1detail_1_1IsResult_3_01Result_3_01T_01_4_01_4" refkind="compound"><highlight class="normal"></highlight><highlight class="keyword">struct<sp/></highlight><highlight class="normal"><ref refid="structiceberg_1_1detail_1_1IsResult" kindref="compound">IsResult</ref><Result<T>><sp/>:<sp/>std::true_type<sp/>{};</highlight></codeline> |
| <codeline lineno="44"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="45"><highlight class="normal"></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/><</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>T></highlight></codeline> |
| <codeline lineno="46" refid="concepticeberg_1_1detail_1_1ResultType" refkind="compound"><highlight class="normal"></highlight><highlight class="keyword">concept<sp/></highlight><highlight class="normal"><ref refid="concepticeberg_1_1detail_1_1ResultType" kindref="compound">ResultType</ref><sp/>=<sp/>IsResult<std::remove_cvref_t<T>>::value;</highlight></codeline> |
| <codeline lineno="47"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="48"><highlight class="normal"></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/><</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>F></highlight></codeline> |
| <codeline lineno="49" refid="concepticeberg_1_1detail_1_1RetryTask" refkind="compound"><highlight class="normal"></highlight><highlight class="keyword">concept<sp/></highlight><highlight class="normal"><ref refid="concepticeberg_1_1detail_1_1RetryTask" kindref="compound">RetryTask</ref><sp/>=<sp/></highlight><highlight class="keyword">requires</highlight><highlight class="normal">(F&<sp/>f)<sp/>{</highlight></codeline> |
| <codeline lineno="50"><highlight class="normal"><sp/><sp/>{<sp/>std::invoke(f)<sp/>}<sp/>-><sp/><ref refid="concepticeberg_1_1detail_1_1ResultType" kindref="compound">ResultType</ref>;</highlight></codeline> |
| <codeline lineno="51"><highlight class="normal">};</highlight></codeline> |
| <codeline lineno="52"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="53"><highlight class="normal"></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/><</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>F></highlight></codeline> |
| <codeline lineno="54"><highlight class="normal"></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal">RetryTaskResult<sp/>=<sp/>std::remove_cvref_t<std::invoke_result_t<F&>>;</highlight></codeline> |
| <codeline lineno="55"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="56"><highlight class="normal">}<sp/><sp/></highlight><highlight class="comment">//<sp/>namespace<sp/>detail</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="57"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="59" refid="structiceberg_1_1RetryConfig" refkind="compound"><highlight class="keyword">struct<sp/></highlight><highlight class="normal">ICEBERG_EXPORT<sp/><ref refid="structiceberg_1_1RetryConfig" kindref="compound">RetryConfig</ref><sp/>{</highlight></codeline> |
| <codeline lineno="61" refid="structiceberg_1_1RetryConfig_1a0d4e08f7e74793956080ddb66c797602" refkind="member"><highlight class="normal"><sp/><sp/>int32_t<sp/>num_retries<sp/>=<sp/>4;</highlight></codeline> |
| <codeline lineno="63" refid="structiceberg_1_1RetryConfig_1ae803735b161f9c2eb4478c2b5fa043c4" refkind="member"><highlight class="normal"><sp/><sp/>int32_t<sp/>min_wait_ms<sp/>=<sp/>100;</highlight></codeline> |
| <codeline lineno="65" refid="structiceberg_1_1RetryConfig_1a11a1892d24142aaa9fb5385576cb7b81" refkind="member"><highlight class="normal"><sp/><sp/>int32_t<sp/>max_wait_ms<sp/>=<sp/>60<sp/>*<sp/>1000;<sp/><sp/></highlight><highlight class="comment">//<sp/>1<sp/>minute</highlight></codeline> |
| <codeline lineno="67" refid="structiceberg_1_1RetryConfig_1a263c3683a4e87e62f70a256d0eb83f7a" refkind="member"><highlight class="normal"><sp/><sp/>int32_t<sp/>total_timeout_ms<sp/>=<sp/>30<sp/>*<sp/>60<sp/>*<sp/>1000;<sp/><sp/></highlight><highlight class="comment">//<sp/>30<sp/>minutes</highlight></codeline> |
| <codeline lineno="69" refid="structiceberg_1_1RetryConfig_1a98f14caf3962c28f8a43eaecffcf3bc9" refkind="member"><highlight class="normal"><sp/><sp/></highlight><highlight class="keywordtype">double</highlight><highlight class="normal"><sp/>scale_factor<sp/>=<sp/>2.0;</highlight></codeline> |
| <codeline lineno="70"><highlight class="normal">};</highlight></codeline> |
| <codeline lineno="71"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="76" refid="classiceberg_1_1RetryRunner" refkind="compound"><highlight class="keyword">class<sp/></highlight><highlight class="normal">ICEBERG_EXPORT<sp/><ref refid="classiceberg_1_1RetryRunner" kindref="compound">RetryRunner</ref><sp/>{</highlight></codeline> |
| <codeline lineno="77"><highlight class="normal"><sp/></highlight><highlight class="keyword">public</highlight><highlight class="normal">:</highlight></codeline> |
| <codeline lineno="79" refid="classiceberg_1_1RetryRunner_1a4dad9ff4b8d5bd0ce2f8dc8be1eddc46" refkind="member"><highlight class="normal"><sp/><sp/></highlight><highlight class="keyword">explicit</highlight><highlight class="normal"><sp/><ref refid="classiceberg_1_1RetryRunner_1a4dad9ff4b8d5bd0ce2f8dc8be1eddc46" kindref="member">RetryRunner</ref>(<ref refid="structiceberg_1_1RetryConfig" kindref="compound">RetryConfig</ref><sp/>config<sp/>=<sp/>{})<sp/>:<sp/>config_(<ref refid="namespacestd" kindref="compound">std</ref>::move(config))<sp/>{}</highlight></codeline> |
| <codeline lineno="80"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="88" refid="classiceberg_1_1RetryRunner_1a74ade24306f9d95dc8858cad398f1d76" refkind="member"><highlight class="normal"><sp/><sp/><ref refid="classiceberg_1_1RetryRunner" kindref="compound">RetryRunner</ref>&<sp/><ref refid="classiceberg_1_1RetryRunner_1a74ade24306f9d95dc8858cad398f1d76" kindref="member">OnlyRetryOn</ref>(std::initializer_list<ErrorKind><sp/>error_kinds)<sp/>{</highlight></codeline> |
| <codeline lineno="89"><highlight class="normal"><sp/><sp/><sp/><sp/>retry_policy_mode_<sp/>=<sp/>RetryPolicyMode::kOnlyRetryOn;</highlight></codeline> |
| <codeline lineno="90"><highlight class="normal"><sp/><sp/><sp/><sp/>retry_error_kinds_<sp/>=<sp/>std::vector<ErrorKind>(error_kinds);</highlight></codeline> |
| <codeline lineno="91"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>*</highlight><highlight class="keyword">this</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="92"><highlight class="normal"><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="93"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="98" refid="classiceberg_1_1RetryRunner_1a99ec9aa552a2b1ff95579c2f43bb9037" refkind="member"><highlight class="normal"><sp/><sp/><ref refid="classiceberg_1_1RetryRunner" kindref="compound">RetryRunner</ref>&<sp/><ref refid="classiceberg_1_1RetryRunner_1a99ec9aa552a2b1ff95579c2f43bb9037" kindref="member">OnlyRetryOn</ref>(ErrorKind<sp/>error_kind)<sp/>{<sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/><ref refid="classiceberg_1_1RetryRunner_1a99ec9aa552a2b1ff95579c2f43bb9037" kindref="member">OnlyRetryOn</ref>({error_kind});<sp/>}</highlight></codeline> |
| <codeline lineno="99"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="107" refid="classiceberg_1_1RetryRunner_1a57a9703d04a6d65590ee96e28d698fc2" refkind="member"><highlight class="normal"><sp/><sp/><ref refid="classiceberg_1_1RetryRunner" kindref="compound">RetryRunner</ref>&<sp/><ref refid="classiceberg_1_1RetryRunner_1a57a9703d04a6d65590ee96e28d698fc2" kindref="member">StopRetryOn</ref>(std::initializer_list<ErrorKind><sp/>error_kinds)<sp/>{</highlight></codeline> |
| <codeline lineno="108"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">if</highlight><highlight class="normal"><sp/>(retry_policy_mode_<sp/>==<sp/>RetryPolicyMode::kOnlyRetryOn)<sp/>{</highlight></codeline> |
| <codeline lineno="109"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>*</highlight><highlight class="keyword">this</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="110"><highlight class="normal"><sp/><sp/><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="111"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="112"><highlight class="normal"><sp/><sp/><sp/><sp/>retry_policy_mode_<sp/>=<sp/>RetryPolicyMode::kStopRetryOn;</highlight></codeline> |
| <codeline lineno="113"><highlight class="normal"><sp/><sp/><sp/><sp/>retry_error_kinds_<sp/>=<sp/>std::vector<ErrorKind>(error_kinds);</highlight></codeline> |
| <codeline lineno="114"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>*</highlight><highlight class="keyword">this</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="115"><highlight class="normal"><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="116"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="121" refid="classiceberg_1_1RetryRunner_1a5d6bb40dd0b0d16e879faf30991a8f33" refkind="member"><highlight class="normal"><sp/><sp/><ref refid="classiceberg_1_1RetryRunner" kindref="compound">RetryRunner</ref>&<sp/><ref refid="classiceberg_1_1RetryRunner_1a5d6bb40dd0b0d16e879faf30991a8f33" kindref="member">StopRetryOn</ref>(ErrorKind<sp/>error_kind)<sp/>{<sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/><ref refid="classiceberg_1_1RetryRunner_1a5d6bb40dd0b0d16e879faf30991a8f33" kindref="member">StopRetryOn</ref>({error_kind});<sp/>}</highlight></codeline> |
| <codeline lineno="122"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="129"><highlight class="normal"><sp/><sp/></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/><</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>F></highlight></codeline> |
| <codeline lineno="130"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">requires</highlight><highlight class="normal"><sp/><ref refid="concepticeberg_1_1detail_1_1RetryTask" kindref="compound">detail::RetryTask<F></ref></highlight></codeline> |
| <codeline lineno="131" refid="classiceberg_1_1RetryRunner_1a5502259f597476b247170f3d5daa84e3" refkind="member"><highlight class="normal"><sp/><sp/></highlight><highlight class="keyword">auto</highlight><highlight class="normal"><sp/><ref refid="classiceberg_1_1RetryRunner_1a5502259f597476b247170f3d5daa84e3" kindref="member">Run</ref>(F&&<sp/>task,<sp/>int32_t*<sp/>attempt_counter<sp/>=<sp/></highlight><highlight class="keyword">nullptr</highlight><highlight class="normal">)<sp/>-><sp/>detail::RetryTaskResult<F><sp/>{</highlight></codeline> |
| <codeline lineno="132"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal">TaskResult<sp/>=<sp/>detail::RetryTaskResult<F>;</highlight></codeline> |
| <codeline lineno="133"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="134"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal"><sp/></highlight><highlight class="keyword">auto</highlight><highlight class="normal"><sp/>validation<sp/>=<sp/>ValidateConfig();</highlight></codeline> |
| <codeline lineno="135"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">if</highlight><highlight class="normal"><sp/>(!validation.has_value())<sp/>{</highlight></codeline> |
| <codeline lineno="136"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>TaskResult(std::unexpected(validation.error()));</highlight></codeline> |
| <codeline lineno="137"><highlight class="normal"><sp/><sp/><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="138"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="139"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal"><sp/></highlight><highlight class="keyword">auto</highlight><highlight class="normal"><sp/>deadline<sp/>=<sp/>ComputeDeadline();</highlight></codeline> |
| <codeline lineno="140"><highlight class="normal"><sp/><sp/><sp/><sp/>int32_t<sp/>attempt<sp/>=<sp/>0;</highlight></codeline> |
| <codeline lineno="141"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal"><sp/>int32_t<sp/>max_attempts<sp/>=<sp/>config_.num_retries<sp/>+<sp/>1;</highlight></codeline> |
| <codeline lineno="142"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="143"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">while</highlight><highlight class="normal"><sp/>(</highlight><highlight class="keyword">true</highlight><highlight class="normal">)<sp/>{</highlight></codeline> |
| <codeline lineno="144"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/>++attempt;</highlight></codeline> |
| <codeline lineno="145"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">if</highlight><highlight class="normal"><sp/>(attempt_counter<sp/>!=<sp/></highlight><highlight class="keyword">nullptr</highlight><highlight class="normal">)<sp/>{</highlight></codeline> |
| <codeline lineno="146"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>*attempt_counter<sp/>=<sp/>attempt;</highlight></codeline> |
| <codeline lineno="147"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="148"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="149"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">auto</highlight><highlight class="normal"><sp/>result<sp/>=<sp/>std::invoke(task);</highlight></codeline> |
| <codeline lineno="150"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">if</highlight><highlight class="normal"><sp/>(result.has_value())<sp/>{</highlight></codeline> |
| <codeline lineno="151"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>result;</highlight></codeline> |
| <codeline lineno="152"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="153"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="154"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">if</highlight><highlight class="normal"><sp/>(!CanRetry(result.error().kind,<sp/>attempt,<sp/>max_attempts,<sp/>deadline))<sp/>{</highlight></codeline> |
| <codeline lineno="155"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>result;</highlight></codeline> |
| <codeline lineno="156"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="157"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="158"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">if</highlight><highlight class="normal"><sp/>(!WaitForNextAttempt(attempt,<sp/>deadline))<sp/>{</highlight></codeline> |
| <codeline lineno="159"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>result;</highlight></codeline> |
| <codeline lineno="160"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="161"><highlight class="normal"><sp/><sp/><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="162"><highlight class="normal"><sp/><sp/>}</highlight></codeline> |
| <codeline lineno="163"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="164"><highlight class="normal"><sp/></highlight><highlight class="keyword">private</highlight><highlight class="normal">:</highlight></codeline> |
| <codeline lineno="165"><highlight class="normal"><sp/><sp/></highlight><highlight class="keyword">enum<sp/>class</highlight><highlight class="normal"><sp/>RetryPolicyMode<sp/>{</highlight></codeline> |
| <codeline lineno="166"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="comment">//<sp/>No<sp/>retry<sp/>policy<sp/>was<sp/>selected;<sp/>invalid<sp/>when<sp/>retries<sp/>are<sp/>enabled.</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="167"><highlight class="normal"><sp/><sp/><sp/><sp/>kUnset,</highlight></codeline> |
| <codeline lineno="168"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="comment">//<sp/>Retry<sp/>only<sp/>errors<sp/>listed<sp/>in<sp/>retry_error_kinds_.</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="169"><highlight class="normal"><sp/><sp/><sp/><sp/>kOnlyRetryOn,</highlight></codeline> |
| <codeline lineno="170"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="comment">//<sp/>Retry<sp/>all<sp/>errors<sp/>except<sp/>those<sp/>listed<sp/>in<sp/>retry_error_kinds_.</highlight><highlight class="normal"></highlight></codeline> |
| <codeline lineno="171"><highlight class="normal"><sp/><sp/><sp/><sp/>kStopRetryOn,</highlight></codeline> |
| <codeline lineno="172"><highlight class="normal"><sp/><sp/>};</highlight></codeline> |
| <codeline lineno="173"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="174"><highlight class="normal"><sp/><sp/></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal">Clock<sp/>=<sp/>std::chrono::steady_clock;</highlight></codeline> |
| <codeline lineno="175"><highlight class="normal"><sp/><sp/></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal">Duration<sp/>=<sp/>std::chrono::milliseconds;</highlight></codeline> |
| <codeline lineno="176"><highlight class="normal"><sp/><sp/></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal">TimePoint<sp/>=<sp/>Clock::time_point;</highlight></codeline> |
| <codeline lineno="177"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="179"><highlight class="normal"><sp/><sp/>Status<sp/>ValidateConfig()<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="180"><highlight class="normal"><sp/><sp/>std::optional<TimePoint><sp/>ComputeDeadline()<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="181"><highlight class="normal"><sp/><sp/></highlight><highlight class="keywordtype">bool</highlight><highlight class="normal"><sp/>HasTimedOut(</highlight><highlight class="keyword">const</highlight><highlight class="normal"><sp/>std::optional<TimePoint>&<sp/>deadline)<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="182"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="184"><highlight class="normal"><sp/><sp/></highlight><highlight class="keywordtype">bool</highlight><highlight class="normal"><sp/>ShouldRetry(ErrorKind<sp/>kind)<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="185"><highlight class="normal"><sp/><sp/></highlight><highlight class="keywordtype">bool</highlight><highlight class="normal"><sp/>CanRetry(ErrorKind<sp/>kind,<sp/>int32_t<sp/>attempt,<sp/>int32_t<sp/>max_attempts,</highlight></codeline> |
| <codeline lineno="186"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal"><sp/>std::optional<TimePoint>&<sp/>deadline)<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="187"><highlight class="normal"><sp/><sp/>std::optional<Duration><sp/>RetryDelayWithinBudget(</highlight></codeline> |
| <codeline lineno="188"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/>int32_t<sp/>attempt,<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal"><sp/>std::optional<TimePoint>&<sp/>deadline)<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="189"><highlight class="normal"><sp/><sp/></highlight><highlight class="keywordtype">bool</highlight><highlight class="normal"><sp/>WaitForNextAttempt(int32_t<sp/>attempt,</highlight></codeline> |
| <codeline lineno="190"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal"><sp/>std::optional<TimePoint>&<sp/>deadline)<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="192"><highlight class="normal"><sp/><sp/>int32_t<sp/>CalculateDelay(int32_t<sp/>attempt)<sp/></highlight><highlight class="keyword">const</highlight><highlight class="normal">;</highlight></codeline> |
| <codeline lineno="193"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="194"><highlight class="normal"><sp/><sp/>RetryConfig<sp/>config_;</highlight></codeline> |
| <codeline lineno="195"><highlight class="normal"><sp/><sp/>RetryPolicyMode<sp/>retry_policy_mode_<sp/>=<sp/>RetryPolicyMode::kUnset;</highlight></codeline> |
| <codeline lineno="196"><highlight class="normal"><sp/><sp/>std::vector<ErrorKind><sp/>retry_error_kinds_;</highlight></codeline> |
| <codeline lineno="197"><highlight class="normal">};</highlight></codeline> |
| <codeline lineno="198"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="200"><highlight class="normal">ICEBERG_EXPORT<sp/></highlight><highlight class="keyword">inline</highlight><highlight class="normal"><sp/>RetryRunner<sp/>MakeCommitRetryRunner(int32_t<sp/>num_retries,</highlight></codeline> |
| <codeline lineno="201"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>int32_t<sp/>min_wait_ms,</highlight></codeline> |
| <codeline lineno="202"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>int32_t<sp/>max_wait_ms,</highlight></codeline> |
| <codeline lineno="203"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>int32_t<sp/>total_timeout_ms)<sp/>{</highlight></codeline> |
| <codeline lineno="204"><highlight class="normal"><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/>RetryRunner(RetryConfig{.num_retries<sp/>=<sp/>num_retries,</highlight></codeline> |
| <codeline lineno="205"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>.min_wait_ms<sp/>=<sp/>min_wait_ms,</highlight></codeline> |
| <codeline lineno="206"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>.max_wait_ms<sp/>=<sp/>max_wait_ms,</highlight></codeline> |
| <codeline lineno="207"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>.total_timeout_ms<sp/>=<sp/>total_timeout_ms})</highlight></codeline> |
| <codeline lineno="208"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/>.OnlyRetryOn(ErrorKind::kCommitFailed);</highlight></codeline> |
| <codeline lineno="209"><highlight class="normal">}</highlight></codeline> |
| <codeline lineno="210"><highlight class="normal"></highlight></codeline> |
| <codeline lineno="211"><highlight class="normal">}<sp/><sp/></highlight><highlight class="comment">//<sp/>namespace<sp/>iceberg</highlight><highlight class="normal"></highlight></codeline> |
| </programlisting> |
| <location file="iceberg/util/retry_util.h"/> |
| </compounddef> |
| </doxygen> |
