applications(java): add shared instructions for variables with dots

content/doc/applications/java/java-gradle.md

@@ -88,16 +88,7 @@ Example:
 CC_RUN_COMMAND="java -jar somefile.jar <options>"
 ```
 
-### Environment injection
-
-Clever Cloud can inject environment variables that are defined in the
-dashboard and by add-ons linked to your application.
-
-For Java applications, the environment is injected in the `System.getProperties()` object.
-
-So, to use a variable, you just need `System.getProperties().getProperty("MY_VARIABLE")`.
-
-For Groovy applications, just use the `System.getProperty("MY_VARIABLE")`.
+{{% content "java-env-injection" %}}
 
 ## The Gradle Wrapper
 

content/doc/applications/java/java-jar.md

@@ -124,16 +124,7 @@ Example:
 CC_RUN_COMMAND="java -jar somefile.jar <options>"
 ```
 
-### Environment injection
-
-Clever Cloud can inject environment variables that are defined in the
-dashboard and by add-ons linked to your application.
-
-For Java applications, the environment is injected in the `System.getProperties()` object.
-
-So, to use a variable, you just need `System.getProperties().getProperty("MY_VARIABLE")`.
-
-For Groovy applications, just use the `System.getProperty("MY_VARIABLE")`.
+{{% content "java-env-injection" %}}
 
  {{% content "deploy-git" %}}
 

content/doc/applications/java/java-maven.md

@@ -126,6 +126,8 @@ Example:
 CC_RUN_COMMAND="java -jar somefile.jar <options>"
 ```
 
+{{% content "java-env-injection" %}}
+
  {{% content "new-relic" %}}
 
  {{% content "deploy-git" %}}

content/doc/applications/java/java-war.md

@@ -175,6 +175,8 @@ Example:
 CC_RUN_COMMAND="java -jar somefile.jar <options>"
 ```
 
+{{% content "java-env-injection" %}}
+
  {{% content "new-relic" %}}
 
  {{% content "deploy-git" %}}

content/doc/applications/scala/_index.md

@@ -89,9 +89,7 @@ application.secret=${APPLICATION_SECRET}
 
 {{% content "new-relic" %}}
 
-{{% content "env-injection" %}}
-
-To access environment variables from your code, just get them from the environment with `System.getenv("MY_VARIABLE")`. Be aware that it can return null.
+{{% content "java-env-injection" %}}
 
 {{% content "deploy-git" %}}
 

content/doc/applications/scala/play-framework-2.md

@@ -70,10 +70,9 @@ For instance, if your Sbt project contains a `shared` and `play` module and you
 
  {{% content "new-relic" %}}
 
- {{% content "env-injection" %}}
+{{% content "java-env-injection" %}}
 
-To access the environment variables from your code, you need to add `my.option=${MY_VARIABLE}` in your `application.conf` file, and then use the configuration item `my.option` in your application. e.g `%clevercloud.db.url="jdbc:mysql://"${MYSQL_ADDON_HOST}"/"${MYSQL_ADDON_DB}`.
-You can also use the `System.getenv("MY_VARIABLE")` method. Be aware that it can return null.
+To access the environment variables from your code, you can also add `my.option=${MY_VARIABLE}` in your `application.conf` file, and then use the configuration item `my.option` in your application. e.g `%clevercloud.db.url="jdbc:mysql://"${MYSQL_ADDON_HOST}"/"${MYSQL_ADDON_DB}`.
 
  {{% content "deploy-git" %}}
 

shared/java-env-injection.md

@@ -0,0 +1,17 @@
+### Environment injection
+
+Clever Cloud injects environment variables defined in the Console and by linked add-ons into your application. For JVM-based applications, all environment variables are passed as system properties using `-D` flags, making them accessible through `System.getProperty()`.
+
+To access a standard environment variable such as `MY_VARIABLE`, use `System.getProperty("MY_VARIABLE")` or `System.getenv("MY_VARIABLE")`.
+
+#### Variables with dots as JVM system properties
+
+Environment variable names containing a dot (`.`) are handled differently. Since most shells do not support dots in variable names, these variables are passed exclusively as JVM system properties via `-D` flags, and are not set in the shell environment.
+
+For example, if you define `my.app.config=production` in the Clever Cloud Console, the JVM receives `-Dmy.app.config=production` at startup. You can then retrieve it with:
+
+```java
+String value = System.getProperty("my.app.config"); // returns "production"
+```
+
+This is useful for setting framework-specific properties directly from the Console without modifying configuration files (e.g. Spring Boot properties, Quarkus settings, or any custom `-D` parameter your application expects).