blob: e3eb77ed0f7060e61a043903554192e274540ebf [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (1.8.0_152) on Mon Apr 02 22:38:39 UTC 2018 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>AbstractBackOffStrategy (streams-util 0.5.2-SNAPSHOT API)</title>
<meta name="date" content="2018-04-02">
<link rel="stylesheet" type="text/css" href="../../../../../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../../../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="AbstractBackOffStrategy (streams-util 0.5.2-SNAPSHOT API)";
}
}
catch(err) {
}
//-->
var methods = {"i0":10,"i1":6,"i2":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/AbstractBackOffStrategy.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev&nbsp;Class</li>
<li><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffException.html" title="class in org.apache.streams.util.api.requests.backoff"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../../index.html?org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html" target="_top">Frames</a></li>
<li><a href="AbstractBackOffStrategy.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.streams.util.api.requests.backoff</div>
<h2 title="Class AbstractBackOffStrategy" class="title">Class AbstractBackOffStrategy</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>org.apache.streams.util.api.requests.backoff.AbstractBackOffStrategy</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html" title="interface in org.apache.streams.util.api.requests.backoff">BackOffStrategy</a></dd>
</dl>
<dl>
<dt>Direct Known Subclasses:</dt>
<dd><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/impl/ConstantTimeBackOffStrategy.html" title="class in org.apache.streams.util.api.requests.backoff.impl">ConstantTimeBackOffStrategy</a>, <a href="../../../../../../../org/apache/streams/util/api/requests/backoff/impl/ExponentialBackOffStrategy.html" title="class in org.apache.streams.util.api.requests.backoff.impl">ExponentialBackOffStrategy</a>, <a href="../../../../../../../org/apache/streams/util/api/requests/backoff/impl/LinearTimeBackOffStrategy.html" title="class in org.apache.streams.util.api.requests.backoff.impl">LinearTimeBackOffStrategy</a></dd>
</dl>
<hr>
<br>
<pre>public abstract class <span class="typeNameLabel">AbstractBackOffStrategy</span>
extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>
implements <a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html" title="interface in org.apache.streams.util.api.requests.backoff">BackOffStrategy</a></pre>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html" title="interface in org.apache.streams.util.api.requests.backoff"><code>BackOffStrategy</code></a></dd>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html#AbstractBackOffStrategy-long-">AbstractBackOffStrategy</a></span>(long&nbsp;baseBackOffTime)</code>
<div class="block">A BackOffStrategy that can effectively be used endlessly.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html#AbstractBackOffStrategy-long-int-">AbstractBackOffStrategy</a></span>(long&nbsp;baseBackOffTime,
int&nbsp;maximumNumberOfBackOffAttempts)</code>
<div class="block">A BackOffStrategy that has a limited number of uses before it throws a
<a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffException.html" title="class in org.apache.streams.util.api.requests.backoff"><code>BackOffException</code></a>.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html#backOff--">backOff</a></span>()</code>
<div class="block">Cause the current thread to sleep for an amount of time based on the implemented strategy.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>protected abstract long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html#calculateBackOffTime-int-long-">calculateBackOffTime</a></span>(int&nbsp;attemptCount,
long&nbsp;baseSleepTime)</code>
<div class="block">Calculate the amount of time in milliseconds that the strategy should back off for</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html#reset--">reset</a></span>()</code>
<div class="block">Rests the back off strategy to its original state.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a name="AbstractBackOffStrategy-long-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>AbstractBackOffStrategy</h4>
<pre>public&nbsp;AbstractBackOffStrategy(long&nbsp;baseBackOffTime)</pre>
<div class="block">A BackOffStrategy that can effectively be used endlessly.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>baseBackOffTime</code> - amount of time back of in seconds</dd>
</dl>
</li>
</ul>
<a name="AbstractBackOffStrategy-long-int-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>AbstractBackOffStrategy</h4>
<pre>public&nbsp;AbstractBackOffStrategy(long&nbsp;baseBackOffTime,
int&nbsp;maximumNumberOfBackOffAttempts)</pre>
<div class="block">A BackOffStrategy that has a limited number of uses before it throws a
<a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffException.html" title="class in org.apache.streams.util.api.requests.backoff"><code>BackOffException</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>baseBackOffTime</code> - time to back off in milliseconds, must be greater than 0.</dd>
<dd><code>maximumNumberOfBackOffAttempts</code> - maximum number of attempts, must be grater than 0 or -1.
-1 indicates there is no maximum number of attempts.</dd>
</dl>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="backOff--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>backOff</h4>
<pre>public&nbsp;void&nbsp;backOff()
throws <a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffException.html" title="class in org.apache.streams.util.api.requests.backoff">BackOffException</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html#backOff--">BackOffStrategy</a></code></span></div>
<div class="block">Cause the current thread to sleep for an amount of time based on the implemented strategy. If limits are set
on the number of times the backOff can be called, an exception will be thrown.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html#backOff--">backOff</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html" title="interface in org.apache.streams.util.api.requests.backoff">BackOffStrategy</a></code></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffException.html" title="class in org.apache.streams.util.api.requests.backoff">BackOffException</a></code> - BackOffException</dd>
</dl>
</li>
</ul>
<a name="reset--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>reset</h4>
<pre>public&nbsp;void&nbsp;reset()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html#reset--">BackOffStrategy</a></code></span></div>
<div class="block">Rests the back off strategy to its original state.
After the call the strategy will act as if <a href="../../../../../../../org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html#backOff--"><code>backOff()</code></a>
has never been called.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html#reset--">reset</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffStrategy.html" title="interface in org.apache.streams.util.api.requests.backoff">BackOffStrategy</a></code></dd>
</dl>
</li>
</ul>
<a name="calculateBackOffTime-int-long-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>calculateBackOffTime</h4>
<pre>protected abstract&nbsp;long&nbsp;calculateBackOffTime(int&nbsp;attemptCount,
long&nbsp;baseSleepTime)</pre>
<div class="block">Calculate the amount of time in milliseconds that the strategy should back off for</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>attemptCount</code> - the number of attempts the strategy has backed off.
i.e. 1 -> this is the first attempt, 2 -> this is the second attempt, etc.</dd>
<dd><code>baseSleepTime</code> - the minimum amount of time it should back off for in milliseconds</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the amount of time it should back off in milliseconds</dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/AbstractBackOffStrategy.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev&nbsp;Class</li>
<li><a href="../../../../../../../org/apache/streams/util/api/requests/backoff/BackOffException.html" title="class in org.apache.streams.util.api.requests.backoff"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../../index.html?org/apache/streams/util/api/requests/backoff/AbstractBackOffStrategy.html" target="_top">Frames</a></li>
<li><a href="AbstractBackOffStrategy.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2018 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
</body>
</html>