diff --git a/administration/logging.md b/administration/logging.md index 452042796..0081bad22 100644 --- a/administration/logging.md +++ b/administration/logging.md @@ -157,7 +157,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/javase/7/docs/api/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/11/docs/api/java.base/java/util/Formatter.html). ## Log4j configuration and logging into separate files diff --git a/configuration/items.md b/configuration/items.md index 4aaa2f736..c6bb09d33 100644 --- a/configuration/items.md +++ b/configuration/items.md @@ -271,7 +271,7 @@ Number Livingroom_Temperature "Temperature [%.1f °C]" If no state presentation and no square brackets are given, the Item will not provide a textual presentation of its internal state (i.e. in UIs no state is shown). 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](http://docs.oracle.com/javase/7/docs/api/java/util/Formatter.html#syntax). +Formatting of the presentation is done applying [Java formatter class syntax](https://docs.oracle.com/en/java/javase/11/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/developers/guidelines.md b/developers/guidelines.md index ded6151e7..70cea49f5 100644 --- a/developers/guidelines.md +++ b/developers/guidelines.md @@ -134,7 +134,7 @@ Data-transfer-objects (DTOs map from Json/XML to Java classes) do not require Ja ## D. Language Levels and Libraries -1. openHAB generally targets the long time supported Java 8 and Java 11 releases with the following restrictions: +1. openHAB generally targets the long time supported Java 11 releases with the following restrictions: * To allow optimized runtimes, the set of Java packages to be used is further restricted to [Compact Profile 2](https://www.oracle.com/technetwork/java/embedded/resources/tech/compact-profiles-overview-2157132.html). 2. The [OSGi Core Release 7](https://osgi.org/download/r7/osgi.core-7.0.0.pdf) with [OSGI Compendium Release 7](https://osgi.org/download/r7/osgi.cmpn-7.0.0.pdf) is targeted, and newer features should not be used. 3. [slf4j](http://slf4j.org) is used for logging. @@ -149,7 +149,7 @@ Expensive operations should therefore rather be scheduled as a job. 2. 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/javase/8/docs/api/java/util/concurrent/ScheduledExecutorService.html#scheduleWithFixedDelay(java.lang.Runnable,%20long,%20long,%20java.util.concurrent.TimeUnit)) should be preferred over [scheduleAtFixedRate](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ScheduledExecutorService.html#scheduleAtFixedRate(java.lang.Runnable,%20long,%20long,%20java.util.concurrent.TimeUnit)). +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)). 3. 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 ```). 4. Bundles must not require any substantial CPU time. diff --git a/developers/ide/eclipse.md b/developers/ide/eclipse.md index 95155a26f..ce7562e9e 100644 --- a/developers/ide/eclipse.md +++ b/developers/ide/eclipse.md @@ -15,10 +15,10 @@ If you already have Eclipse installed it is recommended to perform a separate Ec ## Eclipse IDE Setup -1. Install the Java 8 JDK if you did not have it installed. +1. Install the Java 11 JDK if you did not have it installed. ::: warning Attention - openHAB development requires **Java JDK version 8**. + openHAB development requires **Java JDK version 11**. ::: 1. Download the "Eclipse Installer": [can be downloaded from the Eclipse web site](https://wiki.eclipse.org/Eclipse_Installer) diff --git a/developers/ide/intellij.md b/developers/ide/intellij.md index 0f90038eb..983b8d3dc 100644 --- a/developers/ide/intellij.md +++ b/developers/ide/intellij.md @@ -6,7 +6,7 @@ title: IntelliJ # IntelliJ IDE ## Prerequisities - - git, Maven, IntelliJ and Java 8 are installed + - git, Maven, IntelliJ and Java 11 are installed ## Install OpenHAB distribution 1. Install the official [openHAB distribution](https://www.openhab.org/download/) diff --git a/developers/index.md b/developers/index.md index 0d49674e5..209312ab7 100644 --- a/developers/index.md +++ b/developers/index.md @@ -15,7 +15,7 @@ Try [git - the simple guide](http://rogerdudler.github.io/git-guide/) as a start Add-ons and the core itself are written in Java. Java is not hard to learn, but it helps if you have a general technical understanding of programming languages. -The different guides of this chapter assume that you are somewhat familiar with Java 8 and that you have a rough idea of Git's workflow (eg "checkout", "branches", "push"). +The different guides of this chapter assume that you are somewhat familiar with Java 11 and that you have a rough idea of Git's workflow (eg "checkout", "branches", "push"). ## Choose the Right Concept @@ -49,7 +49,7 @@ Please ensure that you have the following prerequisites installed as well: 1. [Git](https://git-scm.com/downloads) For retrieving our source code and push changes back. On Windows: Must be available in %PATH% 1. [Maven 3.x](https://maven.apache.org/download.cgi) Our buildsystem tool. On Windows: Must be available in %PATH% -1. Java JDK 8, for example from Oracle [Oracle JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html). On Windows: %JAVA% must be set. +1. Java JDK 11, for example from Oracle [Oracle JDK 11](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html). On Windows: %JAVA% must be set. You can use any IDE that is suitable for OSGi/Java development. We have prepared some step-by-step guides for the following IDEs: diff --git a/developers/osgi/osgi.md b/developers/osgi/osgi.md index 81e1e2a4c..2fece7683 100644 --- a/developers/osgi/osgi.md +++ b/developers/osgi/osgi.md @@ -47,7 +47,7 @@ More details about the OSGi architecture can be found at