|
||||||||||||||
Outline |
||||||||||||||
Notice
The contents of this document refer to the UML1-based feature
set in MyEclipse. As of MyEclipse 7.0 M2, there are both UML1 ( |
||||||||||||||
1. PrefaceThis document was written using MyEclipse 6.0. All screenshots are based upon the default user interface settings for MyEclipse, and Windows XP. If you experience difficulty with the instruction of this document, please see the User Feedback section for how to provide feedback to the MyEclipse documentation team. |
||||||||||||||
2. RequirementsMyEclipse UML Tools are supported in the following enviornments:
|
||||||||||||||
3. Introduction
MyEclipse UML provides developers the MyEclipse developers with
the following UML features:
UML PerspectiveThe MyEclipse UML Perspective provides a workbench organization tailored to activities of the modeling process. Default views include the UML Diagram Editor, Outline View, and custom Properties View. Toolbar actions are contributed to make new diagram creation quick and simple. An annotated class diagram example is shown below.
Figure 3.1. UML Perspective
|
||||||||||||||
4. Creating a UML Model Repository
MyEclipse UML stores all UML diagrams and model elements in a
special file known as a UML Model Repository (UMR). A UMR has a
file extension of " .umr" and is depicted with the
The 1st step in working with new MyEclipse UML diagrams is to create a UML model repository using the New UMR Wizard.
That concludes creating the steps necessary to create a UML repository. In the next section adding diagrams to the model is discussed. |
||||||||||||||
5. Creating and Editing UML Diagrams |
||||||||||||||
5.1 Creating UML DiagramsA model repository can contain any number of diagrams of any type. To add a new diagram to a model repository, open the UML repository file in the editor and then click on the appropriate new UML Diagram action from the dropdown menu on the Diagram Editor's toolbar, as shown below.
Diagrams can also be created from the UML Outline View, as shown below
To edit or view a UML diagram select it from either the dropdown diagram list on the Diagram Editor's local toolbar or from the MyEclipse UML outline view. The Diagram Editor toolbar is shown below.
While editing UML diagrams, you can enter "mass add" mode which allows you to continually click in the diagram area adding the same type of element, click after click. To enter mass-add mode you simply double-click the type of element you want to add to your diagram, and then begin clicking in the diagram area:
To exit mass-add mode, simply click back on the
arrow icon and continue editing the diagram.
|
||||||||||||||
5.2 Adding Model Elements to DiagramsModel elements can be added to the current diagram from the UML editor's toolbar simply by clicking on the appropriate element button and then selecting the location on the diagram where the new element should reside. Please note that the toolbar is "diagram-specific", so its contents changes based on the active diagram's type. Below is a sequence of screenshots that show how a class can be added to a class diagram. Any element can be added to other diagrams in a similar way.
|
||||||||||||||
5.3 Editing Diagram ElementsThe Diagram Editor enables you to directly modify nodes and connections through a concept known as a hot-zone. There are two type of hot-zones: text and connection. Text hot-zone is an editable region within a node or at the center and end-points of a connection, e.g., association, that is activated by double-clicking within its region. When activated, a hot-zone presents a rectangular editable type-in field. The type-in field accepts direct text entry and delete/cut/copy/paste operations. To commit the changes of a text hot-zone, select anywhere outside of the hot-zone edit region. The type-in region will disappear and be replaced with its content.
Quick Connects are a type of hot-zone that provides fly-over short-cut association and generalization connections on a node. The user can quickly choose the connection type, e.g., association, generalization, self association, and drag the connection to another node to complete the connection.
Properties editing allows any change to an element to be entered through a form-based UI called the Properties View. The Properties View has several pages for easy entry or edit of any attribute associated with an element. Some of the editable fields overlap with changes that can be made in a hot-zone, and others are only available in the Properties view.
|
||||||||||||||
6. Forward Engineering - UML Class Diagrams to Java CodeMyEclipse UML enables you to generate Java code directly from the class diagrams of your UML model.
After generation is complete, the newly generated Java classes will appear in the specified source folder.
|
||||||||||||||
7. Reverse Engineering - Java Code to UML Class DiagramsReverse engineering from Java code to UML can be done in two different ways, through batch processing or through drag-and-drop. Both options will be described in this section. |
||||||||||||||
7.1 Batch Mode - Reverse-EngineeringThe MyEclipse UML Reverse-Engineering tools enable you to import the Java classes and interfaces from any Java project, source folder, Java package or source file.
|
||||||||||||||
7.2 Drag-and-Drop - Reverse-EngineeringYou can seamlessly add Java classes and interfaces to any UML class diagram using drag-n-drop operations.
Upon completion, the class diagram will reflect the new additions, including any associations between them, as shown below.
|
||||||||||||||
8. Drawing ToolsSince it's often useful to annotate diagrams with some amount of free-form drawing or text, MyEclipse UML includes a set of drawing tools for simple shapes and text which can be used on any type of diagram. The drawing tool selection menu is in the main diagram toolbar and is used to select the element type.
|
||||||||||||||
9. Compatibility with Argo UMLMyEclipse UML is backward compatible with the.zargo file format of Argo UML (ver. 0.17 or earlier). To use an existing Argo model file with MyEclipse UML do the following:
|
||||||||||||||
10. FAQ
Q1: When I open the MyEclipse workbench I don't
see how to get started using UML features.
|
||||||||||||||
11. ReferencesTo learn more about UML visit the UML Resource Center. |
||||||||||||||
12. User Feedback
If you have comments or suggestions regarding
this document please submit them to the If you
have comments or suggestions regarding this document
please submit them to the
MyEclipse
Documentation Forum.
|