[LANG-1634] Add ObjectUtils #applyIfNonNull and #applyFirstNonNull #684

bindul · 2020-12-28T21:17:10Z

Utility methods that take a java.util.function.Consumer and possibly null value(s). The consumer is invoked if the value is not null or with the first non-null value, respectively.

See LANG-1634 and discussion at [lang] ObjectUtils enhancement - consumer with non-null value

sgflt · 2020-12-28T21:25:44Z

src/main/java/org/apache/commons/lang3/ObjectUtils.java

+     * </p>
+     *
+     * <pre>
+     * ObjectUtils.applyIfNonNull(bean::setValue, null)                 - setValue not invoked


typo in method name

Corrected, thanks.

coveralls · 2020-12-28T21:29:50Z

Coverage increased (+0.005%) to 94.986% when pulling adf1e04 on bindul:LANG-1634_ObjectUtils-applyIfNonNull into 6b03fe5 on apache:master.

garydgregory · 2020-12-29T15:46:34Z

It seems to me the true test of a new API like applyIfNonNull is where can it be used within Commons Lang, if we don't eat our own dog food, it seems odd to tell others to do so. IOW, I'd like to see this PR include using this API.

I'm not convinced as to the utility of applyFirstNonNull, see above.

Also, for my money, I'd flip the arguments:

ObjectUtils.applyIfNonNull(null, bean::setValue);

Which reads to me like "if the object is non-null, then apply the function" but then maybe the method should be ifNonNullApply, at least that's how my left-to-right reading brain works ;-)

garydgregory · 2020-12-29T15:52:05Z

src/main/java/org/apache/commons/lang3/ObjectUtils.java

@@ -226,6 +227,62 @@ public static boolean anyNotNull(final Object... values) {
        return firstNonNull(values) != null;
    }

