blob: b95a102bb3b60258df77ef26d052695112833b2c [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>IRepacking (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="IRepacking (Heron Java API)";
}
}
catch(err) {
}
//-->
var data = {"i0":6,"i1":6,"i2":6,"i3":6};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract 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>Constr&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>Constr&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.spi.packing</a></div>
<h2 title="Interface IRepacking" class="title">Interface IRepacking</h2>
</div>
<div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Superinterfaces:</dt>
<dd><code>java.lang.AutoCloseable</code></dd>
</dl>
<dl>
<dt>All Known Implementing Classes:</dt>
<dd><code><a href="../../packing/AbstractPacking.html" title="class in org.apache.heron.packing">AbstractPacking</a></code>, <code><a href="../../packing/binpacking/FirstFitDecreasingPacking.html" title="class in org.apache.heron.packing.binpacking">FirstFitDecreasingPacking</a></code>, <code><a href="../../packing/roundrobin/ResourceCompliantRRPacking.html" title="class in org.apache.heron.packing.roundrobin">ResourceCompliantRRPacking</a></code>, <code><a href="../../packing/roundrobin/RoundRobinPacking.html" title="class in org.apache.heron.packing.roundrobin">RoundRobinPacking</a></code></dd>
</dl>
<hr>
<pre><a href="../../classification/InterfaceAudience.LimitedPrivate.html" title="annotation in org.apache.heron.classification">@LimitedPrivate</a>
<a href="../../classification/InterfaceStability.Unstable.html" title="annotation in org.apache.heron.classification">@Unstable</a>
public interface <span class="typeNameLabel">IRepacking</span>
extends java.lang.AutoCloseable</pre>
<div class="block">Packing algorithm for adding and/or removing component instances from an existing packing plan
Packing hints like number of containers may be passed through scheduler config.</div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== 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="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract 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>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#close()">close</a></span>()</code></th>
<td class="colLast">
<div class="block">This is to for disposing or cleaning up any internal state.</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="#initialize(org.apache.heron.spi.common.Config,org.apache.heron.api.generated.TopologyAPI.Topology)">initialize</a></span>&#8203;(<a href="../common/Config.html" title="class in org.apache.heron.spi.common">Config</a>&nbsp;config,
<a href="../../api/generated/TopologyAPI.Topology.html" title="class in org.apache.heron.api.generated">TopologyAPI.Topology</a>&nbsp;topology)</code></th>
<td class="colLast">
<div class="block">Initialize the packing algorithm with the static config and the associated topology</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code><a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#repack(org.apache.heron.spi.packing.PackingPlan,int,java.util.Map)">repack</a></span>&#8203;(<a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a>&nbsp;currentPackingPlan,
int&nbsp;containers,
java.util.Map&lt;java.lang.String,&#8203;java.lang.Integer&gt;&nbsp;componentChanges)</code></th>
<td class="colLast">
<div class="block">Generates a new packing given an existing packing and component changes
Packing algorithm output generates instance id and container id.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code><a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#repack(org.apache.heron.spi.packing.PackingPlan,java.util.Map)">repack</a></span>&#8203;(<a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a>&nbsp;currentPackingPlan,
java.util.Map&lt;java.lang.String,&#8203;java.lang.Integer&gt;&nbsp;componentChanges)</code></th>
<td class="colLast">
<div class="block">Generates a new packing given an existing packing and component changes
Packing algorithm output generates instance id and container id.</div>
</td>
</tr>
</table>
</li>
</ul>
</section>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a id="initialize(org.apache.heron.spi.common.Config,org.apache.heron.api.generated.TopologyAPI.Topology)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>initialize</h4>
<pre class="methodSignature">void&nbsp;initialize&#8203;(<a href="../common/Config.html" title="class in org.apache.heron.spi.common">Config</a>&nbsp;config,
<a href="../../api/generated/TopologyAPI.Topology.html" title="class in org.apache.heron.api.generated">TopologyAPI.Topology</a>&nbsp;topology)</pre>
<div class="block">Initialize the packing algorithm with the static config and the associated topology</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>config</code> - topology config</dd>
<dd><code>topology</code> - topology to repack</dd>
</dl>
</li>
</ul>
<a id="repack(org.apache.heron.spi.packing.PackingPlan,java.util.Map)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>repack</h4>
<pre class="methodSignature"><a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a>&nbsp;repack&#8203;(<a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a>&nbsp;currentPackingPlan,
java.util.Map&lt;java.lang.String,&#8203;java.lang.Integer&gt;&nbsp;componentChanges)
throws <a href="PackingException.html" title="class in org.apache.heron.spi.packing">PackingException</a></pre>
<div class="block">Generates a new packing given an existing packing and component changes
Packing algorithm output generates instance id and container id.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>currentPackingPlan</code> - Existing packing plan</dd>
<dd><code>componentChanges</code> - Map &lt; componentName, new component parallelism &gt;
that contains the parallelism for each component whose parallelism has changed.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>PackingPlan describing the new packing plan.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="PackingException.html" title="class in org.apache.heron.spi.packing">PackingException</a></code> - if the packing plan can not be generated</dd>
</dl>
</li>
</ul>
<a id="repack(org.apache.heron.spi.packing.PackingPlan,int,java.util.Map)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>repack</h4>
<pre class="methodSignature"><a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a>&nbsp;repack&#8203;(<a href="PackingPlan.html" title="class in org.apache.heron.spi.packing">PackingPlan</a>&nbsp;currentPackingPlan,
int&nbsp;containers,
java.util.Map&lt;java.lang.String,&#8203;java.lang.Integer&gt;&nbsp;componentChanges)
throws <a href="PackingException.html" title="class in org.apache.heron.spi.packing">PackingException</a></pre>
<div class="block">Generates a new packing given an existing packing and component changes
Packing algorithm output generates instance id and container id.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>currentPackingPlan</code> - Existing packing plan</dd>
<dd><code>componentChanges</code> - Map &lt; componentName, new component parallelism &gt;
that contains the parallelism for each component whose parallelism has changed.</dd>
<dd><code>containers</code> - &lt; the new number of containers for the topology
specified by the user</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>PackingPlan describing the new packing plan.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="PackingException.html" title="class in org.apache.heron.spi.packing">PackingException</a></code> - if the packing plan can not be generated</dd>
</dl>
</li>
</ul>
<a id="close()">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>close</h4>
<pre class="methodSignature">void&nbsp;close()</pre>
<div class="block">This is to for disposing or cleaning up any internal state.
Closes this stream and releases any system resources associated
with it. If the stream is already closed then invoking this
method has no effect.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code>close</code>&nbsp;in interface&nbsp;<code>java.lang.AutoCloseable</code></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>Constr&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>Constr&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>