Language

Command Dispatcher

Frame (Index), No frame                 version:0.3(latest)  

Field	Description
currentCommandId	private int currentCommandId Sets the current command Id.
previousCommandId	private int previousCommandId Sets the previous command Id.
activeCreateShapeLS	public CreateShapeLS activeCreateShapeLS Sets the activated CreateShapeLS object. This field is used for cancelling the activated CreateShapeLS object. =>The forced termination of the CreateShapeLS
clickedPoint	Point2D clickedPoint Sets the clicked point. Currently, this field is referred to specify the paste position (getPastePosition method of the Edit). This field is set by the CLICKEDPOINT command generated by the prepareClickedPointCommand method of the SelectionLS.

Method	Description
exec	public void exec(Command command) Gets the commandId from the parameter and dispatches the command. =>The list of command dispatch ∙ If the "creating a shape" command didn't performed normally, then aborts the "creating a shape" command. =>The forced termination of the CreateShapeLS
getCurrentCommandId	public int getCurrentCommandId() Returns the currentCommandId.
setCurrentCommandId	pupublic void setCurrentCommandId(int commandId) Sets the parameter to the currentCommandId.
getPreviousCommandId	public int getPreviousCommandId() Returns the previousCommandId.
setPreviousCommandId	public void setPreviousCommandId(int commandId) Sets the parameter to the previousCommandId.
getClickedPoint	public Point2D getClickedPoint() Returns the clickedPoint.

: The forced termination of the CreateShapeLS

When a shape button is clicked on the toolbar, the creatingStart method of the CreateShapeLS registers the the CreateShapeLS to the ListenerPanel as a MouseListener and MouseMotionListener. Then the CreateShapeLS r eceives the mouse motion and creates a shape object. And when the CreateShapeLS ends normally or abnormally, the creatingEnd method removes the CreateShapeLS from the ListenerPanel. This is the outline of creating a shape process (=> CreateShapeLS Control flow).

What happens if a shape button is clicked and then other button is clicked continuously without the mouse drag or mouse click?
In this case, the CreateShapeLS remains on the ListenerPanel as a MouseListener and MouseMotionListener, and it may cause unnecessary operations. So, the CreateShapeLS must be terminated forcibly.

To terminate the CreateShapeLS forcibly, the variable activeCreateShapeLS is set up in the ExecCommand and the abort method is implemented in the CreateShapeLS. When a shape button is clicked, the CreateShapeLS object is assigned to the activeCreateShapeLS. On the other hand, the exec method of the ExecCommand always checks whether the activeCreateShapeLS is null or not. If not and the current command is unrelated to the previous shape creating command, then calls the abort method and assigns null to the activeCreateShapeLS.

Method	Description
addTextBox	public void addTextBox(ShapeContainer[] containers) Parameters: containers - ShapeContainer objects. Processing: Calls the ShapeContainer.addTextBox and sets undo setting for the operation.
deleteTextBox	public void deleteTextBox(ShapeContainer[] containers) Parameters: containers - ShapeContainer objects. Processing: Calls the ShapeContainer.deleteTextBox and sets undo setting for the operation.
checkTextBox	private int checkTextBox(ShapeContainer[] containers, String operation) Parameters: containers - ShapeContainer objects. operation - "add", "delete" and so on. Processing: This method is called addTextBox and deleteTextBox methods of this class to check whether each of the containers is suitable to have a text box or not.
setFontStyle	public void setFontStyle(FontStyle fontStyle) This method calls the setFontStyle method of the TextBox. : This method does the undo setup.
setTextBoxLayout	public void setTextBoxLayout(Insets textBoxInsets, int textAlign, double lineSpace) Parameters: textBoxInsets - This parameter corresponds to textBoxInsets the TextBox. textAlign - This parameter corresponds to textAlign the TextBox. lineSpace - This parameter corresponds to lineSpace the TextBox. Processing: This method calls the setTextBoxLayout method of the TextBox. : This method does the undo setup.
moveZorder	public void moveZorder(int mode) Parameters: mode=0 - move to front mode=1 - move to back mode=2 - move foreward mode=3 - move backward Processing: Changes the Z order of the selected shapes by using the addContainer, deleteContainer and swapContainers methods of the ContainerManager :This method does the undo setup.
aligns	public void aligns(int mode) Parameters: mode=0 - Aligns_left mode=1 - Aligns_center mode=2 - :Aligns_right mode=3 - Aligns_top mode=4 - Aligns_middle mode= 5 - Aligns_bottom Processing: Aligns the selected shapes by the resizeContainer method of the ConnectionUtil. : The undo setup is done in the resizeContainer method.

