ivakegg commented on code in PR #383: URL: https://github.com/apache/accumulo-website/pull/383#discussion_r1167103684
########## _docs-2/development/iterators.md: ########## @@ -408,12 +408,16 @@ On an instance of an Iterator: `init` is always called before `seek`, `seek` is ### Teardown -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 `deepCopy` -being called on the new instance with the old instance provided as the argument to `deepCopy`. References -to the old instance are removed and the object is lazily garbage collected by the JVM. +As mentioned, instances of iterators may be torn down inside 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), or the iterator is yielded. Being torn down means that the Review Comment: Being torn down means that the iterator stack is completely dropped, and the only information retained is that last key returned (or the yielded position) along with the original options and seek range. When the scan is continued, then the iterator stack is rebuilt, re-initialized using the original options, and then seeked using the original range with the start key replaced by the last key returned (or the yielded position), non-inclusive. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
