de.must.markup

Class DataPropertyPresentation

java.lang.Object

de.must.markup.Dialog

de.must.markup.PropertyPresentation

de.must.markup.DataPropertyPresentation

All Implemented Interfaces:

Invokable

public abstract class DataPropertyPresentation
extends PropertyPresentation

Frame-like container to enclose data presenting components with database field association and controlling load action. Is used for delete confirmation as well. Used for property presentation of a single database record. It is meant to contain several markupables like e.g. DataTextPresenter

Field Summary

Fields

Modifier and Type	Field and Description
protected DataObject	mainDataObject
static int	MODE_DELETE
static int	MODE_SHOW
static int	NEW_LINE
static int	STAY_IN_LINE

Fields inherited from class de.must.markup.PropertyPresentation

currentAttributeList, dialogNbr, 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
DataPropertyPresentation(DataObject mainDataObject, SessionData sessionData) Constructs a new data property presentation.

Method Summary

Modifier and Type	Method and Description
protected void	append(java.lang.String StringToAppend) Appends a string to the same line as previously used.
protected DataBoolPresenter	createBoolPresenter(java.lang.String checkText, java.lang.String assignedColumnName) Creates a database connected boolean presentation field in the same line as previously used.
protected DataBoolPresenter	createBoolPresenter(java.lang.String label, java.lang.String checkText, java.lang.String assignedColumnName) Creates a database connected boolean presentation field in a new line with its describing label.
protected DataDatePresenter	createDatePresenter(java.lang.String name) Creates a database connected date presentation field in a the same line as previously used.
protected DataDatePresenter	createDatePresenter(java.lang.String label, java.lang.String name) Creates a database connected date presentation field in a new line with its describing label.
protected DataDecimalPresenter	createDecimalPresenter(java.lang.String name) Creates a database connected decimal presentation field in the same line as previously used.
protected DataDecimalPresenter	createDecimalPresenter(java.lang.String label, java.lang.String name) Creates a database connected decimal presentation field in the same line as previously used.
protected DataImageViewer	createImagePresenter(java.lang.String loadDirectory) Creates a database connected image presentation field.
protected DataImageViewer	createImagePresenter(java.lang.String label, java.lang.String loadDirectory) Creates a database connected image presentation field in a new line with its describing label.
protected DataIntPresenter	createIntPresenter(java.lang.String name) Creates a database connected integer presentation field in the same line as previously used.
protected DataIntPresenter	createIntPresenter(java.lang.String label, java.lang.String name) Creates a database connected integer presentation field in the same line as previously used.
protected DataLinkPresenter	createLinkPresenter(java.lang.String name) Creates a database connected link presentation field in the same line as previously used.
protected DataLinkPresenter	createLinkPresenter(java.lang.String label, java.lang.String name) Creates a database connected link presentation field in a new line with its describing label.
protected DataReferencePresenter	createReferencePresenter(java.lang.String label, java.lang.String assignedColumnName, DataObject referenceDataObject, java.lang.String presentableColumnName) Creates a database connected reference presentation field in a new line with its describing label.
protected DataReferencePresenter	createReferencePresenter(java.lang.String label, java.lang.String assignedColumnName, java.lang.String[][] content) Creates a database connected reference presentation field in a new line with its describing label.
protected DataTextPresenter	createTextPresenter(java.lang.String name) Creates a database connected text presentation field in the same line as previously used.
protected DataTextPresenter	createTextPresenter(java.lang.String label, java.lang.String name) Creates a database connected text presentation field in a new line with its describing label.
java.lang.String	getEntryDescription() Returns the description of the presented entry.
HelpContext	getHelpContext() Returns the component's help context.
int	getMode() Returns the mode which may be MODE_SHOW or MODE_DELETE
Submission	getSubmission() Returns the submission details for the next invokable in stack.
java.lang.String	getTagSequence() Returns the default tag sequence to represent the component in markup languages.
java.lang.String	getTitle() Returns the title of the property presentation
void	init() Initializes the invokable in order to reuse the component without garbage from the previous use.
boolean	isCancelToOffer() Returns true if the button cancel should be offered.
protected void	loadValues() Loads an entity specified by a primary key integer value.
protected void	newPanel(int lineCapacity) Dummy method - not supported yet.
protected void	newPanel(java.lang.String tabLabel, int lineCapacity) Dummy method - not supported yet.
void	process(GeneralizedRequest request) Allows the invokable to react to the request.
void	setDeleteHelpContext(java.lang.String helpTopic, java.lang.String helpTarget) Sets the component's special context help for delete confirmation use.
protected void	setFrameDisplayTitleField(DataTextField newFrameDisplayTitleField) Sets the title of the "frame" for display usage.
protected void	setFrameDisplayTitleField(DataTextField[] newFrameDisplayTitleFields) Sets the title of the "frame" for display usage.
void	setSubmitter(Invokable submitter) Sets the submitter of this dialog step.
protected void	setTabSize(int tabSize) Dummy method - not supported yet.
void	setTitle(java.lang.String title) Sets the title of the property presentation.
protected void	setToolTipText(java.lang.String toolTipText) Sets the tool tip text of the last used presentable.
boolean	wantToBeFinalized() Returns true if the invokable wants to be finalized after request is worked off.

