[Review request] TreeTableView

[Jonathan Giles]

I'm working on writing the javadocs now, but I can put up a zip of the 
generated javadocs on jira as they stand now if that would be useful.

-- Jonathan

On Tuesday, 27 November 2012 1:25:48 p.m., Richard Bair wrote:
> Is there any kind of JavaDocs available for these APIs? For example, I'm wondering what the subclasses are of ResizeFeaturesBase, and the getters / setters / etc on the various proposed classes.
>
> Thanks
> Richard
>
> On Nov 26, 2012, at 2:19 PM, Jonathan Giles <jonathan.giles at oracle.com> wrote:
>
>> Hi all,
>>
>> I'm planning to relocate the TreeTableView control I've been developing in the OpenJFX 8.0 controls sandbox over into the proper OpenJFX 8.0 controls repo. Before that happens there is a gate here that we need to go through related to having an early API review. To make understanding the control easier, I've written up an overview of the TreeTableView control here:
>>
>> https://wikis.oracle.com/display/OpenJDK/TreeTableView
>>
>> This documentation covers the core concepts of the API, it includes examples of how the API is used, and finally I've put up a brief paragraph detailing the implementation (although I may add more detail in here as time passes and questions come in). My colleage Jindra Dinga, who is responsible for the UX design of the TreeTableView control, has posted his UX documentation for it at the same link above, so hopefully this too will prove useful for people to fully understand precisely what a TreeTableView is, and is not.
>>
>> To get a slightly more in-depth understanding of the path TreeTableView has taken to where it is today, you may also be interested in the following Jira issue, and perhaps you may choose to follow it and / or offer feedback directly into the Jira issue:
>>
>> http://javafx-jira.kenai.com/browse/RT-17288
>>
>> The TreeTableView control that is in the sandbox repo is far superior to the prototype that is in the 8.0 controls repo (in the com.preview.* package). It is my intention to completely remove the old TreeTableView control and replace it with the new implementation, and even go so far as to place it in the correct packages so that I can make use of package protected API. However, it is important to note that the API _is not final_ - I'm only going through the first gate here to get the code into the correct repo and packages - there will be further discussion in the future regarding API design, missing / incorrect functionality, and straight out bugs.
>>
>> I hope that you are all excited about getting a TreeTableView control into JavaFX 8.0, and I hope you can all help guide the control towards an API that meets your requirements and use cases. I think what we have now is good, but API design can not be done in a vacuum so I look forward to your feedback. I would recommend that discussion regarding moving TreeTableView into the official OpenJFX 8.0 controls repo take place here, and that discussion around API design and functionality be posted on the Jira issue linked above (rather than here), to try to prevent the amount of noise on this list.
>>
>> Thanks!
>> -- Jonathan
>