Press the mouse right button, then the popup menu will be shown. The type of the popup menu is depend on the location where the mouse right button is pressed.
∙ On a single shape object or its boundary -> The ShapePopupMenu will be shown.
∙ On a group object or the boundaries of the grouped shapes -> The GroupPopupMenu will be shown.
∙ On the empty place -> The DrawPanelPopupMenu will be shown.
The DrawPanelPopupMenu shows the list of the shape objects or the mouse listeners on the ListenerPanel, mainly for debug.

(a)clicks the right mouse button on the selected shape.	(b)Selects a text box of a shape and clicks the right mouse button.	(c)Clicks the right mouse button on the display panel.	(d)DialogOfShapeFormat dialog
Figure 5.1 The pop up menu and the shape Format dialog (DialogOfShapeFormat)

Method	Description
show	public void show(MouseEvent e) The popup menu is shown according to the returned value (menuType) of the getCase method. ∙ menuType=0 Gets the PopupPulldownMenu whose command name is "DRAWPANEL_POPUP_MENU" by the getMenuComponent method of the MenuUtil and calls the show method of the PopupPulldownMenu. ∙ menuType=1 Gets the PopupPulldownMenu whose command name is "SHAPE_POPUP_MENU" and calls the show method. According to the type of the selected shape, sets "enable/disable" to some of the menu items of the PopupPulldownMenu. Round rectangle Line Text box ∙ menuType=2 Gets the PopupPulldownMenu whose command name is "GROUP_POPUP_MENU" and calls the show method.
getCase	private int getCase() Returns: Returns the mouse hit information. 0 - The mouse hits nothing. 1 - The mouse hits a single shape object. 2 - The mouse hits a group shape object. 3 - The mouse hits a text box of a single/group shape object. Processing: Gets the MousePositionInfo object by the getMousePositionInfoForSelection method of the MousePositionLS and returns the code.

