com.goldencode.p2j.ui.client.format

Class StringFormat.CharBuf

java.lang.Object

com.goldencode.p2j.ui.client.format.DisplayFormat.Presentation

com.goldencode.p2j.ui.client.format.StringFormat.CharBuf

Enclosing class:

StringFormat

private class StringFormat.CharBuf
extends DisplayFormat.Presentation

Presentation implementation as ScreenBuffer wrapper.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.StringBuilder	buf Value chars.
private ErrorManager.ErrorEntry	error Parsing error
private boolean	unknownValueDisplayed Indicates that ? mark should be displayed as an unknown value.

Fields inherited from class com.goldencode.p2j.ui.client.format.DisplayFormat.Presentation

forFieldValue, presCursorPos, presInsertMode

Constructor Summary

Constructors

Constructor and Description
CharBuf() Constructs clear presentation.
CharBuf(character varChar, boolean forFieldValue) Constructs from variable's value.

Method Summary

Modifier and Type	Method and Description
private boolean	checkFixedCharsPrefixedByRepeatedFillCharFormatAndParse(java.lang.String value) Check that this CharBuf has the following special format specification started from the repeated fill characters and ended up with fixed characters (*)+X(N) and parse incomplete screen value for this special format specification.
void	checkFormat() Checks format rules.
void	clear() Delete the screen value.
StringFormat.CharBuf	clear(boolean zapClear) Makes new buffer with removed all value chars after cursor.
private void	clearDisplayedUnknownChar() Clears displayed unknown char.
boolean	deleteBack() Erases one symbol before the cursor position.
boolean	deleteCurrent() Erases one symbol in the cursor position.
boolean	finishEdit() Indicates completion of an edit.
private char	getChar(int pos)
boolean	input(char ch) Inputs character.
private boolean	insert(char ch) Inputs character with the insert mode.
boolean	isFixedFont() Determine if this format must use the DEFAULT-FIXED-FONT, if no font is specified.
boolean	isUnknown() Returns if the presentation currently represents the unknown value.
boolean	moveCursorBegin() Moves cursor to the beginning of the field.
boolean	moveCursorEnd() Moves cursor to the end of the field.
boolean	moveCursorLeft() Moves cursor one character to the left.
boolean	moveCursorRight() Moves cursor one character to the right.
private boolean	overwrite(char ch) Inputs character with the overwrite mode.
private void	parseFieldValue(java.lang.String val) Apply format to the new String value before assignment to the FIELD-VALUE
private boolean	parseIncompleteScreenValue(java.lang.String value) Parse incomplete valid screen values.
private void	parseScreenValue(java.lang.String text) Apply format to the new String value before assignment to the Screen-VALUE
private void	setChar(int pos, char ch) Places given char into given buffer position.
java.lang.String	toScreenValue() Formats the data as a string that is ready for display.
java.lang.String	toScreenValue(boolean edit) Formats the data as a string that is ready for display.
private java.lang.String	toScreenValueInt(boolean edit) Formats the data as a string that is ready for display.
void	toVar(BaseDataType var) Instantiates a variable that is equivalent to the presentation's internal representation.
ErrorManager.ErrorEntry[]	validateFormat() Validate representation according to format rules and return error message if there is an error.

Methods inherited from class com.goldencode.p2j.ui.client.format.DisplayFormat.Presentation

activate, deleteRegion, forFieldValue, getCursorPos, getInitialCursorPos, getInsertMode, getLastPos, isFixedNumeric, isLastCharEntered, isNegative, isOptionalLeftSign, setCursorPos, setInsertMode, setLastCharEntered

Methods inherited from class java.lang.Object

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

Field Detail

buf

private java.lang.StringBuilder buf

Value chars. May be null which means UNKNOWN value.

unknownValueDisplayed

private boolean unknownValueDisplayed

Indicates that ? mark should be displayed as an unknown value.

error

private ErrorManager.ErrorEntry error

Parsing error

Constructor Detail

CharBuf

public CharBuf()

Constructs clear presentation.

CharBuf

public CharBuf(character varChar,
               boolean forFieldValue)

Constructs from variable's value.

Parameters:

varChar - Variable's value.

forFieldValue - true if this presentation is for buffer field value

Method Detail

clear

public void clear()

Delete the screen value.

Specified by:

clear in class DisplayFormat.Presentation

isFixedFont

public boolean isFixedFont()

Determine if this format must use the DEFAULT-FIXED-FONT, if no font is specified.

Specified by:

isFixedFont in class DisplayFormat.Presentation

Returns:

The state of the StringFormat.fixedFont flag.

validateFormat

public ErrorManager.ErrorEntry[] validateFormat()

Validate representation according to format rules and return error message if there is an error.

Overrides:

validateFormat in class DisplayFormat.Presentation

Returns:

null if no error or error message if there is an error.

checkFormat

public void checkFormat()
                 throws DisplayFormatCheckException

Checks format rules. Method finishEdit() should be called before it.

Specified by:

checkFormat in class DisplayFormat.Presentation

Throws:

DisplayFormatCheckException - When data is incompatible with format

isUnknown

public boolean isUnknown()

