semorg.gui
Class CompanyWindow

java.lang.Object
  extended by semorg.gui.CompanyWindow

public class CompanyWindow
extends Object

The window for editing new or existing company records.


Nested Class Summary
(package private)  class CompanyWindow.InputChangedListener
          Inner class which provides a listener reacting on changes of the input in the CompanyWindow window.
 
Field Summary
private  org.eclipse.swt.widgets.Button abortButton
           
private  org.eclipse.swt.widgets.Combo annexCombo
           
private  org.eclipse.swt.widgets.Button applyButton
           
private  AssociationTabControl bookingsControl
          The control widget to manage the association between Company and Booking (and its subclasses).
private  org.eclipse.swt.widgets.Text cityText
           
private  org.eclipse.swt.widgets.Combo countryCombo
           
private  CalendarControl cpBirthDayCalendar
           
private  org.eclipse.swt.widgets.Text cpDepartmentText
           
private  org.eclipse.swt.widgets.Text cpEmailText
           
private  org.eclipse.swt.widgets.Text cpFaxText
           
private  org.eclipse.swt.widgets.Text cpFirstNameText
           
private  org.eclipse.swt.widgets.Text cpMobileText
           
private  org.eclipse.swt.widgets.Text cpNameText
           
private  org.eclipse.swt.widgets.Text cpPhoneText
           
private  org.eclipse.swt.widgets.Combo cpSalutationCombo
           
private  org.eclipse.swt.widgets.Text cpTaskText
           
private  org.eclipse.swt.widgets.Combo cpTitleCombo
           
private  CalendarControl customerSinceCalendar
           
private  org.eclipse.swt.widgets.Text emailText
           
private  AssociationTabControl employeeControl
          The control widget to manage the association employee between Client and Company.
private  org.eclipse.swt.widgets.Text faxText
           
private  org.eclipse.swt.widgets.Text firstNameText
           
private  Company input
          Holds the data of the actual displayed data record.
private  boolean inputChanged
          Is set to true if the input has been changed and not committed yet, otherwise it is set to false.
private  CompanyWindow.InputChangedListener inputChangedListener
          Listener instance added to the most elements of the window.
private  boolean inputEditingEnabled
          true if the editing of the input (i.e. the elements of the form) has been enabled, otherwise it is false.
private  org.eclipse.swt.widgets.Text memoText
           
private  org.eclipse.swt.widgets.Text mobileText
           
private  org.eclipse.swt.widgets.Text nameText
           
private  org.eclipse.swt.widgets.Button newButton
           
private  org.eclipse.swt.widgets.Button nextButton
          The triangle-button with the apex to the right.
private  org.eclipse.swt.widgets.Label numberLabel
           
private  org.eclipse.swt.widgets.Text numberText
           
private  org.eclipse.swt.widgets.Button okButton
           
private  org.eclipse.swt.widgets.Text phoneText
           
private  org.eclipse.swt.widgets.Button prevButton
          The triangle-button with the apex to the left.
private  org.eclipse.swt.widgets.Combo salutationCombo
           
private  boolean settingInput
          Is set to true if the data from the database (or corresponding from input) is to be set into the window form, otherwise false.
private  org.eclipse.swt.widgets.Shell shell
          The editing window.
private  org.eclipse.swt.widgets.Text shortMessageText
           
private  org.eclipse.swt.widgets.Text shortNameText
           
private  org.eclipse.swt.widgets.Text streetText
           
private  int titleBarHeight
           
private  org.eclipse.swt.widgets.Combo titleCombo
           
private  org.eclipse.swt.widgets.Text turnoverText
           
private  org.eclipse.swt.widgets.Text zipCodeText
           
 
Constructor Summary
private CompanyWindow(org.eclipse.swt.widgets.Shell parent)
          Creates a CompanyWindow instance with the given shell as the parent shell.
  CompanyWindow(org.eclipse.swt.widgets.Shell parent, Company input, ForeignKeyConstraintSelector caller)
          Creates an instance of this class, sets the input and finally opens it.
 
