Class ZonePrinterParser

java.lang.Object

javax.time.calendar.format.ZonePrinterParser

All Implemented Interfaces:

DateTimeParser, DateTimePrinter

final class ZonePrinterParser
extends Object
implements DateTimePrinter, DateTimeParser

Prints or parses a zone offset.

ZonePrinterParser is immutable and thread-safe.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	ZonePrinterParser.SubstringTree	Model a tree of substrings to make the parsing easier.

Field Summary

Fields

Modifier and Type	Field	Description
private static Set<String>	preparedIDs	The cached IDs.
private static ZonePrinterParser.SubstringTree	preparedTree	The cached tree to speed up parsing.
private final DateTimeFormatterBuilder.TextStyle	textStyle	The text style to output, null means the id.

Constructor Summary

Constructors

Constructor	Description
ZonePrinterParser()	Constructor.
ZonePrinterParser(DateTimeFormatterBuilder.TextStyle textStyle)	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	isPrintDataAvailable(Calendrical calendrical)	Checks if the calendrical contains the data necessary to be printed.
int	parse(DateTimeParseContext context, String parseText, int position)	This implementation looks for the longest matching string.
private static ZonePrinterParser.SubstringTree	prepareParser(Set<String> availableIDs)	Builds an optimized parsing tree.
void	print(Calendrical calendrical, Appendable appendable, DateTimeFormatSymbols symbols)	Prints the calendrical object to the appendable.
String	toString()

Methods inherited from class Object

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

Field Details

textStyle

private final DateTimeFormatterBuilder.TextStyle textStyle

The text style to output, null means the id.

preparedTree

private static ZonePrinterParser.SubstringTree preparedTree

The cached tree to speed up parsing.

preparedIDs

private static Set<String> preparedIDs

The cached IDs.

Constructor Details

ZonePrinterParser

ZonePrinterParser()

Constructor.

ZonePrinterParser

ZonePrinterParser(DateTimeFormatterBuilder.TextStyle textStyle)

Constructor.

Parameters:

textStyle - the test style to output, not null

Method Details

print

public void print(Calendrical calendrical,
 Appendable appendable,
 DateTimeFormatSymbols symbols)
           throws IOException

Prints the calendrical object to the appendable.

Specified by:

print in interface DateTimePrinter

Parameters:

calendrical - the calendrical to print, not null

appendable - the appendable to add to, not null

symbols - the formatting symbols to use, not null

Throws:

IOException - if the append throws an exception

isPrintDataAvailable

public boolean isPrintDataAvailable(Calendrical calendrical)

Checks if the calendrical contains the data necessary to be printed.

The implementation should not check the validity of the data, just whether there is sufficient data to attempt a print.

Specified by:

isPrintDataAvailable in interface DateTimePrinter

Parameters:

calendrical - the calendrical to check, not null

Returns:

true if the calendrical can be printed, false if not

parse

public int parse(DateTimeParseContext context,
 String parseText,
 int position)

This implementation looks for the longest matching string. For example, parsing Etc/GMT-2 will return Etc/GMC-2 rather than just Etc/GMC although both are valid.

This implementation uses a tree to search for valid time-zone names in the parseText. The top level node of the tree has a length equal to the length of the shortest time-zone as well as the beginning characters of all other time-zones.

Specified by:

parse in interface DateTimeParser

Parameters:

context - the context to use and parse into, not null

parseText - the input text to parse, not null

position - the position to start parsing at, from 0 to the text length

Returns:

the new parse position, where negative means an error with the error position encoded using the complement ~ operator

prepareParser

private static ZonePrinterParser.SubstringTree prepareParser(Set<String> availableIDs)

Builds an optimized parsing tree.

Parameters:

availableIDs - the available IDs, not null, not empty

Returns:

the tree, never null

toString

public String toString()

Overrides:

toString in class Object