Annotation Interface ConfigValue

@Documented @Retention(RUNTIME) @Target({FIELD,PARAMETER,RECORD_COMPONENT}) public @interface ConfigValue
Injects one value from the safe application configuration view.

The annotation does not expose internal runtime configuration maps. Secret-like keys are redacted from diagnostics and status output. Missing required values fail activation with INVALID_ARGUMENT; optional values use defaultValue(). Managed primitive injection requires either a required value or a nonempty explicit default; no implicit zero/false default is assumed.

  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    String
    value
    Returns the configuration key.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    defaultValue
    Returns the default value used when the key is absent.
    boolean
    refresh
    Enables validated updates in a managed provider; legacy injection remains a snapshot.
    boolean
    required
    Returns whether the value must be present.

  • Element Details

    • value

      String value
      Returns the configuration key.
      Returns:
      application configuration key

    • defaultValue

      String defaultValue
      Returns the default value used when the key is absent.
      Returns:
      default value, or the empty string when no default is declared
      Default:
      ""

    • required

      boolean required
      Returns whether the value must be present.
      Returns:
      true when absence is an activation failure
      Default:
      false

    • refresh

      boolean refresh
      Enables validated updates in a managed provider; legacy injection remains a snapshot.
      Returns:
      whether a managed provider may observe newer configuration versions
      Default:
      false