org.eclipse.equinox.internal.p2.updatechecker

Class UpdateChecker

java.lang.Object

org.eclipse.equinox.internal.p2.updatechecker.UpdateChecker

All Implemented Interfaces:

IUpdateChecker

public class UpdateChecker
extends java.lang.Object
implements IUpdateChecker

Default implementation of IUpdateChecker.

This implementation is not optimized. It doesn't optimize for multiple polls on the same profile, nor does it cache any info about a profile from poll to poll.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG
static boolean	TRACE

Fields inherited from interface org.eclipse.equinox.internal.provisional.p2.updatechecker.IUpdateChecker

ONE_TIME_CHECK, SERVICE_NAME

Constructor Summary

Constructors

Constructor and Description
UpdateChecker(IProvisioningAgent agent)

Method Summary

Modifier and Type	Method and Description
void	addUpdateCheck(java.lang.String profileId, <any> query, long delay, long poll, IUpdateListener listener) Adds an update listener that will be notified when updates are available for all installable units that satisfy the given query.
void	removeUpdateCheck(IUpdateListener listener) Removes an update listener from the set of listeners registered with this update checker.

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static boolean DEBUG

TRACE

public static boolean TRACE

Constructor Detail

UpdateChecker

public UpdateChecker(IProvisioningAgent agent)

Method Detail

addUpdateCheck

public void addUpdateCheck(java.lang.String profileId,
                           <any> query,
                           long delay,
                           long poll,
                           IUpdateListener listener)

Description copied from interface: IUpdateChecker

Adds an update listener that will be notified when updates are available for all installable units that satisfy the given query. The listener will remain registered until removed using the IUpdateChecker.removeUpdateCheck(IUpdateListener) method. Adding a listener that is identical to a listener that is already registered has no effect.

Once the listener is registered, it will continue to receive notification of updates based on the specified polling frequency. However, if a delay value of IUpdateChecker.ONE_TIME_CHECK is used, only a single update check will occur for that listener. If this delay value is used, the specified polling frequency is ignored.

Specified by:

addUpdateCheck in interface IUpdateChecker

Parameters:

profileId - The profile id to check for updates

query - An installable unit query that matches the units to check for updates

delay - The delay in milliseconds before the first query should occur, or IUpdateChecker.ONE_TIME_CHECK to indicate that a single update check should occur immediately

poll - The polling frequency, in milliseconds, between checks for updates

listener - The listener to be notified of updates

See Also:

IUpdateChecker.removeUpdateCheck(IUpdateListener)

removeUpdateCheck

public void removeUpdateCheck(IUpdateListener listener)

Description copied from interface: IUpdateChecker

Removes an update listener from the set of listeners registered with this update checker. If an update check is currently in progress the listener may still receive events after this method returns. Removing a listener that is not registered has no effect.

Specified by:

removeUpdateCheck in interface IUpdateChecker

Parameters:

listener - The listener to remove

See Also:

#addUpdateCheck(String, IQuery, long, long, IUpdateListener)