Package org.joda.time.tz

Class ZoneInfoCompiler

java.lang.Object

org.joda.time.tz.ZoneInfoCompiler

public class ZoneInfoCompiler
extends Object

Compiles standard format time zone data files into binary files for each time zone in the database. DateTimeZoneBuilder is used to construct and encode compiled data files. ZoneInfoProvider loads the encoded files and converts them back into DateTimeZone objects.

Although this tool is similar to zic, the binary formats are not compatible. The latest time zone database files may be obtained here.

ZoneInfoCompiler is mutable and not thread-safe, although the main method may be safely invoked by multiple threads.

Since:

1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	ZoneInfoCompiler.DateTimeOfYear
(package private) static class	ZoneInfoCompiler.Rule
private static class	ZoneInfoCompiler.RuleSet
private static class	ZoneInfoCompiler.Zone

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static Chronology	cLenientISO
(package private) static ZoneInfoCompiler.DateTimeOfYear	cStartOfYear
(package private) static final Map<String,Integer>	DOW_LOOKUP
private List<String>	iBackLinks
private List<String>	iGoodLinks
private Map<String,ZoneInfoCompiler.RuleSet>	iRuleSets
private List<ZoneInfoCompiler.Zone>	iZones
(package private) static final Set<String>	LINK_LOOKUP
(package private) static final Set<String>	MAX_YEAR_LOOKUP
(package private) static final Set<String>	MIN_YEAR_LOOKUP
(package private) static final Map<String,Integer>	MONTH_LOOKUP
(package private) static final Set<String>	ONLY_YEAR_LOOKUP
(package private) static final Set<String>	RULE_LOOKUP
(package private) static final Set<String>	ZONE_LOOKUP

Constructor Summary

Constructors

Constructor	Description
ZoneInfoCompiler()

Method Summary

Modifier and Type	Method	Description
Map<String,DateTimeZone>	compile(File outputDir, File[] sources)	Returns a map of ids to DateTimeZones.
private static Set<String>	expand(String whole, String shortest)
(package private) static Chronology	getLenientISOChronology()
(package private) static ZoneInfoCompiler.DateTimeOfYear	getStartOfYear()
static void	main(String[] args)	Launches the ZoneInfoCompiler tool.
void	parseDataFile(BufferedReader in, boolean backward)
(package private) static int	parseDayOfWeek(String str)
(package private) static int	parseMonth(String str)
(package private) static String	parseOptional(String str)
(package private) static int	parseTime(String str)
(package private) static int	parseYear(String str, int def)
(package private) static char	parseZoneChar(char c)
private static void	printUsage()
private static void	put(Set<String> strs, int value, Map<String,Integer> map)
(package private) static boolean	test(String id, DateTimeZone tz)
private void	writeZone(File outputDir, DateTimeZoneBuilder builder, DateTimeZone tz)
(package private) static void	writeZoneInfoMap(DataOutputStream dout, Map<String,DateTimeZone> zimap)

Methods inherited from class java.lang.Object

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

Field Details

cStartOfYear

static ZoneInfoCompiler.DateTimeOfYear cStartOfYear

cLenientISO

static Chronology cLenientISO

RULE_LOOKUP

static final Set<String> RULE_LOOKUP

ZONE_LOOKUP

static final Set<String> ZONE_LOOKUP

LINK_LOOKUP

static final Set<String> LINK_LOOKUP

MIN_YEAR_LOOKUP

static final Set<String> MIN_YEAR_LOOKUP

MAX_YEAR_LOOKUP

static final Set<String> MAX_YEAR_LOOKUP

ONLY_YEAR_LOOKUP

static final Set<String> ONLY_YEAR_LOOKUP

MONTH_LOOKUP

static final Map<String,Integer> MONTH_LOOKUP

DOW_LOOKUP

static final Map<String,Integer> DOW_LOOKUP

iRuleSets

private Map<String,ZoneInfoCompiler.RuleSet> iRuleSets

iZones

private List<ZoneInfoCompiler.Zone> iZones

iGoodLinks

private List<String> iGoodLinks

iBackLinks

private List<String> iBackLinks

Constructor Details

ZoneInfoCompiler

public ZoneInfoCompiler()

Method Details

put

private static void put(Set<String> strs,
 int value,
 Map<String,Integer> map)

expand

private static Set<String> expand(String whole,
 String shortest)

main

public static void main(String[] args)
                 throws Exception

Launches the ZoneInfoCompiler tool.

 Usage: java org.joda.time.tz.ZoneInfoCompiler <options> <source files>
 where possible options include:
   -src <directory>    Specify where to read source files
   -dst <directory>    Specify where to write generated files
   -verbose            Output verbosely (default false)
 

Throws:

Exception

printUsage

private static void printUsage()

getStartOfYear

static ZoneInfoCompiler.DateTimeOfYear getStartOfYear()

getLenientISOChronology

static Chronology getLenientISOChronology()

writeZoneInfoMap

static void writeZoneInfoMap(DataOutputStream dout,
 Map<String,DateTimeZone> zimap)
                      throws IOException

Parameters:

zimap - maps string ids to DateTimeZone objects.

Throws:

IOException

parseYear

static int parseYear(String str,
 int def)

parseMonth

static int parseMonth(String str)

parseDayOfWeek

static int parseDayOfWeek(String str)

parseOptional

static String parseOptional(String str)

parseTime

static int parseTime(String str)

parseZoneChar

static char parseZoneChar(char c)

test

static boolean test(String id,
 DateTimeZone tz)

Returns:

false if error.

compile

public Map<String,DateTimeZone> compile(File outputDir,
 File[] sources)
                                 throws IOException

Returns a map of ids to DateTimeZones.

Parameters:

outputDir - optional directory to write compiled data files to

sources - optional list of source files to parse

Throws:

IOException

writeZone

private void writeZone(File outputDir,
 DateTimeZoneBuilder builder,
 DateTimeZone tz)
                throws IOException

Throws:

IOException

parseDataFile

public void parseDataFile(BufferedReader in,
 boolean backward)
                   throws IOException

Throws:

IOException