org.openstreetmap.josm.command

Class ChangePropertyCommand

java.lang.Object

org.openstreetmap.josm.command.PseudoCommand

org.openstreetmap.josm.command.Command

org.openstreetmap.josm.command.ChangePropertyCommand

public class ChangePropertyCommand
extends Command

Command that manipulate the key/value structure of several objects. Manages deletion, adding and modify of values and keys.

Since:

24

Nested Class Summary

Nested classes/interfaces inherited from class org.openstreetmap.josm.command.Command

Command.OldNodeState

Field Summary

Fields

Modifier and Type	Field and Description
private List<OsmPrimitive>	objects All primitives that are affected with this command.
private Map<String,String>	tags Key and value pairs.

Constructor Summary

Constructors

Constructor and Description
ChangePropertyCommand(Collection<? extends OsmPrimitive> objects, Map<String,String> tags) Creates a command to change multiple tags of multiple objects
ChangePropertyCommand(Collection<? extends OsmPrimitive> objects, String key, String value) Creates a command to change one tag of multiple objects
ChangePropertyCommand(OsmPrimitive object, String key, String value) Creates a command to change one tag of one object

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
boolean	executeCommand() Executes the command on the dataset.
void	fillModifiedData(Collection<OsmPrimitive> modified, Collection<OsmPrimitive> deleted, Collection<OsmPrimitive> added) Fill in the changed data this command operates on.
Collection<PseudoCommand>	getChildren() Returns the subcommands of this command.
Icon	getDescriptionIcon() Provides a descriptive icon of this command.
String	getDescriptionText() Provides a description text representing this command.
int	getObjectsNumber() Returns the number of objects that will effectively be modified, before the command is executed.
Map<String,String>	getTags() Returns the tags to set (key/value pairs).
int	hashCode()
private void	init(Collection<? extends OsmPrimitive> objects) Initialize the instance by finding what objects will be modified

Methods inherited from class org.openstreetmap.josm.command.Command

checkAndConfirmOutlyingOperation, getLayer, getOrig, getParticipatingPrimitives, invalidBecauselayerRemoved, undoCommand

Methods inherited from class java.lang.Object

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

Field Detail

objects

private final List<OsmPrimitive> objects

All primitives that are affected with this command.

tags

private final Map<String,String> tags

Key and value pairs. If value is null, delete all key references with the given key. Otherwise, change the tags of all objects to the given value or create keys of those objects that do not have the key yet.

Constructor Detail

ChangePropertyCommand

public ChangePropertyCommand(Collection<? extends OsmPrimitive> objects,
                             Map<String,String> tags)

Creates a command to change multiple tags of multiple objects

Parameters:

objects - the objects to modify

tags - the tags to set

ChangePropertyCommand

public ChangePropertyCommand(Collection<? extends OsmPrimitive> objects,
                             String key,
                             String value)

Creates a command to change one tag of multiple objects

Parameters:

objects - the objects to modify

key - the key of the tag to set

value - the value of the key to set

ChangePropertyCommand

public ChangePropertyCommand(OsmPrimitive object,
                             String key,
                             String value)

Creates a command to change one tag of one object

Parameters:

object - the object to modify

key - the key of the tag to set

value - the value of the key to set

Method Detail

init

private void init(Collection<? extends OsmPrimitive> objects)

Initialize the instance by finding what objects will be modified

Parameters:

objects - the objects to (possibly) modify

executeCommand

public boolean executeCommand()

Description copied from class: Command

Executes the command on the dataset. This implementation will remember all primitives returned by fillModifiedData for restoring them on undo.

Overrides:

executeCommand in class Command

Returns:

true

fillModifiedData

public void fillModifiedData(Collection<OsmPrimitive> modified,
                             Collection<OsmPrimitive> deleted,
                             Collection<OsmPrimitive> added)

Description copied from class: Command

Fill in the changed data this command operates on. Add to the lists, don't clear them.

Specified by:

fillModifiedData in class Command

Parameters:

modified - The modified primitives

deleted - The deleted primitives

added - The added primitives

getDescriptionText

public String getDescriptionText()

Description copied from class: PseudoCommand

Provides a description text representing this command.

Specified by:

getDescriptionText in class PseudoCommand

Returns:

description text representing this command

getDescriptionIcon

public Icon getDescriptionIcon()

Description copied from class: PseudoCommand

Provides a descriptive icon of this command.

Overrides:

getDescriptionIcon in class PseudoCommand

Returns:

descriptive icon of this command

getChildren

public Collection<PseudoCommand> getChildren()

Description copied from class: PseudoCommand

Returns the subcommands of this command. Override for subclasses that have child commands.

Overrides:

getChildren in class PseudoCommand

Returns:

the subcommands, null if there are no child commands

getObjectsNumber

public final int getObjectsNumber()

Returns the number of objects that will effectively be modified, before the command is executed.

Returns:

the number of objects that will effectively be modified (can be 0)

Since:

8945

See Also:

Command.getParticipatingPrimitives()

getTags

public Map<String,String> getTags()

Returns the tags to set (key/value pairs).

Returns:

the tags to set (key/value pairs)

hashCode

public int hashCode()

Overrides:

hashCode in class Command

equals

public boolean equals(Object obj)

Overrides:

equals in class Command