Select enum constants from boolean[] or bit mask

pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright (C) Posten Norge AS
+    Copyright (C) Posten Bring AS
 
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.

src/license-header.txt

@@ -1,4 +1,4 @@
-Copyright (C) Posten Norge AS
+Copyright (C) Posten Bring AS
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggBase.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggCollectors.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggCompare.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggConcurrent.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggEnums.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
  */
 package no.digipost;
 
+import java.util.BitSet;
 import java.util.Collection;
 import java.util.function.Function;
 import java.util.function.Predicate;
@@ -23,6 +24,7 @@
 
 import static java.util.Arrays.asList;
 import static java.util.Arrays.stream;
+import static java.util.Objects.requireNonNull;
 import static java.util.stream.Collectors.joining;
 
 /**
@@ -94,6 +96,57 @@ public static <E extends Enum<E>> Stream<E> fromEnumsString(String enumsString,
     }
 
 
+    /**
+     * Select enum constants by mapping <em>indexes</em> of elements in a boolean array which are {@code true} to <em>ordinals</em>
+     * of the enum type.
+     * <p>
+     * It is valid that the enum contains either more or less constants than the given boolean array,
+     * and the resolving will discard any exhaustive elements in either cases. E.g. specifying two booleans
+     * will at most consider two first constants of a given enum type, as well as if the enum only has one
+     * constant, only the first boolean will be processed.
+     *
+     * @param includedOrdinals the boolean array where the <em>indexes</em> of {@code true} elements are mapped
+     *                         to any existing ordinals of the given {@code enumType}
+     * @param enumType the enum type to resolve constants from
+     *
+     * @return the resolved {@code enum} constants
+     */
+    public static <E extends Enum<E>> Stream<E> selectByIndexAsOrdinals(boolean[] includedOrdinals, Class<E> enumType) {
+        BitSet mask = new BitSet(includedOrdinals.length);
+        for (int i = 0; i < includedOrdinals.length; i++) {
+            mask.set(i, includedOrdinals[i]);
+        }
+        return selectByBitmask(mask, enumType);
+    }
+
+
+    /**
+     * Select enum constants by overlaying a bitmask ({@code long}) and selecting the enum <em>by ordinals</em>
+     * which align with the indices of the set bits, mapping the first index to the first enum constant and so
+     * forth. A bitmask of {@code 10110001} (177) will select the first, fifth, sixth, and eight enum constant.
+     * <p>
+     * It is valid both for the enum to contain more constants than the length of the mask,
+     * or less constants than the highest index of a <em>set</em> bit in the given mask,
+     * and the resolving will discard any exhaustive elements in either cases. E.g. a set bit at
+     * index 2 will be ignored for enums with only one constant.
+     *
+     * @param mask the bit mask used for selecting enum constants, the method may mutate this mask
+     * @param enumType the enum type to resolve constants from
+     *
+     * @return the resolved {@code enum} constants
+     */
+    public static <E extends Enum<E>> Stream<E> selectByBitmask(BitSet mask, Class<E> enumType) {
+        if (mask.cardinality() == 0) {
+            return Stream.empty();
+        }
+        E[] candidates = requireNonNull(enumType.getEnumConstants(), enumType + " is not an enum");
+        if (candidates.length == 0) {
+            return Stream.empty();
+        }
+        return mask.get(0, candidates.length).stream().mapToObj(selectedOrdinal -> candidates[selectedOrdinal]);
+    }
+
+
     /**
      * Join several {@code enum} constants to a comma separated string of their {@link Enum#name() names}.
      *

src/main/java/no/digipost/DiggExceptions.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggIO.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggMaps.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggOptionals.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggPredicates.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/DiggStreams.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/collection/BatchedIterable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/collection/ConflictingElementEncountered.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/collection/EnforceAtMostOneElementCollector.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/collection/EnforceDistinctFirstTupleElementCollector.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/collection/NonEmptyHeadTailList.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/collection/NonEmptyList.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/collection/SimpleIterator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/CompletionHandler.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/CountDown.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/OneTimeAssignment.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/OneTimeToggle.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/SignalMediator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/TargetState.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/Waiter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/executor/DefaultExecutors.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/concurrent/executor/ExternallyManagedExecutorService.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/DecaFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/HexaFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/NonaFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ObjIntFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ObjLongFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/OctoFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/PentaFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/QuadFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/SeptiFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/SerializableFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ThrowingBiConsumer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ThrowingBiFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ThrowingConsumer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ThrowingFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ThrowingRunnable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/ThrowingSupplier.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

src/main/java/no/digipost/function/TriFunction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) Posten Norge AS
+ * Copyright (C) Posten Bring AS
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.