Visual Library API - Architecture Review Opinion

Issue: 95110
Submitter: David Kaspar
Date: March 8th, 2007
Reviewers: Joelle Lam, Anton Epple, Nathan Fiedler, Milos Kleint, Jaroslav Tulach (not voting)

Content

Summary

Motivation

The purpose of this API is to create a library for easier development of visual applications based on the NetBeans Platform. Long-term goal is to provide tools to unify the UI appearance and behaviour of those applications.

Decision

Accepted with TCRs

Opinion

Renaming of non-standard names

Some names of methods/classes are non-standard e.g. FillLayout.
TCR: Change those names to standard ones e.g. OverlayLayout.
This will introduce an backward-incompatible change against the release551 branch.

Missing support for ActionMap

ActionMap class is a standard and should be integrated into the library.
TCR: Create an ActionFactory.createActionMapAction method which creates a wrapper widget-action that handles keyPressed and popup-menu creation.

Move deprecated classes from the public API

The library contains a few deprecated classes and methods.
TCR: Since there would be incompatible-change already, move these deprecated (to-be-changed) classes to non-public API packages. Users would be able to access them suing the implementation dependency.

VMD package

The library contains a VMD package. It is a particular implementation of a visualization.
Answer: do NOT move it to a separate module, do NOT rename it
TCR: Improve javadoc

Public, non-final classes/methods

The library contains a lot of non-public or final elements.
Answer: Because of API maintaince, it should stay like it is right now.
An API change request could be sent to the users@graph.netbeans.org mailing list or entered as an issue with API_REVIEW or API_REVIEW_FAST keywords.
The API change process will follow standard or fast-tract review steps. For details, see Architecture Review Steps.

Minority Opinion

None.

Appendixes

Appendix A: Technical Changes Required

97562 - Renaming of non-standard names
97563 - Missing support for ActionMap
97564 - Move deprecated classes from the public API
(not entered into IZ) - Improve VMD package javadoc

Appendix B: Technical Changes Advised

None.

Appendix C: Reference Material

None.

Project Features

About this Project

openide was started in November 2009, is owned by Antonin Nebuzelsky, and has 7 members.
By use of this website, you agree to the NetBeans Policies and Terms of Use (revision 20131025.e7cbc9d). © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo
 
 
Close
loading
Please Confirm
Close