semorg.gui
Class SeminarTypeWindow

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

public class SeminarTypeWindow
extends Object

The window for editing new or existing SeminarType records.


Nested Class Summary
(package private)  class SeminarTypeWindow.InputChangedListener
          Inner class which provides a listener reacting on changes of the input in the SeminarTypeWindow window.
 
Field Summary
private  org.eclipse.swt.widgets.Button abortButton
           
private  org.eclipse.swt.widgets.Button applyButton
           
private  org.eclipse.swt.widgets.Text audienceText
           
private  org.eclipse.swt.widgets.Text chargeText
           
private  org.eclipse.swt.widgets.Text documentsText
           
private  org.eclipse.swt.widgets.Text durationText
           
private  SeminarType 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  SeminarTypeWindow.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  AssociationTabControl lecturerControl
           
private  org.eclipse.swt.widgets.Text maxEntrantsText
           
private  org.eclipse.swt.widgets.Text methodologyText
           
private  org.eclipse.swt.widgets.Text minEntrantsText
           
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.Text objectiveText
           
private  org.eclipse.swt.widgets.Button okButton
           
private  AssociationTabControl presentationControl
           
private  org.eclipse.swt.widgets.Button prevButton
          The triangle-button with the apex to the left.
private  org.eclipse.swt.widgets.Text requirementsText
           
private  org.eclipse.swt.widgets.Text routineText
           
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 shortTitleText
           
private  org.eclipse.swt.widgets.Text titleText
           
private  org.eclipse.swt.widgets.Text topicText
           
 
Constructor Summary
private SeminarTypeWindow(org.eclipse.swt.widgets.Shell parent)
          Creates a SeminarTypeWindow instance with the given shell as the parent shell.
  SeminarTypeWindow(org.eclipse.swt.widgets.Shell parent, SeminarType input, AssociationTabControl caller)
          Creates an instance of this class, sets the input and finally opens it.
  SeminarTypeWindow(org.eclipse.swt.widgets.Shell parent, SeminarType 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 CompanyInternalPresentation 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 SeminarType 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(AssociationTabControl caller)
          Adds a listener to several buttons of the window form.
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(SeminarType seminarType)
          Loads a given CompanyInternalPresentation 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 SeminarType 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 SeminarTypeWindow.InputChangedListener inputChangedListener
Listener instance added to the most elements of the window.


shell

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


numberLabel

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

numberText

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

shortTitleText

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

titleText

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

objectiveText

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

methodologyText

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

topicText

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

routineText

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

durationText

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

documentsText

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

audienceText

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

requirementsText

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

chargeText

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

maxEntrantsText

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

minEntrantsText

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

presentationControl

private AssociationTabControl presentationControl

lecturerControl

private AssociationTabControl lecturerControl

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

SeminarTypeWindow

private SeminarTypeWindow(org.eclipse.swt.widgets.Shell parent)
Creates a SeminarTypeWindow 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.

SeminarTypeWindow

public SeminarTypeWindow(org.eclipse.swt.widgets.Shell parent,
                         SeminarType input,
                         AssociationTabControl 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 AssociationTabControl instance which calls the constructor.

SeminarTypeWindow

public SeminarTypeWindow(org.eclipse.swt.widgets.Shell parent,
                         SeminarType 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(SeminarType seminarType)
Loads a given CompanyInternalPresentation record into the window form of initialize the elements of the form the empty string/null if no data is given.

Parameters:
seminarType - SeminarType instance 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(AssociationTabControl 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 - AssociationTabControl instance which called the constructor which itself calls this method.

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 CompanyInternalPresentation 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), Utility.isCorrectInteger(String)

commitInputToDB

protected void commitInputToDB()
Reads the data from the window form elements, sets the values to a SeminarType 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 handles 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(SeminarType).

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