feat(#1381): Add a way to specify "inject-only" with @JacksonInject

release-notes/CREDITS-2.x

@@ -1955,6 +1955,8 @@ Eddú Meléndez Gonzales (@eddumelendez)
   (2.19.2)
 
 Giulio Longfils (@giulong)
+ * Contributed #1381: Add a way to specify "inject-only" with `@JacksonInject`
+  (2.20.0)
  * Contributed fix for #2678: `@JacksonInject` added to property overrides value
    from the JSON even if `useInput` is `OptBoolean.TRUE`
   (2.20.0)

release-notes/VERSION-2.x

@@ -6,6 +6,8 @@ Project: jackson-databind
 
 Not yet released
 
+#1381: Add a way to specify "inject-only" with `@JacksonInject`
+ (fix by Giulio L)
 #2678: `@JacksonInject` added to property overrides value from the JSON
   even if `useInput` is `OptBoolean.TRUE`
  (reported by Plamen T)

src/main/java/com/fasterxml/jackson/databind/DeserializationContext.java

@@ -471,8 +471,10 @@ public final Object findInjectableValue(Object valueId,
         if (_injectableValues == null) {
             // `optional` comes from property annotation (if any); has precedence
             // over global setting.
-            if (Boolean.TRUE.equals(optional)
-                    || (optional == null && !isEnabled(DeserializationFeature.FAIL_ON_UNKNOWN_INJECT_VALUE))) {
+            if (Boolean.TRUE.equals(useInput)
+                    || Boolean.TRUE.equals(optional)
+                    || (useInput == null || optional == null)
+                    && !isEnabled(DeserializationFeature.FAIL_ON_UNKNOWN_INJECT_VALUE)) {
                 return JacksonInject.Value.empty();
             }
             throw missingInjectableValueException(String.format(

src/main/java/com/fasterxml/jackson/databind/deser/CreatorProperty.java

@@ -280,6 +280,11 @@ public Object getInjectableValueId() {
         return (_injectableValue == null) ? null : _injectableValue.getId();
     }
 
+    @Override // since 2.20
+    public JacksonInject.Value getInjectionDefinition() {
+        return _injectableValue;
+    }
+
     @Override
     public boolean isInjectionOnly() {
         return (_injectableValue != null) && !_injectableValue.willUseInput(true);

src/main/java/com/fasterxml/jackson/databind/deser/SettableBeanProperty.java

@@ -3,6 +3,7 @@
 import java.io.IOException;
 import java.lang.annotation.Annotation;
 
+import com.fasterxml.jackson.annotation.JacksonInject;
 import com.fasterxml.jackson.core.*;
 import com.fasterxml.jackson.databind.*;
 import com.fasterxml.jackson.databind.deser.impl.FailingDeserializer;
@@ -468,6 +469,14 @@ public int getCreatorIndex() {
      */
     public Object getInjectableValueId() { return null; }
 
+    /**
+     * Accessor for injection definition, if this bean property supports
+     * value injection.
+     *
+     * @since 2.20
+     */
+    public JacksonInject.Value getInjectionDefinition() { return null; }
+
     /**
      * Accessor for checking whether this property is injectable, and if so,
      * ONLY injectable (will not bind from input).

src/main/java/com/fasterxml/jackson/databind/deser/impl/PropertyValueBuffer.java

@@ -3,6 +3,7 @@
 import java.io.IOException;
 import java.util.BitSet;
 
+import com.fasterxml.jackson.annotation.JacksonInject;
 import com.fasterxml.jackson.core.JsonParser;
 import com.fasterxml.jackson.databind.*;
 import com.fasterxml.jackson.databind.deser.*;
@@ -218,6 +219,25 @@ public Object[] getParameters(SettableBeanProperty[] props)
         if (_anyParamSetter != null) {
             _creatorParameters[_anyParamSetter.getParameterIndex()] = _createAndSetAnySetterValue();
         }
+
+        for (int ix = 0; ix < props.length; ++ix) {
+            final SettableBeanProperty prop = props[ix];
+            final JacksonInject.Value injection = prop.getInjectionDefinition();
+
+            if (injection != null) {
+                final Boolean useInput = injection.getUseInput();
+
+                if (!Boolean.TRUE.equals(useInput)) {
+                    final Object value = _context.findInjectableValue(injection.getId(),
+                            prop, prop.getMember(), injection.getOptional(), useInput);
+
+                    if (value != JacksonInject.Value.empty()) {
+                        _creatorParameters[ix] = value;
+                    }
+                }
+            }
+        }
+
         if (_context.isEnabled(DeserializationFeature.FAIL_ON_NULL_CREATOR_PROPERTIES)) {
             for (int ix = 0; ix < props.length; ++ix) {
                 if (_creatorParameters[ix] == null) {

src/main/java/com/fasterxml/jackson/databind/deser/impl/ValueInjector.java

@@ -69,7 +69,14 @@ public void inject(DeserializationContext context, Object beanInstance)
         throws IOException
     {
         final Object value = findValue(context, beanInstance);
-        if (!JacksonInject.Value.empty().equals(value)) {
+
+        if (value == JacksonInject.Value.empty()) {
+            if (Boolean.FALSE.equals(_optional)) {
+                throw context.missingInjectableValueException(String.format(
+                        "No 'injectableValues' configured, cannot inject value with id '%s'", _valueId),
+                        _valueId, null, beanInstance);
+            }
+        } else if (!Boolean.TRUE.equals(_useInput)) {
             _member.setValue(beanInstance, value);
         }
     }

src/main/java/com/fasterxml/jackson/databind/deser/std/StdValueInstantiator.java

@@ -675,8 +675,8 @@ private Object _createUsingDelegate(AnnotatedWithParams delegateCreator,
                 } else { // nope, injectable:
                     // 09-May-2025, tatu: Not sure where to get "optional" (last arg) value...
                     // 25-Aug-2025, tatu: ... or "useInput"
-                    args[i] = ctxt.findInjectableValue(prop.getInjectableValueId(), prop,
-                            null, null, null);
+                    args[i] = ctxt.findInjectableValue(prop.getInjectableValueId(), prop, null,
+                            null, null);
                 }
             }
             // and then try calling with full set of arguments

src/test/java/com/fasterxml/jackson/databind/deser/inject/JacksonInject1381DeserializationFeatureDisabledTest.java

@@ -0,0 +1,179 @@
+package com.fasterxml.jackson.databind.deser.inject;
+
+import com.fasterxml.jackson.annotation.JacksonInject;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.OptBoolean;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.InjectableValues;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.exc.ValueInstantiationException;
+import com.fasterxml.jackson.databind.testutil.DatabindTestUtil;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+class JacksonInject1381DeserializationFeatureDisabledTest extends DatabindTestUtil {
+    static class InputDefault {
+        @JacksonInject(value = "key")
+        @JsonProperty("field")
+        private final String _field;
+
+        @JsonCreator
+        public InputDefault(@JsonProperty("field") final String field) {
+            _field = field;
+        }
+
+        public String getField() {
+            return _field;
+        }
+    }
+
+    static class InputDefaultConstructor {
+        private final String _field;
+
+        @JsonCreator
+        public InputDefaultConstructor(@JacksonInject(value = "key")
+                                       @JsonProperty("field") final String field) {
+            _field = field;
+        }
+
+        public String getField() {
+            return _field;
+        }
+    }
+
+    static class InputTrue {
+        @JacksonInject(value = "key", useInput = OptBoolean.TRUE)
+        @JsonProperty("field")
+        private final String _field;
+
+        @JsonCreator
+        public InputTrue(@JsonProperty("field") final String field) {
+            _field = field;
+        }
+
+        public String getField() {
+            return _field;
+        }
+    }
+
+    static class InputTrueConstructor {
+        private final String _field;
+
+        @JsonCreator
+        public InputTrueConstructor(@JacksonInject(value = "key", useInput = OptBoolean.TRUE)
+                                    @JsonProperty("field") final String field) {
+            _field = field;
+        }
+
+        public String getField() {
+            return _field;
+        }
+
+    }
+
+    static class InputFalse {
+        @JacksonInject(value = "key", useInput = OptBoolean.FALSE)
+        @JsonProperty("field")
+        private final String _field;
+
+        @JsonCreator
+        public InputFalse(@JsonProperty("field") final String field) {
+            _field = field;
+        }
+
+        public String getField() {
+            return _field;
+        }
+    }
+
+    static class InputFalseConstructor {
+        private final String _field;
+
+        @JsonCreator
+        public InputFalseConstructor(@JacksonInject(value = "key", useInput = OptBoolean.FALSE)
+                                     @JsonProperty("field") final String field) {
+            _field = field;
+        }
+
+        public String getField() {
+            return _field;
+        }
+    }
+
+    private final String empty = "{}";
+    private final String input = "{\"field\": \"input\"}";
+
+    private final ObjectMapper plainMapper = jsonMapperBuilder()
+            .disable(DeserializationFeature.FAIL_ON_UNKNOWN_INJECT_VALUE)
+            .build();
+    private final ObjectMapper injectedMapper = jsonMapperBuilder()
+            .injectableValues(new InjectableValues.Std().addValue("key", "injected"))
+            .disable(DeserializationFeature.FAIL_ON_UNKNOWN_INJECT_VALUE)
+            .build();
+
+    @Test
+    @DisplayName("FAIL_ON_UNKNOWN_INJECT_VALUE NO, input NO, injectable NO, useInput DEFAULT|TRUE|FALSE => exception")
+    void test1() {
+        assertThrows(ValueInstantiationException.class,
+                () -> plainMapper.readValue(empty, InputDefault.class));
+        assertThrows(ValueInstantiationException.class,
+                () -> plainMapper.readValue(empty, InputDefaultConstructor.class));
+
+        assertThrows(ValueInstantiationException.class,
+                () -> plainMapper.readValue(empty, InputTrue.class));
+        assertThrows(ValueInstantiationException.class,
+                () -> plainMapper.readValue(empty, InputTrueConstructor.class));
+
+        assertThrows(ValueInstantiationException.class,
+                () -> plainMapper.readValue(empty, InputFalse.class));
+        assertThrows(ValueInstantiationException.class,
+                () -> plainMapper.readValue(empty, InputFalseConstructor.class));
+    }
+
+    @Test
+    @DisplayName("FAIL_ON_UNKNOWN_INJECT_VALUE NO, input NO, injectable YES, useInput DEFAULT|TRUE|FALSE => injected")
+    void test2() throws Exception {
+        assertEquals("injected", injectedMapper.readValue(empty, InputDefault.class).getField());
+        assertEquals("injected", injectedMapper.readValue(empty, InputDefaultConstructor.class).getField());
+        assertEquals("injected", injectedMapper.readValue(empty, InputTrue.class).getField());
+        assertEquals("injected", injectedMapper.readValue(empty, InputTrueConstructor.class).getField());
+        assertEquals("injected", injectedMapper.readValue(empty, InputFalse.class).getField());
+        assertEquals("injected", injectedMapper.readValue(empty, InputFalseConstructor.class).getField());
+    }
+
+    @Test
+    @DisplayName("FAIL_ON_UNKNOWN_INJECT_VALUE NO, input YES, injectable NO, useInput DEFAULT|FALSE => exception")
+    void test3() throws Exception {
+        assertEquals("input", plainMapper.readValue(input, InputDefault.class).getField());
+        assertEquals("input", plainMapper.readValue(input, InputDefaultConstructor.class).getField());
+        assertEquals("input", plainMapper.readValue(input, InputFalse.class).getField());
+        assertEquals("input", plainMapper.readValue(input, InputFalseConstructor.class).getField());
+    }
+
+    @Test
+    @DisplayName("FAIL_ON_UNKNOWN_INJECT_VALUE NO, input YES, injectable NO, useInput TRUE => input")
+    void test4() throws Exception {
+        assertEquals("input", plainMapper.readValue(input, InputTrue.class).getField());
+        assertEquals("input", plainMapper.readValue(input, InputTrueConstructor.class).getField());
+    }
+
+    @Test
+    @DisplayName("FAIL_ON_UNKNOWN_INJECT_VALUE NO, input YES, injectable YES, useInput DEFAULT|FALSE => injected")
+    void test5() throws Exception {
+        assertEquals("injected", injectedMapper.readValue(input, InputDefault.class).getField());
+        assertEquals("injected", injectedMapper.readValue(input, InputDefaultConstructor.class).getField());
+        assertEquals("injected", injectedMapper.readValue(input, InputFalse.class).getField());
+        assertEquals("injected", injectedMapper.readValue(input, InputFalseConstructor.class).getField());
+    }
+
+    @Test
+    @DisplayName("FAIL_ON_UNKNOWN_INJECT_VALUE NO, input YES, injectable YES, useInput TRUE => input")
+    void test6() throws Exception {
+        assertEquals("input", injectedMapper.readValue(input, InputTrue.class).getField());
+        assertEquals("input", injectedMapper.readValue(input, InputTrueConstructor.class).getField());
+    }
+}