org.openstreetmap.josm.plugins

Class ReadRemotePluginInformationTask

java.lang.Object

org.openstreetmap.josm.gui.PleaseWaitRunnable

org.openstreetmap.josm.plugins.ReadRemotePluginInformationTask

All Implemented Interfaces:

Runnable, ProgressMonitor.CancelListener

public class ReadRemotePluginInformationTask
extends PleaseWaitRunnable

An asynchronous task for downloading plugin lists from the configured plugin download sites.

Since:

2817

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ReadRemotePluginInformationTask.CacheType

Field Summary

Fields

Modifier and Type	Field and Description
private List<PluginInformation>	availablePlugins
private boolean	canceled
private HttpURLConnection	connection
private Collection<String>	sites

Fields inherited from class org.openstreetmap.josm.gui.PleaseWaitRunnable

progressMonitor

Constructor Summary

Constructors

Constructor and Description
ReadRemotePluginInformationTask(Collection<String> sites) Creates the task
ReadRemotePluginInformationTask(ProgressMonitor monitor, Collection<String> sites) Creates the task

Method Summary

Modifier and Type	Method and Description
protected void	cachePluginList(String site, String list) Writes the list of plugins to a cache file
protected void	cancel() User pressed cancel button.
protected File	createSiteCacheFile(File pluginDir, String site, ReadRemotePluginInformationTask.CacheType type) Creates the file name for the cached plugin list and the icon cache file.
protected void	downloadPluginIcons(String site, File destFile, ProgressMonitor monitor) Downloads the icon archive from a remote location
protected String	downloadPluginList(String site, ProgressMonitor monitor) Downloads the list from a remote location
protected List<PluginInformation>	filterDeprecatedPlugins(List<PluginInformation> plugins) Filter information about deprecated plugins from the list of downloaded plugins
protected void	finish() Finish up the data work.
List<PluginInformation>	getAvailablePlugins() Replies the list of plugins described in the downloaded plugin lists
private void	handleIOException(ProgressMonitor monitor, IOException e, String title, String firstMessage)
protected void	init(Collection<String> sites)
boolean	isCanceled() Replies true if the task was canceled
protected void	parsePluginListDocument(String site, String doc) Parses the plugin list
protected void	realRun() Called in the worker thread to do the actual work.

Methods inherited from class org.openstreetmap.josm.gui.PleaseWaitRunnable

afterFinish, canRunInBackground, getProgressMonitor, operationCanceled, run

Methods inherited from class java.lang.Object

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

Field Detail

sites

private Collection<String> sites

canceled

private boolean canceled

connection

private HttpURLConnection connection

availablePlugins

private List<PluginInformation> availablePlugins

Constructor Detail

ReadRemotePluginInformationTask

public ReadRemotePluginInformationTask(Collection<String> sites)

Creates the task

Parameters:

sites - the collection of download sites. Defaults to the empty collection if null.

ReadRemotePluginInformationTask

public ReadRemotePluginInformationTask(ProgressMonitor monitor,
                                       Collection<String> sites)

Creates the task

Parameters:

monitor - the progress monitor. Defaults to NullProgressMonitor.INSTANCE if null

sites - the collection of download sites. Defaults to the empty collection if null.

Method Detail

init

protected void init(Collection<String> sites)

cancel

protected void cancel()

Description copied from class: PleaseWaitRunnable

User pressed cancel button.

Specified by:

cancel in class PleaseWaitRunnable

finish

protected void finish()

Description copied from class: PleaseWaitRunnable

Finish up the data work. Is guaranteed to be called if realRun is called. Finish is called in the gui thread just after the dialog disappeared.

Specified by:

finish in class PleaseWaitRunnable

createSiteCacheFile

protected File createSiteCacheFile(File pluginDir,
                                   String site,
                                   ReadRemotePluginInformationTask.CacheType type)

Creates the file name for the cached plugin list and the icon cache file.

Parameters:

site - the name of the site

type - icon cache or plugin list cache

Returns:

the file name for the cache file

downloadPluginList

protected String downloadPluginList(String site,
                                    ProgressMonitor monitor)

Downloads the list from a remote location

Parameters:

site - the site URL

monitor - a progress monitor

Returns:

the downloaded list

handleIOException

private void handleIOException(ProgressMonitor monitor,
                               IOException e,
                               String title,
                               String firstMessage)

downloadPluginIcons

protected void downloadPluginIcons(String site,
                                   File destFile,
                                   ProgressMonitor monitor)

Downloads the icon archive from a remote location

Parameters:

site - the site URL

monitor - a progress monitor

cachePluginList

protected void cachePluginList(String site,
                               String list)

Writes the list of plugins to a cache file

Parameters:

site - the site from where the list was downloaded

list - the downloaded list

filterDeprecatedPlugins

protected List<PluginInformation> filterDeprecatedPlugins(List<PluginInformation> plugins)

Filter information about deprecated plugins from the list of downloaded plugins

Parameters:

plugins - the plugin informations

Returns:

the plugin informations, without deprecated plugins

parsePluginListDocument

protected void parsePluginListDocument(String site,
                                       String doc)

Parses the plugin list

Parameters:

site - the site from where the list was downloaded

doc - the document with the plugin list

realRun

protected void realRun()
                throws SAXException,
                       IOException,
                       OsmTransferException

Description copied from class: PleaseWaitRunnable

Called in the worker thread to do the actual work. When any of the exception is thrown, a message box will be displayed and closeDialog is called. finish() is called in any case.

Specified by:

realRun in class PleaseWaitRunnable

Throws:

SAXException

IOException

OsmTransferException

isCanceled

public boolean isCanceled()

Replies true if the task was canceled

Returns:

true if the task was stopped by the user

getAvailablePlugins

public List<PluginInformation> getAvailablePlugins()

Replies the list of plugins described in the downloaded plugin lists

Returns:

the list of plugins

Since:

5601