de.must.markup

Class DataTableAdministration

java.lang.Object

de.must.markup.Dialog

de.must.markup.DataTableAdministration

All Implemented Interfaces:

Invokable

public abstract class DataTableAdministration
extends Dialog

Frame-like container to enclose input-output fields like text fields with database field association grid-like. Controls load and save actions. Used for property administration of a multiple database records. It is meant to contain several strorables like e.g. DataTextField.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ACTION_DELETE
protected DataObject	assignedDataObject
protected boolean	wantToBeFinalized

Fields inherited from class de.must.markup.Dialog

additionalButtons, backButton, cancelButton, NAME_FOR_BACK_ACTION, NAME_FOR_CANCEL_ACTION, NAME_FOR_CLOSE_ACTION, NAME_FOR_DIALOG_NBR, NAME_FOR_HELP_ACTION, NAME_FOR_LIST_ACTION, NAME_FOR_NEW_ENTRY_ACTION, NAME_FOR_OK_ACTION, okButton, processComplete, sessionData, stackMovement

Constructor Summary

Constructors

Constructor and Description
DataTableAdministration(SessionData sessionData) Constructs a new data property administration.

Method Summary

Modifier and Type	Method and Description
void	createDataTableModel() Creates a new data table model.
void	createDataTableModel(int sortIndexNbr) Creates a new data table model with the specified sort index number.
void	fetchValuesFromRequest(GeneralizedRequest request) Causes the invokable to delegate this function to all embedded markupables to fetch their current value as edited by the user from the request.
protected abstract DataObject	getAssignedDataObject() Returns the assigned data object.
protected java.lang.String[]	getColumnLabels() Returns the labels of the columns to be laid-out.
protected abstract java.lang.String[]	getColumnNames() Returns the names of the columns to be laid-out.
Identifier	getIdentifyValue(int row) Returns the identify value (primary key) of the entry in the row as specified.
java.lang.String	getInnerTableTagSequence() Returns the kernel default tag sequence.
Submission	getSubmission() Informs the next invokable in stack about the submission details.
java.lang.String	getTagSequence() Returns the default tag sequence (as HTML).
java.lang.String	getTitle() Returns the title of the property administration
void	handleSaveRequest() Handles save request.
void	init() Initializes the invokable in order to reuse the component without garbage from the previous use.
boolean	isCancelAllowed() Returns true if it is allowed to cancel the dialog.
boolean	isClosingAllowed() Returns true if it is allowed to close the dialog.
protected boolean	isInputAccepted() Returns true if user input is accepted.
protected abstract boolean	isInUse(Identifier keyIdentifier) Returns true if the entry as specified by the identifier is in use.
boolean	isModified() Returns true if input was modified.
boolean	isSuitableDialog(GeneralizedRequest request) Indicates whether the request fits to this dialog.
void	loadValues() Loads values into the grid.
void	markForDeletion(int row) Marks the entry in row as specified as to be deleted.
void	process(GeneralizedRequest request) Allows the invokable to react to the request.
boolean	saveValues() Saves values.
void	setSubmitter(Invokable submitter) Informs this invokable, from which previous invokable it is submitted.
void	setTitle(java.lang.String title) Sets the title of the property administration
boolean	wantToBeFinalized() Returns true if the invokable wants to be finalized after request is worked off.

Methods inherited from class de.must.markup.Dialog

afterOutput, appendAdditionalButton, beforeOutput, destroy, finalize, free, getAdditionalButtons, getBackButtonTagSequence, getCancelButtonTagSequence, getFooter, getHeader, getHelpContext, getInvokableInAdvance, getOkButtonTagSequence, getScriptToExecute, getScriptToExecuteSequence, getStackMovement, getSubTitle, isCancelable, isPost, setHelpContext, setHelpContext, setMessageToKeep, setMessageToKeepIfNotAlreadySet, setScriptToExecute, setStackMovement, setSubTitle

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ACTION_DELETE

public static final int ACTION_DELETE

See Also:

Constant Field Values

assignedDataObject

protected DataObject assignedDataObject

wantToBeFinalized

protected boolean wantToBeFinalized

Constructor Detail

DataTableAdministration

public DataTableAdministration(SessionData sessionData)

Constructs a new data property administration.

Parameters:

sessionData - the session's public data

Method Detail

init

public void init()

Initializes the invokable in order to reuse the component without garbage from the previous use.

Specified by:

init in interface Invokable

Overrides:

init in class Dialog

setTitle

