This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new 51632131 Automatic Site Publish by Buildbot
51632131 is described below
commit 51632131bda49127572fc01f5a98d565c287b404
Author: buildbot <us...@infra.apache.org>
AuthorDate: Mon Apr 17 16:30:26 2023 +0000
Automatic Site Publish by Buildbot
---
output/docs/2.x/development/iterators.html | 16 ++++++++++------
output/feed.xml | 4 ++--
output/search_data.json | 2 +-
3 files changed, 13 insertions(+), 9 deletions(-)
diff --git a/output/docs/2.x/development/iterators.html
b/output/docs/2.x/development/iterators.html
index ada4e834..442082c1 100644
--- a/output/docs/2.x/development/iterators.html
+++ b/output/docs/2.x/development/iterators.html
@@ -832,12 +832,16 @@ always see all intended data that is generated.</p>
<h3 id="teardown">Teardown</h3>
-<p>As mentioned, instance of Iterators may be torn down inside of the server
transparently. When a complex
-collection of iterators is performing some advanced functionality, they will
not be torn down until a Key-Value
-pair is returned out of the “stack” of Iterators (and added into the batch of
Key-Values to be returned
-to the caller). Being torn-down is equivalent to a new instance of the
Iterator being creating and <code class="language-plaintext
highlighter-rouge">deepCopy</code>
-being called on the new instance with the old instance provided as the
argument to <code class="language-plaintext highlighter-rouge">deepCopy</code>.
References
-to the old instance are removed and the object is lazily garbage collected by
the JVM.</p>
+<p>Instances of iterators may be torn down inside the server transparently.
When a complex collection
+of iterators is performing advanced functionality, they will not be torn down
until a Key-Value pair
+is returned out of the “stack” of iterators (and added into the batch of
Key-Values to be returned
+to the caller), or the iterator is yielded.</p>
+
+<p>When an iterator is torn down, the entire stack is dropped and no state is
preserved. Only the last
+key returned (or the yielded position), original options, and seek range are
retained. When the scan
+is continued, the iterator stack is rebuilt and re-initialized using the
original options. The stack
+is then seeked with the original range, and the start key is replaced by the
last key returned (or
+the yielded position), non-inclusive.</p>
<h2 id="compaction-time-iterators">Compaction-time Iterators</h2>
diff --git a/output/feed.xml b/output/feed.xml
index 9caa23df..f39c0391 100644
--- a/output/feed.xml
+++ b/output/feed.xml
@@ -6,8 +6,8 @@
</description>
<link>https://accumulo.apache.org/</link>
<atom:link href="https://accumulo.apache.org/feed.xml"; rel="self"
type="application/rss+xml"/>
- <pubDate>Fri, 07 Apr 2023 13:25:00 +0000</pubDate>
- <lastBuildDate>Fri, 07 Apr 2023 13:25:00 +0000</lastBuildDate>
+ <pubDate>Mon, 17 Apr 2023 16:30:18 +0000</pubDate>
+ <lastBuildDate>Mon, 17 Apr 2023 16:30:18 +0000</lastBuildDate>
<generator>Jekyll v4.3.1</generator>
diff --git a/output/search_data.json b/output/search_data.json
index 43095f00..2c424e3a 100644
--- a/output/search_data.json
+++ b/output/search_data.json
@@ -114,7 +114,7 @@
"docs-2-x-development-iterators": {
"title": "Iterators",
- "content": "Accumulo SortedKeyValueIterators, commonly referred to as
Iterators for short, are server-side programming constructsthat allow users to
implement custom retrieval or computational purpose within Accumulo
TabletServers. The name rightlybrings forward similarities to the Java
Iterator interface; however, Accumulo Iterators are more complex than
JavaIterators. Notably, in addition to the expected methods to retrieve the
current element and advance to the next elementin t [...]
+ "content": "Accumulo SortedKeyValueIterators, commonly referred to as
Iterators for short, are server-side programming constructsthat allow users to
implement custom retrieval or computational purpose within Accumulo
TabletServers. The name rightlybrings forward similarities to the Java
Iterator interface; however, Accumulo Iterators are more complex than
JavaIterators. Notably, in addition to the expected methods to retrieve the
current element and advance to the next elementin t [...]
"url": " /docs/2.x/development/iterators",
"categories": "development"
},