Method Summary
protected  boolean checkInput()
          Checks if all obligatory attributes of a Company record are entered into the window form and if the entered fees are correct float numbers.
protected  void commitInputToDB()
          Reads the data from the window form elements, sets the values to a Company instance and commits the changes / the new record into the database.
private  boolean confirmClose()
          Creates a message dialog if the data in the window form has been changed (or was entered newly) and these changes haven't been confirmed (e.g. by clicking the ok button) or discarded so far.
private  void createButtonListener(ForeignKeyConstraintSelector caller)
          Adds a listener to several buttons of the window form.
private  boolean onSave()
          Checks whether the input has been changed (i.e. inputChanged equals true) or not.
private  void setInput(Company company)
          Loads a given client record into the window form of initialize the elements of the form the empty string/null if no data is given.
private  void setInputComponentsEnabled(boolean enabled)
          According to the value of the given parameter (true/false) this method enables / disables the widgets of the window form.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

input

private Company input
Holds the data of the actual displayed data record. If a new record is entered it is set to null until the changes have been committed.


settingInput

private boolean settingInput
Is set to true if the data from the database (or corresponding from input) is to be set into the window form, otherwise false.

That is needed to prevent the ModifyListener from firing when the data is load into the window form by using the .setText() methods of the GUI elements.


inputChanged

private boolean inputChanged
Is set to true if the input has been changed and not committed yet, otherwise it is set to false.


inputEditingEnabled

private boolean inputEditingEnabled
true if the editing of the input (i.e. the elements of the form) has been enabled, otherwise it is false.

This flag indicates whether the actual displayed record has been locked by the actual editing window or not. This avoids the releasing of records which are locked by other editing windows.


inputChangedListener

private CompanyWindow.InputChangedListener inputChangedListener
Listener instance added to the most elements of the window.


shell

private org.eclipse.swt.widgets.Shell shell
The editing window.


titleBarHeight

private int titleBarHeight

numberLabel

private final org.eclipse.swt.widgets.Label numberLabel

numberText

private final org.eclipse.swt.widgets.Text numberText

shortNameText

private final org.eclipse.swt.widgets.Text shortNameText

salutationCombo

private final org.eclipse.swt.widgets.Combo salutationCombo

titleCombo

private final org.eclipse.swt.widgets.Combo titleCombo

firstNameText

private final org.eclipse.swt.widgets.Text firstNameText

nameText

private final org.eclipse.swt.widgets.Text nameText

streetText

private final org.eclipse.swt.widgets.Text streetText

zipCodeText

private final org.eclipse.swt.widgets.Text zipCodeText

cityText

private final org.eclipse.swt.widgets.Text cityText

countryCombo

private final org.eclipse.swt.widgets.Combo countryCombo

annexCombo

private final org.eclipse.swt.widgets.Combo annexCombo

phoneText

private final org.eclipse.swt.widgets.Text phoneText

mobileText

private final org.eclipse.swt.widgets.Text mobileText

faxText

private final org.eclipse.swt.widgets.Text faxText

emailText

private final org.eclipse.swt.widgets.Text emailText

cpSalutationCombo

private final org.eclipse.swt.widgets.Combo cpSalutationCombo

cpTitleCombo

private final org.eclipse.swt.widgets.Combo cpTitleCombo

cpFirstNameText

private final org.eclipse.swt.widgets.Text cpFirstNameText

cpNameText

private final org.eclipse.swt.widgets.Text cpNameText

cpPhoneText

private final org.eclipse.swt.widgets.Text cpPhoneText

cpMobileText

private final org.eclipse.swt.widgets.Text cpMobileText

cpFaxText

private final org.eclipse.swt.widgets.Text cpFaxText

cpEmailText

private final org.eclipse.swt.widgets.Text cpEmailText

cpDepartmentText

private final org.eclipse.swt.widgets.Text cpDepartmentText

cpTaskText

private final org.eclipse.swt.widgets.Text cpTaskText

customerSinceCalendar

private final CalendarControl customerSinceCalendar

