e4s.html.input.extended
Class LONGFIELD

java.lang.Object
  e4s.util.E4Object
      e4s.html.E4HtmlObject
          e4s.html.E4HtmlElementGeneral
              e4s.html.input.extended.E4FieldsetLayout
                  e4s.html.input.extended.E4InputField
                      e4s.html.input.extended.LONGFIELD

All Implemented Interfaces:

E4FieldsetLayout_Intf, E4HtmlElement_Intf, E4InputField_Intf

public class LONGFIELD
extends E4InputField
implements E4InputField_Intf

An input field (for <FORM>) elements representing a numeric long value.

Example_InputForm.java

Since:

JDK 1.4

See Also:

TEXTFIELD, DATEFIELD, FLOATFIELD, E4ValidatorLONGFIELD, FORM

Nested Class Summary

Nested classes/interfaces inherited from class e4s.html.input.extended.E4InputField

E4InputField.A_PICK

Field Summary

static int

DEFAULT_LENGTH Default length for numeric input fields

Fields inherited from class e4s.html.input.extended.E4InputField

BGCOLOR_READONLY, HTML_TAG, m_helpid, m_label, m_multiple_tablerows_id, m_name, m_pickup_ref, m_readonly, m_show_label, m_style_active, m_style_inactive, m_validation_object, m_validationmessage, m_value, m_visible, ms_help_image, PICKUP_IMAGE_NAME_PREFIX

Fields inherited from class e4s.html.E4HtmlElementGeneral

m_elements, m_needed_scripts

Fields inherited from class e4s.html.E4HtmlObject

m_parent_e4sID

Fields inherited from class e4s.util.E4Object

CRLF, E4S_CORE_SYSTEM_LANGUAGE, NBSP, NULLSTR, URL_ENCODING_CHARSET

Constructor Summary

LONGFIELD(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label)
Construct a text input field for numeric values.

LONGFIELD(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label, int length)
Construct a text input field for numeric values.

LONGFIELD(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label)
Construct a text input field for numeric values.

LONGFIELD(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label, int length)
Construct a text input field for numeric values.

LONGFIELD(E4InputFieldName_Intf name, E4Label_Intf label)
Construct a text input field for numeric values.

LONGFIELD(E4InputFieldName_Intf name, E4Label_Intf label, int length)
Construct a text input field for numeric values.

LONGFIELD(E4InputFieldName_Intf name, java.lang.String label)
Construct a text input field for numeric values.

LONGFIELD(E4InputFieldName_Intf name, java.lang.String label, int length)
Construct a text input field for numeric values.

LONGFIELD(LONGFIELD field)

Method Summary

static java.lang.String	_getSVNVersionString() Get version info string from subversion.
E4AjaxElementInputValueChanger	addAjaxChanger(FORM form, E4AjaxData_Intf worker, E4ServletImplementation_Intf servlet) Add an AjaxElement to the field that can change the value visible in the form.
E4InputField_Intf	duplicate()
boolean	emptyValue()
long	getValue() Get the value of this input field.
void	setEmptyValue() Sets an "empty" value which is not equal to "0" (just using "").
void	setValidation(long from, long to)
void	setValue(double value) Sets the value as long (prevents decimal point).
void	setValue(E4CgiParams params) Look in the parameter list, and if the HTML-fieldname matches one of the parameters, assign it as String.
void	setValue(float value) Sets the value as long (prevents decimal point).
void	setValue(int value) Sets the value as long.
void	setValue(long value) Sets the value as long.
void	toHtml(E4StringBufferHtml buf, E4ServletImplementation_Intf servlet) Create the HTML output for this element.
boolean	validate() If a validation function is declared, then it is called and any String result returning from this validation function indicates that something with the field went wrong, and the return value will be false.

Methods inherited from class e4s.html.input.extended.E4InputField

addElement, AppendValidationE4Message, changeColumnName, collectStylesForEditing, collectTranslationsForEditing, debugToString, definePickupList, definePickupList, definePickupList, definePickupList, definePickupList, definePickupList, definePickupList, display_simpleReport, E4ID, equalsIgnoreCase, eventHandlers, getCanChangeLayout, getColumnName, getErrorMessage, getEventHandlers, getHelpId, getHtmlParamName, getLabel, getMultipleTablerowsId, getPersistant, getPersistantLayout, getPickupList, getReadOnly, getSTYLE, getSTYLE, getValidator, getValue_native, hideLabel, HtmlEncode, isHiddenField, isMandatory, isVisible, onChange, onChange, onChange, onClick, removePickupList, resetValidation, setCanChangeLayout, setErrorMessage, setErrorMessage, setEventHandler, setHelpId, setHelpImage, setLabel, setMultipleTablerowsId, setReadOnly, setReadOnly, setReadOnly, setSTYLE, setSTYLE, setValidation, setValidator, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setVisible, toHIDDENFIELD, toHtml_drawSimpleReport, toHtml_drawSimpleReport, toHtml_drawSimpleReport, toHtml_hidden, toHtml, toString, updatePersistantLayout, validate, validate

