Class ApplicationProperties

java.lang.Object
io.fluxzero.sdk.configuration.ApplicationProperties
public class ApplicationProperties extends Object
Central utility for resolving configuration properties within a Fluxzero application.

This class delegates to a layered PropertySource, typically obtained from the active Fluxzero instance. If no context-bound property source is present, it falls back to a DecryptingPropertySource that wraps the default layered DefaultPropertySource.

Property sources are accessed in a prioritized order:

  1. EnvironmentVariablesSource – highest precedence
  2. SystemPropertiesSource
  3. FluxzeroAdditionalPropertiesSource – extra locations declared with FLUXZERO_CONFIG_LOCATIONS
  4. ApplicationEnvironmentPropertiesSource – e.g. application-dev.properties
  5. ApplicationPropertiesSource – fallback base configuration from application.properties
  6. FluxzeroPropertiesSource – Fluxzero-specific SDK defaults from fluxzero.properties or fluxzero.json

Property resolution supports typed access, default values, encryption, and template substitution.

Common usage: 

String token = ApplicationProperties.getProperty("FLUXZERO_API_TOKEN");
boolean featureEnabled = ApplicationProperties.getBooleanProperty("my.feature.enabled", true);
See Also:
  • PropertySource
  • DefaultPropertySource
  • DecryptingPropertySource

  • Field Details

    • DEFAULTS_VERSION_PROPERTY

      public static final String DEFAULTS_VERSION_PROPERTY
      Selects the versioned Fluxzero default behavior profile for applications that do not configure each default explicitly.

      Existing applications can omit this property to keep compatibility defaults. New applications can set a value in yyyy.MM.dd format to opt into all default changes introduced on or before that date. Each default can still be overridden by its own dedicated property.

      Versioned defaults
      Defaults version Equivalent property Behavior
      >= 2026.05.20 fluxzero.tracking.unconfiguredHandlerConsumerMode = perHandler Handlers without an explicit consumer get an isolated generated default consumer per handler class, instead of joining the shared application default consumer for the message type.
      >= 2026.05.21 fluxzero.scheduling.periodic.useDefaultInitialDelay = true @Periodic schedules without an explicit initialDelay use their natural first deadline: fixed-delay schedules first run after delay, and cron schedules first run at the next cron match. Use initialDelay = 0 for an immediate first run.
      See Also:

  • Constructor Details

    • ApplicationProperties

      public ApplicationProperties()

  • Method Details

    • getProperty

      public static String getProperty(String name)
      Returns the raw string property for the given key, or null if not found.

    • mapProperty

      public static <T> T mapProperty(String name, Function<String,T> mapper)
      Maps a property value identified by its name to a desired type using the provided mapping function. If the property is not available, the method returns null.

    • mapProperty

      public static <T> T mapProperty(String name, Function<String,T> mapper, Supplier<T> defaultValueSupplier)
      Maps a property value identified by its name to a desired type using the provided mapping function. If the property is not found, the method returns a default value supplied by the given supplier.

    • getFirstAvailableProperty

      public static String getFirstAvailableProperty(String... propertyNames)
      Returns an Optional containing the first non-null property value among the provided property names, if any exist. If no properties are resolved, returns an empty Optional.

    • getBooleanProperty

      public static boolean getBooleanProperty(String name)
      Resolves a boolean property by key, returning false if not present.

      Accepts case-insensitive "true" as true, otherwise returns false.

    • getBooleanProperty

      public static boolean getBooleanProperty(String name, boolean defaultValue)
      Resolves a boolean property by key, returning a default if the property is not present.

    • getIntegerProperty

      public static Integer getIntegerProperty(String name)
      Resolves an integer property by key, or null if not found.
      Throws:
      NumberFormatException - if the property value is not a valid integer

    • getIntegerProperty

      public static Integer getIntegerProperty(String name, Integer defaultValue)
      Resolves an integer property by key, or returns the given default value if not found.
      Throws:
      NumberFormatException - if the property value is not a valid integer

    • getLongProperty

      public static Long getLongProperty(String name)
      Resolves a long property by key, or null if not found.
      Throws:
      NumberFormatException - if the property value is not a valid long

    • getLongProperty

      public static Long getLongProperty(String name, Long defaultValue)
      Resolves a long property by key, or returns the given default value if not found.
      Throws:
      NumberFormatException - if the property value is not a valid long

    • getProperty

      public static String getProperty(String name, String defaultValue)
      Returns the string property value for the given key, or the specified default if not found.

    • requireProperty

      public static String requireProperty(String name)
      Returns the string property for the given key, throwing an IllegalStateException if not found.

    • containsProperty

      public static boolean containsProperty(String name)
      Returns true if a property with the given name exists.

    • substituteProperties

      public static String substituteProperties(String template)
      Substitutes placeholders in the given template using current property values.

      Placeholders use the syntax ${propertyName}.

    • substituteProperties

      public static Properties substituteProperties(Properties properties)
      Substitutes placeholders in the properties using current property values.

      Placeholders use the syntax ${propertyName}.

    • getEncryption

      public static io.fluxzero.common.encryption.Encryption getEncryption()
      Returns the currently active Encryption instance.

      By default, wraps the encryption from the current PropertySource.

    • encryptValue

      public static String encryptValue(String value)
      Encrypts the given value using the configured Encryption strategy.

    • decryptValue

      public static String decryptValue(String encryptedValue)
      Decrypts the given encrypted value using the configured Encryption strategy.

      Returns the original value if decryption is not applicable.