com.google.gwt.dev.shell

Class CheckForUpdates

java.lang.Object

com.google.gwt.dev.shell.CheckForUpdates

Direct Known Subclasses:

CheckForUpdatesIE6

public class CheckForUpdates
extends Object

Orchestrates a best-effort attempt to find out if a new version of GWT is available.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CheckForUpdates.UpdateResult Returns the result of an update check.

Field Summary

Fields

Modifier and Type	Field and Description
static long	ONE_DAY
static long	ONE_MINUTE
protected static String	PROPERTY_DEBUG_HTTP_GET
protected static String	PROPERTY_FORCE_NONNATIVE
protected static String	PROPERTY_PREFS_NAME
protected static String	PROPERTY_QUERY_URL

Constructor Summary

Constructors

Constructor and Description
CheckForUpdates(TreeLogger logger, String entryPoint) Create an update checker which will poll a server URL and log a message about an update if available.

Method Summary

Modifier and Type	Method and Description
CheckForUpdates.UpdateResult	check() Check for updates and log to the logger if they are available.
CheckForUpdates.UpdateResult	check(long minCheckMillis) Check for updates and log to the logger if they are available.
static FutureTask<CheckForUpdates.UpdateResult>	checkForUpdatesInBackgroundThread(TreeLogger logger, long minCheckMillis)
static String	computeEntryPoint() Find the first method named "main" on the call stack and use its class as the entry point.
static CheckForUpdates	createUpdateChecker(TreeLogger logger)
static CheckForUpdates	createUpdateChecker(TreeLogger logger, String entryPoint)
protected byte[]	doHttpGet(TreeLogger branch, String userAgent, String url) Default implementation just uses the platform-independent method.
protected byte[]	httpGetNonNative(TreeLogger branch, String userAgent, String url) This default implementation uses regular Java HTTP, which doesn't deal with proxies automagically.
static void	logUpdateAvailable(TreeLogger logger, CheckForUpdates.UpdateResult result)
static void	logUpdateAvailable(TreeLogger logger, FutureTask<CheckForUpdates.UpdateResult> updater)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Field Detail

ONE_DAY

public static final long ONE_DAY

See Also:

Constant Field Values

ONE_MINUTE

public static final long ONE_MINUTE

See Also:

Constant Field Values

PROPERTY_DEBUG_HTTP_GET

protected static final String PROPERTY_DEBUG_HTTP_GET

See Also:

Constant Field Values

PROPERTY_FORCE_NONNATIVE

protected static final String PROPERTY_FORCE_NONNATIVE

See Also:

Constant Field Values

PROPERTY_PREFS_NAME

protected static final String PROPERTY_PREFS_NAME

See Also:

Constant Field Values

PROPERTY_QUERY_URL

protected static final String PROPERTY_QUERY_URL

See Also:

Constant Field Values

Constructor Detail

CheckForUpdates

public CheckForUpdates(TreeLogger logger,
                       String entryPoint)

Create an update checker which will poll a server URL and log a message about an update if available.

Parameters:

logger - TreeLogger to use

entryPoint - the name of the main entry point used for this execution

Method Detail

checkForUpdatesInBackgroundThread

public static FutureTask<CheckForUpdates.UpdateResult> checkForUpdatesInBackgroundThread(TreeLogger logger,
                                                                                         long minCheckMillis)

computeEntryPoint

public static String computeEntryPoint()

Find the first method named "main" on the call stack and use its class as the entry point.

createUpdateChecker

public static CheckForUpdates createUpdateChecker(TreeLogger logger)

createUpdateChecker

public static CheckForUpdates createUpdateChecker(TreeLogger logger,
                                                  String entryPoint)

logUpdateAvailable

public static void logUpdateAvailable(TreeLogger logger,
                                      FutureTask<CheckForUpdates.UpdateResult> updater)

logUpdateAvailable

public static void logUpdateAvailable(TreeLogger logger,
                                      CheckForUpdates.UpdateResult result)

check

public CheckForUpdates.UpdateResult check()

Check for updates and log to the logger if they are available.

Returns:

an UpdateResult or null if there is no new update

check

public CheckForUpdates.UpdateResult check(long minCheckMillis)

Check for updates and log to the logger if they are available.

Returns:

an UpdateResult or null if there is no new update

doHttpGet

protected byte[] doHttpGet(TreeLogger branch,
                           String userAgent,
                           String url)

Default implementation just uses the platform-independent method. A subclass should override this method for platform-dependent proxy handling, for example.

Parameters:

branch - TreeLogger to use

userAgent - user agent string to send in request

url - URL to fetch

Returns:

byte array of response, or null if an error

httpGetNonNative

protected byte[] httpGetNonNative(TreeLogger branch,
                                  String userAgent,
                                  String url)

This default implementation uses regular Java HTTP, which doesn't deal with proxies automagically. See the IE6 subclasses for an implementation that does deal with proxies.

Parameters:

branch - TreeLogger to use

userAgent - user agent string to send in request

url - URL to fetch

Returns:

byte array of response, or null if an error