Methods inherited from class e4s.html.input.extended.E4FieldsetLayout

isNextRow, layoutToNextRow

Methods inherited from class e4s.html.E4HtmlElementGeneral

addScript, addScript, addScript, addStyleForEditing, addTranslationForEditing, buildStyleAttribute, buildStyleClassReference, collectScripts, collectStylesForEditing, collectStylesForEditing, collectTranslationsForEditing, createScript, createScript, findElement, findElement, findElement, findElement, getElements, getElementsVec, getField, getId, getLastElement, getStringContent, getStyle, getStyle, hasScripts, hasSTYLE, isContentClass, isE4InputField_Intf, openTag, removeAll, removeElementById, removeElements, removeElements, removeStyle, setId, setStyle, setStyle, setSTYLE, Style, Style

Methods inherited from class e4s.html.E4HtmlObject

E4ID, set_e4sID

Methods inherited from class e4s.util.E4Object

Calendar, CName, CName, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelNone, E4LabelNone, E4LabelNone, E4LabelNone, E4LabelSys, E4LabelSys, e4sCopyright, e4sVersion, encode, encode, encode, encodeHtml, encodeHtml, encodeHtml, encodeURL, encodeURL, encodeURL, finalize, getLINE, getTRACE, getTRACE, getTRACE, getTRACE, getTRACE, getTRACE, getTraceMemory, HtmlEncode, HtmlEncode, isdecimal, isdigit, isnotok, isnotok, isnumeric, isok, isok, isok, isok, lastCallingFunction, lastCallingFunction, lastCallingFunction, lastCallingFunction, lastCallingStack, mkdirs, null2nbsp, null2nbsp, null2nbsp, ok, ok, ok, ok, outPrintln, setLogFile4Trace, setTraceMemory, STACKTRACE, toDebug, toDouble, toFloat, toFloat, TRACE_CALLS, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, wait

Methods inherited from class java.lang.Object

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

Methods inherited from interface e4s.html.input.extended.E4InputField_Intf

changeColumnName, definePickupList, definePickupList, display_simpleReport, equalsIgnoreCase, eventHandlers, getCanChangeLayout, getColumnName, getErrorMessage, getHtmlParamName, getLabel, getMultipleTablerowsId, getPickupList, getReadOnly, getValue_native, hideLabel, isHiddenField, isMandatory, isVisible, resetValidation, setCanChangeLayout, setErrorMessage, setErrorMessage, setEventHandler, setHelpId, setLabel, setMultipleTablerowsId, setReadOnly, setReadOnly, setValidator, setValue, setValue, setValue, setValue, setVisible, toHIDDENFIELD, toHtml_drawSimpleReport, toHtml_drawSimpleReport, validate

Methods inherited from interface e4s.html.E4FieldsetLayout_Intf

isNextRow, layoutToNextRow

Methods inherited from interface e4s.html.E4HtmlElement_Intf

addScript, addScript, addScript, collectScripts, collectStylesForEditing, collectTranslationsForEditing, debugToString, findElement, findElement, getElements, getElementsVec, getField, getId, getStringContent, isContentClass, removeAll, removeElementById, removeElements, set_e4sID, setId, toHtml_hidden, validate

Field Detail

DEFAULT_LENGTH

public static final int DEFAULT_LENGTH

Default length for numeric input fields

See Also:

Constant Field Values

Constructor Detail

LONGFIELD

public LONGFIELD(E4ID parent_id,
                 E4InputFieldName_Intf name,
                 java.lang.String label)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

LONGFIELD

public LONGFIELD(E4InputFieldName_Intf name,
                 java.lang.String label)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

LONGFIELD

public LONGFIELD(E4ID parent_id,
                 E4InputFieldName_Intf name,
                 java.lang.String label,
                 int length)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

length - is the number of characters displayed and entered

LONGFIELD

public LONGFIELD(E4InputFieldName_Intf name,
                 java.lang.String label,
                 int length)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

length - is the number of characters displayed and entered

LONGFIELD

public LONGFIELD(E4ID parent_id,
                 E4InputFieldName_Intf name,
                 E4Label_Intf label)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

LONGFIELD

public LONGFIELD(E4InputFieldName_Intf name,
                 E4Label_Intf label)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

