Link to Java 17 documentation (#2119)

This prevents issues because older documentation may not apply to Java 17.

Signed-off-by: Wouter Born <github@maindrain.net>
pull/2128/head
Wouter Born 2023-08-21 18:13:13 +02:00 committed by GitHub
parent bdb37078aa
commit 98a6d319a6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 3 additions and 3 deletions

View File

@ -159,7 +159,7 @@ See [Default libraries](#default-libraries) for more details.
1. Creation of threads must be avoided. 1. Creation of threads must be avoided.
Instead, resort into using existing schedulers which use pre-configured thread pools. 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. 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/11/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/11/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/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)).
1. Bundles need to cleanly start and stop without throwing exceptions or malfunctioning. 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 <bundle-id>``` resp. ```start <bundle-id>```). This can be tested by manually starting and stopping the bundle from the console (```stop <bundle-id>``` resp. ```start <bundle-id>```).
1. Bundles must not require any substantial CPU time. 1. Bundles must not require any substantial CPU time.

View File

@ -42,7 +42,7 @@ More details about the OSGi architecture can be found at <https://www.osgi.org/d
Modules (called **bundles**) are the smallest unit of modularization. Modules (called **bundles**) are the smallest unit of modularization.
Technically a bundle is a JAR file with additional meta information. Technically a bundle is a JAR file with additional meta information.
This information is stored in file called [**manifest**](#important-definitions) file. This information is stored in file called [**manifest**](#important-definitions) file.
The manifest file is part of the standard [JAR specification](https://docs.oracle.com/en/java/javase/11/docs/specs/jar/jar.html#jar-manifest), but OSGi adds additional metadata to it in form of specific headers. The manifest file is part of the standard [JAR specification](https://docs.oracle.com/en/java/javase/17/docs/specs/jar/jar.html#jar-manifest), but OSGi adds additional metadata to it in form of specific headers.
The _Bundle-SymbolicName_ and the _Bundle-Version_ headers uniquely identify a bundle. The _Bundle-SymbolicName_ and the _Bundle-Version_ headers uniquely identify a bundle.
In OSGi is allowed to have **bundles with same name, but different version running at the same time.** In OSGi is allowed to have **bundles with same name, but different version running at the same time.**

View File

@ -517,7 +517,7 @@ Adds a time-series chart object for the display of logged data.
- `forceasitem` is used to show the value of a `Group` instead of showing a graph for each member (which is the default). - `forceasitem` is used to show the value of a `Group` instead of showing a graph for each member (which is the default).
- `yAxisDecimalPattern` is used to format the values on the y axis. - `yAxisDecimalPattern` is used to format the values on the y axis.
It accepts [DecimalFormat](https://docs.oracle.com/javase/7/docs/api/java/text/DecimalFormat.html). It accepts [DecimalFormat](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/text/DecimalFormat.html).
For example with `#.##` a number has to decimals. For example with `#.##` a number has to decimals.
Visit [Charts](https://github.com/openhab/openhab/wiki/Charts) in the Wiki for examples. Visit [Charts](https://github.com/openhab/openhab/wiki/Charts) in the Wiki for examples.