+    /**
+     * <p>
+     * Invokes the given {@code consumer's} {@link Consumer#accept(Object)} with the first {@code non-null} value from


IMO, you're not "invoking", you're "accepting", so the Javadoc should say "Accepts...". Actually, the method is misnamed since the underlying method is Consumer#accept(), this method should be use "accept", not "apply".

I have changed the method name to 'accept...' and updated the Javadoc comment accordingly.

garydgregory · 2020-12-29T15:54:35Z

src/main/java/org/apache/commons/lang3/ObjectUtils.java

+     * @see #applyFirstNonNull(Consumer, Object...)
+     * @since 3.12
+     */
+    public static <T> void applyIfNonNull(final Consumer<T> consumer, final T object) {


See "accept" comment above and other comment in the Conversation stream of this PR.

I have changed the method name to 'accept...', switched the parameter order and updated the Javadoc comment accordingly.

garydgregory · 2020-12-29T15:56:24Z

src/test/java/org/apache/commons/lang3/ObjectUtilsTest.java

+            return value;
+        }
+        public void setValue(String value) {
+            this.value = value;


You can add a call to Objects.requireNonNull() here instead of the blind assignment:

this.value = Objects.requireNonNull(value, "value");

This inner class was meant as a simple Java bean with a setter and getter, hence did not have any checks in it. I have changed it now.

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul · 2020-12-29T20:42:00Z

@garydgregory

I have renamed the methods to accept from apply and switched the parameter order where possible.

acceptFirstNonNull is the analogous method to existing ObjectUtils.firstNonNull or StringUtils.firstNonBlank. If I remember correctly, I have had one use for this method in my real life code, where a configuration parameter value could be supplied at multiple levels (specific instance, application default or global default; the first two could be null) and I have used a similar method to handle this. If you don't want to include it, I am happy to remove this.

In a real life scenario, the use case for the acceptIfNonNull method is usually when setting configuration values. The driver (say for something like redis, solr, etc.) or library (like a HTTP client library) accepts a configuration bean with some default values set. Your application accepts configuration values, and you only want to set those in the configuration bean if they are not null (or you lose the default). Anyways, I have updated 3 existing commons-lang classes to show how it can reduce 3 lines of code to 1. I did not go and update every possible occurrence, as that would make this PR large and lose focus on the primary change in the PR.

Please review and let me know if I should make further modifications.

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

garydgregory · 2021-01-06T20:55:50Z

@bindul Please rebase on master. TY!

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul · 2021-01-06T22:04:25Z

@garydgregory Done!
Please let me know if you want me to squash commits into logical groups (I am thinking 1 with the change and the changes for review comments and another where the new method is used elsewhere in lang)

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

Utility methods that take a java.util.function.Consumer and possibly null value(s). The consumer is invoked if the value is not null or with the first non-null value, respectively.

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

Update a few existing classes to use ObjectUtils#acceptIfNonNull(Object, Consumer)

singhbaljit · 2023-01-07T05:04:05Z

We could really use this method. This is helpful because it removes the if/else code branch from the application codes, and therefore, devs don't have to write trivial unit tests to meet the code coverage requirements.

singhbaljit · 2023-01-07T05:21:47Z

src/main/java/org/apache/commons/lang3/ObjectUtils.java

+     * @see #acceptFirstNonNull(Consumer, Object...)
+     * @since 3.12
+     */
+    public static <T> void acceptIfNonNull(final T object, final Consumer<T> consumer) {


more user-friendly: Consumer<? super T> consumer.

Also, requireNonNull(consumer, "consumer").

sgflt reviewed Dec 28, 2020

View reviewed changes

garydgregory requested changes Dec 29, 2020

View reviewed changes

bindul added a commit to bindul/commons-lang that referenced this pull request Dec 29, 2020

Changes for review comments on PR apache#684

84f63b0

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from e5de898 to cbcc405 Compare December 29, 2020 20:32

bindul added a commit to bindul/commons-lang that referenced this pull request Dec 29, 2020

Changes for review comments on PR apache#684

8062ae1

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from cbcc405 to 0128401 Compare December 29, 2020 20:44

bindul added a commit to bindul/commons-lang that referenced this pull request Dec 30, 2020

Changes for review comments on PR apache#684

03165ee

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from 0128401 to d5cdd4e Compare December 30, 2020 01:49

bindul added a commit to bindul/commons-lang that referenced this pull request Jan 1, 2021

Changes for review comments on PR apache#684

d63eb72

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from d5cdd4e to 6ae1ac0 Compare January 1, 2021 03:06

bindul added a commit to bindul/commons-lang that referenced this pull request Jan 4, 2021

Changes for review comments on PR apache#684

63efa4e

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from 6ae1ac0 to bde0870 Compare January 4, 2021 19:47

bindul added a commit to bindul/commons-lang that referenced this pull request Jan 6, 2021

Changes for review comments on PR apache#684

8b62b23

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from bde0870 to 7684dac Compare January 6, 2021 21:52

bindul added a commit to bindul/commons-lang that referenced this pull request Jan 7, 2021

Changes for review comments on PR apache#684

0122581

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from 7684dac to 1813f18 Compare January 7, 2021 17:07

bindul added a commit to bindul/commons-lang that referenced this pull request Jan 15, 2021

Changes for review comments on PR apache#684

7732f26

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from 1813f18 to 2e65abd Compare January 15, 2021 17:55

bindul added 4 commits January 23, 2021 12:17

[LANG-1634] Add ObjectUtils #applyIfNonNull and #applyFirstNonNull

3cab389

Utility methods that take a java.util.function.Consumer and possibly null value(s). The consumer is invoked if the value is not null or with the first non-null value, respectively.

Correct method name in Javadoc.

15d0642

Changes for review comments on PR apache#684

25f5eff

- Changed method names from applyIfNonNull -> acceptIfNonNull; and applyFirstNonNull -> acceptFirstNonNull - Changed parameter order

Eat your own dog food for LANG-1634

adf1e04

Update a few existing classes to use ObjectUtils#acceptIfNonNull(Object, Consumer)

bindul force-pushed the LANG-1634_ObjectUtils-applyIfNonNull branch from 2e65abd to adf1e04 Compare January 23, 2021 19:20

singhbaljit reviewed Jan 7, 2023

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[LANG-1634] Add ObjectUtils #applyIfNonNull and #applyFirstNonNull #684

[LANG-1634] Add ObjectUtils #applyIfNonNull and #applyFirstNonNull #684

bindul commented Dec 28, 2020

sgflt Dec 28, 2020

bindul Dec 28, 2020

coveralls commented Dec 28, 2020 •

edited

Loading

garydgregory commented Dec 29, 2020 •

edited

Loading

garydgregory Dec 29, 2020

bindul Dec 29, 2020

garydgregory Dec 29, 2020

bindul Dec 29, 2020

garydgregory Dec 29, 2020

bindul Dec 29, 2020

bindul commented Dec 29, 2020

garydgregory commented Jan 6, 2021

bindul commented Jan 6, 2021

singhbaljit commented Jan 7, 2023

singhbaljit Jan 7, 2023

[LANG-1634] Add ObjectUtils #applyIfNonNull and #applyFirstNonNull #684

Are you sure you want to change the base?

[LANG-1634] Add ObjectUtils #applyIfNonNull and #applyFirstNonNull #684

Conversation

bindul commented Dec 28, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

coveralls commented Dec 28, 2020 • edited Loading

garydgregory commented Dec 29, 2020 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

bindul commented Dec 29, 2020

garydgregory commented Jan 6, 2021

bindul commented Jan 6, 2021

singhbaljit commented Jan 7, 2023

Choose a reason for hiding this comment

coveralls commented Dec 28, 2020 •

edited

Loading

garydgregory commented Dec 29, 2020 •

edited

Loading