Returns if the presentation currently represents the unknown value. If any editing has occurred, then this will return false even if the editing is not complete.

Specified by:

isUnknown in class DisplayFormat.Presentation

Returns:

true if this is unknown.

deleteBack

public boolean deleteBack()

Erases one symbol before the cursor position.

Specified by:

deleteBack in class DisplayFormat.Presentation

Returns:

true if input is accepted (nevertheless it may be silently ignored in reality).

deleteCurrent

public boolean deleteCurrent()

Erases one symbol in the cursor position.

Specified by:

deleteCurrent in class DisplayFormat.Presentation

Returns:

true if input is accepted (nevertheless it may be silently ignored in reality).

input

public boolean input(char ch)

Inputs character. The result depends from the current insert mode.

Specified by:

input in class DisplayFormat.Presentation

Parameters:

ch - Input character

Returns:

true if input is accepted (nevertheless it may be silently ignored in reality).

moveCursorLeft

public boolean moveCursorLeft()

Moves cursor one character to the left.

Specified by:

moveCursorLeft in class DisplayFormat.Presentation

Returns:

true if input is accepted (nevertheless it may be silently ignored in reality).

moveCursorRight

public boolean moveCursorRight()

Moves cursor one character to the right. Also updates insert mode.

Specified by:

moveCursorRight in class DisplayFormat.Presentation

Returns:

true if input is accepted (nevertheless it may be silently ignored in reality).

moveCursorBegin

public boolean moveCursorBegin()

Moves cursor to the beginning of the field.

Specified by:

moveCursorBegin in class DisplayFormat.Presentation

Returns:

true if input is accepted (nevertheless it may be silently ignored in reality).

moveCursorEnd

public boolean moveCursorEnd()

Moves cursor to the end of the field.

Specified by:

moveCursorEnd in class DisplayFormat.Presentation

Returns:

true if input is accepted (nevertheless it may be silently ignored in reality).

finishEdit

public boolean finishEdit()

Indicates completion of an edit. The presentation instance may fill some unfilled places.

Specified by:

finishEdit in class DisplayFormat.Presentation

Returns:

true if rendering is necessary.

toScreenValue

public java.lang.String toScreenValue(boolean edit)

Formats the data as a string that is ready for display.

Overrides:

toScreenValue in class DisplayFormat.Presentation

Parameters:

edit - true if the screen value is being generated for interactive editing purposes.

Returns:

The formatted string.

toScreenValue

public java.lang.String toScreenValue()

Formats the data as a string that is ready for display.

Specified by:

toScreenValue in class DisplayFormat.Presentation

Returns:

The formatted string.

toVar

public void toVar(BaseDataType var)

Instantiates a variable that is equivalent to the presentation's internal representation.

Specified by:

toVar in class DisplayFormat.Presentation

Parameters:

var - A variable which must be compatible with the format.

clear

public StringFormat.CharBuf clear(boolean zapClear)

Makes new buffer with removed all value chars after cursor. Insert mode and cursor position are not changed and are the same in the both buffers.

Parameters:

zapClear - If true then presentation is cleared completely, like if zap mode is ON. If false then it is cleared like if CLEAR event was applied (that means it is cleared from the current cursor position).

Returns:

New buffer.

clearDisplayedUnknownChar

private void clearDisplayedUnknownChar()

Clears displayed unknown char.

toScreenValueInt

private final java.lang.String toScreenValueInt(boolean edit)

Formats the data as a string that is ready for display.

Parameters:

edit - true if the screen value is being generated for interactive editing purposes.

Returns:

The formatted string.

insert

private boolean insert(char ch)

Inputs character with the insert mode.

Parameters:

ch - Input character

Returns:

Is input accepted (nevertheless it may be silently ignored in real).

overwrite

private boolean overwrite(char ch)

Inputs character with the overwrite mode.

Parameters:

ch - Input character

Returns:

Is input accepted (nevertheless it may be silently ignored in real).

getChar

private char getChar(int pos)

Parameters:

pos - Position.

Returns:

Char in this position making right fill with spaces.

setChar

private void setChar(int pos,
                     char ch)

Places given char into given buffer position.

Parameters:

pos - Position.

ch - Char.

checkFixedCharsPrefixedByRepeatedFillCharFormatAndParse

private boolean checkFixedCharsPrefixedByRepeatedFillCharFormatAndParse(java.lang.String value)

Check that this CharBuf has the following special format specification started from the repeated fill characters and ended up with fixed characters (*)+X(N) and parse incomplete screen value for this special format specification.

Parameters:

value - Input screen value

Returns:

True if and only if the given input value can be parsed by this special format.

parseIncompleteScreenValue

private boolean parseIncompleteScreenValue(java.lang.String value)

Parse incomplete valid screen values.

Parameters:

value - Input screen value

Returns:

True if and only if the given input value can be parsed.

parseScreenValue

private void parseScreenValue(java.lang.String text)

Apply format to the new String value before assignment to the Screen-VALUE

Parameters:

text - new String value

parseFieldValue

private void parseFieldValue(java.lang.String val)

Apply format to the new String value before assignment to the FIELD-VALUE

Parameters:

val - new String value