This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 20129

Summary: While editing source code, would like a way to quickly see high-level view of class
Product: editor Reporter: eakle <eakle>
Component: -- Other --Assignee: issues@editor <issues>
Status: RESOLVED WORKSFORME    
Severity: blocker CC: bht, jeri
Priority: P3    
Version: 3.x   
Hardware: PC   
OS: All   
Issue Type: ENHANCEMENT Exception Reporter:
Bug Depends on: 35583    
Bug Blocks:    

Description eakle 2002-02-04 17:57:54 UTC
The Netbeans explorer-view of a class can be very helpful when editing and 
navigating through a large source file; for example, I may want to quickly see 
a list of all the methods in the source code I'm editing, and the source was 
opened long ago (is one of many edit tabs) and is no longer selected in the 
explorer. But I would like to quickly jump to this class in the explorer to 
then see a high-level view of, say, the methods in the class.  To do this, I 
would like to see another option added to the popup menu I see in the source 
code editor; something like: "[Go to] Explorer View of Class".  That menuitem 
would open the explorer tree down to my class, to the level where I would 
see "Fields", "Methods", "Constructors", and any inner classes listed; I would 
then open one of those to get the high-level view I am after.
The menuitem would do the same thing, regardless of where I am positioned in 
the file.
Comment 1 Marek Grummich 2002-07-22 09:56:09 UTC
Set target milestone to TBD
Comment 2 Marek Grummich 2002-07-22 09:58:44 UTC
Set target milestone to TBD
Comment 3 bht 2002-07-23 21:51:36 UTC
A possible way of implementing this would be to give the explorer a
"Go to" function.
This function would accept a kind of URL that could be clear text and
be valid throgh the whole netbeans system.

Any GUI e.g. source editor would provide this URL from "self" by
copying it to the clipboard.
Likewise any GIU would consume this URL from the clipboard.

The clipboard becomes the hub that resolves the many-to-many
relationship of this "Go to" issue.

Without such a hub, it is very complex to present the user with all
the options in every GUI.

In other words, any GUI has to know what other applications exist that
coule open "this" (the currently open object or file) via the
suggested "Go to" function.

In Windows 95/NT, there is a explorer utility "Send to X" that
selected files as a list of file names to the clipboard.

Linux KDE solves this even more elegantly via the copy function
[Ctl+C] etc. So if you copy a file in KDE what you get when you paste
depends on what the application can handle. If you paste in a notepad
you get a list of file names, if you paste in Konqueror then you get
the files moved/copied.

Netbeans should have this too IMHO. It's very smart.
Comment 4 eakle 2002-07-30 17:01:03 UTC
On second thought, I think it would be nice if the 
behavior of this menuitem could be sensitive to where you 
are in the source file (if that's feasible).  For example, 
if I'm positioned in method "foo" in the source editor, 
and I select this GoTo/Jump menuitem, then it would open 
the explorer down to the methods in that class and 
position me on "foo".  If it's possible to do this, then 
it would be a useful behavior.
Comment 5 Miloslav Metelka 2002-07-31 12:34:12 UTC
I'm wondering whether your original issue would be covered by the code
folding that will appear in 4.0. There should certainly be an action
that would fold all the method bodies so that you would just see the
skeleton of the class (fields, method signatures, inner classes
skeletons).
Comment 6 eakle 2002-07-31 17:02:27 UTC
code folding will be nice and what is described above 
should offer a useful way to navigate within a file. I 
still think that providing a way to navigate to the 
explorer is useful though, even with code folding for 2 
reasons: 1. MDR should allow Netbeans to support rapid 
navigation from the current class to other related classes 
(superclass, subclasses, etc. -- see issue 25863); these 
navigations will likely operate from a high-level view of 
the class, as in the explorer or other yet-to-be-written 
workshop. So I would like a way to jump from the source 
editor to the place where navigations can begin for the 
current class.  2. It's really nice to have both the high-
level view of a class (explorer) and the detailed view 
(source code) on display at the same time.  That lets me 
click a method in the high-level view and see its source 
code in the detail view; that has better useability than 
having to fold all the code (losing the detail view), 
click a method and then unfold the code (losing the high-
level view).
So, code folding will be great, but I don't think it 
covers the need for jumping between the high-level and 
detail views of a class.
Comment 7 bht 2004-02-07 04:41:49 UTC
Works for me. I think the original issue is coverd with the new feature 

Menu|Window|Select Document in|File
Systems[Ctrl+Shift+2]/Project[Ctrl+Shift+3].

This is a very useful feature.