com.ontimize.gui.field.document

Class HourDateDocument

java.lang.Object

javax.swing.text.AbstractDocument

javax.swing.text.PlainDocument

com.ontimize.gui.field.document.DateDocument

com.ontimize.gui.field.document.HourDateDocument

All Implemented Interfaces:

Internationalization, Serializable, Document

public class HourDateDocument
extends DateDocument

Document for managing hour and dates in same field. It is useful for table editors that map columns with timestamp values.

Since:

5.2059EN

Author:

Imatia Innovation SL

See Also:

DateCellEditor}, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.ontimize.gui.field.document.DateDocument

DateDocument.DateFormatCache, DateDocument.DateFormatCacheKey

Nested classes/interfaces inherited from class javax.swing.text.AbstractDocument

AbstractDocument.AbstractElement, AbstractDocument.AttributeContext, AbstractDocument.BranchElement, AbstractDocument.Content, AbstractDocument.DefaultDocumentEvent, AbstractDocument.ElementEdit, AbstractDocument.LeafElement

Field Summary

Fields

Modifier and Type	Field and Description
static char	charDateHourSeparator
protected Date	currentDocumentDate Date that stores the document for each moment.
protected static SimpleDateFormat	dfHourDate Instance of date formatter
static String	HH_mm Default pattern for hours HH:mm
protected boolean	hourFirst Hour will be showed at first.
protected boolean	onlyHour It assigns a pattern to the document without date, only with hour.
protected String	patternHour String with hour pattern
protected String	patternHourDate String with hour and date patterns separated by charDateHourSeparator.
protected String	sDateHourSeparator

Fields inherited from class com.ontimize.gui.field.document.DateDocument

currentDate, currentTimestamp, dateFormat, datePattern, DEBUG, defaultLocale, dfConstructor, insertedDate, locale

Fields inherited from class javax.swing.text.PlainDocument

lineLimitAttribute, tabSizeAttribute

Fields inherited from class javax.swing.text.AbstractDocument

BAD_LOCATION, BidiElementName, ContentElementName, ElementNameAttribute, listenerList, ParagraphElementName, SectionElementName

Fields inherited from interface com.ontimize.gui.i18n.Internationalization

DEBUG_LANGUAGE

Fields inherited from interface javax.swing.text.Document

StreamDescriptionProperty, TitleProperty

Constructor Summary

Constructors

Constructor and Description
HourDateDocument() Constructor that creates a date document with hour and date, when hour is showed at first.
HourDateDocument(boolean onlyHour, boolean hourFirst)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	buildHourDatePattern() Concatenates both patterns.
protected void	buildHourPattern() Builds hour pattern.
protected void	buildPattern() Builds pattern for date and hour.
String	getText(int offset, int length)
Timestamp	getTimestampValue()
void	insertString(int offset, String sValue, AttributeSet attributes) Date pattern is known: - Non numeric characters are allowed.
boolean	isValid() Pattern is valid when parsing returns a correct date.
boolean	isValidHour(String sHour) Checks whether hour is valid.
void	setPattern(String patternHourDate) Applies specified pattern to date formatter.
void	setValue(Date value)

Methods inherited from class com.ontimize.gui.field.document.DateDocument

format, getDate, getDatePattern, getFormat, getTextsToTranslate, getTimestampValue, insertStringWithoutCheck, isValid, setComponentLocale, setDatePattern, setResourceBundle

Methods inherited from class javax.swing.text.PlainDocument

createDefaultRoot, getDefaultRootElement, getParagraphElement, insertUpdate, removeUpdate

Methods inherited from class javax.swing.text.AbstractDocument

addDocumentListener, addUndoableEditListener, createBranchElement, createLeafElement, createPosition, dump, fireChangedUpdate, fireInsertUpdate, fireRemoveUpdate, fireUndoableEditUpdate, getAsynchronousLoadPriority, getAttributeContext, getBidiRootElement, getContent, getCurrentWriter, getDocumentFilter, getDocumentListeners, getDocumentProperties, getEndPosition, getLength, getListeners, getProperty, getRootElements, getStartPosition, getText, getUndoableEditListeners, postRemoveUpdate, putProperty, readLock, readUnlock, remove, removeDocumentListener, removeUndoableEditListener, render, replace, setAsynchronousLoadPriority, setDocumentFilter, setDocumentProperties, writeLock, writeUnlock

Methods inherited from class java.lang.Object

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

Field Detail

HH_mm

public static final String HH_mm

Default pattern for hours HH:mm

See Also:

Constant Field Values

charDateHourSeparator

public static final char charDateHourSeparator

See Also:

Constant Field Values

sDateHourSeparator

protected String sDateHourSeparator

patternHour

protected String patternHour

String with hour pattern

patternHourDate

protected String patternHourDate

String with hour and date patterns separated by charDateHourSeparator. Order of these patterns will be assigned according to variable hourFirst. By default, hour is showed at first.

currentDocumentDate

protected Date currentDocumentDate

Date that stores the document for each moment.

dfHourDate

protected static SimpleDateFormat dfHourDate

Instance of date formatter

onlyHour

protected boolean onlyHour

It assigns a pattern to the document without date, only with hour.

hourFirst

protected boolean hourFirst

Hour will be showed at first.

Constructor Detail

HourDateDocument

public HourDateDocument()

Constructor that creates a date document with hour and date, when hour is showed at first.

HourDateDocument

public HourDateDocument(boolean onlyHour,
                boolean hourFirst)

Method Detail

insertString

public void insertString(int offset,
                String sValue,
                AttributeSet attributes)
                  throws BadLocationException

Description copied from class: DateDocument

Date pattern is known:
- Non numeric characters are allowed.
- Year field has 4 characters (9999 maximum).
- Month and day fields have 2 characters. The maximum value for day is 31 and for month 12. An the minimum value for both is 1.
- When a value is introduced in field, this one is checked and text will be showed in red color until that the value is a correct date. Moreover, field value is also checked when field losts focus or ENTER key is pressed.
- Separator for dates is /. So a valid format date could be: 12/12/2008

Specified by:

insertString in interface Document

Overrides:

insertString in class DateDocument

Throws:

BadLocationException

buildPattern

protected void buildPattern()

Builds pattern for date and hour. Moreover, it concatenates both patterns.

Overrides:

buildPattern in class DateDocument

buildHourDatePattern

protected void buildHourDatePattern()

Concatenates both patterns.

setPattern

public void setPattern(String patternHourDate)

Applies specified pattern to date formatter.

Parameters:

patternHourDate - The pattern to be applied.

buildHourPattern

protected void buildHourPattern()

Builds hour pattern.

isValid

public boolean isValid()

Pattern is valid when parsing returns a correct date.

Overrides:

isValid in class DateDocument

isValidHour

public boolean isValidHour(String sHour)

Checks whether hour is valid.

Parameters:

sHour - String with hour

Returns:

True when hour is well formed according to the hour pattern

getText

public String getText(int offset,
             int length)
               throws BadLocationException

Specified by:

getText in interface Document

Overrides:

getText in class AbstractDocument

Throws:

BadLocationException

setValue

public void setValue(Date value)

Overrides:

setValue in class DateDocument

getTimestampValue

public Timestamp getTimestampValue()

Overrides:

getTimestampValue in class DateDocument