Command	Description
File (NEW, OPEN, SAVE, SAVE, SAVEAS)	Calls the FileIo.fileNew, FileIo.fileOpen, FileIo.fileSave or FileIo.fileSaveAs method.
Page setup (NEXT_PAGE, PREVIOUS_PAGE, INSERT_NEW_PAGE, DELETE_PAGE, PAGE_SETUP, PAGE_LAYOUT)	The command is specified by the item of the pull down menu or the button. ∙ Specified by the pulldown menu of "Page" The action command of the selected menu item is passed by the parameter (params). So dispatches by the action command and calls the corresponding method such as pageManager.showNextPage, pageManager.showPreviousPage, ........., DialogOfPageSetup.showDialog or DialogOfPageLayout.showDialog. ∙ Specified by the buttons. Dispatches the PREVIOUS_PAGE, INSERT_NEW_PAGE or DELETE_PAGE command by the commandId.
Print (PRINT)	Calls the FileIo.printOut method.
Editing (CUT, COPY, PASTE, DELETE, SELECT_ALL)	The command is specified by the item of the pull down menu or the button. Calls Edit.cut, Edit.copy, Edit.paste or Edit.delete method. For SELECT_ALL, gets all the ShapeContainer objects and calls their setSelected(true) methods.
undo, redo (UNDO, REDO)	Calls the undo or redo of the UndoDrawManager.
Creating shape (TEXT_BOX, RECTANGLE, ROUND_RECTANGLE, ELLIPSE, LINE, ARROW, DOUBLE_ARROW, POLYLINE, CUBIC_CURVE, COMPONENT_SHAPE)	Creates the new CreateShapeLS object and calls its creatingStart method. => CreateShapeLS Control flow of creating a shape, Serious errors in CreatShapeLS
Component library (LIB)	Create a new ComponentLibDialog object and calls the showDialog method.
Moving/Resizing shape (MOVE, RESIZE)	This command is issued by the prepareMoveResizeCommand method of the SelectionLS. =>Control flow of moving/resizing And the resize command is also issued by the ShapeFormatAction which perform the action of the DialogOfShapeFormat object. In this case, calls the resizeContainer method of the ConnectionUtil.
Add text box /Delete Text box / Manipulating shape (ADD_TEXT_BOX, DELETE_TEXT_BOX, TRANSLATE, ROTATE, FLIP, MODIFY_SHAPE, CUT_SHAPE, CONNECT_CURVES)	Calls the following methods. ∙ ADD_TEXT_BOX: Calls the ShapeContainer.addTextBox through ExecCommandUtil.addTextBox method. ∙ DELETE_TEXT_BOX: Calls the ShapeContainer.deleteTextBox method through ExecCommandUtil.deleteTextBox method ∙ TRANSLATE: Creates a new Translate object and calls the showDialog method. ∙ ROTATE: Creates a new Rotate object and calls the showDialog method. ∙ FLIP: Creates a new Flip object and calls the showDialog method. ∙ MODIFY_SHAPE: Creates a new ModifyShape object and calls the showDialog method. ∙ CUT_SHAPE: Creates a new CutShape object and calls the showDialog method. ∙ CONNECT_CURVES: Creates a new ConnectCurves object and calls the showDialog method.
Setting (AUTO_ALIGN, ENABLE_CONNECTOR, DRAW_NODE_POINTS)	Sets the states of the menu items to the corresponding fields of the Drawparameters.
Information (SHAPE_FORMAT, DRAW_PANEL_INFORMATION)	Calls the following methods. ∙ SHAPE_FORMAT: Creates a new DialogOfShapeFormat object and calls the showDialog method. ∙ DRAW_PANEL_INFORMATION: Creates a new DialogOfShapeFormat object and calls the showDialog method.
Font attribute (FONT_FAMILY, FONT_SIZE, FONT_COLOR, BOLD, ITALIC, UNDERLINE, SUBSCRIPT/SUPERSCRIPT )	Gets the FontStyle object from the font menu by the getFontStyleFromMenu of the FontStyle method and calls the ExecCommandUtil.setFontStyle methodl.
Text box (TEXTBOX_LAYOUT, TEXT_ALIGN)	Calls the ExecCommandUtil.setTextBoxLayout method.
Shape attribute (FILL_COLOR, LINE_COLOR, LINE_WIDTH, LINE_STROKE, ARROW_STYLE)	Calls the corresponding method such as setFillColor, setLineStroke,..... of the ShapeContainer.
Z-order (MOVE_TO_FRONT, MOVE_TO_BACK, MOVE_FORWARD, MOVE_BACKWARD)	Calls the ExecCommandUtil.moveZorder method.
Align (ALIGN_LEFT, ALIGN_CENTER, ALIGN_RIGHT, ALIGN_TOP, ALIGN_MIDDLE, ALIGN_BOTTOM)	Calls the ExecCommandUtil.align method..
Group (GROUP, UNGROUP)	∙ GROUP: Calls the group method of the ContainerManager. ∙ UNGROUP: Calls the ungroup method of the ContainerManager.
Zoom (ZOOM, ZOOM_TO)	∙ ZOOM: Creates a new DialogOfZoom object and calls the showDialog method. ∙ ZOOM_TO: Calls the zoom method of the ViewUtil.