org.refcodes.date.impls

Class ConcurrentDateFormat

java.lang.Object

java.text.Format

java.text.DateFormat

java.text.SimpleDateFormat

org.refcodes.date.impls.ConcurrentDateFormat

All Implemented Interfaces:

Serializable, Cloneable

public class ConcurrentDateFormat
extends SimpleDateFormat

This concurrent ConcurrentDateFormat can be casted to SimpleDateFormat with additional thread safety which SimpleDateFormat cannot provide.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.text.DateFormat

DateFormat.Field

Field Summary

Fields inherited from class java.text.DateFormat

AM_PM_FIELD, calendar, DATE_FIELD, DAY_OF_WEEK_FIELD, DAY_OF_WEEK_IN_MONTH_FIELD, DAY_OF_YEAR_FIELD, DEFAULT, ERA_FIELD, FULL, HOUR_OF_DAY0_FIELD, HOUR_OF_DAY1_FIELD, HOUR0_FIELD, HOUR1_FIELD, LONG, MEDIUM, MILLISECOND_FIELD, MINUTE_FIELD, MONTH_FIELD, numberFormat, SECOND_FIELD, SHORT, TIMEZONE_FIELD, WEEK_OF_MONTH_FIELD, WEEK_OF_YEAR_FIELD, YEAR_FIELD

Constructor Summary

Constructors

Constructor and Description
ConcurrentDateFormat()
ConcurrentDateFormat(String pattern)
ConcurrentDateFormat(String pattern, Locale locale)

Method Summary

Modifier and Type	Method and Description
void	applyLocalizedPattern(String pattern) Deprecated. as it is not considered to be thread safe.
void	applyPattern(String pattern) Deprecated. as it is not considered to be thread safe.
StringBuffer	format(Date date, StringBuffer toAppendTo, FieldPosition fieldPosition) This method is overridden as the DateFormat.format(Date) method is final and calls this method.
AttributedCharacterIterator	formatToCharacterIterator(Object obj) Deprecated. as it is not considered to be thread safe.
Date	get2DigitYearStart() Deprecated. as it is not considered to be thread safe.
Calendar	getCalendar() Deprecated. as it is not considered to be thread safe.
DateFormatSymbols	getDateFormatSymbols() Deprecated. as it is not considered to be thread safe.
NumberFormat	getNumberFormat() Deprecated. as it is not considered to be thread safe.
TimeZone	getTimeZone() Deprecated. as it is not considered to be thread safe.
boolean	isLenient() Deprecated. as it is not considered to be thread safe.
Date	parse(String source) Delegate the parse method to the thread safe FastDateFormat class.
Date	parse(String text, ParsePosition pos) Deprecated. as it is only thread safe due to synchronization.
Object	parseObject(String source) Deprecated. as it is not considered to be thread safe.
Object	parseObject(String source, ParsePosition pos) Deprecated. as it is not considered to be thread safe.
void	set2DigitYearStart(Date startDate) Deprecated. as it is not considered to be thread safe.
void	setCalendar(Calendar newCalendar) Deprecated. as it is not considered to be thread safe.
void	setDateFormatSymbols(DateFormatSymbols newFormatSymbols) Deprecated. as it is not considered to be thread safe.
void	setLenient(boolean lenient) Deprecated. as it is not considered to be thread safe.
void	setNumberFormat(NumberFormat newNumberFormat) Deprecated. as it is not considered to be thread safe.
void	setTimeZone(TimeZone zone) Deprecated. as it is not considered to be thread safe.
String	toString(Date aDate) This methods is a substitute for the DateFormat.format(Date) method which (in this case) unnecessarily calls the format(Date, StringBuffer, FieldPosition) method with the result of creating unnecessary StringBuffer instances; please use this substitute of DateFormat.format(Date).

Methods inherited from class java.text.SimpleDateFormat

clone, equals, hashCode, toLocalizedPattern, toPattern

Methods inherited from class java.text.DateFormat

format, format, getAvailableLocales, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getTimeInstance, getTimeInstance, getTimeInstance

Methods inherited from class java.text.Format

format

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConcurrentDateFormat

public ConcurrentDateFormat()

ConcurrentDateFormat

public ConcurrentDateFormat(String pattern,
                            Locale locale)

ConcurrentDateFormat

public ConcurrentDateFormat(String pattern)

Method Detail

format