Methods inherited from class de.must.markup.PropertyPresentation

fetchValuesFromRequest, getAttributeList

Methods inherited from class de.must.markup.Dialog

afterOutput, appendAdditionalButton, beforeOutput, destroy, finalize, free, getAdditionalButtons, getBackButtonTagSequence, getCancelButtonTagSequence, getFooter, getHeader, getInvokableInAdvance, getOkButtonTagSequence, getScriptToExecute, getScriptToExecuteSequence, getStackMovement, getSubTitle, isCancelable, isPost, isSuitableDialog, 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

NEW_LINE

public static final int NEW_LINE

See Also:

Constant Field Values

STAY_IN_LINE

public static final int STAY_IN_LINE

See Also:

Constant Field Values

MODE_SHOW

public static final int MODE_SHOW

See Also:

Constant Field Values

MODE_DELETE

public static final int MODE_DELETE

See Also:

Constant Field Values

mainDataObject

protected DataObject mainDataObject

Constructor Detail

DataPropertyPresentation

public DataPropertyPresentation(DataObject mainDataObject,
                                SessionData sessionData)

Constructs a new data property presentation.

Parameters:

mainDataObject - the data object that is to be used mainly

sessionData - the session's public data

Method Detail

setTitle

public void setTitle(java.lang.String title)

Sets the title of the property presentation.

Overrides:

setTitle in class Dialog

Parameters:

title - the title of the property presentation

getTitle

public java.lang.String getTitle()

Returns the title of the property presentation

Overrides:

getTitle in class Dialog

Returns:

the title of the property presentation

setDeleteHelpContext

public void setDeleteHelpContext(java.lang.String helpTopic,
                                 java.lang.String helpTarget)

Sets the component's special context help for delete confirmation use.

Parameters:

helpTopic - the delete confirmation context help's topic

helpTarget - the delete confirmation context help's target

getHelpContext

public HelpContext getHelpContext()

Returns the component's help context.

Overrides:

getHelpContext in class Dialog

Returns:

the component's help context

setSubmitter

public void setSubmitter(Invokable submitter)

Sets the submitter of this dialog step.

Parameters:

submitter - the calling submitter

setTabSize

protected void setTabSize(int tabSize)

Dummy method - not supported yet.

Parameters:

tabSize - the tab size - not supported yet

newPanel

protected void newPanel(int lineCapacity)

Dummy method - not supported yet.

Parameters:

lineCapacity - the line capacity - not supported yet

newPanel

protected void newPanel(java.lang.String tabLabel,
                        int lineCapacity)

Dummy method - not supported yet.

Parameters:

tabLabel - the tab label - not supported yet

lineCapacity - the line capacity - not supported yet

createTextPresenter

protected DataTextPresenter createTextPresenter(java.lang.String label,
                                                java.lang.String name)

Creates a database connected text presentation field in a new line with its describing label.

Parameters:

label - the description of the attribute line.

name - the name of the field which has to be the column name of the database table.

Returns:

the created text presentation field

createTextPresenter

protected DataTextPresenter createTextPresenter(java.lang.String name)

Creates a database connected text presentation field in the same line as previously used.

Parameters:

name - the name of the field which has to be the column name of the database table.

Returns:

the created text presentation field

createLinkPresenter

protected DataLinkPresenter createLinkPresenter(java.lang.String label,
                                                java.lang.String name)

Creates a database connected link presentation field in a new line with its describing label.

Parameters:

label - the description of the attribute line.

name - the name of the field which has to be the column name of the database table.

Returns:

the created text presentation field

createLinkPresenter

protected DataLinkPresenter createLinkPresenter(java.lang.String name)

Creates a database connected link presentation field in the same line as previously used.

Parameters:

name - the name of the field which has to be the column name of the database table.

Returns:

the created text presentation field

createIntPresenter

protected DataIntPresenter createIntPresenter(java.lang.String label,
                                              java.lang.String name)

Creates a database connected integer presentation field in the same line as previously used.

Parameters:

label - the description of the attribute line.

name - the name of the field which has to be the column name of the database table.

Returns:

the created integer presentation field

createIntPresenter

protected DataIntPresenter createIntPresenter(java.lang.String name)

Creates a database connected integer presentation field in the same line as previously used.

Parameters:

name - the name of the field which has to be the column name of the database table.

Returns:

the created integer presentation field

createDecimalPresenter

protected DataDecimalPresenter createDecimalPresenter(java.lang.String label,
                                                      java.lang.String name)

Creates a database connected decimal presentation field in the same line as previously used.

Parameters:

label - the description of the attribute line.

name - the name of the field which has to be the column name of the database table.

Returns:

the created decimal presentation field

createDecimalPresenter

protected DataDecimalPresenter createDecimalPresenter(java.lang.String name)

