Package org.eblocker.server.common.update

Interface SystemUpdater

All Known Implementing Classes:

DebianUpdater

public interface SystemUpdater

Runs system updates. Only one instance should exist.

System updates usually take a few seconds (or minutes), so this is an asynchronous interface. You can start an update and ask if an update is in progress.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	SystemUpdater.State

Method Summary

Modifier and Type	Method	Description
java.time.LocalDateTime	getLastUpdateTime()	Get the last time an update was executed.
List<String>	getUpdateProgress()	Returns a list of notable update progress events
SystemUpdater.State	getUpdateStatus()
UpdatingStatus	getUpdatingStatus()
boolean	invalidLicense()	Checks whether the license is invalid, i.e. invalid registration credentials or license revoked.
boolean	pinEblockerListsPackage()	Creates a apt-pinning file named for eblocker lists to prevent upgrading eblocker lists.
void	startDownload()	Starts downloading new updates
void	startUpdate()	Starts an update.
void	startUpdateRecovery()	Start the update recovery process.
boolean	unpinEblockerListsPackage()	Delete the pinning of the eblocker-lists package
boolean	updatesAvailable()	Checks whether new updates are available.
List<String>	updatesAvailablePackages()	Returns a list of package updates

Method Details

startUpdate

void startUpdate()
          throws IOException,
InterruptedException,
EblockerException

Starts an update. If the current state is not State.NOT_UPDATING or the device is not registered or the subscription is not valid, calling this method has no effect.

Throws:

IOException

InterruptedException

EblockerException

startUpdateRecovery

void startUpdateRecovery()
                  throws IOException,
InterruptedException

Start the update recovery process.

Throws:

IOException

InterruptedException

getUpdateStatus

SystemUpdater.State getUpdateStatus()
                             throws IOException,
InterruptedException

Returns:

the update state

Throws:

InterruptedException

IOException

getLastUpdateTime

java.time.LocalDateTime getLastUpdateTime()

Get the last time an update was executed.

Returns:

startDownload

void startDownload()
            throws IOException,
InterruptedException

Starts downloading new updates

Throws:

InterruptedException

IOException

updatesAvailable

boolean updatesAvailable()
                  throws IOException,
InterruptedException

Checks whether new updates are available.

Returns:

the update state

Throws:

InterruptedException

IOException

updatesAvailablePackages

List<String> updatesAvailablePackages()

Returns a list of package updates

Returns:

A list of new updates. The list is empty if no updates are available.

getUpdateProgress

List<String> getUpdateProgress()

Returns a list of notable update progress events

Returns:

A list like "Unpacked ..., Installed ..." or an empty list if no progress was made.

invalidLicense

boolean invalidLicense()

Checks whether the license is invalid, i.e. invalid registration credentials or license revoked. No new revocation test call will be made but cached data will be used.

Returns:

True if the license is invalid, false if not.

pinEblockerListsPackage

boolean pinEblockerListsPackage()
                         throws IOException,
InterruptedException

Creates a apt-pinning file named for eblocker lists to prevent upgrading eblocker lists.

Returns:

True if the successful, otherwise false.

Throws:

IOException

InterruptedException

unpinEblockerListsPackage

boolean unpinEblockerListsPackage()
                           throws IOException,
InterruptedException

Delete the pinning of the eblocker-lists package

Returns:

True if the successful, otherwise false.

Throws:

IOException

InterruptedException

getUpdatingStatus

UpdatingStatus getUpdatingStatus()
                          throws IOException,
InterruptedException

Throws:

IOException

InterruptedException