diff --git a/administration/logging.md b/administration/logging.md index c2cf2bfb76..728df04541 100644 --- a/administration/logging.md +++ b/administration/logging.md @@ -168,7 +168,7 @@ An example output of the last log statement above is: 2016-06-04 16:28:39.482 [DEBUG] [org.openhab.core.model.script.heating] Bedroom: Temperature 21.3°C, Mode NORMAL ``` -Note that, in the last example above, inclusion and formatting of values is done using [Java Formatter String Syntax](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/Formatter.html). +Note that, in the last example above, inclusion and formatting of values is done using [Java Formatter String Syntax](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Formatter.html). ## Log4j configuration and logging into separate files diff --git a/configuration/actions.md b/configuration/actions.md index 85510d54c3..cb053adeef 100644 --- a/configuration/actions.md +++ b/configuration/actions.md @@ -61,7 +61,7 @@ You have different options to execute a command through an action. For example you could run `var ScriptResponse = executeCommandLine(Duration.ofSeconds(60), "path/to/my/script.sh");` would get executed and wait 1 minute for the output to be responded back and write it into the `ScriptResponse` variable. Other Durations than `ofSeconds` units are possible too. -Check out the [Java Documentation](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/Duration.html?is-external=true) for possible units. +Check out the [Java Documentation](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/Duration.html?is-external=true) for possible units. #### Scripts with parameters diff --git a/configuration/items.md b/configuration/items.md index 89af9bef72..903861a794 100644 --- a/configuration/items.md +++ b/configuration/items.md @@ -257,7 +257,7 @@ If no square brackets are given and the Item is not linked to a channel, the Ite No text between the square brackets also implies no textual presentation. This is often meaningful when an Item is presented by a non-textual UI elements like a switch or a diagram. -Formatting of the presentation is done applying [Java formatter class syntax](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/Formatter.html#syntax). +Formatting of the presentation is done applying [Java formatter class syntax](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Formatter.html#syntax). If square brackets are given, the leading `%` and the trailing formatter conversion are mandatory. Free text, like a unit, can be added before or after the formatter string. diff --git a/configuration/jsr223.md b/configuration/jsr223.md index 7de82d7b86..92444cf854 100644 --- a/configuration/jsr223.md +++ b/configuration/jsr223.md @@ -258,11 +258,11 @@ With `scriptExtension.get("automationManager")` the `automationManager` can be m |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `State` | [`org.openhab.core.types.State`](https://www.openhab.org/javadoc/latest/org/openhab/core/types/state) | | `Command` | [`org.openhab.core.types.Command`](https://www.openhab.org/javadoc/latest/org/openhab/core/types/command) | -| `URLEncoder` | [`java.net.URLEncoder`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/URLEncoder.html) | -| `File` | [`java.io.File`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/io/File.html) | -| `Files` | [`java.nio.file.Files`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/file/Files.html) | -| `Path` | [`java.nio.file.Path`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/file/Path.html) | -| `Paths` | [`java.nio.file.Paths`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/file/Paths.html) | +| `URLEncoder` | [`java.net.URLEncoder`](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/net/URLEncoder.html) | +| `File` | [`java.io.File`](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html) | +| `Files` | [`java.nio.file.Files`](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html) | +| `Path` | [`java.nio.file.Path`](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Path.html) | +| `Paths` | [`java.nio.file.Paths`](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Paths.html) | | `IncreaseDecreaseType` | [`org.openhab.core.library.types.IncreaseDecreaseType`](https://www.openhab.org/javadoc/latest/org/openhab/core/library/types/increasedecreasetype) | | `DECREASE` | `IncreaseDecreaseType` enum item | | `INCREASE` | `IncreaseDecreaseType` enum item | diff --git a/developers/guidelines.md b/developers/guidelines.md index dc6c0eaf7f..b9a7d40a71 100644 --- a/developers/guidelines.md +++ b/developers/guidelines.md @@ -159,7 +159,7 @@ See [Default libraries](#default-libraries) for more details. 1. Creation of threads must be avoided. Instead, resort into using existing schedulers which use pre-configured thread pools. If there is no suitable scheduler available, start a discussion in the forum about it rather than creating a thread by yourself. - For periodically executed jobs that do not require a fixed rate [scheduleWithFixedDelay](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/concurrent/ScheduledExecutorService.html#scheduleWithFixedDelay(java.lang.Runnable,long,long,java.util.concurrent.TimeUnit)) should be preferred over [scheduleAtFixedRate](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/concurrent/ScheduledExecutorService.html#scheduleAtFixedRate(java.lang.Runnable,long,long,java.util.concurrent.TimeUnit)). + For periodically executed jobs that do not require a fixed rate [scheduleWithFixedDelay](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/concurrent/ScheduledExecutorService.html#scheduleWithFixedDelay(java.lang.Runnable,long,long,java.util.concurrent.TimeUnit)) should be preferred over [scheduleAtFixedRate](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/concurrent/ScheduledExecutorService.html#scheduleAtFixedRate(java.lang.Runnable,long,long,java.util.concurrent.TimeUnit)). 1. Bundles need to cleanly start and stop without throwing exceptions or malfunctioning. This can be tested by manually starting and stopping the bundle from the console (```stop ``` resp. ```start ```). 1. Bundles must not require any substantial CPU time. diff --git a/developers/osgi/osgi.md b/developers/osgi/osgi.md index 9f782ee0da..71288d1303 100644 --- a/developers/osgi/osgi.md +++ b/developers/osgi/osgi.md @@ -42,7 +42,7 @@ More details about the OSGi architecture can be found at