Creates a database connected decimal presentation field in the same line as previously used.

Parameters:

name - the name of the field which has to be the column name of the database table.

Returns:

the created decimal presentation field

createDatePresenter

protected DataDatePresenter createDatePresenter(java.lang.String label,
                                                java.lang.String name)

Creates a database connected date presentation field in a new line with its describing label.

Parameters:

label - the description of the attribute line.

name - the name of the field which has to be the column name of the database table.

Returns:

the created date presentation field

createDatePresenter

protected DataDatePresenter createDatePresenter(java.lang.String name)

Creates a database connected date presentation field in a the same line as previously used.

Parameters:

name - the name of the field which has to be the column name of the database table.

Returns:

the created date presentation field

createReferencePresenter

protected DataReferencePresenter createReferencePresenter(java.lang.String label,
                                                          java.lang.String assignedColumnName,
                                                          DataObject referenceDataObject,
                                                          java.lang.String presentableColumnName)

Creates a database connected reference presentation field in a new line with its describing label.

Parameters:

label - the description of the attribute line.

assignedColumnName - the name of the column to assign the reference

referenceDataObject - the reference (key) data object

presentableColumnName - the name of the column to be presented

Returns:

the created reference presentation field

createReferencePresenter

protected DataReferencePresenter createReferencePresenter(java.lang.String label,
                                                          java.lang.String assignedColumnName,
                                                          java.lang.String[][] content)

Creates a database connected reference presentation field in a new line with its describing label.

Parameters:

label - the description of the attribute line.

assignedColumnName - the name of the column to assign the reference

content - the static content of assign the reference

Returns:

the created reference presentation field

createBoolPresenter

protected DataBoolPresenter createBoolPresenter(java.lang.String label,
                                                java.lang.String checkText,
                                                java.lang.String assignedColumnName)

Creates a database connected boolean presentation field in a new line with its describing label.

Parameters:

label - the description of the attribute line.

checkText - the text to be presented if the value of the boolean presenter is true

assignedColumnName - the name of the field which has to be the column name of the database table

Returns:

the created boolean presentation field

createBoolPresenter

protected DataBoolPresenter createBoolPresenter(java.lang.String checkText,
                                                java.lang.String assignedColumnName)

Creates a database connected boolean presentation field in the same line as previously used.

Parameters:

checkText - the text to be presented if the value of the boolean presenter is true

assignedColumnName - the name of the field which has to be the column name of the database table

Returns:

the created boolean presentation field

createImagePresenter

protected DataImageViewer createImagePresenter(java.lang.String label,
                                               java.lang.String loadDirectory)

Creates a database connected image presentation field in a new line with its describing label.

Parameters:

label - the description of the attribute line.

loadDirectory - the directory from where the images are to be loaded.

Returns:

the created image presentation field

createImagePresenter

protected DataImageViewer createImagePresenter(java.lang.String loadDirectory)

Creates a database connected image presentation field.

Parameters:

loadDirectory - the directory from where the images are to be loaded.

Returns:

the created image presentation field

append

protected void append(java.lang.String StringToAppend)

Appends a string to the same line as previously used.

Parameters:

stringToAppend - the string to add

setToolTipText

protected void setToolTipText(java.lang.String toolTipText)

Sets the tool tip text of the last used presentable.

Parameters:

toolTipText - the presentable's tool tip text

setFrameDisplayTitleField

protected void setFrameDisplayTitleField(DataTextField newFrameDisplayTitleField)

Sets the title of the "frame" for display usage.

Parameters:

newFrameDisplayTitleField - the field to determine the for Display title

setFrameDisplayTitleField

protected void setFrameDisplayTitleField(DataTextField[] newFrameDisplayTitleFields)

Sets the title of the "frame" for display usage.

Parameters:

newFrameDisplayTitleFields - the fields to determine the for display title

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

getTagSequence

public java.lang.String getTagSequence()

Returns the default tag sequence to represent the component in markup languages.

Returns:

the default tag sequence to represent the component in markup languages

getEntryDescription

public java.lang.String getEntryDescription()

Returns the description of the presented entry.

Returns:

the description of the presented entry

isCancelToOffer

public boolean isCancelToOffer()

Returns true if the button cancel should be offered.

Returns:

true if the button cancel should be offered

getMode

public int getMode()

Returns the mode which may be MODE_SHOW or MODE_DELETE

Returns:

the mode

process

public void process(GeneralizedRequest request)

Allows the invokable to react to the request.

Specified by:

process in interface Invokable

Overrides:

process in class Dialog

Parameters:

the - request to react to

loadValues

protected void loadValues()

Loads an entity specified by a primary key integer value.

Parameters:

identifyValue - the primary key integer value.

getSubmission

public Submission getSubmission()

Returns the submission details for the next invokable in stack.

Returns:

the submission details

wantToBeFinalized

public boolean wantToBeFinalized()

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

Specified by:

wantToBeFinalized in interface Invokable

Overrides:

wantToBeFinalized in class PropertyPresentation

Returns:

true if the invokable wants to be finalized