C# Class Ketarin.Updater

Handles the updating process of a list of application jobs.

Afficher le fichier Open project: GitSullied/Ketarin Class Usage Examples

Protected Properties

Свойство	Type	Description
m_LastProgress	int

Méthodes publiques

Méthode	Description
BeginCheckForOnlineUpdates ( ApplicationJob jobs ) : void	Checks for which of the given applications updates are available asynchronously.
BeginUpdate ( ApplicationJob jobs, bool onlyCheck, bool installUpdated ) : void	Starts one or more threads which update the given applications asynchronously.
Cancel ( ) : void	Cancels the updating progress.
GetDownloadSize ( ApplicationJob job ) : long	Returns the download size of a given application in bytes.
GetProgress ( ApplicationJob job ) : short	Returns the progress of the given application.
GetStatus ( ApplicationJob job ) : Status	Returns the current status of a given application.

Méthodes protégées

Méthode	Description
DoDownload ( ApplicationJob job, Uri urlToRequest ) : Status	Executes the actual download from an URL. Does not handle exceptions, but takes care of proper cleanup.
DoDownload ( ApplicationJob job, string &requestedUrl ) : Status	Executes the actual download (determines the URL to download from). Does not handle exceptions, but takes care of proper cleanup.
OnProgressChanged ( long pos, long length, ApplicationJob job ) : void	Fires the ProgressChangedEvent. Only fires if the progress value has changed significantly to prevent (for example) too frequent GUI updates.
OnStatusChanged ( ApplicationJob job ) : void	Fires the StatusChanged event.
OnUpdateCompleted ( ) : void	Fires the UpdateCompleted event.
OnUpdatesFound ( string updatedApps ) : void	Fires the UpdatesFound.

Private Methods

Méthode	Description
AddRequestToCancel ( WebRequest reqest ) : void	Allows all routines involved in the update to store the corresponding WebRequest here. When the user cancels the process, these WebRequests wil be aborted, so that it finishes more or less instantly.
CheckForOnlineUpdates ( object argument ) : void	Checks for which of the given applications updates are available. Fires an event when finished.
GetBaseHost ( Uri uri ) : string	Determines the base host (TLD + server name) of an URI.
GetContentLength ( WebResponse response ) : long	Determines the actual content length in a more reliable way for FTP downloads.
StartNewThread ( object paramJob ) : void	Performs the update process of a single application. Catches most exceptions and stores them for later use.
UpdateApplications ( ) : void	Performs the actual update check for the current applications. Starts multiple threads if necessary.

Method Details

BeginCheckForOnlineUpdates() public méthode

Checks for which of the given applications updates are available asynchronously.

public BeginCheckForOnlineUpdates ( ApplicationJob jobs ) : void
jobs	ApplicationJob
Résultat	void

BeginUpdate() public méthode

Starts one or more threads which update the given applications asynchronously.

public BeginUpdate ( ApplicationJob jobs, bool onlyCheck, bool installUpdated ) : void
jobs	ApplicationJob
onlyCheck	bool	Specifies whether or not to download the updates
installUpdated	bool
Résultat	void

Cancel() public méthode

Cancels the updating progress.

public Cancel ( ) : void
Résultat	void

DoDownload() protected méthode

Executes the actual download from an URL. Does not handle exceptions, but takes care of proper cleanup.

This exception is thrown, if the resulting file is not of a binary type This exception is thrown, if the resulting target path of an application is not valid

protected DoDownload ( ApplicationJob job, Uri urlToRequest ) : Status
job	ApplicationJob	The job to process
urlToRequest	System.Uri	URL from which should be downloaded
Résultat	Status

DoDownload() protected méthode

Executes the actual download (determines the URL to download from). Does not handle exceptions, but takes care of proper cleanup.

protected DoDownload ( ApplicationJob job, string &requestedUrl ) : Status
job	ApplicationJob	The job to process
requestedUrl	string	The URL from which has been downloaded
Résultat	Status

GetDownloadSize() public méthode

Returns the download size of a given application in bytes.

public GetDownloadSize ( ApplicationJob job ) : long
job	ApplicationJob
Résultat	long

GetProgress() public méthode

Returns the progress of the given application.

public GetProgress ( ApplicationJob job ) : short
job	ApplicationJob
Résultat	short

GetStatus() public méthode

Returns the current status of a given application.

public GetStatus ( ApplicationJob job ) : Status
job	ApplicationJob
Résultat	Status

OnProgressChanged() protected méthode

Fires the ProgressChangedEvent. Only fires if the progress value has changed significantly to prevent (for example) too frequent GUI updates.

protected OnProgressChanged ( long pos, long length, ApplicationJob job ) : void
pos	long	Current position of the stream
length	long	Total length of the stream
job	ApplicationJob	Current ApplicationJob
Résultat	void

OnStatusChanged() protected méthode

Fires the StatusChanged event.

protected OnStatusChanged ( ApplicationJob job ) : void
job	ApplicationJob
Résultat	void

OnUpdateCompleted() protected méthode

Fires the UpdateCompleted event.

protected OnUpdateCompleted ( ) : void
Résultat	void

OnUpdatesFound() protected méthode

Fires the UpdatesFound.

protected OnUpdatesFound ( string updatedApps ) : void
updatedApps	string
Résultat	void

Property Details

m_LastProgress protected_oe property

protected int m_LastProgress
Résultat	int