LONGFIELD

public LONGFIELD(E4ID parent_id,
                 E4InputFieldName_Intf name,
                 E4Label_Intf label,
                 int length)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

length - is the number of characters displayed and entered

LONGFIELD

public LONGFIELD(E4InputFieldName_Intf name,
                 E4Label_Intf label,
                 int length)

Construct a text input field for numeric values.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

length - is the number of characters displayed and entered

LONGFIELD

public LONGFIELD(LONGFIELD field)

Method Detail

toHtml

public void toHtml(E4StringBufferHtml buf,
                   E4ServletImplementation_Intf servlet)
            throws java.lang.Exception

Description copied from interface: E4HtmlElement_Intf

Create the HTML output for this element. Also run throught all child elements, and call their E4HtmlElement_Intf.toHtml(e4s.util.E4StringBufferHtml, e4s.servlet.E4ServletImplementation_Intf) function to generate output of those objects which becomes appended. Normally, there is no need to call this function anyway, and this also might result in side effects of too-early relasing of objects in some cases. This function is called by E4ServletImplementation_Intf.write(e4s.html.E4HtmlElement) on the top level HTML element (common this is a HTML or BODY element) and branches down to all child elements.

Specified by:

toHtml in interface E4HtmlElement_Intf

Specified by:

toHtml in interface E4InputField_Intf

Overrides:

toHtml in class E4HtmlElementGeneral

servlet - the servlet environment currently running in

Throws:

java.lang.Exception

getValue

public long getValue()
              throws java.lang.NumberFormatException

Get the value of this input field.

Returns:

the value

Throws:

java.lang.NumberFormatException

See Also:

E4InputField.setValue(java.lang.String), setEmptyValue()

setEmptyValue

public void setEmptyValue()

Sets an "empty" value which is not equal to "0" (just using "").

emptyValue

public boolean emptyValue()

validate

public boolean validate()
                 throws java.lang.Exception

Description copied from class: E4InputField

If a validation function is declared, then it is called and any String result returning from this validation function indicates that something with the field went wrong, and the return value will be false. This indication is stored in the m_validationmessage variable for further use. Only visible fields are validated (see E4InputField.isVisible()).

Specified by:

validate in interface E4InputField_Intf

Overrides:

validate in class E4InputField

Returns:

true, if everything is o.k.

Throws:

java.lang.Exception

See Also:

#setValidation(Object,String), E4InputField_Intf.setErrorMessage(String), E4InputField_Intf.getErrorMessage()

setValidation

public void setValidation(long from,
                          long to)

setValue

public void setValue(E4CgiParams params)

Description copied from class: E4InputField

Look in the parameter list, and if the HTML-fieldname matches one of the parameters, assign it as String. Dangerous for Date, long, boolean input elements which should implement their own version including necessary conversions.

Specified by:

setValue in interface E4HtmlElement_Intf

Specified by:

setValue in interface E4InputField_Intf

Overrides:

setValue in class E4InputField

Parameters:

params - the whole parameter list

See Also:

E4InputField_Intf.setValue(e4s.html.E4CgiParams), #validate(e4s.html.E4CgiParams)

setValue

public void setValue(double value)

Sets the value as long (prevents decimal point).

Parameters:

value - the value to be set

See Also:

E4InputField.setValue(long)

setValue

public void setValue(long value)

Sets the value as long.

Overrides:

setValue in class E4InputField

Parameters:

value - the value to be set

See Also:

E4InputField.setValue(long)

setValue

public void setValue(int value)

Sets the value as long.

Overrides:

setValue in class E4InputField

Parameters:

value - the value to be set

See Also:

E4InputField.setValue(int)

setValue

public void setValue(float value)

Sets the value as long (prevents decimal point).

Overrides:

setValue in class E4InputField

Parameters:

value - the value to be set

See Also:

E4InputField.setValue(long)

duplicate

public E4InputField_Intf duplicate()

Specified by:

duplicate in interface E4InputField_Intf

addAjaxChanger

public E4AjaxElementInputValueChanger addAjaxChanger(FORM form,
                                                     E4AjaxData_Intf worker,
                                                     E4ServletImplementation_Intf servlet)

Add an AjaxElement to the field that can change the value visible in the form.

Parameters:

form - the form where the field belongs to (important for the identification of the form by its name)

worker - the ajax element doing the output, output must be pure text only without any tags

servlet - the actual servlet contect

Returns:

the new created and added ajax element

_getSVNVersionString

public static java.lang.String _getSVNVersionString()

Get version info string from subversion.

Returns:

the version info string.

See Also:

E4Util.getRevisionCodeFromSVN(Class)