Package org.joda.time.tz

Class ZoneInfoCompiler

java.lang.Object

org.joda.time.tz.ZoneInfoCompiler

public class ZoneInfoCompiler
extends java.lang.Object

Compiles IANA ZoneInfo database 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 IANA 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
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
private java.util.List<java.lang.String>	iBackLinks
private java.util.List<java.lang.String>	iGoodLinks
private java.util.Map<java.lang.String,ZoneInfoCompiler.RuleSet>	iRuleSets
private java.util.List<ZoneInfoCompiler.Zone>	iZones

Constructor Summary

Constructors

Constructor	Description
ZoneInfoCompiler()

Method Summary

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

Methods inherited from class java.lang.Object

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

Field Detail

cStartOfYear

static ZoneInfoCompiler.DateTimeOfYear cStartOfYear

cLenientISO

static Chronology cLenientISO

iRuleSets

private java.util.Map<java.lang.String,ZoneInfoCompiler.RuleSet> iRuleSets

iZones

private java.util.List<ZoneInfoCompiler.Zone> iZones

iGoodLinks

private java.util.List<java.lang.String> iGoodLinks

iBackLinks

private java.util.List<java.lang.String> iBackLinks

Constructor Detail

ZoneInfoCompiler

public ZoneInfoCompiler()

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.lang.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:

java.lang.Exception

printUsage

private static void printUsage()

getStartOfYear

static ZoneInfoCompiler.DateTimeOfYear getStartOfYear()

getLenientISOChronology

static Chronology getLenientISOChronology()

writeZoneInfoMap

static void writeZoneInfoMap(java.io.DataOutputStream dout,
                             java.util.Map<java.lang.String,DateTimeZone> zimap)
                      throws java.io.IOException

Parameters:

zimap - maps string ids to DateTimeZone objects.

Throws:

java.io.IOException

parseYear

static int parseYear(java.lang.String str,
                     int def)

parseMonth

static int parseMonth(java.lang.String str)

parseDayOfWeek

static int parseDayOfWeek(java.lang.String str)

parseOptional

static java.lang.String parseOptional(java.lang.String str)

parseTime

static int parseTime(java.lang.String str)

parseZoneChar

static char parseZoneChar(char c)

test

static boolean test(java.lang.String id,
                    DateTimeZone tz)

Returns:

false if error.

compile

public java.util.Map<java.lang.String,DateTimeZone> compile(java.io.File outputDir,
                                                                  java.io.File[] sources)
                                                           throws java.io.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:

java.io.IOException

writeZone

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

Throws:

java.io.IOException

parseDataFile

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

Throws:

java.io.IOException