us.daveread.basicquery.util

Class CheckLatestVersion

java.lang.Object

java.util.Observable

us.daveread.basicquery.util.CheckLatestVersion

All Implemented Interfaces:

java.lang.Runnable

public class CheckLatestVersion
extends java.util.Observable
implements java.lang.Runnable

Checks for the latest version information. Version identifier string must be in the form of MAJOR#.MINOR#.PATCH# with 1 or 2 digits for each part. e.g. 1.8.3

Author:

David Read

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	currentVersion The current version of the application
private int	latestVersionValue The calculated value of the latest version.
private static org.apache.log4j.Logger	LOGGER Logger Instance
private static int	MAX_NEW_FEATURES_MESSAGE_LINES Maximum number of lines in the upgrade message
private NewVersionInformation	newVersionInformation Information regarding the newest version.
private static java.lang.String	VERSION_INFO_URL URL to version information

Constructor Summary

Constructors

Constructor and Description
CheckLatestVersion(java.lang.String pCurrentVersion) Create an instance that will identify if a version newer than the supplied one exists.

Method Summary

Methods

Modifier and Type	Method and Description
private java.lang.String	getVersionInfoFromWebsite() Download the version history information from the website.
void	run()
private void	setupVersionInfo() Get version information from the website and check if any listed versions are newer than the current version.
private void	setupVersionMessage(java.lang.String informationFromWebsite) Determine if a newer version of the application exists and if so setup the newVersionInformation instance with information regarding the newest version.
private int	versionParser(java.lang.String version) Converts a version string MAJOR#.MINOR#.PATCH# into an integer so that versions can be compared numerically.

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Field Detail

VERSION_INFO_URL

private static final java.lang.String VERSION_INFO_URL

URL to version information

See Also:

Constant Field Values

LOGGER

private static final org.apache.log4j.Logger LOGGER

Logger Instance

MAX_NEW_FEATURES_MESSAGE_LINES

private static final int MAX_NEW_FEATURES_MESSAGE_LINES

Maximum number of lines in the upgrade message

See Also:

Constant Field Values

currentVersion

private java.lang.String currentVersion

The current version of the application

latestVersionValue

private int latestVersionValue

The calculated value of the latest version. Used in order to identify keep track of the most recent version identified from the list of newer versions.

newVersionInformation

private NewVersionInformation newVersionInformation

Information regarding the newest version. This is only created if there is a newer version than the currently running version.

Constructor Detail

CheckLatestVersion

public CheckLatestVersion(java.lang.String pCurrentVersion)

Create an instance that will identify if a version newer than the supplied one exists.

Parameters:

pCurrentVersion - The current version (#.#.# format)

Method Detail

run

public void run()

Specified by:

run in interface java.lang.Runnable

setupVersionInfo

private void setupVersionInfo()

Get version information from the website and check if any listed versions are newer than the current version.

getVersionInfoFromWebsite

private java.lang.String getVersionInfoFromWebsite()

Download the version history information from the website.

Returns:

The version history information

setupVersionMessage

private void setupVersionMessage(java.lang.String informationFromWebsite)

Determine if a newer version of the application exists and if so setup the newVersionInformation instance with information regarding the newest version.

Parameters:

informationFromWebsite - Downloadeed version information

versionParser

private int versionParser(java.lang.String version)

Converts a version string MAJOR#.MINOR#.PATCH# into an integer so that versions can be compared numerically. There can only be 1 or 2 digits for each value for this to work properly.

Parameters:

version - The version string (#.#.#)

Returns:

An integer value suitable for comparing versions numerically