add ObjectUtils.firstNonNull/getIfNull/getIfEmpty

Signed-off-by: Vincent Potucek <vpotucek@me.com>

Author: Vincent Potucek

spring-core/src/main/java/org/springframework/util/ObjectUtils.java

@@ -161,6 +161,26 @@ public static <T> Optional<Collection<T>> getIfEmpty(@Nullable final Collection<
 				.or(() -> Optional.ofNullable(defaultValue));
 	}
 
+	/**
+	 * Returns the array if it is not {@code null} and not empty; otherwise, returns the default value.
+	 *
+	 * @param object       the array to test, may be {@code null}
+	 * @param defaultValue the default value to return if the array is {@code null} or empty, may be {@code null}
+	 * @param <T>          the type of elements in the array
+	 * @return An Optional containing the array if not null and not empty, otherwise an Optional of the default
+	 * value.
+	 */
+	public static <T> Optional<T[]> getIfEmpty(@Nullable final T[] object,
+											   @Nullable final T[] defaultValue) {
+		if (Objects.nonNull(object) && object.length > 0) {
+			return Optional.of(object);
+		}
+		if (Objects.nonNull(defaultValue) && defaultValue.length > 0) {
+			return Optional.of(defaultValue);
+		}
+		return Optional.empty();
+	}
+
 	/**
 	 * Determine whether the given object is empty.
 	 * <p>This method supports the following object types.

spring-core/src/test/java/org/springframework/util/ObjectUtilsTests.java

@@ -131,11 +131,12 @@ void getIfNullObject() {
 	}
 
 	@Test
-	void getIfEmptyObject() {
+	void getIfEmptyObjectCollection() {
 		Collection<String> empty = Collections.emptyList();
 		Collection<String> value = List.of(UUID.randomUUID().toString());
 		Collection<String> backup = List.of(UUID.randomUUID().toString());
 
+		assertThat(getIfEmpty(value, backup)).contains(value);
 		assertThat(getIfEmpty(value, backup)).contains(value);
 		assertThat(getIfEmpty(null, backup)).contains(backup);
 		assertThat(getIfEmpty(empty, backup)).contains(backup);
@@ -144,7 +145,22 @@ void getIfEmptyObject() {
 		assertThat(getIfEmpty(backup, backup)).contains(backup);
 		assertThat(getIfEmpty(null, empty)).contains(empty);
 		assertThat(getIfEmpty(null, backup)).contains(backup);
-		assertThat(getIfEmpty(null, null)).isEmpty();
+	}
+
+	@Test
+	void getIfEmptyObjectArray() {
+		String[] empty = new String[0];
+		String[] value = {UUID.randomUUID().toString()};
+		String[] backup = {UUID.randomUUID().toString()};
+
+		assertThat(getIfEmpty(value, backup)).contains(value);
+		assertThat(getIfEmpty(null, backup)).contains(backup);
+		assertThat(getIfEmpty(empty, backup)).contains(backup);
+		assertThat(getIfEmpty(value, empty)).contains(value);
+		assertThat(getIfEmpty(empty, empty)).isEmpty();
+		assertThat(getIfEmpty(backup, backup)).contains(backup);
+		assertThat(getIfEmpty(null, empty)).isEmpty();
+		assertThat(getIfEmpty(null, backup)).contains(backup);
 	}
 
 	@Test