feat: add withQualifiers(Map) to PackageURLBuilder

src/main/java/com/github/packageurl/PackageURLBuilder.java

@@ -21,6 +21,8 @@
  */
 package com.github.packageurl;
 
+import java.util.Map;
+import java.util.Set;
 import java.util.TreeMap;
 
 /**
@@ -35,7 +37,7 @@ public final class PackageURLBuilder {
     private TreeMap<String, String> qualifiers = null;
 
     private PackageURLBuilder() {
-        //empty constructor for utility class
+        // empty constructor for utility class
     }
 
     /**
@@ -124,6 +126,26 @@ public PackageURLBuilder withQualifier(final String key, final String value) {
         return this;
     }
 
+    /**
+     * Adds the package qualifiers.
+     *
+     * @param qualifiers the package qualifiers
+     * @return a reference to the builder
+     * @see PackageURL#getQualifiers()
+     */
+    public PackageURLBuilder withQualifiers(final Map<String, String> qualifiers) {
+        if (qualifiers == null) {
+            this.qualifiers = null;
+        } else {
+            if (this.qualifiers == null) {
+                this.qualifiers = new TreeMap<>(qualifiers);
+            } else {
+                this.qualifiers.putAll(qualifiers);
+            }
+        }
+        return this;
+    }
+
     /**
      * Removes a package qualifier. This is a no-op if the qualifier is not present.
      * @param key the package qualifier key to remove
@@ -132,11 +154,38 @@ public PackageURLBuilder withQualifier(final String key, final String value) {
     public PackageURLBuilder withoutQualifier(final String key) {
         if (qualifiers != null) {
             qualifiers.remove(key);
-            if (qualifiers.isEmpty()) { qualifiers = null; }
+            if (qualifiers.isEmpty()) {
+                qualifiers = null;
+            }
         }
         return this;
     }
 
+    /**
+     * Removes a package qualifier. This is a no-op if the qualifier is not present.
+     * @param keys the package qualifier keys to remove
+     * @return a reference to the builder
+     */
+    public PackageURLBuilder withoutQualifiers(final Set<String> keys) {
+        if (this.qualifiers != null) {
+            keys.forEach(k -> this.qualifiers.remove(k));
+            if (this.qualifiers.isEmpty()) {
+                this.qualifiers = null;
+            }
+        }
+        return this;
+    }
+
+
+    /**
+     * Removes all qualifiers, if any.
+     * @return a reference to this builder.
+     */
+    public PackageURLBuilder withoutQualifiers() {
+        qualifiers = null;
+        return this;
+    }
+
     /**
      * Removes all qualifiers, if any.
      * @return a reference to this builder.
@@ -192,7 +241,9 @@ public String getSubpath() {
      * @return all qualifiers set in this builder, or an empty map if none are set.
      */
     public TreeMap<String, String> getQualifiers() {
-        if (qualifiers == null) { return new TreeMap<>(); }
+        if (qualifiers == null) {
+            return new TreeMap<>();
+        }
         return new TreeMap<>(qualifiers);
     }
 
@@ -202,7 +253,9 @@ public TreeMap<String, String> getQualifiers() {
      * @return qualifier value or {@code null} if one is not set.
      */
     public String getQualifier(String key) {
-        if (qualifiers == null) { return null; }
+        if (qualifiers == null) {
+            return null;
+        }
         return qualifiers.get(key);
     }
 

src/test/java/com/github/packageurl/PackageURLBuilderTest.java

@@ -26,6 +26,8 @@
 import org.junit.Test;
 import org.junit.rules.ExpectedException;
 
+import java.util.Collections;
+import java.util.HashMap;
 import java.util.Map;
 
 import static org.junit.Assert.*;
@@ -193,6 +195,29 @@ public void testEditBuilder1() throws MalformedPackageURLException {
 
     }
 
+    @Test
+    public void testQualifiers() throws MalformedPackageURLException {
+        Map<String, String> qualifiers = new HashMap<>();
+        qualifiers.put("key2", "value2");
+        Map<String, String> qualifiers2 = new HashMap<>();
+        qualifiers.put("key3", "value3");
+        PackageURL purl = PackageURLBuilder.aPackageURL()
+                .withType(PackageURL.StandardTypes.GENERIC)
+                .withNamespace("")
+                .withName("name")
+                .withVersion("version")
+                .withQualifier("key", "value")
+                .withQualifier("next", "value")
+                .withQualifiers(qualifiers)
+                .withQualifier("key4", "value4")
+                .withQualifiers(qualifiers2)
+                .withSubpath("")
+                .withoutQualifiers(Collections.singleton("key4"))
+                .build();
+
+        assertEquals("pkg:generic/name@version?key=value&key2=value2&key3=value3&next=value", purl.toString());
+    }
+
     private void assertBuilderMatch(PackageURL expected, PackageURLBuilder actual) throws MalformedPackageURLException {
 
         Assert.assertEquals(expected.toString(), actual.build().toString());
@@ -216,4 +241,4 @@ private void assertBuilderMatch(PackageURL expected, PackageURLBuilder actual) t
 
     }
 
-}
+}