Changeset 7961 in josm for trunk/src/org/openstreetmap/josm

Timestamp:

2015-01-12T23:08:49+01:00 (9 years ago)

Author:

Don-vip

Message:

signature change to allow better flexibility for plugins

File:

• trunk/src/org/openstreetmap/josm/data/osm/PrimitiveDeepCopy.java (modified) (3 diffs)

trunk/src/org/openstreetmap/josm/data/osm/PrimitiveDeepCopy.java

@@ -14 +14 @@
  * This class allows to create and keep a deep copy of primitives. Provides methods to access directly added
  * primitives and reference primitives
- *
+ * @since 2305
  */
 public class PrimitiveDeepCopy {
@@ -26 +26 @@
     private final CopyOnWriteArrayList<PasteBufferChangedListener> listeners = new CopyOnWriteArrayList<>();
 
+    /**
+     * Constructs a new {@code PrimitiveDeepCopy} without data. Use {@link #makeCopy(Collection)} after that.
+     */
     public PrimitiveDeepCopy() {
-
+        // Do nothing
     }
 
-    public PrimitiveDeepCopy(final Collection<OsmPrimitive> primitives) {
+    /**
+     * Constructs a new {@code PrimitiveDeepCopy} of given OSM primitives.
+     * @param primitives OSM primitives to copy
+     * @since 7961
+     */
+    public PrimitiveDeepCopy(final Collection<? extends OsmPrimitive> primitives) {
         makeCopy(primitives);
     }
 
     /**
-     * Replace content of the object with copy of provided primitives
-     * @param primitives
+     * Replace content of the object with copy of provided primitives.
+     * @param primitives OSM primitives to copy
+     * @since 7961
      */
-    public final void makeCopy(final Collection<OsmPrimitive> primitives) {
+    public final void makeCopy(final Collection<? extends OsmPrimitive> primitives) {
         directlyAdded.clear();
         referenced.clear();
@@ -119 +128 @@
         listeners.remove(listener);
     }
-
 }