cpBirthDayCalendar

private final CalendarControl cpBirthDayCalendar

turnoverText

private final org.eclipse.swt.widgets.Text turnoverText

shortMessageText

private final org.eclipse.swt.widgets.Text shortMessageText

memoText

private final org.eclipse.swt.widgets.Text memoText

employeeControl

private AssociationTabControl employeeControl
The control widget to manage the association employee between Client and Company.


bookingsControl

private AssociationTabControl bookingsControl
The control widget to manage the association between Company and Booking (and its subclasses).


okButton

private final org.eclipse.swt.widgets.Button okButton

applyButton

private final org.eclipse.swt.widgets.Button applyButton

newButton

private final org.eclipse.swt.widgets.Button newButton

abortButton

private final org.eclipse.swt.widgets.Button abortButton

prevButton

private final org.eclipse.swt.widgets.Button prevButton
The triangle-button with the apex to the left.


nextButton

private final org.eclipse.swt.widgets.Button nextButton
The triangle-button with the apex to the right.

Constructor Detail

CompanyWindow

private CompanyWindow(org.eclipse.swt.widgets.Shell parent)
Creates a CompanyWindow instance with the given shell as the parent shell.

It also adds a listener which reacts on closing events. It checks if changes have been made and if so it opens a dialog which informs the user and asks for a decision (confirm/discard). Finally it releases the locked record (if one is displayed and it is locked by this editing window).

Parameters:
parent - Shell instance used the as parent shell of the window.

CompanyWindow

public CompanyWindow(org.eclipse.swt.widgets.Shell parent,
                     Company input,
                     ForeignKeyConstraintSelector caller)
Creates an instance of this class, sets the input and finally opens it.

Parameters:
parent - the parent shell to which this window belongs
input - the data object to be displayed in the window
caller - the ForeignKeyConstraintSelector instance which calls the constructor.
Method Detail

setInput

private void setInput(Company company)
Loads a given client record into the window form of initialize the elements of the form the empty string/null if no data is given.

Parameters:
company - object which contains the data to be displayed or null if a completely new record is to be edited.

setInputComponentsEnabled

private void setInputComponentsEnabled(boolean enabled)
According to the value of the given parameter (true/false) this method enables / disables the widgets of the window form.

Note: It also sets the member inputEditingEnabled to the value of the parameter to signal that editing of the input has been enabled or not.

Parameters:
enabled - if equals true the widgets are enabled otherwise the widgets get disabled.

createButtonListener

private void createButtonListener(ForeignKeyConstraintSelector caller)
Adds a listener to several buttons of the window form.

This involves at the moment the buttons okButton, abortButton, applyButton, newButton, prevButton, nextButton.

Parameters:
caller - ForeignKeyConstraintSelector instance which called the constructor which itself calls this method.

checkInput

protected boolean checkInput()
Checks if all obligatory attributes of a Company record are entered into the window form and if the entered fees are correct float numbers.

Returns:
true if all mandatory fields are set and the fee values are valid float numbers (if entered), otherwise false.
See Also:
Utility.isCorrectFloat(String)

commitInputToDB

protected void commitInputToDB()
Reads the data from the window form elements, sets the values to a Company instance and commits the changes / the new record into the database. Furthermore the member input is set to the new values.


confirmClose

private boolean confirmClose()
Creates a message dialog if the data in the window form has been changed (or was entered newly) and these changes haven't been confirmed (e.g. by clicking the ok button) or discarded so far. It also receives the decision of the user (confirm/discard changes or abort the window closing) and handels it. In the positive case (confirmation of the changes) it invokes the method onSave().

Returns:
true if the shell can be closed and false otherwise.

onSave

private boolean onSave()
Checks whether the input has been changed (i.e. inputChanged equals true) or not. If changes have been done, it firstly checks if the changes are valid (checkInput()), secondly invokes the method commitInputToDB() to commit the changes and thirdly updates the GUI by invoking the method setInput(Company).

Returns:
true if nothing has changed or the commit of the changes to the database was successful, false otherwise.