Merge pull request #69 from eugenp/master

update

algorithms-searching/README.md

@@ -3,6 +3,7 @@
 This module contains articles about searching algorithms.
 
 ### Relevant articles:
+
 - [Binary Search Algorithm in Java](https://www.baeldung.com/java-binary-search)
 - [Depth First Search in Java](https://www.baeldung.com/java-depth-first-search)
 - [Interpolation Search in Java](https://www.baeldung.com/java-interpolation-search)
@@ -11,3 +12,4 @@ This module contains articles about searching algorithms.
 - [Monte Carlo Tree Search for Tic-Tac-Toe Game](https://www.baeldung.com/java-monte-carlo-tree-search)
 - [Range Search Algorithm in Java](https://www.baeldung.com/java-range-search)
 - [Fast Pattern Matching of Strings Using Suffix Tree](https://www.baeldung.com/java-pattern-matching-suffix-tree)
+- [Find the Kth Smallest Element in Two Sorted Arrays](https://www.baeldung.com/java-kth-smallest-element-in-sorted-arrays)

apache-poi/README.md

@@ -3,9 +3,11 @@
 This module contains articles about Apache POI
 
 ### Relevant Articles:
+
 - [Microsoft Word Processing in Java with Apache POI](https://www.baeldung.com/java-microsoft-word-with-apache-poi)
 - [Working with Microsoft Excel in Java](https://www.baeldung.com/java-microsoft-excel)
 - [Creating a MS PowerPoint Presentation in Java](https://www.baeldung.com/apache-poi-slideshow)
 - [Merge Cells in Excel Using Apache POI](https://www.baeldung.com/java-apache-poi-merge-cells)
 - [Get String Value of Excel Cell with Apache POI](https://www.baeldung.com/java-apache-poi-cell-string-value)
 - [Read Excel Cell Value Rather Than Formula With Apache POI](https://www.baeldung.com/apache-poi-read-cell-value-formula)
+- [Setting Formulas in Excel with Apache POI](https://www.baeldung.com/java-apache-poi-set-formulas)

cdi/pom.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project
-    xmlns="http://maven.apache.org/POM/4.0.0"
+        xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <artifactId>cdi</artifactId>
     <version>1.0-SNAPSHOT</version>
@@ -10,9 +10,9 @@
 
     <parent>
         <groupId>com.baeldung</groupId>
-        <artifactId>parent-spring-4</artifactId>
+        <artifactId>parent-spring-5</artifactId>
         <version>0.0.1-SNAPSHOT</version>
-        <relativePath>../parent-spring-4</relativePath>
+        <relativePath>../parent-spring-5</relativePath>
     </parent>
 
     <dependencies>
@@ -26,28 +26,22 @@
             <artifactId>weld-se-core</artifactId>
             <version>${weld-se-core.version}</version>
         </dependency>
-        <dependency>
-            <groupId>org.hamcrest</groupId>
-            <artifactId>hamcrest</artifactId>
-            <version>${hamcrest.version}</version>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.assertj</groupId>
             <artifactId>assertj-core</artifactId>
             <version>${assertj-core.version}</version>
             <scope>test</scope>
         </dependency>
-        <dependency>
-            <groupId>org.springframework</groupId>
-            <artifactId>spring-context</artifactId>
-            <version>${spring.version}</version>
-        </dependency>
         <dependency>
             <groupId>org.aspectj</groupId>
             <artifactId>aspectjweaver</artifactId>
             <version>${aspectjweaver.version}</version>
         </dependency>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-context</artifactId>
+            <version>${spring.version}</version>
+        </dependency>
         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-test</artifactId>
@@ -61,7 +55,6 @@
         <weld-se-core.version>3.0.5.Final</weld-se-core.version>
         <aspectjweaver.version>1.9.2</aspectjweaver.version>
         <assertj-core.version>3.10.0</assertj-core.version>
-        <spring.version>5.1.2.RELEASE</spring.version>
     </properties>
 
 </project>

core-java-modules/core-java-10/README.md

@@ -9,3 +9,4 @@ This module contains articles about Java 10 core features
 - [Copy a List to Another List in Java](http://www.baeldung.com/java-copy-list-to-another)
 - [Deep Dive Into the New Java JIT Compiler – Graal](https://www.baeldung.com/graal-java-jit-compiler)
 - [Copying Sets in Java](https://www.baeldung.com/java-copy-sets)
+- [Converting between a List and a Set in Java](https://www.baeldung.com/convert-list-to-set-and-set-to-list)

core-java-modules/core-java-10/pom.xml

@@ -1,22 +1,29 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project
-    xmlns="http://maven.apache.org/POM/4.0.0"
+        xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <artifactId>core-java-10</artifactId>
     <version>0.1.0-SNAPSHOT</version>
     <name>core-java-10</name>
     <packaging>jar</packaging>
-    <url>http://maven.apache.org</url>
 
     <parent>
-        <groupId>com.baeldung</groupId>
+        <groupId>com.baeldung.core-java-modules</groupId>
-        <artifactId>parent-modules</artifactId>
+        <artifactId>core-java-modules</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <version>0.0.1-SNAPSHOT</version>
-        <relativePath>../../</relativePath>
+        <relativePath>../</relativePath>
     </parent>
 
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-collections4</artifactId>
+            <version>${commons-collections4.version}</version>
+        </dependency>
+    </dependencies>
+
     <build>
         <plugins>
             <plugin>
@@ -34,6 +41,7 @@
     <properties>
         <maven.compiler.source.version>10</maven.compiler.source.version>
         <maven.compiler.target.version>10</maven.compiler.target.version>
+        <commons-collections4.version>4.1</commons-collections4.version>
     </properties>
 
 </project>

core-java-modules/core-java-10/src/test/java/com/baeldung/java10/collections/conversion/ListSetConversionUnitTest.java

@@ -0,0 +1,68 @@
+package com.baeldung.java10.collections.conversion;
+
+import com.google.common.collect.Lists;
+import com.google.common.collect.Sets;
+import org.apache.commons.collections4.CollectionUtils;
+import org.junit.Test;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+public class ListSetConversionUnitTest {
+
+    // Set -> List; List -> Set
+
+    @Test
+    public final void givenUsingCoreJava_whenSetConvertedToList_thenCorrect() {
+        final Set<Integer> sourceSet = Sets.newHashSet(0, 1, 2, 3, 4, 5);
+        final List<Integer> targetList = new ArrayList<>(sourceSet);
+    }
+
+    @Test
+    public final void givenUsingCoreJava_whenListConvertedToSet_thenCorrect() {
+        final List<Integer> sourceList = Lists.newArrayList(0, 1, 2, 3, 4, 5);
+        final Set<Integer> targetSet = new HashSet<>(sourceList);
+    }
+
+    @Test
+    public void givenUsingJava10_whenSetConvertedToList_thenCorrect() {
+        final Set<Integer> sourceSet = Sets.newHashSet(0, 1, 2, 3, 4, 5);
+        final List<Integer> targetList = List.copyOf(sourceSet);
+    }
+
+    @Test
+    public void givenUsingJava10_whenListConvertedToSet_thenCorrect() {
+        final List<Integer> sourceList = Lists.newArrayList(0, 1, 2, 3, 4, 5);
+        final Set<Integer> targetSet = Set.copyOf(sourceList);
+    }
+
+    @Test
+    public final void givenUsingGuava_whenSetConvertedToList_thenCorrect() {
+        final Set<Integer> sourceSet = Sets.newHashSet(0, 1, 2, 3, 4, 5);
+        final List<Integer> targetList = Lists.newArrayList(sourceSet);
+    }
+
+    @Test
+    public final void givenUsingGuava_whenListConvertedToSet_thenCorrect() {
+        final List<Integer> sourceList = Lists.newArrayList(0, 1, 2, 3, 4, 5);
+        final Set<Integer> targetSet = Sets.newHashSet(sourceList);
+    }
+
+    @Test
+    public final void givenUsingCommonsCollections_whenListConvertedToSet_thenCorrect() {
+        final List<Integer> sourceList = Lists.newArrayList(0, 1, 2, 3, 4, 5);
+
+        final Set<Integer> targetSet = new HashSet<>(6);
+        CollectionUtils.addAll(targetSet, sourceList);
+    }
+
+    @Test
+    public final void givenUsingCommonsCollections_whenSetConvertedToList_thenCorrect() {
+        final Set<Integer> sourceSet = Sets.newHashSet(0, 1, 2, 3, 4, 5);
+
+        final List<Integer> targetList = new ArrayList<>(6);
+        CollectionUtils.addAll(targetList, sourceSet);
+    }
+}

core-java-modules/core-java-10/src/test/java/com/baeldung/java10/list/CopyListServiceUnitTest.java

@@ -10,5 +10,6 @@ public class CopyListServiceUnitTest {
     @Test(expected = UnsupportedOperationException.class)
     public void whenModifyCopyOfList_thenThrowsException() {
         List<Integer> copyList = List.copyOf(Arrays.asList(1, 2, 3, 4));
+        copyList.add(4);
     }
 }

core-java-modules/core-java-8-datetime/src/test/java/com/baeldung/datetime/UseDateTimeFormatterUnitTest.java

@@ -31,6 +31,6 @@ public class UseDateTimeFormatterUnitTest {
     public void givenALocalDate_whenFormattingWithStyleAndLocale_thenPass() {
         String result = subject.formatWithStyleAndLocale(localDateTime, FormatStyle.MEDIUM, Locale.UK);
 
-        assertThat(result).isEqualTo("25 Jan 2015, 06:30:00");
+        assertThat(result).isEqualTo("25-Jan-2015 06:30:00");
     }
 }

core-java-modules/core-java-8-datetime/src/test/java/com/baeldung/datetime/UseToInstantUnitTest.java

@@ -3,6 +3,7 @@ package com.baeldung.datetime;
 import static org.assertj.core.api.Assertions.assertThat;
 
 import java.time.LocalDateTime;
+import java.time.ZoneId;
 import java.util.Calendar;
 import java.util.Date;
 import java.util.GregorianCalendar;
@@ -24,10 +25,11 @@ public class UseToInstantUnitTest {
 
     @Test
     public void givenADate_whenConvertingToLocalDate_thenAsExpected() {
-        Date givenDate = new Date(1465817690000L);
+        LocalDateTime currentDateTime = LocalDateTime.now();
+        Date givenDate = Date.from(currentDateTime.atZone(ZoneId.systemDefault()).toInstant());
 
         LocalDateTime localDateTime = subject.convertDateToLocalDate(givenDate);
 
-        assertThat(localDateTime).isEqualTo("2016-06-13T13:34:50");
+        assertThat(localDateTime).isEqualTo(currentDateTime);
     }
 }

core-java-modules/core-java-8-datetime/src/test/java/com/baeldung/datetime/UseZonedDateTimeUnitTest.java

@@ -54,7 +54,7 @@ public class UseZonedDateTimeUnitTest {
     @Test
     public void givenAStringWithTimeZone_whenParsing_thenEqualsExpected() {
         ZonedDateTime resultFromString = zonedDateTime.getZonedDateTimeUsingParseMethod("2015-05-03T10:15:30+01:00[Europe/Paris]");
-        ZonedDateTime resultFromLocalDateTime = ZonedDateTime.of(2015, 5, 3, 11, 15, 30, 0, ZoneId.of("Europe/Paris"));
+        ZonedDateTime resultFromLocalDateTime = ZonedDateTime.of(2015, 5, 3, 10, 15, 30, 0, ZoneId.of("Europe/Paris"));
 
         assertThat(resultFromString.getZone()).isEqualTo(ZoneId.of("Europe/Paris"));
         assertThat(resultFromLocalDateTime.getZone()).isEqualTo(ZoneId.of("Europe/Paris"));

core-java-modules/core-java-arrays-operations-advanced/README.md

@@ -3,7 +3,9 @@
 This module contains articles about advanced operations on arrays in Java. They assume some background knowledge with arrays in Java.
 
 ### Relevant Articles: 
+
 - [How to Copy an Array in Java](https://www.baeldung.com/java-array-copy)
 - [Arrays.deepEquals](https://www.baeldung.com/java-arrays-deepequals)
 - [Find Sum and Average in a Java Array](https://www.baeldung.com/java-array-sum-average)
 - [Intersection Between two Integer Arrays](https://www.baeldung.com/java-array-intersection)
+- [Comparing Arrays in Java](https://www.baeldung.com/java-comparing-arrays)

core-java-modules/core-java-collections-3/README.md

@@ -12,3 +12,4 @@
 - [Fail-Safe Iterator vs Fail-Fast Iterator](https://www.baeldung.com/java-fail-safe-vs-fail-fast-iterator)
 - [Quick Guide to the Java Stack](https://www.baeldung.com/java-stack)
 - [Convert an Array of Primitives to a List](https://www.baeldung.com/java-primitive-array-to-list)
+- [A Guide to BitSet in Java](https://www.baeldung.com/java-bitset)

core-java-modules/core-java-collections-list-3/README.md

@@ -10,4 +10,5 @@ This module contains articles about the Java List collection
 - [Performance Comparison of Primitive Lists in Java](https://www.baeldung.com/java-list-primitive-performance)
 - [Filtering a Java Collection by a List](https://www.baeldung.com/java-filter-collection-by-list)
 - [How to Count Duplicate Elements in Arraylist](https://www.baeldung.com/java-count-duplicate-elements-arraylist)
+- [Finding the Differences Between Two Lists in Java](https://www.baeldung.com/java-lists-difference)
 - [[<-- Prev]](/core-java-modules/core-java-collections-list-2)

core-java-modules/core-java-collections-maps-2/pom.xml

@@ -21,20 +21,15 @@
             <version>${eclipse-collections.version}</version>
         </dependency>
         <dependency>
-            <groupId>net.sf.trove4j</groupId>
+            <groupId>com.carrotsearch</groupId>
-            <artifactId>trove4j</artifactId>
+            <artifactId>hppc</artifactId>
-            <version>${trove4j.version}</version>
+            <version>${hppc.version}</version>
         </dependency>
         <dependency>
             <groupId>it.unimi.dsi</groupId>
             <artifactId>fastutil</artifactId>
             <version>${fastutil.version}</version>
         </dependency>
-        <dependency>
-            <groupId>colt</groupId>
-            <artifactId>colt</artifactId>
-            <version>${colt.version}</version>
-        </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
@@ -69,9 +64,8 @@
         <commons-collections4.version>4.1</commons-collections4.version>
         <avaitility.version>1.7.0</avaitility.version>
         <eclipse-collections.version>8.2.0</eclipse-collections.version>
-        <trove4j.version>3.0.2</trove4j.version>
+        <hppc.version>0.7.2</hppc.version>
         <fastutil.version>8.1.0</fastutil.version>
-        <colt.version>1.2.0</colt.version>
         <assertj.version>3.11.1</assertj.version>
     </properties>
 

core-java-modules/core-java-collections-maps-2/src/main/java/com/baeldung/map/primitives/PrimitiveMaps.java

@@ -1,29 +1,68 @@
 package com.baeldung.map.primitives;
 
-import cern.colt.map.AbstractIntDoubleMap;
+import com.carrotsearch.hppc.IntLongHashMap;
-import cern.colt.map.OpenIntDoubleHashMap;
+import com.carrotsearch.hppc.IntLongScatterMap;
-import gnu.trove.map.TDoubleIntMap;
+import com.carrotsearch.hppc.IntObjectHashMap;
-import gnu.trove.map.hash.TDoubleIntHashMap;
+import com.carrotsearch.hppc.IntObjectMap;
+import com.carrotsearch.hppc.IntObjectScatterMap;
+
 import it.unimi.dsi.fastutil.ints.Int2BooleanMap;
+import it.unimi.dsi.fastutil.ints.Int2BooleanMaps;
 import it.unimi.dsi.fastutil.ints.Int2BooleanOpenHashMap;
 import it.unimi.dsi.fastutil.ints.Int2BooleanSortedMap;
 import it.unimi.dsi.fastutil.ints.Int2BooleanSortedMaps;
+import it.unimi.dsi.fastutil.objects.ObjectIterator;
+
 import org.eclipse.collections.api.map.primitive.ImmutableIntIntMap;
 import org.eclipse.collections.api.map.primitive.MutableIntIntMap;
 import org.eclipse.collections.api.map.primitive.MutableObjectDoubleMap;
 import org.eclipse.collections.impl.factory.primitive.IntIntMaps;
 import org.eclipse.collections.impl.factory.primitive.ObjectDoubleMaps;
 
+import static java.lang.String.format;
+
+import java.math.BigDecimal;
+
 public class PrimitiveMaps {
 
     public static void main(String[] args) {
 
+        hppcMap();
         eclipseCollectionsMap();
-        troveMap();
-        coltMap();
         fastutilMap();
     }
 
+    private static void hppcMap() {
+        //Regular maps
+        IntLongHashMap intLongHashMap = new IntLongHashMap();
+        intLongHashMap.put(25,1L);
+        intLongHashMap.put(150,Long.MAX_VALUE);
+        intLongHashMap.put(1,0L);
+        
+        intLongHashMap.get(150);
+
+        IntObjectMap<BigDecimal> intObjectMap = new IntObjectHashMap<BigDecimal>();
+        intObjectMap.put(1, BigDecimal.valueOf(1));
+        intObjectMap.put(2, BigDecimal.valueOf(2500));
+
+        BigDecimal value = intObjectMap.get(2);
+
+        //Scatter maps
+        IntLongScatterMap intLongScatterMap = new IntLongScatterMap();
+        intLongScatterMap.put(1, 1L);
+        intLongScatterMap.put(2, -2L);
+        intLongScatterMap.put(1000,0L);    
+
+        intLongScatterMap.get(1000);
+
+        IntObjectScatterMap<BigDecimal> intObjectScatterMap = new IntObjectScatterMap<BigDecimal>();
+        intObjectScatterMap.put(1, BigDecimal.valueOf(1));
+        intObjectScatterMap.put(2, BigDecimal.valueOf(2500));
+
+        value = intObjectScatterMap.get(2);
+    }
+
+
     private static void fastutilMap() {
         Int2BooleanMap int2BooleanMap = new Int2BooleanOpenHashMap();
         int2BooleanMap.put(1, true);
@@ -32,13 +71,19 @@ public class PrimitiveMaps {
 
         boolean value = int2BooleanMap.get(1);
 
-        Int2BooleanSortedMap int2BooleanSorted = Int2BooleanSortedMaps.EMPTY_MAP;
+        //Lambda style iteration
-    }
+        Int2BooleanMaps.fastForEach(int2BooleanMap, entry -> {
+            System.out.println(String.format("Key: %d, Value: %b",entry.getIntKey(),entry.getBooleanValue()));
+        });
+
+        //Iterator based loop
+        ObjectIterator<Int2BooleanMap.Entry> iterator = Int2BooleanMaps.fastIterator(int2BooleanMap);
+        while(iterator.hasNext()) {
+            Int2BooleanMap.Entry entry = iterator.next();
+            System.out.println(String.format("Key: %d, Value: %b",entry.getIntKey(),entry.getBooleanValue()));
+
+        }
 
-    private static void coltMap() {
-        AbstractIntDoubleMap map = new OpenIntDoubleHashMap();
-        map.put(1, 4.5);
-        double value = map.get(1);
     }
 
     private static void eclipseCollectionsMap() {
@@ -53,17 +98,5 @@ public class PrimitiveMaps {
         dObject.addToValue("stability", 0.8);
     }
 
-    private static void troveMap() {
-        double[] doubles = new double[] {1.2, 4.5, 0.3};
-        int[] ints = new int[] {1, 4, 0};
 
-        TDoubleIntMap doubleIntMap = new TDoubleIntHashMap(doubles, ints);
-
-        doubleIntMap.put(1.2, 22);
-        doubleIntMap.put(4.5, 16);
-
-        doubleIntMap.adjustValue(1.2, 1);
-        doubleIntMap.adjustValue(4.5, 4);
-        doubleIntMap.adjustValue(0.3, 7);
-    }
 }

core-java-modules/core-java-console/README.md

@@ -1,5 +1,8 @@
 #Core Java Console
 
-[Read and Write User Input in Java](http://www.baeldung.com/java-console-input-output)
+### Relevant Articles:
-[Formatting with printf() in Java](https://www.baeldung.com/java-printstream-printf)
+
-[ASCII Art in Java](http://www.baeldung.com/ascii-art-in-java)
+- [Read and Write User Input in Java](http://www.baeldung.com/java-console-input-output)
+- [Formatting with printf() in Java](https://www.baeldung.com/java-printstream-printf)
+- [ASCII Art in Java](http://www.baeldung.com/ascii-art-in-java)
+- [System.console() vs. System.out](https://www.baeldung.com/java-system-console-vs-system-out)

core-java-modules/core-java-exceptions-3/README.md

@@ -0,0 +1,3 @@
+### Relevant Articles:
+
+- [NoSuchMethodError in Java](https://www.baeldung.com/java-nosuchmethod-error)

core-java-modules/core-java-exceptions-3/pom.xml

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project
+    xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>com.baeldung.exceptions</groupId>
+    <artifactId>core-java-exceptions-3</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <name>core-java-exceptions-3</name>
+    <packaging>jar</packaging>
+    <parent>
+        <groupId>com.baeldung.core-java-modules</groupId>
+        <artifactId>core-java-modules</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+        <relativePath>../</relativePath>
+    </parent>
+
+    <dependencies>
+        <!-- test scoped -->
+        <dependency>
+            <groupId>org.assertj</groupId>
+            <artifactId>assertj-core</artifactId>
+            <version>${assertj-core.version}</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <properties>
+        <!-- testing -->
+        <assertj-core.version>3.10.0</assertj-core.version>
+    </properties>
+</project>

core-java-modules/core-java-exceptions-3/src/main/java/com/baeldung/exceptions/nosuchmethoderror/MainMenu.java

@@ -0,0 +1,11 @@
+package com.baeldung.exceptions.nosuchmethoderror;
+
+public class MainMenu {
+    public static void main(String[] args) {
+        System.out.println("Today's Specials: " + getSpecials());
+    }
+
+    public static String getSpecials() {
+        return SpecialToday.getDesert();
+    }
+}

core-java-modules/core-java-exceptions-3/src/main/java/com/baeldung/exceptions/nosuchmethoderror/SpecialToday.java

@@ -0,0 +1,8 @@
+package com.baeldung.exceptions.nosuchmethoderror;
+public class SpecialToday {
+    private static String desert = "Chocolate Cake";
+
+    public static String getDesert() {
+        return desert;
+    }
+}

core-java-modules/core-java-exceptions-3/src/main/java/com/baeldung/nullmethodparameter/NullParameterExample.java

@@ -0,0 +1,17 @@
+package com.baeldung.nullmethodparameter;
+
+public class NullParameterExample {
+    public void processSomethingNotNull(Object myParameter) {
+        if (myParameter == null) {
+            throw new IllegalArgumentException("Parameter 'myParameter' cannot be null");
+        }
+        //Do something with the parameter
+    }
+    
+    public void processSomethingElseNotNull(Object myParameter) {
+        if (myParameter == null) {
+            throw new NullPointerException("Parameter 'myParameter' cannot be null");
+        }
+        //Do something with the parameter
+    }
+}

core-java-modules/core-java-exceptions-3/src/test/java/com/baeldung/exceptions/nosuchmethoderror/MainMenuUnitTest.java

@@ -0,0 +1,13 @@
+package com.baeldung.exceptions.nosuchmethoderror;
+
+import static org.junit.Assert.assertNotNull;
+
+import org.junit.jupiter.api.Test;
+
+class MainMenuUnitTest {
+
+    @Test
+    void whenGetSpecials_thenNotNull() {
+        assertNotNull(MainMenu.getSpecials());
+    }
+}

core-java-modules/core-java-exceptions-3/src/test/java/com/baeldung/nullmethodparameter/NullParameterExampleUnitTest.java

@@ -0,0 +1,17 @@
+package com.baeldung.nullmethodparameter;
+
+import org.junit.Test;
+
+public class NullParameterExampleUnitTest {
+    @Test(expected = IllegalArgumentException.class)
+    public void givenNullParameter_whenProcessSomethingNotNull_thenIllegalArgumentException() {
+        NullParameterExample example = new NullParameterExample();
+        example.processSomethingNotNull(null);
+    }
+    
+    @Test(expected = NullPointerException.class)
+    public void givenNullParameter_whenProcessSomethingElseNotNull_thenNullPointerException() {
+        NullParameterExample example = new NullParameterExample();
+        example.processSomethingElseNotNull(null);
+    }
+}

core-java-modules/core-java-io-3/README.md

@@ -6,4 +6,7 @@ This module contains articles about core Java input and output (IO)
 
 - [Java – Create a File](https://www.baeldung.com/java-how-to-create-a-file)
 - [Check If a Directory Is Empty in Java](https://www.baeldung.com/java-check-empty-directory)
+- [Check If a File or Directory Exists in Java](https://www.baeldung.com/java-file-directory-exists)
+- [Copy a Directory in Java](https://www.baeldung.com/java-copy-directory)
+- [Java Files Open Options](https://www.baeldung.com/java-file-options)
 - [[<-- Prev]](/core-java-modules/core-java-io-2)

core-java-modules/core-java-io-3/src/test/java/com/baeldung/linenumber/LineAtGivenNumberUnitTest.java

@@ -0,0 +1,82 @@
+package com.baeldung.linenumber;
+
+import org.apache.commons.io.FileUtils;
+import org.apache.commons.io.IOUtils;
+import org.junit.Test;
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+import java.util.List;
+import java.util.Scanner;
+import java.util.stream.Stream;
+
+import static org.junit.Assert.assertEquals;
+
+public class LineAtGivenNumberUnitTest {
+
+    private static final String FILE_PATH = "src/test/resources/linesInput.txt";
+
+    @Test
+    public void givenFile_whenUsingBufferedReader_thenExtractedLineIsCorrect() throws IOException {
+        try (BufferedReader br = Files.newBufferedReader(Paths.get(FILE_PATH))) {
+            for (int i = 0; i < 3; i++) {
+                br.readLine();
+            }
+
+            String extractedLine = br.readLine();
+            assertEquals("Line 4", extractedLine);
+        }
+    }
+
+    @Test
+    public void givenFile_whenUsingScanner_thenExtractedLineIsCorrect() throws IOException {
+        try (Scanner scanner = new Scanner(new File(FILE_PATH))) {
+            for (int i = 0; i < 3; i++) {
+                scanner.nextLine();
+            }
+
+            String extractedLine = scanner.nextLine();
+            assertEquals("Line 4", extractedLine);
+        }
+    }
+
+    @Test
+    public void givenSmallFile_whenUsingFilesAPI_thenExtractedLineIsCorrect() throws IOException {
+        String extractedLine = Files.readAllLines(Paths.get(FILE_PATH)).get(4);
+
+        assertEquals("Line 5", extractedLine);
+    }
+
+    @Test
+    public void givenLargeFile_whenUsingFilesAPI_thenExtractedLineIsCorrect() throws IOException {
+        try (Stream<String> lines = Files.lines(Paths.get(FILE_PATH))) {
+            String extractedLine = lines.skip(4).findFirst().get();
+
+            assertEquals("Line 5", extractedLine);
+        }
+    }
+
+    @Test
+    public void givenFile_whenUsingFileUtils_thenExtractedLineIsCorrect() throws IOException {
+        ClassLoader classLoader = getClass().getClassLoader();
+        File file = new File(classLoader.getResource("linesInput.txt").getFile());
+
+        List<String> lines = FileUtils.readLines(file, "UTF-8");
+
+        String extractedLine = lines.get(0);
+        assertEquals("Line 1", extractedLine);
+    }
+
+    @Test
+    public void givenFile_whenUsingIOUtils_thenExtractedLineIsCorrect() throws IOException {
+        String fileContent = IOUtils.toString(new FileInputStream(FILE_PATH), StandardCharsets.UTF_8);
+
+        String extractedLine = fileContent.split(System.lineSeparator())[0];
+        assertEquals("Line 1", extractedLine);
+    }
+}

core-java-modules/core-java-io-3/src/test/resources/linesInput.txt

@@ -0,0 +1,5 @@
+Line 1
+Line 2
+Line 3
+Line 4
+Line 5

core-java-modules/core-java-jvm-2/README.md

@@ -10,4 +10,5 @@ This module contains articles about working with the Java Virtual Machine (JVM).
 - [boolean and boolean[] Memory Layout in the JVM](https://www.baeldung.com/jvm-boolean-memory-layout)
 - [Where Is the Array Length Stored in JVM?](https://www.baeldung.com/java-jvm-array-length)
 - [Memory Address of Objects in Java](https://www.baeldung.com/java-object-memory-address)
+- [List All Classes Loaded in a Specific Class Loader](https://www.baeldung.com/java-list-classes-class-loader)
 - More articles: [[<-- prev]](/core-java-modules/core-java-jvm)

core-java-modules/core-java-jvm-2/src/main/java/com/baeldung/loadedclasslisting/Launcher.java

@@ -0,0 +1,19 @@
+package com.baeldung.loadedclasslisting;
+
+import java.util.Arrays;
+
+public class Launcher {
+
+    public static void main(String[] args) {
+        printClassesLoadedBy("BOOTSTRAP");
+        printClassesLoadedBy("SYSTEM");
+        printClassesLoadedBy("EXTENSION");
+    }
+
+    private static void printClassesLoadedBy(String classLoaderType) {
+        System.out.println(classLoaderType + " ClassLoader : ");
+        Class<?>[] classes = ListLoadedClassesAgent.listLoadedClasses(classLoaderType);
+        Arrays.asList(classes)
+            .forEach(clazz -> System.out.println(clazz.getCanonicalName()));
+    }
+}

core-java-modules/core-java-jvm-2/src/main/java/com/baeldung/loadedclasslisting/ListLoadedClassesAgent.java

@@ -0,0 +1,40 @@
+package com.baeldung.loadedclasslisting;
+
+import java.lang.instrument.Instrumentation;
+
+public class ListLoadedClassesAgent {
+
+    private static Instrumentation instrumentation;
+
+    public static void premain(String agentArgs, Instrumentation instrumentation) {
+        ListLoadedClassesAgent.instrumentation = instrumentation;
+    }
+
+    public static Class<?>[] listLoadedClasses(String classLoaderType) {
+        if (instrumentation == null) {
+            throw new IllegalStateException(
+              "ListLoadedClassesAgent is not initialized.");
+        }
+        return instrumentation.getInitiatedClasses(
+          getClassLoader(classLoaderType));
+    }
+
+    private static ClassLoader getClassLoader(String classLoaderType) {
+        ClassLoader classLoader = null;
+        switch (classLoaderType) {
+        case "SYSTEM":
+            classLoader = ClassLoader.getSystemClassLoader();
+            break;
+        case "EXTENSION":
+            classLoader = ClassLoader.getSystemClassLoader().getParent();
+            break;
+        // passing a null value to the Instrumentation : getInitiatedClasses method
+        // defaults to the bootstrap class loader
+        case "BOOTSTRAP":
+            break;
+        default:
+            break;
+        }
+        return classLoader;
+    }
+}

core-java-modules/core-java-jvm-2/src/main/java/com/baeldung/loadedclasslisting/MANIFEST.MF

@@ -0,0 +1 @@
+Premain-Class: com.baeldung.loadedclasslisting.ListLoadedClassesAgent

core-java-modules/core-java-lambdas/src/main/java/com/baeldung/java8/lambda/tips/Bar.java

@@ -6,8 +6,11 @@ public interface Bar {
 
     String method(String string);
 
-    default String defaultMethod() {
+    default String defaultBar() {
-        return "String from Bar";
+        return "Default String from Bar";
     }
 
+    default String defaultCommon() {
+        return "Default Common from Bar";
+    }
 }

core-java-modules/core-java-lambdas/src/main/java/com/baeldung/java8/lambda/tips/Baz.java

@@ -6,7 +6,11 @@ public interface Baz {
 
     String method(String string);
 
-    default String defaultMethod() {
+    default String defaultBaz() {
-        return "String from Baz";
+        return "Default String from Baz";
+    }
+
+    default String defaultCommon(){
+        return "Default Common from Baz";
     }
 }

core-java-modules/core-java-lambdas/src/main/java/com/baeldung/java8/lambda/tips/FooExtended.java

@@ -5,8 +5,7 @@ package com.baeldung.java8.lambda.tips;
 public interface FooExtended extends Baz, Bar {
 
     @Override
-    default String defaultMethod() {
+    default String defaultCommon() {
-        return Bar.super.defaultMethod();
+        return Bar.super.defaultCommon();
     }
-
 }

core-java-modules/core-java-lambdas/src/test/java/com/baeldung/java8/lambda/tips/Java8FunctionalInteracesLambdasUnitTest.java

@@ -39,9 +39,9 @@ public class Java8FunctionalInteracesLambdasUnitTest {
     @Test
     public void defaultMethodFromExtendedInterface_whenReturnDefiniteString_thenCorrect() {
         final FooExtended fooExtended = string -> string;
-        final String result = fooExtended.defaultMethod();
+        final String result = fooExtended.defaultCommon();
 
-        assertEquals("String from Bar", result);
+        assertEquals("Default Common from Bar", result);
     }
 
     @Test

core-java-modules/core-java-lang-3/README.md

@@ -4,4 +4,5 @@ This module contains articles about core features in the Java language
 
 - [Class.isInstance vs Class.isAssignableFrom](https://www.baeldung.com/java-isinstance-isassignablefrom)
 - [Converting a Java String Into a Boolean](https://www.baeldung.com/java-string-to-boolean)
+- [When are Static Variables Initialized in Java?](https://www.baeldung.com/java-static-variables-initialization)
 - [[<-- Prev]](/core-java-modules/core-java-lang-2)

core-java-modules/core-java-lang-math-2/src/main/java/com/baeldung/algorithms/largestpowerof2/LargestPowerOf2.java

@@ -0,0 +1,60 @@
+package com.baeldung.algorithms.largestpowerof2;
+
+import org.nd4j.linalg.io.Assert;
+
+public class LargestPowerOf2 {
+    public long findLargestPowerOf2LessThanTheGivenNumber(long input) {
+        Assert.isTrue(input > 1, "Invalid input");
+
+        long firstPowerOf2 = 1;
+        long nextPowerOf2 = 2;
+
+        while (nextPowerOf2 < input) {
+            firstPowerOf2 = nextPowerOf2;
+            nextPowerOf2 = nextPowerOf2 * 2;
+        }
+        return firstPowerOf2;
+    }
+
+    public long findLargestPowerOf2LessThanTheGivenNumberUsingLogBase2(long input) {
+        Assert.isTrue(input > 1, "Invalid input");
+
+        long temp = input;
+        if (input % 2 == 0) {
+            temp = input - 1;
+        }
+
+        // Find log base 2 of a given number
+        long power = (long) (Math.log(temp) / Math.log(2));
+        long result = (long) Math.pow(2, power);
+
+        return result;
+    }
+
+    public long findLargestPowerOf2LessThanTheGivenNumberUsingBitwiseAnd(long input) {
+        Assert.isTrue(input > 1, "Invalid input");
+        long result = 1;
+        for (long i = input - 1; i > 1; i--) {
+            if ((i & (i - 1)) == 0) {
+                result = i;
+                break;
+            }
+        }
+        return result;
+    }
+
+    public long findLargestPowerOf2LessThanTheGivenNumberUsingBitShiftApproach(long input) {
+        Assert.isTrue(input > 1, "Invalid input");
+        long result = 1;
+        long powerOf2;
+
+        for (long i = 0; i < Long.BYTES * 8; i++) {
+            powerOf2 = 1 << i;
+            if (powerOf2 >= input) {
+                break;
+            }
+            result = powerOf2;
+        }
+        return result;
+    }
+}

core-java-modules/core-java-lang-math-2/src/test/java/com/baeldung/algorithms/largestpowerof2/LargestPowerOf2UnitTest.java

@@ -0,0 +1,67 @@
+package com.baeldung.algorithms.largestpowerof2;
+
+import java.util.Arrays;
+import java.util.Collection;
+
+import org.junit.Assert;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.Parameterized;
+
+@RunWith(Parameterized.class)
+public class LargestPowerOf2UnitTest {
+    private long input;
+    private long expectedResult;
+
+    public LargestPowerOf2UnitTest(long input, long expectedResult) {
+        this.input = input;
+        this.expectedResult = expectedResult;
+    }
+
+    @Parameterized.Parameters(name = "{index}: verifyLargestPowerOf2LessThanTheGivenNumber({0}) = {1}")
+    public static Collection<Object[]> data() {
+        return Arrays.asList(new Object[][] { { 2, 1 }, { 4, 2 }, { 500, 256 }, { 512, 256 }, { 1050, 1024 } });
+    }
+
+    @Test
+    public void givenValidInput_verifyLargestPowerOf2LessThanTheGivenNumber() {
+        LargestPowerOf2 largestPowerOf2 = new LargestPowerOf2();
+
+        long result = largestPowerOf2.findLargestPowerOf2LessThanTheGivenNumber(input);
+
+        Assert.assertEquals(expectedResult, result);
+    }
+
+    @Test
+    public void givenValidInput_verifyLargestPowerOf2LessThanTheGivenNumberUsingLogBase2() {
+        LargestPowerOf2 largestPowerOf2 = new LargestPowerOf2();
+
+        long result = largestPowerOf2.findLargestPowerOf2LessThanTheGivenNumberUsingLogBase2(input);
+
+        Assert.assertEquals(expectedResult, result);
+    }
+
+    @Test
+    public void givenValidInput_verifyLargestPowerOf2LessThanTheGivenNumberBitwiseAnd() {
+        LargestPowerOf2 largestPowerOf2 = new LargestPowerOf2();
+
+        long result = largestPowerOf2.findLargestPowerOf2LessThanTheGivenNumberUsingBitwiseAnd(input);
+
+        Assert.assertEquals(expectedResult, result);
+    }
+
+    @Test
+    public void givenValidInput_verifyLargestPowerOf2LessThanTheGivenNumberBitShiftApproach() {
+        LargestPowerOf2 largestPowerOf2 = new LargestPowerOf2();
+
+        long result = largestPowerOf2.findLargestPowerOf2LessThanTheGivenNumberUsingBitShiftApproach(input);
+
+        Assert.assertEquals(expectedResult, result);
+    }
+
+    @Test(expected = IllegalArgumentException.class)
+    public void givenInvalidInput_ShouldThrowException() {
+        LargestPowerOf2 largestPowerOf2 = new LargestPowerOf2();
+        largestPowerOf2.findLargestPowerOf2LessThanTheGivenNumber(1);
+    }
+}

core-java-modules/core-java-lang-oop-types/README.md

@@ -3,6 +3,7 @@
 This module contains articles about types in Java
 
 ### Relevant Articles: 
+
 - [Java Classes and Objects](https://www.baeldung.com/java-classes-objects)
 - [Guide to the this Java Keyword](https://www.baeldung.com/java-this)
 - [Nested Classes in Java](https://www.baeldung.com/java-nested-classes)
@@ -10,3 +11,4 @@ This module contains articles about types in Java
 - [Iterating Over Enum Values in Java](https://www.baeldung.com/java-enum-iteration)
 - [Attaching Values to Java Enum](https://www.baeldung.com/java-enum-values)
 - [A Guide to Java Enums](https://www.baeldung.com/a-guide-to-java-enums)
+- [Determine if an Object is of Primitive Type](https://www.baeldung.com/java-object-primitive-type)

core-java-modules/core-java-os/README.md

@@ -12,5 +12,6 @@ This module contains articles about working with the operating system (OS) in Ja
 - [How to Print Screen in Java](http://www.baeldung.com/print-screen-in-java)
 - [Pattern Search with Grep in Java](http://www.baeldung.com/grep-in-java)
 - [How to Run a Shell Command in Java](http://www.baeldung.com/run-shell-command-in-java)
+- [Taking Screenshots Using Java](https://www.baeldung.com/java-taking-screenshots)
 
-This module uses Java 9, so make sure to have the JDK 9 installed to run it.
+This module uses Java 9, so make sure to have the JDK 9 installed to run it.

core-java-modules/core-java-reflection-2/README.md

@@ -1,3 +1,4 @@
 ### Relevant Articles:
 
 - [Reading the Value of ‘private’ Fields from a Different Class in Java](https://www.baeldung.com/java-reflection-read-private-field-value)
+- [Set Field Value With Reflection](https://www.baeldung.com/java-set-private-field-value)

core-java-modules/core-java/README.md

@@ -1,13 +1,13 @@
 ## Core Java Cookbooks and Examples
 
 ### Relevant Articles: 
-[Getting Started with Java Properties](http://www.baeldung.com/java-properties)
+- [Getting Started with Java Properties](http://www.baeldung.com/java-properties)
-[Java Money and the Currency API](http://www.baeldung.com/java-money-and-currency)
+- [Java Money and the Currency API](http://www.baeldung.com/java-money-and-currency)
-[Introduction to Java Serialization](http://www.baeldung.com/java-serialization)
+- [Introduction to Java Serialization](http://www.baeldung.com/java-serialization)
-[Guide to UUID in Java](http://www.baeldung.com/java-uuid)
+- [Guide to UUID in Java](http://www.baeldung.com/java-uuid)
-[Compiling Java *.class Files with javac](http://www.baeldung.com/javac)
+- [Compiling Java *.class Files with javac](http://www.baeldung.com/javac)
-[Introduction to Javadoc](http://www.baeldung.com/javadoc)
+- [Introduction to Javadoc](http://www.baeldung.com/javadoc)
-[Guide to the Externalizable Interface in Java](http://www.baeldung.com/java-externalizable)
+- [Guide to the Externalizable Interface in Java](http://www.baeldung.com/java-externalizable)
-[What is the serialVersionUID?](http://www.baeldung.com/java-serial-version-uid)
+- [What is the serialVersionUID?](http://www.baeldung.com/java-serial-version-uid)
-[A Guide to the ResourceBundle](http://www.baeldung.com/java-resourcebundle)
+- [A Guide to the ResourceBundle](http://www.baeldung.com/java-resourcebundle)
-[Merging java.util.Properties Objects](https://www.baeldung.com/java-merging-properties)
+- [Merging java.util.Properties Objects](https://www.baeldung.com/java-merging-properties)

core-java-modules/pom.xml

@@ -22,6 +22,7 @@
         <!-- <module>core-java-11</module> --> <!-- We haven't upgraded to java 11. Fixing in BAEL-10841 -->
         <!-- <module>core-java-12</module> --> <!-- We haven't upgraded to java 12. Fixing in BAEL-10841 -->
         <!-- <module>core-java-13</module> --> <!-- We haven't upgraded to java 12. Fixing in BAEL-10841 -->
+        <!-- <module>core-java-14</module> --> <!-- We haven't upgraded to java 14.-->
         <module>core-java-8</module>
         <module>core-java-8-2</module>
 
@@ -59,15 +60,20 @@
         <module>core-java-concurrency-basic</module>
         <module>core-java-concurrency-basic-2</module>
         <module>core-java-concurrency-collections</module>
+        <module>core-java-concurrency-collections-2</module>
+        <module>core-java-console</module>
 
+        <!--<module>core-java-8-datetime</module>--> <!-- unit test case failure -->
+        <module>core-java-8-datetime-2</module>
         <!-- <module>core-java-date-operations-1</module> --> <!-- We haven't upgraded to java 9. Fixing in BAEL-10841 -->
         <module>core-java-date-operations-2</module>
         <!-- We haven't upgraded to java 9. -->
         <!-- <module>core-java-datetime-computations</module> <module>core-java-datetime-conversion</module> <module>core-java-datetime-java8</module> <module>core-java-datetime-string</module> -->
+        <module>core-java-8-datetime</module>
 
         <module>core-java-exceptions</module>
         <module>core-java-exceptions-2</module>
-
+        <module>core-java-exceptions-3</module>
         <module>core-java-function</module>
 
         <module>core-java-io</module>

core-kotlin-modules/core-kotlin/README.md

@@ -3,6 +3,7 @@
 This module contains articles about Kotlin core features.
 
 ### Relevant articles:
+
 - [Introduction to the Kotlin Language](https://www.baeldung.com/kotlin-intro)
 - [Kotlin Java Interoperability](https://www.baeldung.com/kotlin-java-interoperability)
 - [Get a Random Number in Kotlin](https://www.baeldung.com/kotlin-random-number)
@@ -10,3 +11,4 @@ This module contains articles about Kotlin core features.
 - [Kotlin Ternary Conditional Operator](https://www.baeldung.com/kotlin-ternary-operator)
 - [Sequences in Kotlin](https://www.baeldung.com/kotlin/sequences)
 - [Converting Kotlin Data Class from JSON using GSON](https://www.baeldung.com/kotlin-json-convert-data-class)
+- [Exception Handling in Kotlin](https://www.baeldung.com/kotlin/exception-handling)

deeplearning4j/README.md

@@ -5,3 +5,4 @@ This module contains articles about Deeplearning4j.
 ### Relevant Articles:
 - [A Guide to Deeplearning4j](https://www.baeldung.com/deeplearning4j)
 - [Logistic Regression in Java](https://www.baeldung.com/java-logistic-regression)
+- [How to Implement a CNN with Deeplearning4j](https://www.baeldung.com/java-cnn-deeplearning4j)

docker/README.md

@@ -1,3 +1,4 @@
 ## Relevant Articles:
 
 - [Introduction to Docker Compose](https://www.baeldung.com/docker-compose)
+- [Creating Docker Images with Spring Boot](https://www.baeldung.com/spring-boot-docker-images)

docker/docker-spring-boot/README.md

@@ -1,3 +0,0 @@
-### Relevant Article:
-
-- [Creating Docker Images with Spring Boot](https://www.baeldung.com/spring-boot-docker-images)

excelformula/README.md

@@ -1,5 +0,0 @@
-## Apache POI
-
-This module contains articles about Apache POI
-
-### Relevant Articles:

gradle-5/settings.gradle

@@ -1,3 +1,4 @@
 rootProject.name='gradle-5-articles'
 include 'java-exec'
-include 'unused-dependencies'
+include 'unused-dependencies'
+include 'source-sets'

gradle-5/source-sets/.gitignore

@@ -0,0 +1 @@
+/build/

gradle-5/source-sets/build.gradle

@@ -0,0 +1,67 @@
+
+apply plugin: "eclipse"
+apply plugin: "java"
+
+description = "Source Sets example"
+
+task printSourceSetInformation(){
+    description = "Print source set information"
+
+    doLast{
+        sourceSets.each { srcSet ->
+            println "["+srcSet.name+"]"
+            print "-->Source directories: "+srcSet.allJava.srcDirs+"\n"
+            print "-->Output directories: "+srcSet.output.classesDirs.files+"\n"
+            print "-->Compile classpath:\n"
+            srcSet.compileClasspath.files.each { 
+                print "  "+it.path+"\n"
+            }
+            println ""
+        }
+    }
+}
+
+sourceSets{
+    itest {
+        compileClasspath += sourceSets.main.output
+        runtimeClasspath += sourceSets.main.output
+        java {
+        }
+    }
+}
+
+test {
+    testLogging {
+        events "passed","skipped", "failed"
+    }
+}
+
+dependencies {
+    implementation('org.apache.httpcomponents:httpclient:4.5.12')
+    testImplementation('junit:junit:4.12')
+    itestImplementation('com.google.guava:guava:29.0-jre')
+}
+
+task itest(type: Test) {
+    description = "Run integration tests"
+    group = "verification"
+    testClassesDirs = sourceSets.itest.output.classesDirs
+    classpath = sourceSets.itest.runtimeClasspath
+}
+
+itest {
+    testLogging {
+        events "passed","skipped", "failed"
+    }
+}
+
+configurations {
+    itestImplementation.extendsFrom(testImplementation)
+    itestRuntimeOnly.extendsFrom(testRuntimeOnly)
+}
+
+eclipse {
+    classpath {
+        plusConfigurations+=[configurations.itestCompileClasspath] 
+    } 
+}

gradle-5/source-sets/src/itest/java/com/baeldung/itest/SourceSetsItest.java

@@ -0,0 +1,25 @@
+package com.baeldung.itest;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.junit.Assert.assertThat;
+
+import java.util.List;
+
+import org.junit.Test;
+
+import com.baeldung.main.SourceSetsObject;
+import com.google.common.collect.ImmutableList;
+
+public class SourceSetsItest {
+
+    @Test
+    public void givenImmutableList_whenRun_ThenSuccess() {
+
+        SourceSetsObject underTest = new SourceSetsObject("lorem", "ipsum");
+        List<String> someStrings = ImmutableList.of("Baeldung", "is", "cool");
+
+        assertThat(underTest.getUser(), is("lorem"));
+        assertThat(underTest.getPassword(), is("ipsum"));
+        assertThat(someStrings.size(), is(3));
+    }
+}

gradle-5/source-sets/src/main/java/com/baeldung/main/SourceSetsMain.java

@@ -0,0 +1,9 @@
+package com.baeldung.main;
+
+public class SourceSetsMain {
+
+    public static void main(String[] args) {
+        System.out.println("Hell..oh...world!");
+    }
+
+}

gradle-5/source-sets/src/main/java/com/baeldung/main/SourceSetsObject.java

@@ -0,0 +1,21 @@
+package com.baeldung.main;
+
+public class SourceSetsObject {
+
+    private final String user;
+    private final String password;
+
+    public SourceSetsObject(String user, String password) {
+        this.user = user;
+        this.password = password;
+    }
+
+    public String getPassword() {
+        return password;
+    }
+
+    public String getUser() {
+        return user;
+    }
+
+}

gradle-5/source-sets/src/test/java/com/baeldung/test/SourceSetsTest.java

@@ -0,0 +1,20 @@
+package com.baeldung.test;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.junit.Assert.assertThat;
+
+import org.junit.Test;
+
+import com.baeldung.main.SourceSetsObject;
+
+public class SourceSetsTest {
+
+    @Test
+    public void whenRun_ThenSuccess() {
+
+        SourceSetsObject underTest = new SourceSetsObject("lorem", "ipsum");
+
+        assertThat(underTest.getUser(), is("lorem"));
+        assertThat(underTest.getPassword(), is("ipsum"));
+    }
+}

java-collections-conversions-2/README.md

@@ -3,6 +3,8 @@
 This module contains articles about conversions among Collection types and arrays in Java.
 
 ### Relevant Articles: 
+
 - [Array to String Conversions](https://www.baeldung.com/java-array-to-string)
 - [Mapping Lists with ModelMapper](https://www.baeldung.com/java-modelmapper-lists)
+- [Converting List to Map With a Custom Supplier](https://www.baeldung.com/list-to-map-supplier)
 - More articles: [[<-- prev]](../java-collections-conversions)

java-collections-conversions-2/src/test/java/com/baeldung/arrayconversion/ArrayToListConversionUnitTest.java

@@ -0,0 +1,32 @@
+package com.baeldung.arrayconversion;
+
+import org.junit.Test;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
+public class ArrayToListConversionUnitTest {
+
+    @Test(expected = UnsupportedOperationException.class)
+    public void givenAnArray_whenConvertingToList_returnUnmodifiableListUnitTest() {
+        String[] stringArray = new String[] { "A", "B", "C", "D" };
+        List<String> stringList = Arrays.asList(stringArray);
+        System.out.println(stringList);
+        stringList.set(0, "E");
+        System.out.println(stringList);
+        System.out.println(Arrays.toString(stringArray));
+        stringList.add("F");
+    }
+
+    @Test
+    public void givenAnArray_whenConvertingToList_returnModifiableListUnitTest() {
+        String[] stringArray = new String[] { "A", "B", "C", "D" };
+        List<String> stringList = new ArrayList<>(Arrays.asList(stringArray));
+        System.out.println(stringList);
+        stringList.set(0, "E");
+        System.out.println(stringList);
+        System.out.println(Arrays.toString(stringArray));
+        stringList.add("F");
+    }
+}

java-collections-conversions/README.md

@@ -5,7 +5,6 @@ This module contains articles about conversions among Collection types and array
 ### Relevant Articles: 
 - [Converting between an Array and a List in Java](https://www.baeldung.com/convert-array-to-list-and-list-to-array)
 - [Converting between an Array and a Set in Java](https://www.baeldung.com/convert-array-to-set-and-set-to-array)
-- [Converting between a List and a Set in Java](https://www.baeldung.com/convert-list-to-set-and-set-to-list)
 - [Convert a Map to an Array, List or Set in Java](https://www.baeldung.com/convert-map-values-to-array-list-set)
 - [Converting a List to String in Java](https://www.baeldung.com/java-list-to-string)
 - [How to Convert List to Map in Java](https://www.baeldung.com/java-list-to-map)

java-collections-conversions/src/test/java/com/baeldung/java/collections/JavaCollectionConversionUnitTest.java

@@ -101,42 +101,6 @@ public class JavaCollectionConversionUnitTest {
         final int[] primitiveTargetArray = ArrayUtils.toPrimitive(targetArray);
     }
 
-    // Set -> List; List -> Set
-
-    public final void givenUsingCoreJava_whenSetConvertedToList_thenCorrect() {
-        final Set<Integer> sourceSet = Sets.newHashSet(0, 1, 2, 3, 4, 5);
-        final List<Integer> targetList = new ArrayList<>(sourceSet);
-    }
-
-    public final void givenUsingCoreJava_whenListConvertedToSet_thenCorrect() {
-        final List<Integer> sourceList = Lists.newArrayList(0, 1, 2, 3, 4, 5);
-        final Set<Integer> targetSet = new HashSet<>(sourceList);
-    }
-
-    public final void givenUsingGuava_whenSetConvertedToList_thenCorrect() {
-        final Set<Integer> sourceSet = Sets.newHashSet(0, 1, 2, 3, 4, 5);
-        final List<Integer> targetList = Lists.newArrayList(sourceSet);
-    }
-
-    public final void givenUsingGuava_whenListConvertedToSet_thenCorrect() {
-        final List<Integer> sourceList = Lists.newArrayList(0, 1, 2, 3, 4, 5);
-        final Set<Integer> targetSet = Sets.newHashSet(sourceList);
-    }
-
-    public final void givenUsingCommonsCollections_whenListConvertedToSet_thenCorrect() {
-        final List<Integer> sourceList = Lists.newArrayList(0, 1, 2, 3, 4, 5);
-
-        final Set<Integer> targetSet = new HashSet<>(6);
-        CollectionUtils.addAll(targetSet, sourceList);
-    }
-
-    public final void givenUsingCommonsCollections_whenSetConvertedToList_thenCorrect() {
-        final Set<Integer> sourceSet = Sets.newHashSet(0, 1, 2, 3, 4, 5);
-
-        final List<Integer> targetList = new ArrayList<>(6);
-        CollectionUtils.addAll(targetList, sourceSet);
-    }
-
     // Map (values) -> Array, List, Set
 
     @Test

java-numbers-4/README.md

@@ -0,0 +1,3 @@
+### Relevant Articles:
+
+- [Probability in Java](https://www.baeldung.com/java-probability)

javax-servlets/README.md

@@ -12,4 +12,4 @@ This module contains articles about Servlets.
 - [Jakarta EE Servlet Exception Handling](https://www.baeldung.com/servlet-exceptions)
 - [Context and Servlet Initialization Parameters](https://www.baeldung.com/context-servlet-initialization-param)
 - [The Difference between getRequestURI and getPathInfo in HttpServletRequest](https://www.baeldung.com/http-servlet-request-requesturi-pathinfo)
-- Difference between request.getSession() and request.getSession(true)
+- [Difference between request.getSession() and request.getSession(true)](https://www.baeldung.com/java-request-getsession)

jgit/src/main/java/com/baeldung/jgit/porcelain/AddFile.java

@@ -6,6 +6,8 @@ import com.baeldung.jgit.helper.Helper;
 import org.eclipse.jgit.api.Git;
 import org.eclipse.jgit.api.errors.GitAPIException;
 import org.eclipse.jgit.lib.Repository;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 /**
  * Simple snippet which shows how to add a file to the index
@@ -14,6 +16,8 @@ import org.eclipse.jgit.lib.Repository;
  */
 public class AddFile {
 
+    private static final Logger logger = LoggerFactory.getLogger(AddFile.class);
+
     public static void main(String[] args) throws IOException, GitAPIException {
         // prepare a new test-repository
         try (Repository repository = Helper.createNewRepository()) {
@@ -29,7 +33,7 @@ public class AddFile {
                         .addFilepattern("testfile")
                         .call();
 
-                System.out.println("Added file " + myfile + " to repository at " + repository.getDirectory());
+                logger.debug("Added file " + myfile + " to repository at " + repository.getDirectory());
             }
         }
     }

jgit/src/main/java/com/baeldung/jgit/porcelain/CommitAll.java

@@ -7,6 +7,8 @@ import com.baeldung.jgit.helper.Helper;
 import org.eclipse.jgit.api.Git;
 import org.eclipse.jgit.api.errors.GitAPIException;
 import org.eclipse.jgit.lib.Repository;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 /**
  * Simple snippet which shows how to commit all files
@@ -15,6 +17,8 @@ import org.eclipse.jgit.lib.Repository;
  */
 public class CommitAll {
 
+    private static final Logger logger = LoggerFactory.getLogger(CommitAll.class);
+
     public static void main(String[] args) throws IOException, GitAPIException {
         // prepare a new test-repository
         try (Repository repository = Helper.createNewRepository()) {
@@ -44,7 +48,7 @@ public class CommitAll {
                         .call();
 
 
-                System.out.println("Committed all changes to repository at " + repository.getDirectory());
+                logger.debug("Committed all changes to repository at " + repository.getDirectory());
             }
         }
     }

jgit/src/main/java/com/baeldung/jgit/porcelain/CreateAndDeleteTag.java

@@ -9,6 +9,8 @@ import org.eclipse.jgit.lib.Ref;
 import org.eclipse.jgit.lib.Repository;
 import org.eclipse.jgit.revwalk.RevCommit;
 import org.eclipse.jgit.revwalk.RevWalk;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 /**
  * Simple snippet which shows how to create a tag
@@ -17,6 +19,8 @@ import org.eclipse.jgit.revwalk.RevWalk;
  */
 public class CreateAndDeleteTag {
 
+    private static final Logger logger = LoggerFactory.getLogger(CreateAndDeleteTag.class);
+
     public static void main(String[] args) throws IOException, GitAPIException {
         // prepare test-repository
         try (Repository repository = Helper.openJGitRepository()) {
@@ -26,7 +30,7 @@ public class CreateAndDeleteTag {
 
                 // set it on the current HEAD
                 Ref tag = git.tag().setName("tag_for_testing").call();
-                System.out.println("Created/moved tag " + tag + " to repository at " + repository.getDirectory());
+                logger.debug("Created/moved tag " + tag + " to repository at " + repository.getDirectory());
 
                 // remove the tag again
                 git.tagDelete().setTags("tag_for_testing").call();
@@ -36,14 +40,14 @@ public class CreateAndDeleteTag {
                 try (RevWalk walk = new RevWalk(repository)) {
                     RevCommit commit = walk.parseCommit(id);
                     tag = git.tag().setObjectId(commit).setName("tag_for_testing").call();
-                    System.out.println("Created/moved tag " + tag + " to repository at " + repository.getDirectory());
+                    logger.debug("Created/moved tag " + tag + " to repository at " + repository.getDirectory());
 
                     // remove the tag again
                     git.tagDelete().setTags("tag_for_testing").call();
 
                     // create an annotated tag
                     tag = git.tag().setName("tag_for_testing").setAnnotated(true).call();
-                    System.out.println("Created/moved tag " + tag + " to repository at " + repository.getDirectory());
+                    logger.debug("Created/moved tag " + tag + " to repository at " + repository.getDirectory());
 
                     // remove the tag again
                     git.tagDelete().setTags("tag_for_testing").call();

jgit/src/main/java/com/baeldung/jgit/porcelain/Log.java

@@ -7,6 +7,9 @@ import org.eclipse.jgit.api.errors.GitAPIException;
 import org.eclipse.jgit.lib.Repository;
 import org.eclipse.jgit.revwalk.RevCommit;
 
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
 /**
  * Simple snippet which shows how to get the commit-ids for a file to provide log information.
  *
@@ -14,6 +17,8 @@ import org.eclipse.jgit.revwalk.RevCommit;
  */
 public class Log {
 
+    private static final Logger logger = LoggerFactory.getLogger(Log.class);
+
     @SuppressWarnings("unused")
     public static void main(String[] args) throws IOException, GitAPIException {
         try (Repository repository = Helper.openJGitRepository()) {
@@ -22,30 +27,30 @@ public class Log {
                         .call();
                 int count = 0;
                 for (RevCommit rev : logs) {
-                    //System.out.println("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
+                    logger.trace("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
                     count++;
                 }
-                System.out.println("Had " + count + " commits overall on current branch");
+                logger.debug("Had " + count + " commits overall on current branch");
 
                 logs = git.log()
                         .add(repository.resolve(git.getRepository().getFullBranch()))
                         .call();
                 count = 0;
                 for (RevCommit rev : logs) {
-                    System.out.println("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
+                    logger.trace("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
                     count++;
                 }
-                System.out.println("Had " + count + " commits overall on "+git.getRepository().getFullBranch());
+                logger.debug("Had " + count + " commits overall on "+git.getRepository().getFullBranch());
 
                 logs = git.log()
                         .all()
                         .call();
                 count = 0;
                 for (RevCommit rev : logs) {
-                    //System.out.println("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
+                    logger.trace("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
                     count++;
                 }
-                System.out.println("Had " + count + " commits overall in repository");
+                logger.debug("Had " + count + " commits overall in repository");
 
                 logs = git.log()
                         // for all log.all()
@@ -53,10 +58,10 @@ public class Log {
                         .call();
                 count = 0;
                 for (RevCommit rev : logs) {
-                    //System.out.println("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
+                    logger.trace("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
                     count++;
                 }
-                System.out.println("Had " + count + " commits on README.md");
+                logger.debug("Had " + count + " commits on README.md");
 
                 logs = git.log()
                         // for all log.all()
@@ -64,10 +69,10 @@ public class Log {
                         .call();
                 count = 0;
                 for (RevCommit rev : logs) {
-                    //System.out.println("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
+                    logger.trace("Commit: " + rev /* + ", name: " + rev.getName() + ", id: " + rev.getId().getName() */);
                     count++;
                 }
-                System.out.println("Had " + count + " commits on pom.xml");
+                logger.debug("Had " + count + " commits on pom.xml");
             }
         }
     }

jgit/src/test/java/com/baeldung/jgit/porcelain/PorcelainUnitTest.java

@@ -11,7 +11,8 @@ public class PorcelainUnitTest {
         CommitAll.main(null);
         
         CreateAndDeleteTag.main(null);
-         
+
-        Log.main(null);    
+        Log.main(null);
+
     }
 }

jmh/README.md

@@ -6,3 +6,4 @@ This module contains articles about the Java Microbenchmark Harness (JMH).
 
 - [Microbenchmarking with Java](https://www.baeldung.com/java-microbenchmark-harness)
 - [A Guide to False Sharing and @Contended](https://www.baeldung.com/java-false-sharing-contended)
+- [Performance Comparison of boolean[] vs BitSet](https://www.baeldung.com/java-boolean-array-bitset-performance)

json-2/README.md

@@ -3,5 +3,7 @@
 This module contains articles about JSON.
 
 ### Relevant Articles:
+
 - [Introduction to Jsoniter](https://www.baeldung.com/java-jsoniter)
 - [Introduction to Moshi Json](https://www.baeldung.com/java-json-moshi)
+- [Hypermedia Serialization With JSON-LD](https://www.baeldung.com/json-linked-data)

jsoup/README.md

@@ -5,6 +5,7 @@ This module contains articles about jsoup.
 ### Relevant Articles: 
 - [Parsing HTML in Java with Jsoup](https://www.baeldung.com/java-with-jsoup)
 - [How to add proxy support to Jsoup?](https://www.baeldung.com/java-jsoup-proxy)
+- [Preserving Line Breaks When Using Jsoup](https://www.baeldung.com/jsoup-line-breaks)
 
 ### Build the Project
 

libraries-testing/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <artifactId>libraries-testing</artifactId>
     <name>libraries-testing</name>
@@ -158,6 +158,13 @@
             <scope>test</scope>
         </dependency>
 
+        <dependency>
+            <groupId>com.tngtech.archunit</groupId>
+            <artifactId>archunit-junit5</artifactId>
+            <version>${archunit.version}</version>
+            <scope>test</scope>
+        </dependency>
+
     </dependencies>
 
     <build>
@@ -193,7 +200,7 @@
 
     <properties>
         <asciidoctor.version>1.5.7.1</asciidoctor.version>
-		<serenity.version>1.9.9</serenity.version>
+        <serenity.version>1.9.9</serenity.version>
         <serenity.jbehave.version>1.9.0</serenity.jbehave.version>
         <serenity.jira.version>1.9.0</serenity.jira.version>
         <serenity.plugin.version>1.9.27</serenity.plugin.version>
@@ -210,6 +217,7 @@
         <maven-compiler-plugin.target>1.8</maven-compiler-plugin.target>
         <maven-compiler-plugin.source>1.8</maven-compiler-plugin.source>
         <maven-compiler-plugin.version>3.8.1</maven-compiler-plugin.version>
+        <archunit.version>0.14.1</archunit.version>
     </properties>
 
 </project>

libraries-testing/src/main/java/com/baeldung/archunit/smurfs/persistence/SmurfsRepository.java

@@ -0,0 +1,37 @@
+package com.baeldung.archunit.smurfs.persistence;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.TreeMap;
+
+import com.baeldung.archunit.smurfs.persistence.domain.Smurf;
+
+import static java.util.stream.Collectors.toList;
+
+public class SmurfsRepository {
+    
+    private static Map<String,Smurf> smurfs = Collections.synchronizedMap(new TreeMap<>());
+    
+    static {
+        // Just a few here. A full list can be found 
+        // at https://smurfs.fandom.com/wiki/List_of_Smurf_characters
+        smurfs.put("Papa", new Smurf("Papa", true, true));
+        smurfs.put("Actor", new Smurf("Actor", true, true));
+        smurfs.put("Alchemist", new Smurf("Alchemist", true, true));
+        smurfs.put("Archeologist", new Smurf("Archeologist", true, true));
+        smurfs.put("Architect", new Smurf("Architect", true, true));
+        smurfs.put("Baby", new Smurf("Baby", true, true));
+        smurfs.put("Baker", new Smurf("Baker", true, true));
+    }
+
+    public List<Smurf> findAll() {
+       return Collections.unmodifiableList(smurfs.values().stream().collect(toList()));
+    }
+    
+    public Optional<Smurf> findByName(String name) {
+        return Optional.of(smurfs.get(name));
+    }
+
+}

libraries-testing/src/main/java/com/baeldung/archunit/smurfs/persistence/domain/Smurf.java

@@ -0,0 +1,37 @@
+package com.baeldung.archunit.smurfs.persistence.domain;
+
+public class Smurf {
+    private String name;
+    private boolean comic;
+    private boolean cartoon;
+
+    public Smurf(String name, boolean comic, boolean cartoon) {
+        this.name = name;
+        this.comic = comic;
+        this.cartoon = cartoon;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public boolean isComic() {
+        return comic;
+    }
+
+    public void setCommic(boolean comic) {
+        this.comic = comic;
+    }
+
+    public boolean isCartoon() {
+        return cartoon;
+    }
+
+    public void setCartoon(boolean cartoon) {
+        this.cartoon = cartoon;
+    }
+}

libraries-testing/src/main/java/com/baeldung/archunit/smurfs/presentation/SmurfsController.java

@@ -0,0 +1,27 @@
+package com.baeldung.archunit.smurfs.presentation;
+
+import java.util.List;
+
+import org.springframework.http.MediaType;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.baeldung.archunit.smurfs.service.SmurfsService;
+import com.baeldung.archunit.smurfs.service.dto.SmurfDTO;
+
+@RequestMapping(value = "/smurfs", produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
+@RestController
+public class SmurfsController {
+    
+    private SmurfsService smurfs;
+    
+    public SmurfsController(SmurfsService smurfs) {
+        this.smurfs = smurfs;
+    }
+
+    @GetMapping
+    public List<SmurfDTO> getSmurfs() {
+        return smurfs.findAll();
+    }
+}

libraries-testing/src/main/java/com/baeldung/archunit/smurfs/service/SmurfsService.java

@@ -0,0 +1,35 @@
+
+package com.baeldung.archunit.smurfs.service;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+import org.springframework.stereotype.Component;
+
+import com.baeldung.archunit.smurfs.persistence.SmurfsRepository;
+import com.baeldung.archunit.smurfs.persistence.domain.Smurf;
+import com.baeldung.archunit.smurfs.service.dto.SmurfDTO;
+
+@Component
+public class SmurfsService {
+    
+    private SmurfsRepository repository;
+    
+    public SmurfsService(SmurfsRepository repository) {
+        this.repository = repository;
+    }
+    
+    public List<SmurfDTO> findAll() {
+        
+        return repository.findAll()
+          .stream()
+          .map(SmurfsService::toDTO)
+          .collect(Collectors.toList());
+    }
+    
+    
+    public static SmurfDTO toDTO(Smurf smurf) {
+        return new SmurfDTO(smurf.getName(),smurf.isComic(), smurf.isCartoon());
+    }
+
+}

libraries-testing/src/main/java/com/baeldung/archunit/smurfs/service/dto/SmurfDTO.java

@@ -0,0 +1,41 @@
+
+package com.baeldung.archunit.smurfs.service.dto;
+
+public class SmurfDTO {
+    private String name;
+    private boolean comic;
+    private boolean cartoon;
+    
+    public SmurfDTO() {}
+    
+    public SmurfDTO(String name, boolean comic, boolean cartoon) {
+        this.name = name;
+        this.comic = comic;
+        this.cartoon = cartoon;
+    }
+    
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+    
+    public boolean isComic() {
+        return comic;
+    }
+
+    public void setCommic(boolean comic) {
+        this.comic = comic;
+    }
+    
+    public boolean isCartoon() {
+        return cartoon;
+    }
+
+    public void setCartoon(boolean cartoon) {
+        this.cartoon = cartoon;
+    }
+    
+}

libraries-testing/src/test/java/com/baeldung/archunit/smurfs/SmurfsArchUnitTest.java

@@ -0,0 +1,76 @@
+package com.baeldung.archunit.smurfs;
+
+
+import com.tngtech.archunit.core.domain.JavaClasses;
+import com.tngtech.archunit.core.importer.ClassFileImporter;
+import com.tngtech.archunit.lang.ArchRule;
+import com.tngtech.archunit.library.Architectures.LayeredArchitecture;
+
+import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.classes;
+import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
+import static com.tngtech.archunit.library.Architectures.layeredArchitecture;
+
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+import org.junit.jupiter.api.Test;
+
+public class SmurfsArchUnitTest {
+    
+    @Test
+    public void givenPresentationLayerClasses_thenWrongCheckFails() {        
+        JavaClasses jc = new ClassFileImporter().importPackages("com.baeldung.archunit.smurfs");
+        
+        ArchRule r1 = classes()
+          .that()
+          .resideInAPackage("..presentation..")
+          .should().onlyDependOnClassesThat()
+          .resideInAPackage("..service..");
+    
+        assertThrows(AssertionError.class, ()-> r1.check(jc)) ;
+    }
+    
+
+    @Test
+    public void givenPresentationLayerClasses_thenCheckWithFrameworkDependenciesSuccess() {        
+        JavaClasses jc = new ClassFileImporter().importPackages("com.baeldung.archunit.smurfs");
+        
+        ArchRule r1 = classes()
+          .that()
+          .resideInAPackage("..presentation..")
+          .should().onlyDependOnClassesThat()
+          .resideInAnyPackage("..service..", "java..", "javax..", "org.springframework..");
+
+        r1.check(jc);
+    }
+
+    @Test
+    public void givenPresentationLayerClasses_thenNoPersistenceLayerAccess() {        
+        JavaClasses jc = new ClassFileImporter().importPackages("com.baeldung.archunit.smurfs");
+        
+        ArchRule r1 = noClasses()
+          .that()
+          .resideInAPackage("..presentation..")
+          .should().dependOnClassesThat()
+          .resideInAPackage("..persistence..");
+        
+        r1.check(jc);
+    }
+    
+    @Test
+    public void givenApplicationClasses_thenNoLayerViolationsShouldExist() {
+        
+        JavaClasses jc = new ClassFileImporter().importPackages("com.baeldung.archunit.smurfs");
+        
+        LayeredArchitecture arch = layeredArchitecture()
+           // Define layers
+          .layer("Presentation").definedBy("..presentation..")
+          .layer("Service").definedBy("..service..")
+          .layer("Persistence").definedBy("..persistence..")
+          // Add constraints
+          .whereLayer("Presentation").mayNotBeAccessedByAnyLayer()
+          .whereLayer("Service").mayOnlyBeAccessedByLayers("Presentation")
+          .whereLayer("Persistence").mayOnlyBeAccessedByLayers("Service");
+        
+        arch.check(jc);
+    }
+}

libraries-testing/src/test/resources/logback.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <logger name="org.dbunit" level="INFO" />
+</configuration>
+

logging-modules/log-mdc/pom.xml

@@ -10,9 +10,9 @@
 
     <parent>
         <groupId>com.baeldung</groupId>
-        <artifactId>parent-spring-4</artifactId>
+        <artifactId>parent-spring-5</artifactId>
         <version>0.0.1-SNAPSHOT</version>
-        <relativePath>../../parent-spring-4</relativePath>
+        <relativePath>../../parent-spring-5</relativePath>
     </parent>
 
     <dependencies>

maven-modules/maven-profiles/pom.xml

@@ -66,27 +66,29 @@
                 </file>
             </activation>
         </profile>
+        <profile>
+            <id>show-active-profiles</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-help-plugin</artifactId>
+                        <version>${help.plugin.version}</version>
+                        <executions>
+                            <execution>
+                                <id>show-profiles</id>
+                                <phase>compile</phase>
+                                <goals>
+                                    <goal>active-profiles</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
     </profiles>
 
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-help-plugin</artifactId>
-                <version>${help.plugin.version}</version>
-                <executions>
-                    <execution>
-                        <id>show-profiles</id>
-                        <phase>compile</phase>
-                        <goals>
-                            <goal>active-profiles</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-        </plugins>
-    </build>
-
     <properties>
        <help.plugin.version>3.2.0</help.plugin.version>
     </properties>

maven-modules/optional-dependencies/README.md

@@ -1,3 +1,3 @@
 ### Relevant Articles:
 
-- Optional Dependency in Maven
+- [Optional Dependency in Maven](https://www.baeldung.com/maven-optional-dependency)

open-liberty/pom.xml

@@ -27,6 +27,7 @@
             <groupId>org.apache.derby</groupId>
             <artifactId>derby</artifactId>
             <version>${version.derby}</version>
+            <scope>provided</scope>
         </dependency>
 
         <!-- For tests -->
@@ -70,27 +71,16 @@
                 <groupId>io.openliberty.tools</groupId>
                 <artifactId>liberty-maven-plugin</artifactId>
                 <version>${version.liberty-maven-plugin}</version>
-            </plugin>
+                <configuration>
-            <plugin>
+                    <copyDependencies>
-                <groupId>org.apache.maven.plugins</groupId>
+                        <location>${project.build.directory}/liberty/wlp/usr/shared/resources/</location>
-                <artifactId>maven-dependency-plugin</artifactId>
+                        <dependency>
-                <version>${version.maven-dependency-plugin}</version>
+                            <groupId>org.apache.derby</groupId>
-                <executions>
+                            <artifactId>derby</artifactId>
-                    <execution>
+                            <version>${version.derby}</version>
-                        <id>copy-derby-dependency</id>
+                        </dependency>
-                        <phase>package</phase>
+                    </copyDependencies>
-                        <goals>
+                </configuration>
-                            <goal>copy-dependencies</goal>
-                        </goals>
-                        <configuration>
-                            <includeArtifactIds>derby</includeArtifactIds>
-                            <outputDirectory>${project.build.directory}/liberty/wlp/usr/shared/resources/</outputDirectory>
-                            <systemPropertyVariables>
-                                <liberty.test.port>${testServerHttpPort}</liberty.test.port>
-                            </systemPropertyVariables>
-                        </configuration>
-                    </execution>
-                </executions>
             </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
@@ -112,8 +102,7 @@
         <version.jakarta.jakartaee-web-api>8.0.0</version.jakarta.jakartaee-web-api>
         <version.microprofile>3.2</version.microprofile>
         <version.derby>10.14.2.0</version.derby>
-        <version.liberty-maven-plugin>3.1</version.liberty-maven-plugin>
+        <version.liberty-maven-plugin>3.3-M3</version.liberty-maven-plugin>
-        <version.maven-dependency-plugin>2.10</version.maven-dependency-plugin>
         <version.maven-war-plugin>3.2.3</version.maven-war-plugin>
         <version.junit>4.12</version.junit>
         <version.yasson>1.0.5</version.yasson>

patterns/pom.xml

@@ -21,6 +21,7 @@
         <module>dip</module>
         <module>cqrs-es</module>
         <module>front-controller</module>
+        <module>hexagonal-architecture</module>
         <module>intercepting-filter</module>
         <module>solid</module>
     </modules>

patterns/solid/README.md

@@ -4,3 +4,4 @@
 - [Single Responsibility Principle in Java](https://www.baeldung.com/java-single-responsibility-principle)
 - [Open/Closed Principle in Java](https://www.baeldung.com/java-open-closed-principle)
 - [Interface Segregation Principle in Java](https://www.baeldung.com/java-interface-segregation)
+- [Liskov Substitution Principle in Java](https://www.baeldung.com/java-liskov-substitution-principle)

performance-tests/README.md

@@ -5,6 +5,7 @@ This module contains articles about performance testing.
 ### Relevant Articles: 
 
 - [Performance of Java Mapping Frameworks](https://www.baeldung.com/java-performance-mapping-frameworks)
+- [Performance Effects of Exceptions in Java](https://www.baeldung.com/java-exceptions-performance)
 
 ### Running
 

performance-tests/pom.xml

@@ -19,27 +19,14 @@
             <version>${orika.version}</version>
         </dependency>
         <dependency>
-            <groupId>net.sf.dozer</groupId>
+            <groupId>com.github.dozermapper</groupId>
-            <artifactId>dozer</artifactId>
+            <artifactId>dozer-core</artifactId>
             <version>${dozer.version}</version>
-        </dependency>
+        </dependency>       
-        <dependency>
-            <groupId>io.craftsman</groupId>
-            <artifactId>dozer-jdk8-support</artifactId>
-            <version>${dozer-jdk8-support.version}</version>
-        </dependency>
         <dependency>
             <groupId>org.mapstruct</groupId>
-            <artifactId>mapstruct-jdk8</artifactId>
+            <artifactId>mapstruct</artifactId>
-            <version>${mapstruct-jdk8.version}</version>
+            <version>${mapstruct.version}</version>
-            <optional>true</optional>
-        </dependency>
-        <!-- https://mvnrepository.com/artifact/org.mapstruct/mapstruct-processor -->
-        <dependency>
-            <groupId>org.mapstruct</groupId>
-            <artifactId>mapstruct-processor</artifactId>
-            <version>${mapstruct-jdk8.version}</version>
-            <scope>provided</scope>
         </dependency>
 
         <dependency>
@@ -77,10 +64,15 @@
                     <source>${javac.target}</source>
                     <target>${javac.target}</target>
                     <annotationProcessorPaths>
+                        <path>
+                            <groupId>org.openjdk.jmh</groupId>
+                            <artifactId>jmh-generator-annprocess</artifactId>
+                            <version>${jmh.version}</version>
+                        </path>
                         <path>
                             <groupId>org.mapstruct</groupId>
                             <artifactId>mapstruct-processor</artifactId>
-                            <version>${mapstruct-processor.version}</version>
+                            <version>${mapstruct.version}</version>
                         </path>
                     </annotationProcessorPaths>
                 </configuration>
@@ -120,28 +112,16 @@
                     </execution>
                 </executions>
             </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-                <version>${maven-jar-plugin.version}</version>
-                <configuration>
-                    <archive>
-                        <manifest>
-                            <mainClass>com.baeldung.performancetests.MappingFrameworksPerformance</mainClass>
-                        </manifest>
-                    </archive>
-                </configuration>
-            </plugin>
         </plugins>
         <pluginManagement>
             <plugins>
                 <plugin>
                     <artifactId>maven-clean-plugin</artifactId>
-                    <version>2.5</version>
+                    <version>${clean.plugin.version}</version>
                 </plugin>
                 <plugin>
                     <artifactId>maven-deploy-plugin</artifactId>
-                    <version>2.8.1</version>
+                    <version>${deploy.plugin.version}</version>
                 </plugin>
                 <plugin>
                     <artifactId>maven-install-plugin</artifactId>
@@ -179,19 +159,13 @@
         <!--
             JMH version to use with this project.
           -->
-        <jmh.version>1.21</jmh.version>
+        <jmh.version>1.23</jmh.version>
-        <orika.version>1.5.2</orika.version>
+        <orika.version>1.5.4</orika.version>
-        <dozer.version>5.5.1</dozer.version>
+        <dozer.version>6.5.0</dozer.version>
-        <dozer-jdk8-support.version>1.0.2</dozer-jdk8-support.version>
+        <mapstruct.version>1.3.1.Final</mapstruct.version>
-        <mapstruct-jdk8.version>1.2.0.Final</mapstruct-jdk8.version>
+        <modelmapper.version>2.3.8</modelmapper.version>
-        <modelmapper.version>1.1.0</modelmapper.version>
+        <jmapper.version>1.6.1.CR2</jmapper.version>             
-        <jmapper.version>1.6.0.1</jmapper.version>
+        
-        <mapstruct-processor.version>1.2.0.Final</mapstruct-processor.version>
-        <jmh-core.version>1.21</jmh-core.version>
-        <jmh-generator.version>1.21</jmh-generator.version>
-        <maven-compiler-plugin.version>3.7.0</maven-compiler-plugin.version>
-        <maven-jar-plugin.version>3.2.0</maven-jar-plugin.version>
-
         <!--
             Java source/target to use for compilation.
           -->
@@ -201,14 +175,16 @@
             Name of the benchmark Uber-JAR to generate.
           -->
         <uberjar.name>benchmarks</uberjar.name>
-        <compiler.plugin.version>3.1</compiler.plugin.version>
+        <clean.plugin.version>3.1.0</clean.plugin.version>
-        <shade.plugin.version>2.2</shade.plugin.version>
+        <deploy.plugin.version>3.0.0-M1</deploy.plugin.version>
-        <install.version>2.5.1</install.version>
+        <compiler.plugin.version>3.8.1</compiler.plugin.version>
-        <jar.plugin.version>2.4</jar.plugin.version>
+        <shade.plugin.version>3.2.4</shade.plugin.version>
-        <javadoc.plugin.version>2.9.1</javadoc.plugin.version>
+        <install.version>3.0.0-M1</install.version>
-        <resources.plugin.version>2.6</resources.plugin.version>
+        <jar.plugin.version>3.2.0</jar.plugin.version>
-        <site.plugin.version>3.3</site.plugin.version>
+        <javadoc.plugin.version>3.2.0</javadoc.plugin.version>
-        <source.plugin.version>2.2.1</source.plugin.version>
+        <resources.plugin.version>3.1.0</resources.plugin.version>
+        <site.plugin.version>3.9.1</site.plugin.version>
+        <source.plugin.version>3.2.1</source.plugin.version>
         <surefire.plugin.version>2.17</surefire.plugin.version>
     </properties>
 

performance-tests/src/main/java/com/baeldung/performancetests/dozer/DozerConverter.java

@@ -2,28 +2,28 @@ package com.baeldung.performancetests.dozer;
 
 import com.baeldung.performancetests.Converter;
 import com.baeldung.performancetests.model.destination.DestinationCode;
+import com.baeldung.performancetests.model.destination.Order;
 import com.baeldung.performancetests.model.source.SourceCode;
 import com.baeldung.performancetests.model.source.SourceOrder;
-import com.baeldung.performancetests.model.destination.Order;
+import com.github.dozermapper.core.DozerBeanMapperBuilder;
-import org.dozer.DozerBeanMapper;
+import com.github.dozermapper.core.Mapper;
-import org.dozer.Mapper;
 
-    public class DozerConverter implements Converter {
+public class DozerConverter implements Converter {
-        private final Mapper mapper;
+    private final Mapper mapper;
 
-        public DozerConverter() {
+    public DozerConverter() {
-            DozerBeanMapper mapper = new DozerBeanMapper();
+        this.mapper = DozerBeanMapperBuilder.create()
-            mapper.addMapping(DozerConverter.class.getResourceAsStream("/dozer-mapping.xml"));
+            .withMappingFiles("dozer-mapping.xml")
-            this.mapper = mapper;
+            .build();
-        }
-
-        @Override
-        public Order convert(SourceOrder sourceOrder) {
-            return mapper.map(sourceOrder,Order.class);
-        }
-
-        @Override
-        public DestinationCode convert(SourceCode sourceCode) {
-            return mapper.map(sourceCode, DestinationCode.class);
-        }
     }
+
+    @Override
+    public Order convert(SourceOrder sourceOrder) {
+        return mapper.map(sourceOrder, Order.class);
+    }
+
+    @Override
+    public DestinationCode convert(SourceCode sourceCode) {
+        return mapper.map(sourceCode, DestinationCode.class);
+    }
+}

performance-tests/src/main/resources/dozer-mapping.xml

@@ -1,8 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<mappings xmlns="http://dozer.sourceforge.net"
+<mappings xmlns="http://dozermapper.github.io/schema/bean-mapping" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://dozermapper.github.io/schema/bean-mapping https://dozermapper.github.io/schema/bean-mapping.xsd">
-          xsi:schemaLocation="http://dozer.sourceforge.net
-          http://dozer.sourceforge.net/schema/beanmapping.xsd">
 
     <configuration>
         <stop-on-errors>true</stop-on-errors>

performance-tests/src/test/resources/dozer-mapping.xml

@@ -1,8 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<mappings xmlns="http://dozer.sourceforge.net"
+<mappings xmlns="http://dozermapper.github.io/schema/bean-mapping" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://dozermapper.github.io/schema/bean-mapping https://dozermapper.github.io/schema/bean-mapping.xsd">
-          xsi:schemaLocation="http://dozer.sourceforge.net
-          http://dozer.sourceforge.net/schema/beanmapping.xsd">
 
     <configuration>
         <stop-on-errors>true</stop-on-errors>

persistence-modules/core-java-persistence/README.md

@@ -13,3 +13,4 @@
 - [Returning the Generated Keys in JDBC](https://www.baeldung.com/jdbc-returning-generated-keys)
 - [Loading JDBC Drivers](https://www.baeldung.com/java-jdbc-loading-drivers)
 - [Difference Between Statement and PreparedStatement](https://www.baeldung.com/java-statement-preparedstatement)
+- [Extracting Database Metadata Using JDBC](https://www.baeldung.com/jdbc-database-metadata)

persistence-modules/flyway-repair/README.MD

@@ -1 +1,3 @@
 ### Relevant Articles:
+
+- [Flyway Repair With Spring Boot](https://www.baeldung.com/spring-boot-flyway-repair)

persistence-modules/hibernate5/README.md

@@ -13,3 +13,4 @@ This module contains articles about Hibernate 5. Let's not add more articles her
 - [Guide to the Hibernate EntityManager](https://www.baeldung.com/hibernate-entitymanager)
 - [Using c3p0 with Hibernate](https://www.baeldung.com/hibernate-c3p0)
 - [Persist a JSON Object Using Hibernate](https://www.baeldung.com/hibernate-persist-json-object)
+- [What Is the Hi/Lo Algorithm?](https://www.baeldung.com/hi-lo-algorithm-hibernate)

persistence-modules/hibernate5/src/main/java/com/baeldung/hibernate/hilo/RestaurantOrder.java

@@ -0,0 +1,34 @@
+package com.baeldung.hibernate.hilo;
+
+import org.hibernate.annotations.GenericGenerator;
+import org.hibernate.annotations.Parameter;
+
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+
+@Entity
+public class RestaurantOrder {
+    @Id
+    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "hilo_sequence_generator")
+    @GenericGenerator(
+      name = "hilo_sequence_generator",
+      strategy = "sequence",
+      parameters = {
+        @Parameter(name = "sequence_name", value = "hilo_seqeunce"),
+        @Parameter(name = "initial_value", value = "1"),
+        @Parameter(name = "increment_size", value = "3"),
+        @Parameter(name = "optimizer", value = "hilo")
+      }
+    )
+    private Long id;
+
+    public long getId() {
+        return id;
+    }
+
+    public void setId(long id) {
+        this.id = id;
+    }
+}

persistence-modules/hibernate5/src/test/java/com/baeldung/hibernate/hilo/HibernateHiloUnitTest.java

@@ -0,0 +1,99 @@
+package com.baeldung.hibernate.hilo;
+
+import org.apache.log4j.BasicConfigurator;
+import org.apache.log4j.Level;
+import org.apache.log4j.LogManager;
+import org.hibernate.HibernateException;
+import org.hibernate.Session;
+import org.hibernate.SessionFactory;
+import org.hibernate.Transaction;
+import org.hibernate.boot.Metadata;
+import org.hibernate.boot.MetadataSources;
+import org.hibernate.boot.SessionFactoryBuilder;
+import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
+import org.hibernate.service.ServiceRegistry;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.net.URL;
+import java.util.Properties;
+
+import static org.junit.Assert.fail;
+
+public class HibernateHiloUnitTest {
+    private Session session;
+
+    @Before
+    public void init() {
+        try {
+            configureLogger();
+
+            ServiceRegistry serviceRegistry = configureServiceRegistry();
+            SessionFactory factory = getSessionFactoryBuilder(serviceRegistry).build();
+            session = factory.openSession();
+        } catch (HibernateException | IOException e) {
+            fail("Failed to initiate Hibernate Session [Exception:" + e.toString() + "]");
+        }
+    }
+
+    private void configureLogger() {
+        BasicConfigurator.configure();
+        LogManager.getLogger("org.hibernate").setLevel(Level.ERROR);
+        LogManager.getLogger("org.hibernate.id.enhanced.SequenceStructure").setLevel(Level.DEBUG);
+        LogManager.getLogger("org.hibernate.event.internal.AbstractSaveEventListener").setLevel(Level.DEBUG);
+        LogManager.getLogger("org.hibernate.SQL").setLevel(Level.DEBUG);
+    }
+
+
+    private static SessionFactoryBuilder getSessionFactoryBuilder(ServiceRegistry serviceRegistry) {
+        MetadataSources metadataSources = new MetadataSources(serviceRegistry);
+        metadataSources.addAnnotatedClass(RestaurantOrder.class);
+        Metadata metadata = metadataSources.buildMetadata();
+
+        return metadata.getSessionFactoryBuilder();
+    }
+
+    private static ServiceRegistry configureServiceRegistry() throws IOException {
+        Properties properties = getProperties();
+
+        return new StandardServiceRegistryBuilder().applySettings(properties)
+          .build();
+    }
+
+    private static Properties getProperties() throws IOException {
+        Properties properties = new Properties();
+        URL propertiesURL = getPropertiesURL();
+
+        try (FileInputStream inputStream = new FileInputStream(propertiesURL.getFile())) {
+            properties.load(inputStream);
+        }
+
+        return properties;
+    }
+
+    private static URL getPropertiesURL() {
+        return Thread.currentThread()
+          .getContextClassLoader()
+          .getResource("hibernate-hilo.properties");
+    }
+
+    @Test
+    public void givenHiLoAlgorithm_when9EntitiesArePersisted_Then3callsToDBForNextValueShouldBeMade() {
+        Transaction transaction = session.beginTransaction();
+
+        for (int i = 0; i < 9; i++) {
+            session.persist(new RestaurantOrder());
+            session.flush();
+        }
+
+        transaction.commit();
+    }
+
+    @After
+    public void cleanup() {
+        session.close();
+    }
+}

persistence-modules/hibernate5/src/test/resources/hibernate-hilo.properties

@@ -0,0 +1,10 @@
+hibernate.connection.driver_class=org.h2.Driver
+hibernate.connection.url=jdbc:h2:mem:hilo_db;DB_CLOSE_DELAY=-1
+hibernate.connection.username=sa
+hibernate.dialect=org.hibernate.dialect.H2Dialect
+hibernate.show_sql=true
+hibernate.hbm2ddl.auto=create-drop
+hibernate.c3p0.min_size=5
+hibernate.c3p0.max_size=20
+hibernate.c3p0.acquire_increment=5
+hibernate.c3p0.timeout=1800

persistence-modules/java-jpa-3/README.md

@@ -1,3 +1,7 @@
 ## JPA in Java
 
 This module contains articles about the Java Persistence API (JPA) in Java.
+
+### Relevant Articles:
+
+- [JPA Entity Equality](https://www.baeldung.com/jpa-entity-equality)

persistence-modules/java-jpa-3/src/main/java/com/baeldung/jpa/equality/EqualByBusinessKey.java

@@ -44,7 +44,7 @@ public class EqualByBusinessKey {
             return false;
         }
         if (obj instanceof EqualByBusinessKey) {
-            if (((EqualByBusinessKey) obj).getEmail() == getEmail()) {
+            if (((EqualByBusinessKey) obj).getEmail().equals(getEmail())) {
                 return true;
             }
         }

persistence-modules/pom.xml

@@ -19,12 +19,14 @@
         <module>core-java-persistence</module>
         <module>deltaspike</module>
         <module>elasticsearch</module>
+        <module>flyway</module>
         <module>flyway-repair</module>
         <module>hbase</module>
         <module>hibernate5</module>
         <module>hibernate-mapping</module> <!-- long running -->
         <module>hibernate-ogm</module>
         <module>hibernate-annotations</module>
+        <module>hibernate-exceptions</module>
         <module>hibernate-libraries</module>
         <module>hibernate-jpa</module>
         <module>hibernate-queries</module>
@@ -53,6 +55,7 @@
         <module>spring-boot-persistence-mongodb</module>
         <module>spring-data-cassandra</module>
         <module>spring-data-cassandra-reactive</module>
+        <module>spring-data-cosmosdb</module>
         <module>spring-data-couchbase-2</module>
         <module>spring-data-dynamodb</module>
         <module>spring-data-eclipselink</module>
@@ -78,6 +81,7 @@
         <module>spring-hibernate-5</module> <!-- long running -->
         <module>spring-hibernate4</module>
         <module>spring-jpa</module>
+        <module>spring-jpa-2</module>
         <!-- <module>spring-mybatis</module> --> <!-- needs fixing in BAEL-9021 -->
         <module>spring-persistence-simple</module>
         <module>spring-persistence-simple-2</module>

persistence-modules/spring-data-cosmosdb/README.md

@@ -0,0 +1,3 @@
+### Relevant Articles:
+
+- [Introduction to Spring Data Azure Cosmos DB](https://www.baeldung.com/spring-data-cosmos-db)

persistence-modules/spring-data-cosmosdb/pom.xml

@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>spring-data-cosmosdb</artifactId>
+    <name>spring-data-cosmos-db</name>
+    <description>tutorial for spring-data-cosmosdb</description>
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>parent-boot-2</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+        <relativePath>../../parent-boot-2</relativePath>
+    </parent>
+    
+    <properties>
+        <java.version>1.8</java.version>
+        <cosmodb.version>2.3.0</cosmodb.version>
+    </properties>
+    
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.microsoft.azure</groupId>
+            <artifactId>spring-data-cosmosdb</artifactId>
+            <version>${cosmodb.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+        </dependency>
+    </dependencies>
+    
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

persistence-modules/spring-data-cosmosdb/src/main/java/com/baeldung/spring/data/cosmosdb/AzureCosmosDbApplication.java

@@ -0,0 +1,12 @@
+package com.baeldung.spring.data.cosmosdb;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class AzureCosmosDbApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(AzureCosmosDbApplication.class, args);
+    }
+}