Array.java

package net.hostsharing.hsadminng.mapper;



import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.Objects;

import static java.util.Arrays.asList;

/**
 * Java has List.of(...), Set.of(...) and Map.of(...) all with varargs parameter,
 * but no Array.of(...). Here it is.
 */
public class Array {

    @SafeVarargs
    public static <E> E[] of(E... elements) {
        return elements;
    }

    public static String[] from(final List<String> initialList, final String... additionalStrings) {
        final var resultList = new ArrayList<>(initialList);
        resultList.addAll(Arrays.stream(additionalStrings).toList());
        return resultList.toArray(String[]::new);
    }

    public static String[] fromFormatted(final List<String> initialList, final String... additionalStrings) {
        final var resultList = new ArrayList<>(initialList);
        resultList.addAll(Arrays.stream(additionalStrings)
                .filter(Objects::nonNull)
                .map(s -> s.replaceAll("  *", " "))
                .toList());
        return resultList.toArray(String[]::new);
    }

    public static String[] from(final String[] initialStrings, final String... additionalStrings) {
        final var resultList = Arrays.asList(initialStrings);
        resultList.addAll(Arrays.stream(additionalStrings).toList());
        return resultList.toArray(String[]::new);
    }

    public static String[] join(final String[]... parts) {
        final String[] joined =  Arrays.stream(parts)
                .flatMap(Arrays::stream)
                .toArray(String[]::new);
        return joined;
    }

    public static <T> T[] emptyArray() {
        return of();
    }

    public static <T> T[] emptyArray(final Class<T> elementClass) {
        //noinspection unchecked
        return (T[]) java.lang.reflect.Array.newInstance(elementClass, 0);
    }

    @SafeVarargs
    public static <T> T[] insertNewEntriesAfterExistingEntry(final T[] array, final T entryToFind, final T... newEntries) {
        final var arrayList = new ArrayList<>(asList(array));
        final var index = arrayList.indexOf(entryToFind);
        if (index < 0) {
            throw new IllegalArgumentException("entry "+ entryToFind + " not found in " + Arrays.toString(array));
        }
        for (int n = 0; n < newEntries.length; ++n) {
            arrayList.add(index +n + 1, newEntries[n]);
        }

        @SuppressWarnings("unchecked")
        final var extendedArray = (T[]) java.lang.reflect.Array.newInstance(array.getClass().getComponentType(), array.length);
        return arrayList.toArray(extendedArray);
    }
}