de.must.appletserver

Class RemoteElement

java.lang.Object

de.must.appletserver.RemoteElement

All Implemented Interfaces:

AppletTalker, Remotable, RemoteContent, Exemptible, ExemptibleManager

Direct Known Subclasses:

CleartextClassification, DataList, ImageLoader, ImagePresenter, ImageViewer, MultChoice, MustCheckBox, MustComboBox, MustInputField, SearchElement, SmallImageChooser, TextPresenter, TwoListTransformer, UniversalTable

public abstract class RemoteElement
extends java.lang.Object
implements RemoteContent, ExemptibleManager

A pseudo-GUI element able to become visible remotely (by an applet).

Field Summary

Fields

Modifier and Type	Field and Description
protected Context	context
protected boolean	editable
protected boolean	enabled
protected boolean	lastEditability
protected boolean	lastVisibility
protected java.lang.String	name the name of the remote element to be identified for update
protected java.lang.String	nonstandardPanel
protected int	nonstandardPosition
protected SessionData	sessionData
protected java.lang.String	toolTipText
protected boolean	visible

Constructor Summary

Constructors

Constructor and Description
RemoteElement(SessionData sessionData) Constructs a new remote element without need to be identified for update.
RemoteElement(SessionData sessionData, java.lang.String name) Constructs a new remote element to be identified by name, e.g. to update it as one of several remote elements in an attribute list.

Method Summary

Modifier and Type	Method and Description
void	beginAction(ToAppletWriter out)
void	buildRemoteView(ToAppletWriter out) Build remote view.
void	endAction(ToAppletWriter out)
void	free() Releases external resources.
Context	getContext() Returns the remote element's context.
java.lang.String	getName() Returns the name of the input field.
protected java.lang.String	getTranslation(java.lang.String resourceKey)
boolean	isEnabled() Determines whether this button is enabled.
boolean	isVisible() Returns true if component is visible.
void	register(Exemptible exemptible) Registers an object to free its external resources as soon as they are not needed any more.
void	requestFocusInWindow() Set focus on the receiving component if isRequestFocusEnabled returns true.
void	resetLastStatus()
void	selectAll() Selects all input of the component, if it is supported - e.g. in JTextField.
void	setEditable(boolean editable) Sets the flag that determines whether or not this component is editable.
void	setEnabled(boolean enabled)
void	setToolTipText(java.lang.String newToolTipText) Sets the component's tool tip text.
void	setValues(ToAppletWriter out)
void	setVisible(boolean visible) Makes the component visible or invisible.

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.must.appletserver.Remotable

destroy, fetchValuesFromRequest

Field Detail

sessionData

protected SessionData sessionData

name

protected java.lang.String name

the name of the remote element to be identified for update

context

protected Context context

toolTipText

protected java.lang.String toolTipText

nonstandardPanel

protected java.lang.String nonstandardPanel

nonstandardPosition

protected int nonstandardPosition

enabled

protected boolean enabled

visible

protected boolean visible

lastVisibility

protected boolean lastVisibility

editable

protected boolean editable

lastEditability

protected boolean lastEditability

Constructor Detail

RemoteElement

public RemoteElement(SessionData sessionData)

Constructs a new remote element without need to be identified for update.

Parameters:

sessionData - the shared data of the session

RemoteElement

public RemoteElement(SessionData sessionData,
                     java.lang.String name)

Constructs a new remote element to be identified by name, e.g. to update it as one of several remote elements in an attribute list.

Parameters:

sessionData - the shared data of the session

name - the name of the remote element to be identified for update

Method Detail

setToolTipText

public void setToolTipText(java.lang.String newToolTipText)

Description copied from interface: Remotable

Sets the component's tool tip text.

Specified by:

setToolTipText in interface Remotable

Parameters:

newToolTipText - the component's tool tip text

getContext

public Context getContext()

Returns the remote element's context.

Returns:

the remote element's context

register

public void register(Exemptible exemptible)

Description copied from interface: ExemptibleManager

Registers an object to free its external resources as soon as they are not needed any more. The purpose of this registration is to ensure that already during the construction of this object, that certain resources are automatically released at a suitable later moment.

Specified by:

register in interface ExemptibleManager

Parameters:

exemptible - the exemptible object to register

setEditable

public void setEditable(boolean editable)

Sets the flag that determines whether or not this component is editable. This means: value may be changed by user. It does not mean, that user may type in characters. To allow this, use setEditableForUserTyping. If the flag is set to true, this component becomes user editable. If the flag is set to false, the cannot change the text of this text component.

Parameters:

editable - a flag indicating whether this component should be user editable

See Also:

#setEditableForUserTyping

setEnabled

public void setEnabled(boolean enabled)

isEnabled

public boolean isEnabled()

Determines whether this button is enabled. An enabled component can respond to user input and generate events. Buttons are enabled initially by default. A component may be enabled or disabled by calling its setEnabled method.

Returns:

true if the button is enabled; false otherwise.

See Also:

setEnabled(boolean)

getName

public java.lang.String getName()

Returns the name of the input field.

Returns:

the name of the input field

getTranslation

protected java.lang.String getTranslation(java.lang.String resourceKey)

requestFocusInWindow

public void requestFocusInWindow()

Description copied from interface: RemoteContent

Set focus on the receiving component if isRequestFocusEnabled returns true.

Specified by:

requestFocusInWindow in interface RemoteContent

selectAll

public void selectAll()

Description copied from interface: RemoteContent

Selects all input of the component, if it is supported - e.g. in JTextField. Allows easy new input, because the previous value is reset when the first key stroke occurs.

Specified by:

selectAll in interface RemoteContent

setVisible

public void setVisible(boolean visible)

Makes the component visible or invisible.

Parameters:

visible - true to make the component visible; false to make it invisible

isVisible

public boolean isVisible()

Returns true if component is visible.

Returns:

true if component is visible

resetLastStatus

public void resetLastStatus()

beginAction

public void beginAction(ToAppletWriter out)

endAction

public void endAction(ToAppletWriter out)

buildRemoteView

public void buildRemoteView(ToAppletWriter out)

Description copied from interface: AppletTalker

Build remote view.

Specified by:

buildRemoteView in interface AppletTalker

Parameters:

out - the writer which will be read by the applet

setValues

public void setValues(ToAppletWriter out)

Specified by:

setValues in interface RemoteContent

free

public void free()

Description copied from interface: ExemptibleManager

Releases external resources. May be called manually without waiting for garbage collection to occur.

Specified by:

free in interface Exemptible

Specified by:

free in interface ExemptibleManager