public void setTitle(java.lang.String title)

Sets the title of the property administration

Overrides:

setTitle in class Dialog

Parameters:

title - the title of the property administration

getTitle

public java.lang.String getTitle()

Returns the title of the property administration

Overrides:

getTitle in class Dialog

Returns:

the title of the property administration

setSubmitter

public void setSubmitter(Invokable submitter)

Informs this invokable, from which previous invokable it is submitted. Technique to establish a bilateral communication between invokables.

Parameters:

submitter - the invokable that submitted this invokable

getSubmission

public Submission getSubmission()

Informs the next invokable in stack about the submission details. E.g. a PropertyAdminstration may call this method to receive the primary key of the entry to be edited.

Returns:

the submission details

wantToBeFinalized

public boolean wantToBeFinalized()

Returns true if the invokable wants to be finalized after request is worked off.

Returns:

true if the invokable wants to be finalized

getAssignedDataObject

protected abstract DataObject getAssignedDataObject()

Returns the assigned data object.

Returns:

the assigned data object

getColumnNames

protected abstract java.lang.String[] getColumnNames()

Returns the names of the columns to be laid-out.

Returns:

the names of the columns to be laid-out

getColumnLabels

protected java.lang.String[] getColumnLabels()

Returns the labels of the columns to be laid-out.

Returns:

the labels of the columns to be laid-out

isInUse

protected abstract boolean isInUse(Identifier keyIdentifier)

Returns true if the entry as specified by the identifier is in use.

Parameters:

keyIdentifier - the identifier of the entry to be checked

Returns:

true if the entry is in use

isCancelAllowed

public boolean isCancelAllowed()

Returns true if it is allowed to cancel the dialog.

Returns:

true if it is allowed to cancel the dialog

isClosingAllowed

public boolean isClosingAllowed()

Returns true if it is allowed to close the dialog.

Returns:

true if it is allowed to close the dialog

createDataTableModel

public void createDataTableModel()

Creates a new data table model.

createDataTableModel

public void createDataTableModel(int sortIndexNbr)

Creates a new data table model with the specified sort index number.

Parameters:

sortIndexNbr - the index of the index (object de.must.dataobj.Index) to be used for the order by clause.

loadValues

public void loadValues()

Loads values into the grid.

getIdentifyValue

public Identifier getIdentifyValue(int row)

Returns the identify value (primary key) of the entry in the row as specified.

Parameters:

row - the row of the watched entry

Returns:

the identify value of the entry

getTagSequence

public java.lang.String getTagSequence()

Returns the default tag sequence (as HTML). Normally you should not call this method directly. Use Layout implementing classes instead.

Returns:

the default tag sequence (as HTML)

See Also:

Layout

getInnerTableTagSequence

public java.lang.String getInnerTableTagSequence()

Returns the kernel default tag sequence. Normally you should not call this method directly. Use Layout implementing classes instead.

Returns:

the default tag sequence (as HTML)

See Also:

Layout

isSuitableDialog

public boolean isSuitableDialog(GeneralizedRequest request)

Indicates whether the request fits to this dialog. Useful to stop the user to use any back functions of the browser.

Specified by:

isSuitableDialog in interface Invokable

Overrides:

isSuitableDialog in class Dialog

Parameters:

request - the request to check

Returns:

true if the request fits to this dialog

process

public void process(GeneralizedRequest request)

Allows the invokable to react to the request. Sample: saving data when Ok button was pressed.

Specified by:

process in interface Invokable

Overrides:

process in class Dialog

Parameters:

request - the requeset to react to

fetchValuesFromRequest

public void fetchValuesFromRequest(GeneralizedRequest request)

Causes the invokable to delegate this function to all embedded markupables to fetch their current value as edited by the user from the request.

Specified by:

fetchValuesFromRequest in interface Invokable

Overrides:

fetchValuesFromRequest in class Dialog

Parameters:

request - the request from where the values are to be fetched

See Also:

Markupable#fetchYourValueFromRequest

markForDeletion

public void markForDeletion(int row)

Marks the entry in row as specified as to be deleted.

Parameters:

row - the row of the entry to be deleted

handleSaveRequest

public void handleSaveRequest()

Handles save request.

isInputAccepted

protected boolean isInputAccepted()

Returns true if user input is accepted.

Returns:

true if user input is accepted

saveValues

public boolean saveValues()

Saves values.

Returns:

true if changes occurred.

isModified

public boolean isModified()

Returns true if input was modified.

Returns:

true if input was modified.