Merge remote-tracking branch 'upstream/master'

.travis.yml

@@ -4,7 +4,7 @@ before_install:
   - echo "MAVEN_OPTS='-Xmx2048M -Xss128M -XX:+CMSClassUnloadingEnabled -XX:+UseG1GC -XX:-UseGCOverheadLimit'" > ~/.mavenrc
 
 install: skip
-script: travis_wait 60 mvn -q test
+script: travis_wait 60 mvn -q install
 
 sudo: required
 

README.md

@@ -17,6 +17,10 @@ This project is **a collection of small and focused tutorials** each covering a
 Most of the tutorial projects are focused on the `Spring Framework` (and `Spring Security`).  
 In additional to Spring, the following technologies are in focus: `core Java`, `Jackson`, `HttpClient`, `Guava`. 
 
+Building the project
+====================
+To do the full build, do: `mvn install -Dgib.enabled=false`
+
 
 Working with the code in Eclipse
 ================================
@@ -29,3 +33,10 @@ Any IDE can be used to work with the projects, but if you're using Eclipse, cons
 CI - Jenkins
 ================================
 This tutorials project is being built **[>> HERE](https://rest-security.ci.cloudbees.com/job/tutorials-unit/)**
+
+### Relevant Articles: 
+================================
+
+- [Apache Maven Standard Directory Layout](http://www.baeldung.com/maven-directory-structure)
+- [Apache Maven Tutorial](http://www.baeldung.com/maven)
+- [Designing a User Friendly Java Library](http://www.baeldung.com/design-a-user-friendly-java-library)

algorithms/README.md

@@ -21,3 +21,4 @@
 - [Create a Sudoku Solver in Java](http://www.baeldung.com/java-sudoku)
 - [Displaying Money Amounts in Words](http://www.baeldung.com/java-money-into-words)
 - [A Collaborative Filtering Recommendation System in Java](http://www.baeldung.com/java-collaborative-filtering-recommendations)
+- [Find All Pairs of Numbers in an Array That Add Up to a Given Sum](http://www.baeldung.com/java-algorithm-number-pairs-sum)

apache-opennlp/README.md

@@ -0,0 +1,3 @@
+### Relevant Articles
+
+- [Intro to Apache OpenNLP](http://www.baeldung.com/apache-open-nlp)

asciidoctor/README.md

@@ -2,3 +2,4 @@
 
 - [Introduction to Asciidoctor](http://www.baeldung.com/introduction-to-asciidoctor)
 - [Generating a Book with Asciidoctor](http://www.baeldung.com/asciidoctor-book)
+- [Introduction to Asciidoctor in Java](http://www.baeldung.com/asciidoctor)

autovalue/pom.xml

@@ -18,10 +18,29 @@
             <artifactId>auto-value</artifactId>
             <version>${auto-value.version}</version>
         </dependency>
+        <dependency>
+            <groupId>com.google.auto.factory</groupId>
+            <artifactId>auto-factory</artifactId>
+            <version>${auto-factory.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>com.google.guava</groupId>
+                    <artifactId>guava</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
+        <dependency>
+            <groupId>com.google.inject</groupId>
+            <artifactId>guice</artifactId>
+            <version>${guice.version}</version>
+        </dependency>
     </dependencies>
 
     <properties>
         <auto-value.version>1.3</auto-value.version>
+        <auto-factory.version>1.0-beta5</auto-factory.version>
+        <guice.version>4.2.0</guice.version>
     </properties>
 
 </project>

autovalue/src/main/java/com/baeldung/autofactory/App.java

@@ -0,0 +1,21 @@
+package com.baeldung.autofactory;
+
+import com.baeldung.autofactory.model.Camera;
+import com.baeldung.autofactory.model.Phone;
+import com.baeldung.autofactory.model.PhoneFactory;
+import com.baeldung.autofactory.modules.SonyCameraModule;
+import com.google.inject.Guice;
+import com.google.inject.Injector;
+
+public class App {
+
+    public static void main(String[] args) {
+        PhoneFactory phoneFactory = new PhoneFactory(() -> new Camera("Unknown", "XXX"));
+        Phone simplePhone = phoneFactory.create("other parts");
+
+        Injector injector = Guice.createInjector(new SonyCameraModule());
+        PhoneFactory injectedFactory = injector.getInstance(PhoneFactory.class);
+        Phone xperia = injectedFactory.create("Xperia");
+    }
+
+}

autovalue/src/main/java/com/baeldung/autofactory/CustomStorage.java

@@ -0,0 +1,12 @@
+package com.baeldung.autofactory;
+
+import com.baeldung.autofactory.custom.SmartPhone;
+
+/**
+ * @author aiet
+ */
+public interface CustomStorage {
+
+    SmartPhone customROMInGB(int romSize);
+
+}

autovalue/src/main/java/com/baeldung/autofactory/custom/AbstractFactory.java

@@ -0,0 +1,10 @@
+package com.baeldung.autofactory.custom;
+
+/**
+ * @author aiet
+ */
+public abstract class AbstractFactory {
+
+    abstract CustomPhone newInstance(String brand);
+
+}

autovalue/src/main/java/com/baeldung/autofactory/custom/CustomPhone.java

@@ -0,0 +1,16 @@
+package com.baeldung.autofactory.custom;
+
+import com.google.auto.factory.AutoFactory;
+
+/**
+ * @author aiet
+ */
+@AutoFactory(extending = AbstractFactory.class)
+public class CustomPhone {
+
+    private final String brand;
+
+    public CustomPhone(String brand) {
+        this.brand = brand;
+    }
+}

autovalue/src/main/java/com/baeldung/autofactory/custom/SmartPhone.java

@@ -0,0 +1,18 @@
+package com.baeldung.autofactory.custom;
+
+import com.baeldung.autofactory.CustomStorage;
+import com.google.auto.factory.AutoFactory;
+
+/**
+ * @author aiet
+ */
+@AutoFactory(className = "SamsungFactory", allowSubclasses = true, implementing = CustomStorage.class)
+public class SmartPhone {
+
+    private int romSize;
+
+    public SmartPhone(int romSize) {
+        this.romSize = romSize;
+    }
+
+}

autovalue/src/main/java/com/baeldung/autofactory/model/Camera.java

@@ -0,0 +1,24 @@
+package com.baeldung.autofactory.model;
+
+/**
+ * @author aiet
+ */
+public class Camera {
+
+    private final String manufacturer;
+    private final String serial;
+
+    public Camera(String manufacturer, String serial) {
+        this.manufacturer = manufacturer;
+        this.serial = serial;
+    }
+
+    public String getManufacturer() {
+        return manufacturer;
+    }
+
+    public String getSerial() {
+        return serial;
+    }
+
+}

autovalue/src/main/java/com/baeldung/autofactory/model/ClassicPhone.java

@@ -0,0 +1,38 @@
+package com.baeldung.autofactory.model;
+
+import com.google.auto.factory.AutoFactory;
+import com.google.auto.factory.Provided;
+
+/**
+ * @author aiet
+ */
+public class ClassicPhone {
+
+    private final String dialpad;
+    private final String ringer;
+    private String otherParts;
+
+    @AutoFactory
+    public ClassicPhone(@Provided String dialpad, @Provided String ringer) {
+        this.dialpad = dialpad;
+        this.ringer = ringer;
+    }
+
+    @AutoFactory
+    public ClassicPhone(String otherParts) {
+        this("defaultDialPad", "defaultRinger");
+        this.otherParts = otherParts;
+    }
+
+    public String getDialpad() {
+        return dialpad;
+    }
+
+    public String getRinger() {
+        return ringer;
+    }
+
+    public String getOtherParts() {
+        return otherParts;
+    }
+}

autovalue/src/main/java/com/baeldung/autofactory/model/Phone.java

@@ -0,0 +1,34 @@
+package com.baeldung.autofactory.model;
+
+import com.google.auto.factory.AutoFactory;
+import com.google.auto.factory.Provided;
+
+import javax.inject.Named;
+
+/**
+ * @author aiet
+ */
+@AutoFactory
+public class Phone {
+
+    private Camera camera;
+    private String otherParts;
+
+    public Phone(@Provided @Named("Sony") Camera camera, String otherParts) {
+        this.camera = camera;
+        this.otherParts = otherParts;
+    }
+
+    /* required when used as a base class for AutoFactory */
+    public Phone() {
+    }
+
+    public Camera getCamera() {
+        return camera;
+    }
+
+    public String getOtherParts() {
+        return otherParts;
+    }
+
+}

autovalue/src/main/java/com/baeldung/autofactory/modules/SonyCameraModule.java

@@ -0,0 +1,22 @@
+package com.baeldung.autofactory.modules;
+
+import com.baeldung.autofactory.model.Camera;
+import com.google.inject.AbstractModule;
+import com.google.inject.Provides;
+
+import javax.inject.Named;
+
+/**
+ * @author aiet
+ */
+public class SonyCameraModule extends AbstractModule {
+
+    private static int SONY_CAMERA_SERIAL = 1;
+
+    @Named("Sony")
+    @Provides
+    Camera cameraProvider() {
+        return new Camera("Sony", String.format("%03d", SONY_CAMERA_SERIAL++));
+    }
+
+}

autovalue/src/main/java/com/baeldung/autofactory/provided/IntermediateAssembler.java

@@ -0,0 +1,22 @@
+package com.baeldung.autofactory.provided;
+
+import com.google.auto.factory.AutoFactory;
+import com.google.auto.factory.Provided;
+import javafx.scene.Camera;
+
+import javax.inject.Provider;
+
+/**
+ * @author aiet
+ */
+@AutoFactory
+public class IntermediateAssembler {
+
+    private final Provider<Camera> camera;
+    private final String otherParts;
+
+    public IntermediateAssembler(@Provided Provider<Camera> camera, String otherParts) {
+        this.camera = camera;
+        this.otherParts = otherParts;
+    }
+}

autovalue/src/main/java/com/baeldung/autofactory/provider/SonyCameraProvider.java

@@ -0,0 +1,18 @@
+package com.baeldung.autofactory.provider;
+
+import com.baeldung.autofactory.model.Camera;
+import com.google.inject.Provider;
+
+/**
+ * @author aiet
+ */
+public class SonyCameraProvider implements Provider<Camera> {
+
+    private static int sonyCameraSerial = 1;
+
+    @Override
+    public Camera get() {
+        return new Camera("Sony", String.format("%03d", sonyCameraSerial++));
+    }
+
+}

aws/README.md

@@ -5,4 +5,8 @@
 - [AWS Lambda With Java](http://www.baeldung.com/java-aws-lambda)
 - [Managing EC2 Instances in Java](http://www.baeldung.com/ec2-java)
 - [http://www.baeldung.com/aws-s3-multipart-upload](https://github.com/eugenp/tutorials/tree/master/aws)
+- [Multipart Uploads in Amazon S3 with Java](http://www.baeldung.com/aws-s3-multipart-upload)
+- [Integration Testing with a Local DynamoDB Instance](http://www.baeldung.com/dynamodb-local-integration-tests)
+- [Using the JetS3t Java Client With Amazon S3](http://www.baeldung.com/jets3t-amazon-s3)
+- [Managing Amazon SQS Queues in Java](http://www.baeldung.com/aws-queues-java)
 

cas/cas-secured-app/README.md

@@ -1,2 +1,3 @@
 ## Relevant articles:
 - [CAS SSO With Spring Security](http://www.baeldung.com/spring-security-cas-sso)
+- [Code Analysis with SonarQube](http://www.baeldung.com/sonar-qube)

cdi/pom.xml

@@ -8,16 +8,12 @@
 
     <parent>
         <groupId>com.baeldung</groupId>
-        <artifactId>parent-modules</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <artifactId>parent-spring</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+        <relativePath>../parent-spring</relativePath>
     </parent>
 
     <dependencies>
-        <dependency>
-            <groupId>org.springframework</groupId>
-            <artifactId>spring-core</artifactId>
-            <version>${spring.version}</version>
-        </dependency>
         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-context</artifactId>

core-groovy/pom.xml

@@ -28,12 +28,6 @@
             <artifactId>groovy-sql</artifactId>
             <version>${groovy-sql.version}</version>
         </dependency>
-        <dependency>
-            <groupId>org.junit.jupiter</groupId>
-            <artifactId>junit-jupiter-engine</artifactId>
-            <version>${junit.jupiter.version}</version>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.junit.platform</groupId>
             <artifactId>junit-platform-runner</artifactId>

core-java-10/pom.xml

@@ -0,0 +1,45 @@
+<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</groupId>
+	<artifactId>core-java-10</artifactId>
+	<packaging>jar</packaging>
+	<version>0.1.0-SNAPSHOT</version>
+	<name>core-java-10</name>
+	<url>http://maven.apache.org</url>
+
+	<parent>
+		<groupId>com.baeldung</groupId>
+		<artifactId>parent-modules</artifactId>
+		<version>1.0.0-SNAPSHOT</version>
+	</parent>
+
+	<dependencies>
+		<dependency>
+			<groupId>junit</groupId>
+			<artifactId>junit</artifactId>
+			<version>${junit.version}</version>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-compiler-plugin</artifactId>
+				<version>${maven-compiler-plugin.version}</version>
+				<configuration>
+					<source>${maven.compiler.source.version}</source>
+					<target>${maven.compiler.target.version}</target>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+
+	<properties>
+		<maven.compiler.source.version>10</maven.compiler.source.version>
+		<maven.compiler.target.version>10</maven.compiler.target.version>
+	</properties>
+
+</project>

core-java-10/src/main/java/com/baeldung/App.java

@@ -0,0 +1,13 @@
+package com.baeldung;
+
+/**
+ * Hello world!
+ *
+ */
+public class App 
+{
+    public static void main( String[] args )
+    {
+        System.out.println( "Hello World!" );
+    }
+}

core-java-10/src/test/java/com/baeldung/AppTest.java

@@ -0,0 +1,38 @@
+package com.baeldung;
+
+import junit.framework.Test;
+import junit.framework.TestCase;
+import junit.framework.TestSuite;
+
+/**
+ * Unit test for simple App.
+ */
+public class AppTest 
+    extends TestCase
+{
+    /**
+     * Create the test case
+     *
+     * @param testName name of the test case
+     */
+    public AppTest( String testName )
+    {
+        super( testName );
+    }
+
+    /**
+     * @return the suite of tests being tested
+     */
+    public static Test suite()
+    {
+        return new TestSuite( AppTest.class );
+    }
+
+    /**
+     * Rigourous Test :-)
+     */
+    public void testApp()
+    {
+        assertTrue( true );
+    }
+}

core-java-10/src/test/java/com/baeldung/java10/Java10FeaturesUnitTest.java

@@ -0,0 +1,61 @@
+package com.baeldung.java10;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Collectors;
+
+import org.junit.Before;
+import org.junit.Test;
+
+public class Java10FeaturesUnitTest {
+
+    private List<Integer> someIntList;
+    
+    @Before
+    public void setup() {
+        someIntList = new ArrayList<>();
+        
+        someIntList.add(1);
+        someIntList.add(2);
+        someIntList.add(3);
+    }
+
+    @Test
+    public void whenVarInitWithString_thenGetStringTypeVar() {
+        var message = "Hello, Java 10";
+        assertTrue(message instanceof String);
+    }
+
+    @Test
+    public void whenVarInitWithAnonymous_thenGetAnonymousType() {
+        var obj = new Object() {};
+        assertFalse(obj.getClass().equals(Object.class));
+    }
+
+    @Test(expected = UnsupportedOperationException.class)
+    public void whenModifyCopyOfList_thenThrowsException() {
+        List<Integer> copyList = List.copyOf(someIntList);
+        copyList.add(4);
+    }
+
+    @Test(expected = UnsupportedOperationException.class)
+    public void whenModifyToUnmodifiableList_thenThrowsException() {
+        List<Integer> evenList = someIntList.stream()
+          .filter(i -> i % 2 == 0)
+          .collect(Collectors.toUnmodifiableList());
+        evenList.add(4);
+    }
+
+    @Test
+    public void whenListContainsInteger_OrElseThrowReturnsInteger() {
+        Integer firstEven = someIntList.stream()
+          .filter(i -> i % 2 == 0)
+          .findFirst()
+          .orElseThrow();
+        is(firstEven).equals(Integer.valueOf(2));
+    }
+}

core-java-11/pom.xml

@@ -0,0 +1,45 @@
+<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</groupId>
+	<artifactId>core-java-11</artifactId>
+	<packaging>jar</packaging>
+	<version>0.1.0-SNAPSHOT</version>
+	<name>core-java-11</name>
+	<url>http://maven.apache.org</url>
+
+	<parent>
+		<groupId>com.baeldung</groupId>
+		<artifactId>parent-modules</artifactId>
+		<version>1.0.0-SNAPSHOT</version>
+	</parent>
+
+	<dependencies>
+		<dependency>
+			<groupId>junit</groupId>
+			<artifactId>junit</artifactId>
+			<version>${junit.version}</version>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-compiler-plugin</artifactId>
+				<version>${maven-compiler-plugin.version}</version>
+				<configuration>
+					<source>${maven.compiler.source.version}</source>
+					<target>${maven.compiler.target.version}</target>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+
+	<properties>
+		<maven.compiler.source.version>11</maven.compiler.source.version>
+		<maven.compiler.target.version>11</maven.compiler.target.version>
+	</properties>
+
+</project>

core-java-11/src/main/java/com/baeldung/App.java

@@ -0,0 +1,13 @@
+package com.baeldung;
+
+/**
+ * Hello world!
+ *
+ */
+public class App 
+{
+    public static void main( String[] args )
+    {
+        System.out.println( "Hello World!" );
+    }
+}

core-java-11/src/test/java/com/baeldung/AppTest.java

@@ -0,0 +1,38 @@
+package com.baeldung;
+
+import junit.framework.Test;
+import junit.framework.TestCase;
+import junit.framework.TestSuite;
+
+/**
+ * Unit test for simple App.
+ */
+public class AppTest 
+    extends TestCase
+{
+    /**
+     * Create the test case
+     *
+     * @param testName name of the test case
+     */
+    public AppTest( String testName )
+    {
+        super( testName );
+    }
+
+    /**
+     * @return the suite of tests being tested
+     */
+    public static Test suite()
+    {
+        return new TestSuite( AppTest.class );
+    }
+
+    /**
+     * Rigourous Test :-)
+     */
+    public void testApp()
+    {
+        assertTrue( true );
+    }
+}

core-java-8/README.md

@@ -44,3 +44,10 @@
 - [Java 8 StringJoiner](http://www.baeldung.com/java-string-joiner)
 - [Introduction to Spliterator in Java](http://www.baeldung.com/java-spliterator)
 - [Java 8 Math New Methods](http://www.baeldung.com/java-8-math)
+- [Overview of Java Built-in Annotations](http://www.baeldung.com/java-default-annotations)
+- [Finding Min/Max in an Array with Java](http://www.baeldung.com/java-array-min-max)
+- [Internationalization and Localization in Java 8](http://www.baeldung.com/java-8-localization)
+- [Filtering Kotlin Collections](http://www.baeldung.com/kotlin-filter-collection)
+- [How to Find an Element in a List with Java](http://www.baeldung.com/find-list-element-java)
+- [Measure Elapsed Time in Java](http://www.baeldung.com/java-measure-elapsed-time)
+

core-java-8/pom.xml

@@ -9,17 +9,12 @@
 
     <parent>
         <groupId>com.baeldung</groupId>
-        <artifactId>parent-modules</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <artifactId>parent-java</artifactId>
+    	<version>0.0.1-SNAPSHOT</version>
+    	<relativePath>../parent-java</relativePath>
     </parent>
 
     <dependencies>
-        <!-- utils -->
-        <dependency>
-            <groupId>com.google.guava</groupId>
-            <artifactId>guava</artifactId>
-            <version>${guava.version}</version>
-        </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-collections4</artifactId>