public StringBuffer format(Date date,
                           StringBuffer toAppendTo,
                           FieldPosition fieldPosition)

This method is overridden as the DateFormat.format(Date) method is final and calls this method.

Overrides:

format in class SimpleDateFormat

toString

public String toString(Date aDate)

This methods is a substitute for the DateFormat.format(Date) method which (in this case) unnecessarily calls the format(Date, StringBuffer, FieldPosition) method with the result of creating unnecessary StringBuffer instances; please use this substitute of DateFormat.format(Date).

Parameters:

aDate - The date to be formatted according to the given date.

Returns:

The string as of the provided date.

parse

public Date parse(String source)
           throws ParseException

Delegate the parse method to the thread safe FastDateFormat class.

Overrides:

parse in class DateFormat

Throws:

ParseException

parse

@Deprecated
public Date parse(String text,
                              ParsePosition pos)

Deprecated. as it is only thread safe due to synchronization.

The FastDateFormat does not implement its Format.parseObject(String) nor the FastDateFormat.parseObject(String, ParsePosition) methods :-( Therefore we only can make this method thread safe by synchronizing.

Overrides:

parse in class SimpleDateFormat

set2DigitYearStart

@Deprecated
public void set2DigitYearStart(Date startDate)

Deprecated. as it is not considered to be thread safe.

Overrides:

set2DigitYearStart in class SimpleDateFormat

get2DigitYearStart

@Deprecated
public Date get2DigitYearStart()

Deprecated. as it is not considered to be thread safe.

Overrides:

get2DigitYearStart in class SimpleDateFormat

formatToCharacterIterator

@Deprecated
public AttributedCharacterIterator formatToCharacterIterator(Object obj)

Deprecated. as it is not considered to be thread safe.

Overrides:

formatToCharacterIterator in class SimpleDateFormat

applyPattern

@Deprecated
public void applyPattern(String pattern)

Deprecated. as it is not considered to be thread safe.

Overrides:

applyPattern in class SimpleDateFormat

applyLocalizedPattern

@Deprecated
public void applyLocalizedPattern(String pattern)

Deprecated. as it is not considered to be thread safe.

Overrides:

applyLocalizedPattern in class SimpleDateFormat

getDateFormatSymbols

@Deprecated
public DateFormatSymbols getDateFormatSymbols()

Deprecated. as it is not considered to be thread safe.

Overrides:

getDateFormatSymbols in class SimpleDateFormat

setDateFormatSymbols

@Deprecated
public void setDateFormatSymbols(DateFormatSymbols newFormatSymbols)

Deprecated. as it is not considered to be thread safe.

Overrides:

setDateFormatSymbols in class SimpleDateFormat

parseObject

@Deprecated
public Object parseObject(String source,
                                      ParsePosition pos)

Deprecated. as it is not considered to be thread safe.

Overrides:

parseObject in class DateFormat

setCalendar

@Deprecated
public void setCalendar(Calendar newCalendar)

Deprecated. as it is not considered to be thread safe.

Overrides:

setCalendar in class DateFormat

getCalendar

@Deprecated
public Calendar getCalendar()

Deprecated. as it is not considered to be thread safe.

Overrides:

getCalendar in class DateFormat

setNumberFormat

@Deprecated
public void setNumberFormat(NumberFormat newNumberFormat)

Deprecated. as it is not considered to be thread safe.

Overrides:

setNumberFormat in class DateFormat

getNumberFormat

@Deprecated
public NumberFormat getNumberFormat()

Deprecated. as it is not considered to be thread safe.

Overrides:

getNumberFormat in class DateFormat

setTimeZone

@Deprecated
public void setTimeZone(TimeZone zone)

Deprecated. as it is not considered to be thread safe.

Overrides:

setTimeZone in class DateFormat

getTimeZone

@Deprecated
public TimeZone getTimeZone()

Deprecated. as it is not considered to be thread safe.

Overrides:

getTimeZone in class DateFormat

setLenient

@Deprecated
public void setLenient(boolean lenient)

Deprecated. as it is not considered to be thread safe.

Overrides:

setLenient in class DateFormat

isLenient

@Deprecated
public boolean isLenient()

Deprecated. as it is not considered to be thread safe.

Overrides:

isLenient in class DateFormat

parseObject

@Deprecated
public Object parseObject(String source)
                               throws ParseException

Deprecated. as it is not considered to be thread safe.

Overrides:

parseObject in class Format

Throws:

ParseException