Mailing-List: contact notifications-help@accumulo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: jira@apache.org
Date: Tue, 10 Mar 2015 21:12:39 +0000 (UTC)
From: "Josh Elser (JIRA)" <jira@apache.org>
To: notifications@accumulo.apache.org
Message-ID: <JIRA.12778697.1425279927000.56358.1426021959173@Atlassian.JIRA>
In-Reply-To: <JIRA.12778697.1425279927000@Atlassian.JIRA>
References: <JIRA.12778697.1425279927000@Atlassian.JIRA>
 <JIRA.12778697.1425279927463@arcas>
Subject: [jira] [Commented] (ACCUMULO-3633) Please provide information on
 implementing custom iterators in the documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/ACCUMULO-3633?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14355728#comment-14355728 ] 

Josh Elser commented on ACCUMULO-3633:
--------------------------------------

When I did the first draft, I was thinking about how best to express what the call path really looks like. I'll see if I can make some sort of flow diagram.

Slightly more usable, I was thinking about creating some kind of "fuzzing" framework for Iterators. It would be a tool that accepts a {{SortedMap<Key,Value>}} and an Iterator class and just performs a bunch of random scans over the data. We could provide it to users as an initial entry point to testing their iterators as running them in the tabletserver's JVM is more difficult to debug than a single JVM.

I've been thinking about it for a while -- I'm not entirely convinced if it would be a good long-term solution (as the framework would copy what the tabletserver does, not be guaranteed to do exactly what the tabletserver does). I think I want to at least stub it out and see how it "feels" to use as a testing tool.

> Please provide information on implementing custom iterators in the documentation
> --------------------------------------------------------------------------------
>
>                 Key: ACCUMULO-3633
>                 URL: https://issues.apache.org/jira/browse/ACCUMULO-3633
>             Project: Accumulo
>          Issue Type: Wish
>          Components: docs
>    Affects Versions: 1.6.0
>         Environment: Centos 6.5, Accumulo 1.6.0, CDH 5. 
>            Reporter: Vaibhav Thapliyal
>            Assignee: Josh Elser
>              Labels: documentation
>             Fix For: 1.7.0
>
>         Attachments: 0001-ACCUMULO-3633-User-manual-chapter-on-custom-iterator.patch
>
>
> Dear all,
> Can you please provide a documentation regarding creating custom Iterators. For example, explain the functionality  of the functions inside SortedKeyValueIterator and how to override those functions.
> Please explain how these functions are executed (which class calls these functions when the iterator executes).
> I would appreciate if these changes are made in your future documentations as this would help developers who are new to accumulo to quickly get started on writing their own custom iterators which is an essential part of accumulo. 


--
This message was sent by Atlassian JIRA
(v6.3.4#6332)