Contributed by
and maintained by
and
November 2007 [Revision number: V1-3]
This publication is applicable to NetBeans IDE 6.0 and 6.1 releases
In this tutorial, you learn how to reverse engineer the source code of an existing Java application into a UML project. In the UML project all the classes and other application elements are represented in the Projects window under the UML project node, while the original Java code remains in its original state. This document walks you through several basic tasks as indicated by the topic links listed under Contents.
To use this tutorial, the IDE must be installed on your system and you should be familiar with the basic parts of the IDE. You should also have a basic familiarity with the Java programming language and UML. For a basic understanding of the IDE, see the IDE Basics topics in the online help. A good resource for UML techniques and theory is the official UML resource page at http://www.uml.org/
System Requirements
This tutorial assumes that your system meets the requirements specified in the Systems Requirements section of the NetBeans 6.1 Release Notes.
Software Needed for This Tutorial
To follow this tutorial, you need the software and resources listed in the following table.
In this section, you use the New Project wizard to create the sample Java project and UML project provided with the IDE.
From the main menu of the IDE, choose File > New Project.
The New Project wizard appears.
In the Choose Project page, expand the Samples node in the Categories pane and select the UML node.
The Projects pane is updated with the available UML sample project.
In the Projects pane, select the UML Bank App Sample and click Next.
In the Name and Location page, leave the default value of UMLBankAppSample for the Java project name.
For the Projects Location field, click Browse to navigate to the folder in which you want to save the files for the sample projects.
Notice that when you change the value in the Projects Location field, the IDE automatically updates the values in the Java Project Folder and UML Project Folder fields.
Leave the default value of UMLBankAppSample-Model for the UML project name.
Click Finish.
The Opening Projects progress dialog box appears.
The UMLBankAppSample and UMLBankAppSample-Model projects appears in the Projects window.
This section steps you through the different parts of the UMLBankAppSample application by exploring the different features of the Projects window that represent the elements of the application.
From the main menu, select Windows > Properties to open the Properties window.
In the Projects window, expand the UMLBankAppSample-Model> Model > bankpack node.
Expand the BankAccount node and its Attributes node.
All attributes of the BankAccount class are contained in this folder. If there are less than three attributes, the attributes appear under the class node without an Attributes folder.
Select the Attribute node labeled private double balance.
The Properties window shows the name of the attribute and its properties.
In the Projects window, under the node for the BankAccount class, expand the Operations node .
All the operations on the BankAccount class appear under this node.
Under the BankAccount class, expand the Relationships node .
Nodes for three types of relationships are displayed: Specializations, Aggregation, and Implementation.
Expand the Specializations node , then expand the three Generalization nodes.
The Generalization links show the relationship between BankAccount class to other elements (the Checking, Platinum, and Saving classes).
(Optional) Before continuing to the next section, close the expanded nodes under the BankAccount class.
Creating Another UML Project by Reverse Engineering
In the first section of this tutorial, you loaded the UMLBankAppSample Java project and the UML project, UMLBankAppSample-Model, that was generated using the Reverse Engineering feature. In this section, you go through the steps to create another UML project by reverse engineering the same UMLBankAppSample Java project that you used in the previous section.
In the Projects window, right-click the UMLBankAppSample node and choose Reverse Engineer.
The Reverse Engineer dialog appears.
Notice that the Selected Nodes field contains the non-editable value of UMLBankAppSample.
Leave the checkboxes in the Reverse Engineer column selected.
Select the Create New UML Project button.
In the Project Name field, accept the default, UMLBankAppSample-Model1.
For the Project Location field, leave the default value, which is the directory in which you saved the UML sample projects.
If you want to use a different folder, click Browse to navigate to that folder, and click Open.
Click OK.
The Opening Projects progress dialog box appears.
The UMLBankAppSample-Model1 project appears in the Projects window.
In this section, you use the buttons of the Diagram toolbar to view the application in various UML layouts in the Diagram editor.
Double-click the BankClassDiagram tab at the top of the Diagram editor.
This action stretches the class Diagram editor to fill the entire IDE window space.
Note: This is a toggle: To reverse this action double-click the BankClassDiagram tab again.
Stay in the expanded Diagram editor and click the Fit To Window button on the Diagram toolbar to display the diagram completely in the expanded editor.
Note: Notice the zoom level percentage field in the Diagram toolbar. You can manipulate the size by typing different numbers in this field.
Select the Symmetric Layout button on the Diagram toolbar and click Yes in the Layout warning dialog box.
The IDE arranges the BankClassDiagram diagram into a symmetric layout style.
Select the Hierarchical Layout button on the Diagram toolbar and click Yes in the Layout warning dialog box.
The IDE rearranges the BankClassDiagram diagram into a hierarchical layout style with all elements below the bankpack package.
Select the Orthogonal Layout button
on the Diagram toolbar and click Yes in the Layout warning dialog box.
The IDE rearranges the BankClassDiagram diagram into a rectangular layout style.
Here, use the features of the Overview window to get a scalable view of the diagram in the Diagram editor.
Double-click the BankClassDiagram tab at the top of the expanded Diagram editor.
The IDE returns to the multi-window view.
Select 50% from the zoom drop-down list and then click the Fit to Window button on the Diagram toolbar.
Using the Fit to Window button, the diagram scales from the 75% sized version so that you can read the labels better.
Click the Overview Window button on the Diagram toolbar to open the Overview window.
A small, scalable window displaying the entire diagram appears. A blue box in the window indicates what appears in the Diagram editor. Note: You may need to enlarge the Overview window or select a higher scale in the zoom drop-down list to see the blue box.
Drag the blue box over the BankAccount element.
This focuses the BankAccount element in the center of the Diagram editor.
To zoom in on an element, click one of the handles at the corner of the blue box and decrease the size of the box. Adjust the location of the box to zoom in on a specific part of the diagram.
To zoom out, click one of the handles of the blue box and increase the box's size.
Notice that the IDE zooms out on the diagram.
Close the Overview window by clicking the X in the upper right corner or by clicking the Overview Window button a second time.
Click the Fit to Window button again on the Diagram toolbar
Now, generate a dependency diagram for one of the classes in the BankApp application.
Double-click the BankClassDiagram tab to switch to the full view of the diagram.
Right-click the BankAccount class in the Diagram editor and choose Generate Dependency Diagram from the pop-up menu.
The IDE creates a dependency diagram and opens a BankAccountDependencies tab in the Diagram editor to display the new diagram. Your focus is now in the Diagram editor tab showing the BankAccountDependencies diagram. The BankAccountDependencies diagram shows the following dependency links:
Implementation relationship with the Account interface
Navigable Aggregation link to the History class
Note: Using this option, you can create a diagram showing all the dependencies for any given object.
Double-click the BankClassDiagram tab again to switch to the multi-window view of the IDE.
In the Projects window, expand the BankAccount class node under the UMLProject > Model > bankpack folder.
You see that a BankAccountDependencies node has been added representing the Dependency diagram you just created.
Now generate a sequence diagram for the application's withdraw operation. Examine how it is represented as a diagram and as elements in the UML Project in the Projects window
Click the BankAccountDependencies tab in the Diagram editor.
Select BankAccount element and adjust the zoom so that you can easily read the operation labels.
In the Diagram editor, right-click the withdraw operation and choose Reverse Engineer Operation from the pop-up menu.
The Create New Diagram dialog box appears.
In the Diagram Type list, select Sequence Diagram.
In the Diagram Name field, type withdrawSD.
Accept the default value in the Namespace field and click Finish.
A sequence diagram appears in the Diagram editor.
Expand the Diagram editor and manipulate the zoom level so that you can easily examine the new sequence diagram.
The sequence diagram shows the control flow, the sequence of behavior, and the concurrent processes and activations.
In the Projects windows, under the BankAccount class node, expand the Operations node, then expand the public void withdraw operation node.
You see the new withdraw sequence diagram node .
Expand the withdraw node to see the elements of the sequence diagram represented in the Projects window.
UML uses merge markers to assist you in keeping your source and model synchronized. The IDE adds merge markers by default when you invoke the Code Generation action from your UML project. If the UML project was created by your reverse engineering an existing Java project, there are no merge markers for your existing source elements.
To add merge markers:
Create or open your Java project.
Right click on the Java project node and select Reverse Engineer . Verify that Create New UML Project is selected. Click OK.
Ensure the reverse engineering to complete. The output window displays Task Successful.
Right-click on the newly created UML project node -> Generate Code ...
Select the Java project from the Target Project pull down list. Select the Add Merge Markers to Existing Source Elements. Click OK.
Your source and model are now synchronized and all source elements will have merge markers. You can safely switch back and forth between the source and model. Before each switch, however, you should invoke Reverse Engineer or Code Generation, as appropriate.
In this tutorial, you learned how to reverse engineer a Java application by importing its data into a UML model. You learned how to perform the following tasks:
Generate a class diagram from the imported Java application
Explore the features of the Projects window for representing the elements of the application.
Use the buttons of the Diagram toolbar to view the application in various UML layouts.
Use the Overview Window as a viewing tool.
Generate a dependency diagram for one of the application's classes.
Generate a sequence diagram for an operation and examine how it was represented as a diagram and as elements in the UML Project in the Projects window.
To learn more about the UML feature, complete the Developing Applications tutorial.
To send comments and suggestions, obtain support, and stay informed of the latest changes to the NetBeans IDE J2EE development features, join the
mailing list.
View Demo
labeled private double balance.
. 
. 
, then expand the three Generalization nodes.
View Demo
on the Diagram toolbar to display the diagram completely in the expanded editor.
button on the Diagram toolbar and click Yes in the Layout warning dialog box. 
button on the Diagram toolbar and click Yes in the Layout warning dialog box. 
button
on the Diagram toolbar and click Yes in the Layout warning dialog box. 
on the Diagram toolbar to open the Overview window.
has been added representing the Dependency diagram you just created.
. 
