cz.mallat.uasparser

Class OnlineUpdater

java.lang.Object

java.lang.Thread

cz.mallat.uasparser.OnlineUpdater

All Implemented Interfaces:

java.lang.Runnable

public class OnlineUpdater
extends java.lang.Thread

An updater which runs in a separate background thread and will update once per day.

The updated UA strings are cached on disk. If no cached copy is found on start, one will be fetched immediately. If this initial update fails, it will fallback to an included copy.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CACHE_FILENAME
protected java.io.File	cacheFile
protected int	currentVersion
protected static java.lang.String	DATA_RETRIVE_URL
protected UASparser	parser
static java.lang.String	PROPERTIES_FILENAME
protected java.io.File	propsFile
protected long	updateInterval
protected static java.lang.String	VERSION_CHECK_URL

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
OnlineUpdater(UASparser parser) Create a new updater with the default interval of 1 day
OnlineUpdater(UASparser parser, java.lang.String cacheDir, long interval, java.util.concurrent.TimeUnit units) Create a new updater

Method Summary

Methods

Modifier and Type	Method and Description
protected void	copyFile(java.io.File src, java.io.File dest) Copy source file to destination
static java.io.InputStream	getVendoredInputStream() Retrieve an InputStream to the vendored copy of the UA strings file.
protected int	getVersionFromServer() Gets the current version from user-agent-string.info
void	init() Initialize the parser with cached data.
protected java.util.List<Section>	loadDataFromInternet() Loads the data file from user-agent-string.info and caches it on disk
void	run() Update loop
boolean	update() Fetch latest UA file if a newer one is available

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

CACHE_FILENAME

public static final java.lang.String CACHE_FILENAME

See Also:

Constant Field Values

PROPERTIES_FILENAME

public static final java.lang.String PROPERTIES_FILENAME

See Also:

Constant Field Values

DATA_RETRIVE_URL

protected static final java.lang.String DATA_RETRIVE_URL

See Also:

Constant Field Values

VERSION_CHECK_URL

protected static final java.lang.String VERSION_CHECK_URL

See Also:

Constant Field Values

updateInterval

protected final long updateInterval

currentVersion

protected int currentVersion

parser

protected UASparser parser

cacheFile

protected java.io.File cacheFile

propsFile

protected java.io.File propsFile

Constructor Detail

OnlineUpdater

public OnlineUpdater(UASparser parser)

Create a new updater with the default interval of 1 day

Parameters:

parser - Parser instance to update

OnlineUpdater

public OnlineUpdater(UASparser parser,
             java.lang.String cacheDir,
             long interval,
             java.util.concurrent.TimeUnit units)

Create a new updater

Parameters:

parser - Parser instance to update

cacheDir - directory where file should be cached. If null, uses system temp dir

interval - number of intervals for the given units

units - unit type

Method Detail

init

public void init()

Initialize the parser with cached data. Falls back to vendored copy if no cache is available.

getVendoredInputStream

public static java.io.InputStream getVendoredInputStream()

Retrieve an InputStream to the vendored copy of the UA strings file.

Returns:

InputStream

update

public boolean update()

Fetch latest UA file if a newer one is available

Returns:

boolean True if parser was updated.

run

public void run()

Update loop

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

loadDataFromInternet

protected java.util.List<Section> loadDataFromInternet()
                                                throws java.io.IOException

Loads the data file from user-agent-string.info and caches it on disk

Returns:

Throws:

java.io.IOException

copyFile

protected void copyFile(java.io.File src,
            java.io.File dest)
                 throws java.io.FileNotFoundException,
                        java.io.IOException

Copy source file to destination

Parameters:

src -

dest -

Throws:

java.io.FileNotFoundException

java.io.IOException

getVersionFromServer

protected int getVersionFromServer()
                            throws java.io.IOException

Gets the current version from user-agent-string.info

Returns:

long version number (e.g., 2013012301)

Throws:

java.io.IOException

{@link - NumberFormatException}