blob: 7d1be632726098e2baee45d0c59bf25a8da743e2 [file] [log] [blame]
<!DOCTYPE HTML>
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (11.0.18) on Wed Mar 01 02:01:42 GMT 2023 -->
<title>ReduceByKeyAndWindowCustomGrouping (Heron Java API)</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="dc.created" content="2023-03-01">
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../../../../../jquery/jquery-ui.min.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../../../../../jquery-ui.overrides.css" title="Style">
<script type="text/javascript" src="../../../../../../script.js"></script>
<script type="text/javascript" src="../../../../../../jquery/jszip/dist/jszip.min.js"></script>
<script type="text/javascript" src="../../../../../../jquery/jszip-utils/dist/jszip-utils.min.js"></script>
<!--[if IE]>
<script type="text/javascript" src="../../../../../../jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
<![endif]-->
<script type="text/javascript" src="../../../../../../jquery/jquery-3.6.0.min.js"></script>
<script type="text/javascript" src="../../../../../../jquery/jquery-ui.min.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="ReduceByKeyAndWindowCustomGrouping (Heron Java API)";
}
}
catch(err) {
}
//-->
var data = {"i0":10,"i1":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
var pathtoroot = "../../../../../../";
var useModuleDirectories = true;
loadScripts(document, 'script');</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<header role="banner">
<nav role="navigation">
<div class="fixedNav">
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a id="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</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" id="allclasses_navbar_top">
<li><a href="../../../../../../allclasses.html">All&nbsp;Classes</a></li>
</ul>
<ul class="navListSearch">
<li><label for="search">SEARCH:</label>
<input type="text" id="search" value="search" disabled="disabled">
<input type="reset" id="reset" value="reset" disabled="disabled">
</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>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</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 id="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
</div>
<div class="navPadding">&nbsp;</div>
<script type="text/javascript"><!--
$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
//-->
</script>
</nav>
</header>
<!-- ======== START OF CLASS DATA ======== -->
<main role="main">
<div class="header">
<div class="subTitle"><span class="packageLabelInType">Package</span>&nbsp;<a href="package-summary.html">org.apache.heron.streamlet.impl.groupings</a></div>
<h2 title="Class ReduceByKeyAndWindowCustomGrouping" class="title">Class ReduceByKeyAndWindowCustomGrouping&lt;R,&#8203;K&gt;</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li>java.lang.Object</li>
<li>
<ul class="inheritance">
<li>org.apache.heron.streamlet.impl.groupings.ReduceByKeyAndWindowCustomGrouping&lt;R,&#8203;K&gt;</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><code>java.io.Serializable</code>, <code><a href="../../../api/grouping/CustomStreamGrouping.html" title="interface in org.apache.heron.api.grouping">CustomStreamGrouping</a></code>, <code><a href="../../../api/grouping/StreamGrouping.html" title="interface in org.apache.heron.api.grouping">StreamGrouping</a></code></dd>
</dl>
<hr>
<pre>public class <span class="typeNameLabel">ReduceByKeyAndWindowCustomGrouping&lt;R,&#8203;K&gt;</span>
extends java.lang.Object
implements <a href="../../../api/grouping/CustomStreamGrouping.html" title="interface in org.apache.heron.api.grouping">CustomStreamGrouping</a></pre>
<div class="block">ReduceByKeyAndWindowCustomGrouping is the class that routes the incoming tuples
into the ReduceByKeyAndWindowOperator. It essentially ensures that the values being
routed are of type KeyValue uses the key to route the tuple to the destination.
The current implementation is identical to JoinCustomGrouping but it might
evolve in the future.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../../serialized-form.html#org.apache.heron.streamlet.impl.groupings.ReduceByKeyAndWindowCustomGrouping">Serialized Form</a></dd>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Constructor</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tr class="altColor">
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E(org.apache.heron.streamlet.SerializableFunction)">ReduceByKeyAndWindowCustomGrouping</a></span>&#8203;(<a href="../../SerializableFunction.html" title="interface in org.apache.heron.streamlet">SerializableFunction</a>&lt;<a href="ReduceByKeyAndWindowCustomGrouping.html" title="type parameter in ReduceByKeyAndWindowCustomGrouping">R</a>,&#8203;<a href="ReduceByKeyAndWindowCustomGrouping.html" title="type parameter in ReduceByKeyAndWindowCustomGrouping">K</a>&gt;&nbsp;keyExtractor)</code></th>
<td class="colLast">&nbsp;</td>
</tr>
</table>
</li>
</ul>
</section>
<!-- ========== METHOD SUMMARY =========== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary">
<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="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="colSecond" scope="col">Method</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>java.util.List&lt;java.lang.Integer&gt;</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#chooseTasks(java.util.List)">chooseTasks</a></span>&#8203;(java.util.List&lt;java.lang.Object&gt;&nbsp;values)</code></th>
<td class="colLast">
<div class="block">This function implements a custom stream grouping.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#prepare(org.apache.heron.api.topology.TopologyContext,java.lang.String,java.lang.String,java.util.List)">prepare</a></span>&#8203;(<a href="../../../api/topology/TopologyContext.html" title="interface in org.apache.heron.api.topology">TopologyContext</a>&nbsp;context,
java.lang.String&nbsp;component,
java.lang.String&nbsp;streamId,
java.util.List&lt;java.lang.Integer&gt;&nbsp;targetTasks)</code></th>
<td class="colLast">
<div class="block">Tells the stream grouping at runtime the tasks in the target bolt.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.Object</h3>
<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.org.apache.heron.api.grouping.CustomStreamGrouping">
<!-- -->
</a>
<h3>Methods inherited from interface&nbsp;org.apache.heron.api.grouping.<a href="../../../api/grouping/CustomStreamGrouping.html" title="interface in org.apache.heron.api.grouping">CustomStreamGrouping</a></h3>
<code><a href="../../../api/grouping/CustomStreamGrouping.html#buildStream(java.lang.String,java.lang.String)">buildStream</a></code></li>
</ul>
</li>
</ul>
</section>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a id="&lt;init&gt;(org.apache.heron.streamlet.SerializableFunction)">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>ReduceByKeyAndWindowCustomGrouping</h4>
<pre>public&nbsp;ReduceByKeyAndWindowCustomGrouping&#8203;(<a href="../../SerializableFunction.html" title="interface in org.apache.heron.streamlet">SerializableFunction</a>&lt;<a href="ReduceByKeyAndWindowCustomGrouping.html" title="type parameter in ReduceByKeyAndWindowCustomGrouping">R</a>,&#8203;<a href="ReduceByKeyAndWindowCustomGrouping.html" title="type parameter in ReduceByKeyAndWindowCustomGrouping">K</a>&gt;&nbsp;keyExtractor)</pre>
</li>
</ul>
</li>
</ul>
</section>
<!-- ============ METHOD DETAIL ========== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a id="prepare(org.apache.heron.api.topology.TopologyContext,java.lang.String,java.lang.String,java.util.List)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>prepare</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;prepare&#8203;(<a href="../../../api/topology/TopologyContext.html" title="interface in org.apache.heron.api.topology">TopologyContext</a>&nbsp;context,
java.lang.String&nbsp;component,
java.lang.String&nbsp;streamId,
java.util.List&lt;java.lang.Integer&gt;&nbsp;targetTasks)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../api/grouping/CustomStreamGrouping.html#prepare(org.apache.heron.api.topology.TopologyContext,java.lang.String,java.lang.String,java.util.List)">CustomStreamGrouping</a></code></span></div>
<div class="block">Tells the stream grouping at runtime the tasks in the target bolt.
This information should be used in chooseTasks to determine the target tasks.
<p>
It also tells the grouping the metadata on the stream this grouping will be used on.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../api/grouping/CustomStreamGrouping.html#prepare(org.apache.heron.api.topology.TopologyContext,java.lang.String,java.lang.String,java.util.List)">prepare</a></code>&nbsp;in interface&nbsp;<code><a href="../../../api/grouping/CustomStreamGrouping.html" title="interface in org.apache.heron.api.grouping">CustomStreamGrouping</a></code></dd>
</dl>
</li>
</ul>
<a id="chooseTasks(java.util.List)">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>chooseTasks</h4>
<pre class="methodSignature">public&nbsp;java.util.List&lt;java.lang.Integer&gt;&nbsp;chooseTasks&#8203;(java.util.List&lt;java.lang.Object&gt;&nbsp;values)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../api/grouping/CustomStreamGrouping.html#chooseTasks(java.util.List)">CustomStreamGrouping</a></code></span></div>
<div class="block">This function implements a custom stream grouping. It takes in as input
the number of tasks in the target bolt in prepare and returns the
tasks to send the tuples to.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../api/grouping/CustomStreamGrouping.html#chooseTasks(java.util.List)">chooseTasks</a></code>&nbsp;in interface&nbsp;<code><a href="../../../api/grouping/CustomStreamGrouping.html" title="interface in org.apache.heron.api.grouping">CustomStreamGrouping</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>values</code> - the values to group on</dd>
</dl>
</li>
</ul>
</li>
</ul>
</section>
</li>
</ul>
</div>
</div>
</main>
<!-- ========= END OF CLASS DATA ========= -->
<footer role="contentinfo">
<nav role="navigation">
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a id="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</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" id="allclasses_navbar_bottom">
<li><a href="../../../../../../allclasses.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>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</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 id="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</nav>
</footer>
</body>
</html>