prmr / JetUML

This release fixes a bug that prevented the creation of field nodes in object diagrams (#376).

With Release 3.0 JetUML is deployable as a self-contained application. The release also includes new features to help users learn UML as they go and avoid diagramming errors.

New Deployment Model

• The application was modularized (#352) so that it can be made available as a self-contained application (#372)

New Features

• Verbose tool-tips: It is now possible to optionally see verbose tooltips that provide an extended definition of the different UML elements in the toolbar (#356)
• Auto-activate the Selection Tool: Selecting a diagram element will automatically activate the selection tool, even if a different tools was (usually mistakenly) selected (#363);

Updated Diagram Structure

• Usage modes (text vs. elements) of package node mutually exclusive (#320)
• Simplified dependencies in Class Diagrams (#301)
• Interface stereotype as part of the element view, not data (#359)
• Removed labels on generalization edges in class diagrams (#360)
• Association edges are not implicitly directed (#362)
• Additional checking of edges constaints (#361)
• Automatic migration for these changes (#302)

Bug Fixes and Refactorings

• Fix: Reposition the package when its child node is deleted (#350)
• Fix: Reposition the package node (#351)
• Update Checkstyle Style sheet (#354)
• Potential resource leaks in the JSON library (#355)
• Call Node Mispositioned in the Sequence Diagram (#357)
• Refactor the handling of the tool prototypes (#364)
• Fix: Constructor Call Constraints (#369)
• Sequence Diagram deletion does not preserve control-flow constraints (#353)

This release includes a number of major new features, improvements to the graphical user interface, refactorings, and bug fixes.

New Features

• Support for Constructor Calls in Sequence Diagrams (#269): It is now possible to include constructor calls in sequences diagrams by drawing a call edge to the top box of an implicit parameter node .

• Attach/Detach Existing Nodes to/from Packages (#140): In a class diagram, nodes that are not children of a package node can be attached to this package node by tapping the Shift key. Conversely, if the selected node is the child of a package node, tapping the Shift key will detach it from its parent node. In the case of multiple-selection, the action only has an effect if it can apply to all selected nodes.

• Duplicate Diagram Feature (#150): It is now possible to create a duplicate of a diagram into a new tab. See File | Duplicate.

• UTF-8 Encoding of diagrams (#304): Diagrams are now encoded in UTF-8. Please see Issue #304 for a discussion of potential backward compatibility implications.

Improvements to the Graphical User Interface

• Shortcut Keys for Diagram Tools (#321): The toolbar elements can now be accessed using the keys through 1-9, A... where each shortcut key corresponds to the tool's position in the toolbar.
• New Icons (#330): We modernized the look with a new icon set.

Bug Fixes

• Fixed the AssertionError when dragging past the fame boundaries (#318).
• The package node now supports the drawing with multiple depths (#319).
• Documented an unusual application crash due to JavaFX bug (#324).
• Moving parent node through its child nodes is now bounded within the canvas (#327).
• Removed extra diagram type suffix in the file name (#331).
• Elements being moved as well as the created new node are now always on top of others (#142, #333).
• Child nodes are now staggered when copy-pasted (#338).
• Resolved the unusual behavior when moving a package node through its child nodes. The package node now wraps tightly around its child nodes (#340).

Code Refactoring

• Changed the representation of the diagram types from inheritance to the statically scoped enum type (#326).
• Refactored the node hierarchy to avoid unnecessary downcasting (#337).
• Handled the geometric calculation issue in different systems (#346).

This release comprises mostly internal improvements to simplify the design and improve the run-time performance of the diagram drawing operations. A major outcome of this refactoring is the complete decoupling of the logical diagram representation from the GUI framework.

User-visible changes include:

• Adding installation instructions for Java versions above 8 (#310)
• Fixing a bug which caused some labels in sequence diagrams to be clipped when exported (#316)

This release features a number of minor improvements to the UI as well as refactorings.

Improvements to the User Interface

• The Java version is no longer checked, which now allows users with previously-unrecognized versions to start the application.
• It is now possible to open diagrams larger than the current canvas size: the canvas is automatically increased to fit the new diagram.
• Added an "auto-edit" feature, activated through the View menu, which allows to automatically open the properties page for a node upon creation.
• The layout is slightly improved, scrollbars don't show up when they should not.
• The "dirty status" of a diagram, which controls whether a dialog asks for confirmation before closing, now takes into account the undo stack.
• The Ok button in the properties dialog is now the default button, which can be activated by pressing the "Enter" key.
• Bug fix: Exception when dragging after ctrl+click on selected node

Main Refactorings

• The test suite was migrated to JUnit 5
• The creation of tool icons was refactored
• The JSON library was stripped, leading to an even smaller application footprint.

Small bug fixes and improvements to the user interface.

• Nodes automatically snap to the grid;
• The last used directory is remembered between sessions;
• The last used image format for the export feature is remembered between sessions;
• The MacOS keybinding for Delete is fixed;
• The drawing and pasting of edges in sequence diagrams has been fixed/improved: there is more space between call eges to allow the edge labels to show more clearly, and edges draw in the correct order.
• Point nodes (used for note edges) can now be copied and pasted like any other node.
• Pasting a partial diagram now positions the pasted element relative to the copied elements, and staggers respective pastes.
• The look of object nodes in object diagram has been improved.

Release 2.2 features a major redesign of the code to support model-view-controller separation of diagram-related concerns. User-visible changes made possible by this refactoring include:

• Improved support for building Sequence diagrams
• Fix of a bug causing misalignment of object node names in Object diagrams

This release is a port to Java 10 that features many additional improvements to the graphical user interface that take advantage of the JavaFX capabilities.

Port to Java 10

JetUML 2.1 can now run on Java 10 while remaining backward-compatible to Java 8.

Changes to the file format

Due to rename refactorings that impact the encoding of diagrams in files, diagrams saved with prior versions of the application will not be compatible with JetUML 2.1 and subsequent releases.

Fixed sized diagrams

Diagrams now have a fixed size, i.e., not dependent on the window size. The diagram size can be set through the View | Diagram Size menu (this applies only to new diagrams). The diagram will become scrollable if the diagram tab is smaller than the diagram. The diagram will auto-scroll when user interactions involve invisible areas of the diagram.

Nicer diagrams

On most displays, the diagrams will look sharper, as the drawing code was modified to align element boundaries with pixels. Drop shadows are now rendered using JavaFX's API for a more seamless look.

New design for the Toolbar

The tool bar is now a proper toolbar graphical component. Resizing the application to a size smaller than the toolbar will automatically reveal a native expansion feature. The "tool hints" are now displayed directly on the button tools, if this option is enabled through the View menu.

Better management of View options

View options, accessed through the View menu, are available globally and automatically persisted for a user.

General improvements to the UI

The diagram canvas no longer shows a focus highlight. The license menu has been removed and replaced with a hyperlink in the Help | About dialog. The About dialog was modernized.

Allow selecting edges with the lasso selection tool

It is now possible to select edges using the lasso tool, even if their corresponding nodes are not selected.

Better support for dual monitors

Dialogs and context menus will now show up on the correct monitor.

Code redesign

The design of the code responsible for drawing diagrams and responding to user input on diagrams has been improved.

• Complete migration of the user interface to use the JavaFX library.
• Complete redesign of the graph persistence feature. Diagrams are now saved in JSON format. The new diagram persistence feature is not backward-compatible with previous versions. Graphs saved with JetUML versions older than 2.0.alpha will not load in JetUML 2.0.alpha or later.
• Slightly redesigned look for the Welcome Tab.
• Small bug fixes.

Please note that this release will not run properly with Java 10. The migration to Java 10 will be available in Release 2.1.