org.openstreetmap.josm.gui.history

Class HistoryLoadTask

java.lang.Object

org.openstreetmap.josm.gui.PleaseWaitRunnable

org.openstreetmap.josm.gui.history.HistoryLoadTask

All Implemented Interfaces:

Runnable, ProgressMonitor.CancelListener

Direct Known Subclasses:

DownloadOsmChangeTask.HistoryLoaderAndListener

public class HistoryLoadTask
extends PleaseWaitRunnable

Loads the object history of an collection of objects from the server. It provides a fluent API for configuration. Sample usage:

   HistoryLoadTask task  = new HistoryLoadTask()
      .add(1, OsmPrimitiveType.NODE)
      .add(1233, OsmPrimitiveType.WAY)
      .add(37234, OsmPrimitveType.RELATION)
      .add(aHistoryItem);

   Main.worker.execute(task);

 

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	canceled
private Exception	lastException
private HistoryDataSet	loadedData
private OsmServerHistoryReader	reader
private Set<PrimitiveId>	toLoad

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

progressMonitor

Constructor Summary

Constructors

Constructor and Description
HistoryLoadTask()
HistoryLoadTask(Component parent) Creates a new task

Method Summary

Modifier and Type	Method and Description
HistoryLoadTask	add(Collection<? extends OsmPrimitive> primitives) Adds a collection of objects to loaded, specified by a collection of OSM primitives.
HistoryLoadTask	add(History history) Adds an object to be loaded, the object is specified by an already loaded object history.
HistoryLoadTask	add(HistoryOsmPrimitive primitive) Adds an object to be loaded, the object is specified by a history item.
HistoryLoadTask	add(long id, OsmPrimitiveType type) Adds an object whose history is to be loaded.
HistoryLoadTask	add(OsmPrimitive primitive) Adds an object to be loaded, the object is specified by an OSM primitive.
HistoryLoadTask	add(PrimitiveId pid) Adds an object whose history is to be loaded.
protected void	cancel() User pressed cancel button.
protected void	finish() Finish up the data work.
Exception	getLastException()
boolean	isCanceled()
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

canceled

private boolean canceled

lastException

private Exception lastException

toLoad

private Set<PrimitiveId> toLoad

loadedData

private HistoryDataSet loadedData

reader

private OsmServerHistoryReader reader

Constructor Detail

HistoryLoadTask

public HistoryLoadTask()

HistoryLoadTask

public HistoryLoadTask(Component parent)

Creates a new task

Parameters:

parent - the component to be used as reference to find the parent for PleaseWaitDialog. Must not be null.

Throws:

IllegalArgumentException - thrown if parent is null

Method Detail

add

public HistoryLoadTask add(long id,
                           OsmPrimitiveType type)
                    throws IllegalArgumentException

Adds an object whose history is to be loaded.

Parameters:

id - the object id

type - the object type

Returns:

this task

Throws:

IllegalArgumentException

add

public HistoryLoadTask add(PrimitiveId pid)

Adds an object whose history is to be loaded.

Parameters:

pid - the primitive id. Must not be null. Id > 0 required.

Returns:

this task

add

public HistoryLoadTask add(HistoryOsmPrimitive primitive)

Adds an object to be loaded, the object is specified by a history item.

Parameters:

primitive - the history item

Returns:

this task

Throws:

IllegalArgumentException - thrown if primitive is null

add

public HistoryLoadTask add(History history)

Adds an object to be loaded, the object is specified by an already loaded object history.

Parameters:

history - the history. Must not be null.

Returns:

this task

Throws:

IllegalArgumentException - thrown if history is null

add

public HistoryLoadTask add(OsmPrimitive primitive)

Adds an object to be loaded, the object is specified by an OSM primitive.

Parameters:

primitive - the OSM primitive. Must not be null. primitive.getId() > 0 required.

Returns:

this task

Throws:

IllegalArgumentException - thrown if the primitive is null

IllegalArgumentException - thrown if primitive.getId() <= 0

add

public HistoryLoadTask add(Collection<? extends OsmPrimitive> primitives)

Adds a collection of objects to loaded, specified by a collection of OSM primitives.

Parameters:

primitives - the OSM primitives. Must not be null. primitive.getId() > 0 required.

Returns:

this task

Throws:

IllegalArgumentException - thrown if primitives is null

IllegalArgumentException - thrown if one of the ids in the collection <= 0

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

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()

getLastException

public Exception getLastException()