Merge remote-tracking branch 'upstream/master' into BAEL_4302

apache-shiro/pom.xml

@@ -39,10 +39,19 @@
             <artifactId>jcl-over-slf4j</artifactId>
             <scope>runtime</scope>
         </dependency>
+        <!-- spring-sec -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-security</artifactId>
+        </dependency>
     </dependencies>
 
     <properties>
-        <apache-shiro-core-version>1.4.0</apache-shiro-core-version>
+        <apache-shiro-core-version>1.5.3</apache-shiro-core-version>
         <log4j-version>1.2.17</log4j-version>
     </properties>
 

apache-shiro/src/main/java/com/baeldung/comparison/shiro/CustomRealm.java

@@ -0,0 +1,96 @@
+package com.baeldung.comparison.shiro;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+
+import org.apache.shiro.authc.AuthenticationException;
+import org.apache.shiro.authc.AuthenticationInfo;
+import org.apache.shiro.authc.AuthenticationToken;
+import org.apache.shiro.authc.SimpleAuthenticationInfo;
+import org.apache.shiro.authc.UnknownAccountException;
+import org.apache.shiro.authc.UsernamePasswordToken;
+import org.apache.shiro.authz.AuthorizationInfo;
+import org.apache.shiro.authz.SimpleAuthorizationInfo;
+import org.apache.shiro.realm.jdbc.JdbcRealm;
+import org.apache.shiro.subject.PrincipalCollection;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class CustomRealm extends JdbcRealm {
+    
+    private Logger logger = LoggerFactory.getLogger(CustomRealm.class);
+
+    private Map<String, String> credentials = new HashMap<>();
+    private Map<String, Set<String>> roles = new HashMap<>();
+    private Map<String, Set<String>> permissions = new HashMap<>();
+
+    {
+        credentials.put("Tom", "password");
+        credentials.put("Jerry", "password");
+
+        roles.put("Jerry", new HashSet<>(Arrays.asList("ADMIN")));
+        roles.put("Tom", new HashSet<>(Arrays.asList("USER")));
+
+        permissions.put("ADMIN", new HashSet<>(Arrays.asList("READ", "WRITE")));
+        permissions.put("USER", new HashSet<>(Arrays.asList("READ")));
+    }
+
+    @Override
+    protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token) throws AuthenticationException {
+
+        UsernamePasswordToken userToken = (UsernamePasswordToken) token;
+
+        if (userToken.getUsername() == null || userToken.getUsername()
+            .isEmpty() || !credentials.containsKey(userToken.getUsername())) {
+            throw new UnknownAccountException("User doesn't exist");
+        }
+
+        return new SimpleAuthenticationInfo(userToken.getUsername(), credentials.get(userToken.getUsername()), getName());
+    }
+
+    @Override
+    protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
+        Set<String> roles = new HashSet<>();
+        Set<String> permissions = new HashSet<>();
+
+        for (Object user : principals) {
+            try {
+                roles.addAll(getRoleNamesForUser(null, (String) user));
+                permissions.addAll(getPermissions(null, null, roles));
+            } catch (SQLException e) {
+                logger.error(e.getMessage());
+            }
+        }
+        SimpleAuthorizationInfo authInfo = new SimpleAuthorizationInfo(roles);
+        authInfo.setStringPermissions(permissions);
+        return authInfo;
+    }
+
+    @Override
+    protected Set<String> getRoleNamesForUser(Connection conn, String username) throws SQLException {
+        if (!roles.containsKey(username)) {
+            throw new SQLException("User doesn't exist");
+        }
+        return roles.get(username);
+    }
+
+    @Override
+    protected Set<String> getPermissions(Connection conn, String username, Collection<String> roles) throws SQLException {
+        Set<String> userPermissions = new HashSet<>();
+
+        for (String role : roles) {
+            if (!permissions.containsKey(role)) {
+                throw new SQLException("Role doesn't exist");
+            }
+            userPermissions.addAll(permissions.get(role));
+        }
+        return userPermissions;
+    }
+
+}

apache-shiro/src/main/java/com/baeldung/comparison/shiro/ShiroApplication.java

@@ -0,0 +1,33 @@
+package com.baeldung.comparison.shiro;
+
+import org.apache.shiro.realm.Realm;
+import org.apache.shiro.spring.web.config.DefaultShiroFilterChainDefinition;
+import org.apache.shiro.spring.web.config.ShiroFilterChainDefinition;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.autoconfigure.security.servlet.SecurityAutoConfiguration;
+import org.springframework.context.annotation.Bean;
+
+@SpringBootApplication(exclude = SecurityAutoConfiguration.class)
+public class ShiroApplication {
+
+    public static void main(String... args) {
+        SpringApplication.run(ShiroApplication.class, args);
+    }
+
+    @Bean
+    public Realm customRealm() {
+        return new CustomRealm();
+    }
+
+    @Bean
+    public ShiroFilterChainDefinition shiroFilterChainDefinition() {
+        DefaultShiroFilterChainDefinition filter = new DefaultShiroFilterChainDefinition();
+
+        filter.addPathDefinition("/home", "authc");
+        filter.addPathDefinition("/**", "anon");
+
+        return filter;
+    }
+
+}

apache-shiro/src/main/java/com/baeldung/comparison/shiro/controllers/ShiroController.java

@@ -0,0 +1,99 @@
+package com.baeldung.comparison.shiro.controllers;
+
+import javax.servlet.http.HttpServletRequest;
+
+import org.apache.shiro.SecurityUtils;
+import org.apache.shiro.authc.AuthenticationException;
+import org.apache.shiro.authc.UsernamePasswordToken;
+import org.apache.shiro.subject.Subject;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.servlet.mvc.support.RedirectAttributes;
+
+import com.baeldung.comparison.shiro.models.UserCredentials;
+
+@Controller
+public class ShiroController {
+    
+    private Logger logger = LoggerFactory.getLogger(ShiroController.class);
+
+    @GetMapping("/")
+    public String getIndex() {
+        return "comparison/index";
+    }
+
+    @GetMapping("/login")
+    public String showLoginPage() {
+        return "comparison/login";
+    }
+
+    @PostMapping("/login")
+    public String doLogin(HttpServletRequest req, UserCredentials credentials, RedirectAttributes attr) {
+
+        Subject subject = SecurityUtils.getSubject();
+
+        if (!subject.isAuthenticated()) {
+            UsernamePasswordToken token = new UsernamePasswordToken(credentials.getUsername(), credentials.getPassword());
+            try {
+                subject.login(token);
+            } catch (AuthenticationException ae) {
+                logger.error(ae.getMessage());
+                attr.addFlashAttribute("error", "Invalid Credentials");
+                return "redirect:/login";
+            }
+        }
+        return "redirect:/home";
+    }
+
+    @GetMapping("/home")
+    public String getMeHome(Model model) {
+
+        addUserAttributes(model);
+
+        return "comparison/home";
+    }
+
+    @GetMapping("/admin")
+    public String adminOnly(Model model) {
+        addUserAttributes(model);
+
+        Subject currentUser = SecurityUtils.getSubject();
+        if (currentUser.hasRole("ADMIN")) {
+            model.addAttribute("adminContent", "only admin can view this");
+        }
+        return "comparison/home";
+    }
+
+    @PostMapping("/logout")
+    public String logout() {
+        Subject subject = SecurityUtils.getSubject();
+        subject.logout();
+        return "redirect:/";
+    }
+
+    private void addUserAttributes(Model model) {
+        Subject currentUser = SecurityUtils.getSubject();
+        String permission = "";
+
+        if (currentUser.hasRole("ADMIN")) {
+            model.addAttribute("role", "ADMIN");
+        } else if (currentUser.hasRole("USER")) {
+            model.addAttribute("role", "USER");
+        }
+
+        if (currentUser.isPermitted("READ")) {
+            permission = permission + " READ";
+        }
+
+        if (currentUser.isPermitted("WRITE")) {
+            permission = permission + " WRITE";
+        }
+        model.addAttribute("username", currentUser.getPrincipal());
+        model.addAttribute("permission", permission);
+    }
+
+}

apache-shiro/src/main/java/com/baeldung/comparison/shiro/models/UserCredentials.java

@@ -0,0 +1,28 @@
+package com.baeldung.comparison.shiro.models;
+
+public class UserCredentials {
+
+    private String username;
+    private String password;
+
+    public String getUsername() {
+        return username;
+    }
+
+    public void setUsername(String username) {
+        this.username = username;
+    }
+
+    public String getPassword() {
+        return password;
+    }
+
+    public void setPassword(String password) {
+        this.password = password;
+    }
+
+    @Override
+    public String toString() {
+        return "username = " + getUsername();
+    }
+}

apache-shiro/src/main/java/com/baeldung/comparison/springsecurity/Application.java

@@ -0,0 +1,19 @@
+package com.baeldung.comparison.springsecurity;
+
+import org.apache.shiro.spring.boot.autoconfigure.ShiroAnnotationProcessorAutoConfiguration;
+import org.apache.shiro.spring.boot.autoconfigure.ShiroAutoConfiguration;
+import org.apache.shiro.spring.config.web.autoconfigure.ShiroWebAutoConfiguration;
+import org.apache.shiro.spring.config.web.autoconfigure.ShiroWebFilterConfiguration;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication(exclude = {ShiroAutoConfiguration.class,
+        ShiroAnnotationProcessorAutoConfiguration.class,
+        ShiroWebAutoConfiguration.class,
+        ShiroWebFilterConfiguration.class})
+public class Application {
+
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+}

apache-shiro/src/main/java/com/baeldung/comparison/springsecurity/config/SecurityConfig.java

@@ -0,0 +1,45 @@
+package com.baeldung.comparison.springsecurity.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
+import org.springframework.security.config.annotation.web.builders.HttpSecurity;
+import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
+import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
+import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
+import org.springframework.security.crypto.password.PasswordEncoder;
+
+@EnableWebSecurity
+public class SecurityConfig extends WebSecurityConfigurerAdapter {
+
+    @Override
+    protected void configure(HttpSecurity http) throws Exception {
+        http.csrf().disable().authorizeRequests(authorize -> authorize.antMatchers("/index", "/login")
+            .permitAll()
+            .antMatchers("/home", "/logout")
+            .authenticated()
+            .antMatchers("/admin/**")
+            .hasRole("ADMIN"))
+            .formLogin(formLogin -> formLogin.loginPage("/login")
+                .failureUrl("/login-error"));
+    }
+
+    @Override
+    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
+        auth.inMemoryAuthentication()
+            .withUser("Jerry")
+            .password(passwordEncoder().encode("password"))
+            .authorities("READ", "WRITE")
+            .roles("ADMIN")
+            .and()
+            .withUser("Tom")
+            .password(passwordEncoder().encode("password"))
+            .authorities("READ")
+            .roles("USER");
+    }
+
+    @Bean
+    public PasswordEncoder passwordEncoder() {
+        return new BCryptPasswordEncoder();
+    }
+
+}

apache-shiro/src/main/java/com/baeldung/comparison/springsecurity/web/SpringController.java

@@ -0,0 +1,79 @@
+package com.baeldung.comparison.springsecurity.web;
+
+import java.util.Collection;
+
+import javax.servlet.http.HttpServletRequest;
+
+import org.springframework.security.authentication.AnonymousAuthenticationToken;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.GrantedAuthority;
+import org.springframework.security.core.context.SecurityContextHolder;
+import org.springframework.security.core.userdetails.User;
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+@Controller
+public class SpringController {
+
+    @GetMapping("/")
+    public String getIndex() {
+        return "comparison/index";
+    }
+
+    @GetMapping("/login")
+    public String showLoginPage() {
+        return "comparison/login";
+    }
+
+    @RequestMapping("/login-error")
+    public String loginError(Model model) {
+        model.addAttribute("error", "Invalid Credentials");
+        return "comparison/login";
+    }
+
+    @PostMapping("/login")
+    public String doLogin(HttpServletRequest req) {
+        return "redirect:/home";
+    }
+
+    @GetMapping("/home")
+    public String showHomePage(HttpServletRequest req, Model model) {
+        addUserAttributes(model);
+        return "comparison/home";
+    }
+
+    @GetMapping("/admin")
+    public String adminOnly(HttpServletRequest req, Model model) {
+        addUserAttributes(model);
+        model.addAttribute("adminContent", "only admin can view this");
+        return "comparison/home";
+    }
+
+    private void addUserAttributes(Model model) {
+        Authentication auth = SecurityContextHolder.getContext()
+            .getAuthentication();
+        if (auth != null && !auth.getClass()
+            .equals(AnonymousAuthenticationToken.class)) {
+            User user = (User) auth.getPrincipal();
+            model.addAttribute("username", user.getUsername());
+
+            Collection<GrantedAuthority> authorities = user.getAuthorities();
+
+            for (GrantedAuthority authority : authorities) {
+                if (authority.getAuthority()
+                    .contains("USER")) {
+                    model.addAttribute("role", "USER");
+                    model.addAttribute("permission", "READ");
+                } else if (authority.getAuthority()
+                    .contains("ADMIN")) {
+                    model.addAttribute("role", "ADMIN");
+                    model.addAttribute("permission", "READ WRITE");
+                }
+            }
+        }
+    }
+
+}

apache-shiro/src/main/java/com/baeldung/intro/Main.java

@@ -1,4 +1,4 @@
-package com.baeldung;
+package com.baeldung.intro;
 
 import org.apache.shiro.SecurityUtils;
 import org.apache.shiro.authc.AuthenticationException;

apache-shiro/src/main/java/com/baeldung/intro/MyCustomRealm.java

@@ -1,4 +1,4 @@
-package com.baeldung;
+package com.baeldung.intro;
 
 import java.sql.Connection;
 import java.sql.SQLException;

apache-shiro/src/main/java/com/baeldung/intro/ShiroSpringApplication.java

@@ -1,4 +1,4 @@
-package com.baeldung;
+package com.baeldung.intro;
 
 import org.apache.shiro.realm.Realm;
 import org.apache.shiro.spring.web.config.DefaultShiroFilterChainDefinition;
@@ -7,12 +7,13 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.autoconfigure.security.servlet.SecurityAutoConfiguration;
 import org.springframework.context.annotation.Bean;
 
 /**
  * Created by smatt on 21/08/2017.
  */
-@SpringBootApplication
+@SpringBootApplication(exclude = SecurityAutoConfiguration.class)
 public class ShiroSpringApplication {
 
     private static final transient Logger log = LoggerFactory.getLogger(ShiroSpringApplication.class);
@@ -29,7 +30,7 @@ public class ShiroSpringApplication {
 
 
     @Bean
-    public ShiroFilterChainDefinition shiroFilterChainDefinition() {
+    public ShiroFilterChainDefinition filterChainDefinition() {
         DefaultShiroFilterChainDefinition filter
           = new DefaultShiroFilterChainDefinition();
 

apache-shiro/src/main/java/com/baeldung/intro/controllers/ShiroSpringController.java

@@ -1,6 +1,5 @@
-package com.baeldung.controllers;
+package com.baeldung.intro.controllers;
 
-import com.baeldung.models.UserCredentials;
 import org.apache.shiro.SecurityUtils;
 import org.apache.shiro.authc.AuthenticationException;
 import org.apache.shiro.authc.UsernamePasswordToken;
@@ -13,6 +12,8 @@ import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestMethod;
 import org.springframework.web.servlet.mvc.support.RedirectAttributes;
 
+import com.baeldung.intro.models.UserCredentials;
+
 import javax.servlet.http.HttpServletRequest;
 
 @Controller

apache-shiro/src/main/java/com/baeldung/intro/models/UserCredentials.java

@@ -1,4 +1,4 @@
-package com.baeldung.models;
+package com.baeldung.intro.models;
 
 public class UserCredentials {
 

apache-shiro/src/main/java/com/baeldung/permissions/custom/Main.java

@@ -1,4 +1,4 @@
-package com.baeldung.shiro.permissions.custom;
+package com.baeldung.permissions.custom;
 
 import org.apache.shiro.SecurityUtils;
 import org.apache.shiro.authc.AuthenticationException;

apache-shiro/src/main/java/com/baeldung/permissions/custom/PathPermission.java

@@ -1,4 +1,4 @@
-package com.baeldung.shiro.permissions.custom;
+package com.baeldung.permissions.custom;
 
 import org.apache.shiro.authz.Permission;
 

apache-shiro/src/main/java/com/baeldung/permissions/custom/PathPermissionResolver.java

@@ -1,4 +1,4 @@
-package com.baeldung.shiro.permissions.custom;
+package com.baeldung.permissions.custom;
 
 import org.apache.shiro.authz.Permission;
 import org.apache.shiro.authz.permission.PermissionResolver;

apache-shiro/src/main/resources/templates/comparison/home.ftl

@@ -0,0 +1,19 @@
+<html>
+<head>
+    <title>Home Page</title>
+</head>
+<body style="margin-left: 30px;">
+<h1>Welcome ${username}!</h1>
+<p><strong>Role</strong>: ${role}</p>
+<p><strong>Permissions</strong></p>
+<p>${permission}</p>
+<a href="/admin">Admin only</a>
+<#if adminContent??>
+  ${adminContent}
+</#if>
+<br>
+<form role="form" action="/logout" method="POST">
+   <input type="Submit" value="Logout" />
+</form>
+</body>
+</html>

apache-shiro/src/main/resources/templates/comparison/index.ftl

@@ -0,0 +1,10 @@
+<html>
+<head>
+    <title>Index</title>
+</head>
+<body>
+    <h1>Welcome Guest!</h1>
+    <br>
+    Go to the <a href="/home">secured page
+</body>
+</html>

apache-shiro/src/main/resources/templates/comparison/login.ftl

@@ -0,0 +1,25 @@
+<html>
+<head>
+    <title>Login</title>
+</head>
+<body style="margin-left: 30px;">
+<h3>Login</h3>
+<br>
+<form action="/login" method="post">
+    <#if (error?length > 0)??>
+        <p style="color:darkred;">${error}</p>
+    <#else>
+    </#if>
+
+    <label for="username">Username</label>
+    <br>
+    <input type="text" name="username">
+    <br><br>
+    <label for="password">Password</label>
+    <br>
+    <input type="password" name="password">
+    <br><br>
+    <input type="submit" value="Submit">
+</form>
+</body>
+</html>

apache-shiro/src/test/java/com/baeldung/comparison/shiro/SpringContextTest.java

@@ -0,0 +1,20 @@
+package com.baeldung.comparison.shiro;
+
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.junit.jupiter.SpringExtension;
+
+import com.baeldung.comparison.shiro.ShiroApplication;
+
+@ExtendWith(SpringExtension.class)
+@SpringBootTest(classes = { ShiroApplication.class })
+public class SpringContextTest {
+
+    @Test
+    public void whenSpringContextIsBootstrapped_thenNoExceptions() {
+
+    }
+
+}

apache-shiro/src/test/java/com/baeldung/comparison/springsecurity/SpringContextTest.java

@@ -0,0 +1,19 @@
+package com.baeldung.comparison.springsecurity;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.junit.jupiter.SpringExtension;
+
+import com.baeldung.comparison.springsecurity.Application;
+
+@ExtendWith(SpringExtension.class)
+@SpringBootTest(classes = { Application.class })
+public class SpringContextTest {
+
+    @Test
+    public void whenSpringContextIsBootstrapped_thenNoExceptions() {
+
+    }
+
+}

aws-app-sync/pom.xml

@@ -46,7 +46,4 @@
         </plugins>
     </build>
 
-    <properties>
-        <java.version>1.8</java.version>
-    </properties>
 </project>

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

@@ -27,6 +27,11 @@
             <version>${assertj.version}</version>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-lang3</artifactId>
+            <version>3.10</version>
+        </dependency>
     </dependencies>
 
     <properties>

core-java-modules/core-java-collections-3/src/main/java/com/baeldung/collections/convertarrayprimitives/ConvertPrimitivesArrayToList.java

@@ -0,0 +1,47 @@
+package com.baeldung.collections.iterators;
+
+import java.util.List;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.stream.Collectors;
+import java.util.stream.IntStream;
+import com.google.common.primitives.Ints;
+import org.apache.commons.lang3.ArrayUtils;
+
+public class ConvertPrimitivesArrayToList {
+
+    public static void failConvert() {
+        int[] input = new int[]{1,2,3,4};
+        // List<Integer> inputAsList = Arrays.asList(input);
+    }
+
+    public static List<Integer> iterateConvert(int[] input) {
+        List<Integer> output = new ArrayList<Integer>();
+        for (int value : input) {
+            output.add(value);
+        }
+        return output;
+    }
+
+    public static List<Integer> streamConvert(int[] input) {
+        List<Integer> output = Arrays.stream(input).boxed().collect(Collectors.toList());
+        return output;
+    }
+
+    public static List<Integer> streamConvertIntStream(int[] input) {
+        List<Integer> output = IntStream.of(input).boxed().collect(Collectors.toList());
+        return output;
+    }
+
+    public static List<Integer> guavaConvert(int[] input) {
+        List<Integer> output = Ints.asList(input);
+        return output;
+    }
+
+    public static List<Integer> apacheCommonConvert(int[] input) {
+        Integer[] outputBoxed = ArrayUtils.toObject(input);
+        List<Integer> output = Arrays.asList(outputBoxed);
+        return output;
+    }
+
+}

core-java-modules/core-java-collections-3/src/test/java/com/baeldung/collections/convertarrayprimitives/ConvertPrimitivesArrayToListUnitTest.java

@@ -0,0 +1,38 @@
+package com.baeldung.collections.iterators;
+
+import java.util.List;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.stream.Collectors;
+import com.google.common.primitives.Ints;
+import org.junit.Test;
+
+import static org.junit.Assert.assertEquals;
+
+public class ConvertPrimitivesArrayToListUnitTest {
+
+    @Test
+    public void givenArrayWithPrimitives_whenIterativeConvert_thenArrayGetsConverted() {
+        assertEquals(Arrays.asList(1,2,3,4), ConvertPrimitivesArrayToList.iterateConvert(new int[]{1,2,3,4}));
+    }
+
+    @Test
+    public void givenArrayWithPrimitives_whenStreamConvert_thenArrayGetsConverted() {
+        assertEquals(Arrays.asList(1,2,3,4), ConvertPrimitivesArrayToList.streamConvert(new int[]{1,2,3,4}));
+    }
+
+    @Test
+    public void givenArrayWithPrimitives_whenIntStreamConvert_thenArrayGetsConverted() {
+        assertEquals(Arrays.asList(1,2,3,4), ConvertPrimitivesArrayToList.streamConvertIntStream(new int[]{1,2,3,4}));
+    }
+
+    @Test
+    public void givenArrayWithPrimitives_whenGuavaConvert_thenArrayGetsConverted() {
+        assertEquals(Arrays.asList(1,2,3,4), ConvertPrimitivesArrayToList.guavaConvert(new int[]{1,2,3,4}));
+    }
+
+    @Test
+    public void givenArrayWithPrimitives_whenApacheCommonConvert_thenArrayGetsConverted() {
+        assertEquals(Arrays.asList(1,2,3,4), ConvertPrimitivesArrayToList.apacheCommonConvert(new int[]{1,2,3,4}));
+    }
+}

core-java-modules/core-java-concurrency-basic-2/src/main/java/com/baeldung/concurrent/localvariables/LocalAndLambda.java

@@ -0,0 +1,10 @@
+package com.baeldung.concurrent.localvariables;
+
+public class LocalAndLambda {
+    public static void main(String... args) {
+        String text = "";
+        // Un-commenting the next line will break compilation, because text is no longer effectively final
+        // text = "675";
+        new Thread(() -> System.out.println(text)).start();
+    }
+}

core-java-modules/core-java-concurrency-basic-2/src/main/java/com/baeldung/concurrent/localvariables/LocalVariables.java

@@ -0,0 +1,20 @@
+package com.baeldung.concurrent.localvariables;
+
+import java.security.SecureRandom;
+
+public class LocalVariables implements Runnable {
+    private int field;
+
+    public static void main(String... args) {
+        LocalVariables target = new LocalVariables();
+        new Thread(target).start();
+        new Thread(target).start();
+    }
+
+    @Override
+    public void run() {
+        field = new SecureRandom().nextInt();
+        int local = new SecureRandom().nextInt();
+        System.out.println(field + " - " + local);
+    }
+}

core-java-modules/core-java-concurrency-collections-2/README.md

@@ -1,3 +1,5 @@
 ### Relevant Articles:
 
 - [Introduction to Lock Striping](https://www.baeldung.com/java-lock-stripping)
+- [Guide to the Java TransferQueue](http://www.baeldung.com/java-transfer-queue)
+- [[<-- Prev]](/core-java-modules/core-java-concurrency-collections)

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

@@ -3,9 +3,16 @@
     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.concurrent.lock</groupId>
     <artifactId>core-java-concurrency-collections-2</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <name>core-java-concurrency-collections-2</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>
         <dependency>
@@ -30,19 +37,6 @@
             <scope>test</scope>
         </dependency>
     </dependencies>
-    <build>
-        <sourceDirectory>src</sourceDirectory>
-        <plugins>
-            <plugin>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.8.0</version>
-                <configuration>
-                    <source>1.8</source>
-                    <target>1.8</target>
-                </configuration>
-            </plugin>
-        </plugins>
-    </build>
 
     <properties>
         <jmh.version>1.21</jmh.version>

core-java-modules/core-java-concurrency-collections-2/src/test/java/com/baeldung/concurrent/queue/ConcurrentLinkedQueueUnitTest.java

@@ -19,7 +19,7 @@ import org.junit.FixMethodOrder;
 import org.junit.Test;
 
 @FixMethodOrder
-public class TestConcurrentLinkedQueue {
+public class ConcurrentLinkedQueueUnitTest {
 
     @Test
     public void givenThereIsExistingCollection_WhenAddedIntoQueue_ThenShouldContainElements() {

core-java-modules/core-java-concurrency-collections-2/src/test/java/com/baeldung/concurrent/queue/LinkedBlockingQueueUnitTest.java

@@ -18,7 +18,7 @@ import org.junit.FixMethodOrder;
 import org.junit.Test;
 
 @FixMethodOrder
-public class TestLinkedBlockingQueue {
+public class LinkedBlockingQueueUnitTest {
 
     @Test
     public void givenThereIsExistingCollection_WhenAddedIntoQueue_ThenShouldContainElements() {

core-java-modules/core-java-concurrency-collections-2/src/test/java/com/baeldung/transferqueue/TransferQueueIntegrationTest.java

@@ -4,7 +4,11 @@ import org.junit.FixMethodOrder;
 import org.junit.Test;
 import org.junit.runners.MethodSorters;
 
-import java.util.concurrent.*;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.LinkedTransferQueue;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.TransferQueue;
 
 import static junit.framework.TestCase.assertEquals;
 

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

@@ -10,7 +10,7 @@ This module contains articles about concurrent Java collections
 - [Custom Thread Pools In Java 8 Parallel Streams](http://www.baeldung.com/java-8-parallel-streams-custom-threadpool)
 - [Guide to DelayQueue](http://www.baeldung.com/java-delay-queue)
 - [A Guide to Java SynchronousQueue](http://www.baeldung.com/java-synchronous-queue)
-- [Guide to the Java TransferQueue](http://www.baeldung.com/java-transfer-queue)
 - [Guide to the ConcurrentSkipListMap](http://www.baeldung.com/java-concurrent-skip-list-map)
 - [Guide to CopyOnWriteArrayList](http://www.baeldung.com/java-copy-on-write-arraylist)
 - [LinkedBlockingQueue vs ConcurrentLinkedQueue](https://www.baeldung.com/java-queue-linkedblocking-concurrentlinked)
+- [[Next -->]](/core-java-modules/core-java-concurrency-collections-2)

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

@@ -33,7 +33,6 @@
     <url>http://maven.apache.org</url>
 
     <properties>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <commons.lang3.version>3.10</commons.lang3.version>
         <!-- testing -->
         <assertj-core.version>3.10.0</assertj-core.version>

core-java-modules/core-java-io-conversions-2/README.md

@@ -6,4 +6,6 @@ This module contains articles about core Java input/output(IO) conversions.
 - [Java InputStream to String](https://www.baeldung.com/convert-input-stream-to-string)
 - [Java – Write an InputStream to a File](https://www.baeldung.com/convert-input-stream-to-a-file)
 - [Converting a BufferedReader to a JSONObject](https://www.baeldung.com/java-bufferedreader-to-jsonobject)
+- [Reading a CSV File into an Array](https://www.baeldung.com/java-csv-file-array)
+- [How to Write to a CSV File in Java](https://www.baeldung.com/java-csv)
 - More articles: [[<-- prev]](/core-java-modules/core-java-io-conversions)

core-java-modules/core-java-io-conversions-2/pom.xml

@@ -26,6 +26,12 @@
             <artifactId>json</artifactId>
             <version>${json.version}</version>
         </dependency>
+        <dependency>
+            <groupId>com.opencsv</groupId>
+            <artifactId>opencsv</artifactId>
+            <version>${opencsv.version}</version>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 
     <build>
@@ -40,6 +46,7 @@
 
     <properties>
         <json.version>20200518</json.version>
+        <opencsv.version>4.1</opencsv.version>
     </properties>
 
 </project>

core-java-modules/core-java-io-conversions-2/src/test/java/com/baeldung/csv/ReadCSVInArrayUnitTest.java

@@ -1,20 +1,11 @@
 package com.baeldung.csv;
 
-import java.io.BufferedReader;
-import java.io.File;
-import java.io.FileNotFoundException;
-import java.io.FileReader;
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.Collections;
-import java.util.List;
-import java.util.Scanner;
-
+import com.opencsv.CSVReader;
 import org.junit.Assert;
 import org.junit.Test;
 
-import com.opencsv.CSVReader;
+import java.io.*;
+import java.util.*;
 
 public class ReadCSVInArrayUnitTest {
     public static final String COMMA_DELIMITER = ",";

core-java-modules/core-java-io-conversions-2/src/test/java/com/baeldung/csv/WriteCsvFileExampleUnitTest.java

@@ -1,7 +1,9 @@
 package com.baeldung.csv;
 
-import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertTrue;
+import org.junit.Before;
+import org.junit.Test;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 import java.io.File;
 import java.io.FileNotFoundException;
@@ -10,10 +12,8 @@ import java.io.PrintWriter;
 import java.util.ArrayList;
 import java.util.List;
 
-import org.junit.Before;
-import org.junit.Test;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
 
 public class WriteCsvFileExampleUnitTest {
     private static final Logger LOG = LoggerFactory.getLogger(WriteCsvFileExampleUnitTest.class);

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

@@ -8,10 +8,9 @@ This module contains articles about core Java input and output (IO)
 - [Java – Directory Size](https://www.baeldung.com/java-folder-size)
 - [File Size in Java](https://www.baeldung.com/java-file-size)
 - [Zipping and Unzipping in Java](https://www.baeldung.com/java-compress-and-uncompress)
-- [Reading a CSV File into an Array](https://www.baeldung.com/java-csv-file-array)
 - [How to Get the File Extension of a File in Java](https://www.baeldung.com/java-file-extension)
 - [Getting a File’s Mime Type in Java](https://www.baeldung.com/java-file-mime-type)
-- [How to Write to a CSV File in Java](https://www.baeldung.com/java-csv)
 - [How to Avoid the Java FileNotFoundException When Loading Resources](https://www.baeldung.com/java-classpath-resource-cannot-be-opened)
 - [Create a Directory in Java](https://www.baeldung.com/java-create-directory)
+- [Java – Rename or Move a File](https://www.baeldung.com/java-how-to-rename-or-move-a-file)
 - [[More -->]](/core-java-modules/core-java-io-2)

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

@@ -29,12 +29,6 @@
             <version>${hsqldb.version}</version>
             <scope>runtime</scope>
         </dependency>
-        <dependency>
-            <groupId>com.opencsv</groupId>
-            <artifactId>opencsv</artifactId>
-            <version>${opencsv.version}</version>
-            <scope>test</scope>
-        </dependency>
         <!-- Mime Type Resolution Libraries -->
         <dependency>
             <groupId>org.apache.tika</groupId>
@@ -142,8 +136,6 @@
     </profiles>
 
     <properties>
-        <!-- util -->
-        <opencsv.version>4.1</opencsv.version>
         <!-- testing -->
         <assertj.version>3.6.1</assertj.version>
         <!-- maven plugins -->

core-java-modules/core-java-io/src/test/java/com/baeldung/rename/RenameFileUnitTest.java

@@ -0,0 +1,64 @@
+package com.baeldung.rename;
+
+import org.apache.commons.io.FileUtils;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.FileSystemException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+
+public class RenameFileUnitTest {
+
+    private final String FILE_TO_MOVE = "src/test/resources/originalFileToMove.txt";
+    private final String TARGET_FILE = "src/test/resources/targetFileToMove.txt";
+
+    @BeforeEach
+    public void createFileToMove() throws IOException {
+        File fileToMove = new File(FILE_TO_MOVE);
+        fileToMove.createNewFile();
+    }
+
+    @AfterEach
+    public void cleanUpFiles() {
+        File targetFile = new File(TARGET_FILE);
+        targetFile.delete();
+    }
+
+    @Test
+    public void givenUsingNio_whenMovingFile_thenCorrect() throws IOException {
+        Path fileToMovePath = Paths.get(FILE_TO_MOVE);
+        Path targetPath = Paths.get(TARGET_FILE);
+        Files.move(fileToMovePath, targetPath);
+    }
+
+    @Test
+    public void givenUsingFileClass_whenMovingFile_thenCorrect() throws IOException {
+        File fileToMove = new File(FILE_TO_MOVE);
+        boolean isMoved = fileToMove.renameTo(new File(TARGET_FILE));
+        if (!isMoved) {
+            throw new FileSystemException(TARGET_FILE);
+        }
+    }
+
+    @Test
+    public void givenUsingGuava_whenMovingFile_thenCorrect()
+            throws IOException {
+        File fileToMove = new File(FILE_TO_MOVE);
+        File targetFile = new File(TARGET_FILE);
+
+        com.google.common.io.Files.move(fileToMove, targetFile);
+    }
+
+    @Test
+    public void givenUsingApache_whenMovingFile_thenCorrect() throws IOException {
+        FileUtils.moveFile(
+                FileUtils.getFile(FILE_TO_MOVE),
+                FileUtils.getFile(TARGET_FILE));
+    }
+
+}

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

@@ -3,3 +3,9 @@
 This module contains articles about working with the Java Virtual Machine (JVM).
 
 ### Relevant Articles: 
+
+- [Memory Layout of Objects in Java](https://www.baeldung.com/java-memory-layout)
+- [Measuring Object Sizes in the JVM](https://www.baeldung.com/jvm-measuring-object-sizes)
+- [Adding Shutdown Hooks for JVM Applications](https://www.baeldung.com/jvm-shutdown-hooks)
+- [boolean and boolean[] Memory Layout in the JVM](https://www.baeldung.com/jvm-boolean-memory-layout)
+- More articles: [[<-- prev]](/core-java-modules/core-java-jvm)

core-java-modules/core-java-jvm-2/src/test/java/com/baeldung/memaddress/MemoryAddressUnitTest.java

@@ -0,0 +1,24 @@
+package com.baeldung.memaddress;
+
+import org.junit.Test;
+import org.openjdk.jol.vm.VM;
+
+public class MemoryAddressUnitTest {
+
+    @Test
+    public void printTheMemoryAddress() {
+        String answer = "42";
+
+        System.out.println("The memory address is " + VM.current().addressOf(answer));
+    }
+
+    @Test
+    public void identityHashCodeAndMemoryAddress() {
+        Object obj = new Object();
+
+        System.out.println("Memory address: " + VM.current().addressOf(obj));
+        System.out.println("hashCode: " + obj.hashCode());
+        System.out.println("hashCode: " + System.identityHashCode(obj));
+        System.out.println("toString: " + obj);
+    }
+}

core-java-modules/core-java-jvm-2/src/test/java/com/baeldung/objectsize/Course.java

@@ -0,0 +1,10 @@
+package com.baeldung.objectsize;
+
+public class Course {
+
+    private String name;
+
+    public Course(String name) {
+        this.name = name;
+    }
+}

core-java-modules/core-java-jvm-2/src/test/java/com/baeldung/objectsize/InstrumentedSize.java

@@ -0,0 +1,11 @@
+package com.baeldung.objectsize;
+
+public class InstrumentedSize {
+
+    public static void main(String[] args) {
+        String ds = "Data Structures";
+        Course course = new Course(ds);
+
+        System.out.println(ObjectSizeCalculator.sizeOf(course));
+    }
+}

core-java-modules/core-java-jvm-2/src/test/java/com/baeldung/objectsize/MANIFEST.MF

@@ -0,0 +1 @@
+Premain-Class: com.baeldung.objectsize.ObjectSizeCalculator

core-java-modules/core-java-jvm-2/src/test/java/com/baeldung/objectsize/ObjectSizeCalculator.java

@@ -0,0 +1,16 @@
+package com.baeldung.objectsize;
+
+import java.lang.instrument.Instrumentation;
+
+public class ObjectSizeCalculator {
+
+    private static Instrumentation instrumentation;
+
+    public static void premain(String args, Instrumentation inst) {
+        instrumentation = inst;
+    }
+
+    public static long sizeOf(Object o) {
+        return instrumentation.getObjectSize(o);
+    }
+}

core-java-modules/core-java-jvm-2/src/test/java/com/baeldung/objectsize/ObjectSizeUnitTest.java

@@ -0,0 +1,40 @@
+package com.baeldung.objectsize;
+
+import org.junit.Test;
+import org.openjdk.jol.info.ClassLayout;
+import org.openjdk.jol.info.GraphLayout;
+import org.openjdk.jol.vm.VM;
+
+public class ObjectSizeUnitTest {
+
+    @Test
+    public void printingTheVMDetails() {
+        System.out.println(VM.current().details());
+    }
+
+    @Test
+    public void printingTheProfClassLayout() {
+        System.out.println(ClassLayout.parseClass(Professor.class).toPrintable());
+    }
+
+    @Test
+    public void printingTheCourseClassLayout() {
+        System.out.println(ClassLayout.parseClass(Course.class).toPrintable());
+    }
+
+    @Test
+    public void printingACourseInstanceLayout() {
+        String ds = "Data Structures";
+        Course course = new Course(ds);
+
+        System.out.println("The shallow size is :" + VM.current().sizeOf(course));
+
+        System.out.println(ClassLayout.parseInstance(course).toPrintable());
+        System.out.println(ClassLayout.parseInstance(ds).toPrintable());
+        System.out.println(ClassLayout.parseInstance(ds.toCharArray()).toPrintable());
+
+        System.out.println(GraphLayout.parseInstance(course).totalSize());
+        System.out.println(GraphLayout.parseInstance(course).toFootprint());
+        System.out.println(GraphLayout.parseInstance(course).toPrintable());
+    }
+}

core-java-modules/core-java-jvm-2/src/test/java/com/baeldung/objectsize/Professor.java

@@ -0,0 +1,24 @@
+package com.baeldung.objectsize;
+
+import java.time.LocalDate;
+import java.util.List;
+
+public class Professor {
+
+    private String name;
+    private boolean tenured;
+    private List<Course> courses;
+    private int level;
+    private LocalDate birthDay;
+    private double lastEvaluation;
+
+    public Professor(String name, boolean tenured, List<Course> courses,
+      int level, LocalDate birthDay, double lastEvaluation) {
+        this.name = name;
+        this.tenured = tenured;
+        this.courses = courses;
+        this.level = level;
+        this.birthDay = birthDay;
+        this.lastEvaluation = lastEvaluation;
+    }
+}

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

@@ -11,8 +11,7 @@ This module contains articles about working with the Java Virtual Machine (JVM).
 - [A Guide to System.exit()](https://www.baeldung.com/java-system-exit)
 - [Guide to System.gc()](https://www.baeldung.com/java-system-gc)
 - [Runtime.getRuntime().halt() vs System.exit() in Java](https://www.baeldung.com/java-runtime-halt-vs-system-exit)
-- [Adding Shutdown Hooks for JVM Applications](https://www.baeldung.com/jvm-shutdown-hooks)
 - [How to Get the Size of an Object in Java](http://www.baeldung.com/java-size-of-object)
 - [What Causes java.lang.OutOfMemoryError: unable to create new native thread](https://www.baeldung.com/java-outofmemoryerror-unable-to-create-new-native-thread)
 - [View Bytecode of a Class File in Java](https://www.baeldung.com/java-class-view-bytecode)
-- [boolean and boolean[] Memory Layout in the JVM](https://www.baeldung.com/jvm-boolean-memory-layout)
+- More articles: [[next -->]](/core-java-modules/core-java-jvm-2)

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

@@ -13,4 +13,4 @@ This module contains articles about core features in the Java language
 - [Comparing Long Values in Java](https://www.baeldung.com/java-compare-long-values)
 - [Comparing Objects in Java](https://www.baeldung.com/java-comparing-objects)
 - [Casting int to Enum in Java](https://www.baeldung.com/java-cast-int-to-enum)
-- [[<-- Prev]](/core-java-modules/core-java-lang)
+[[ <-- Prev]](/core-java-modules/core-java-lang)[[Next --> ]](/core-java-modules/core-java-lang-3)

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

@@ -0,0 +1,5 @@
+## Core Java Lang (Part 3)
+
+This module contains articles about core features in the Java language
+
+- [[<-- Prev]](/core-java-modules/core-java-lang-2)

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

@@ -0,0 +1,42 @@
+<?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>
+    <artifactId>core-java-lang-3</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <name>core-java-lang-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>
+        <dependency>
+            <groupId>org.assertj</groupId>
+            <artifactId>assertj-core</artifactId>
+            <version>${assertj.version}</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <finalName>core-java-lang-3</finalName>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+    </build>
+
+    <properties>
+        <assertj.version>3.12.2</assertj.version>
+    </properties>
+      
+</project>

core-java-modules/core-java-lang-3/src/test/java/com/baeldung/stringtoboolean/StringToBooleanUnitTest.java

@@ -0,0 +1,30 @@
+package com.baeldung.stringtoboolean;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import org.junit.Test;
+
+public class StringToBooleanUnitTest {
+    
+    @Test
+    public void givenStringTrue_whenUsingParseBoolean_thenTrue() {
+        assertThat(Boolean.parseBoolean("true")).isTrue();
+    }
+
+    @Test
+    public void givenStringTrue_whenUsingValueOf_thenTrue() {
+        assertThat(Boolean.valueOf("true")).isTrue();
+    }
+
+    @Test
+    public void givenStringTrue_whenUsingGetBoolean_thenFalse() {
+        assertThat(Boolean.getBoolean("true")).isFalse();
+    }
+
+    @Test
+    public void givenSystemProperty_whenUsingGetBoolean_thenTrue() {
+        System.setProperty("CODING_IS_FUN", "true");
+        
+        assertThat(Boolean.getBoolean("CODING_IS_FUN")).isTrue();
+    }
+}

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

@@ -13,4 +13,5 @@ This module contains articles about core features in the Java language
 - [Retrieving a Class Name in Java](https://www.baeldung.com/java-class-name)
 - [The Java continue and break Keywords](https://www.baeldung.com/java-continue-and-break)
 - [Infinite Loops in Java](https://www.baeldung.com/infinite-loops-java)
-- [[More --> ]](/core-java-modules/core-java-lang-2)
+
+[[Next --> ]](/core-java-modules/core-java-lang-2)

core-java-modules/core-java-reflection-2/pom.xml

@@ -0,0 +1,44 @@
+<?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>
+    <artifactId>core-java-reflection-2</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <name>core-java-reflection-2</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>
+    
+    <build>
+        <finalName>core-java-reflection-2</finalName>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>${maven-compiler-plugin.version}</version>
+                <configuration>
+                    <source>${source.version}</source>
+                    <target>${target.version}</target>
+                    <compilerArgument>-parameters</compilerArgument>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+    <properties>
+        <maven-compiler-plugin.version>3.8.0</maven-compiler-plugin.version>
+        <source.version>1.8</source.version>
+        <target.version>1.8</target.version>
+    </properties>
+</project>

core-java-modules/core-java-reflection-2/src/main/java/com/baeldung/reflection/access/privatefields/Person.java

@@ -0,0 +1,87 @@
+package com.baeldung.reflection.access.privatefields;
+
+public class Person {
+
+    private String name = "John";
+    private byte age = 30;
+    private short uidNumber = 5555;
+    private int pinCode = 452002;
+    private long contactNumber = 123456789L;
+    private float height = 6.1242f;
+    private double weight = 75.2564;
+    private char gender = 'M';
+    private boolean active = true;
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public byte getAge() {
+        return age;
+    }
+
+    public void setAge(byte age) {
+        this.age = age;
+    }
+
+    public short getUidNumber() {
+        return uidNumber;
+    }
+
+    public void setUidNumber(short uidNumber) {
+        this.uidNumber = uidNumber;
+    }
+
+    public int getPinCode() {
+        return pinCode;
+    }
+
+    public void setPinCode(int pinCode) {
+        this.pinCode = pinCode;
+    }
+
+    public long getContactNumber() {
+        return contactNumber;
+    }
+
+    public void setContactNumber(long contactNumber) {
+        this.contactNumber = contactNumber;
+    }
+
+    public float getHeight() {
+        return height;
+    }
+
+    public void setHeight(float height) {
+        this.height = height;
+    }
+
+    public double getWeight() {
+        return weight;
+    }
+
+    public void setWeight(double weight) {
+        this.weight = weight;
+    }
+
+    public char getGender() {
+        return gender;
+    }
+
+    public void setGender(char gender) {
+        this.gender = gender;
+    }
+
+    public boolean isActive() {
+        return active;
+    }
+
+    public void setActive(boolean active) {
+        this.active = active;
+    }
+
+}

core-java-modules/core-java-reflection-2/src/test/java/com/baeldung/reflection/access/privatefields/AccessPrivateFieldsUnitTest.java

@@ -0,0 +1,168 @@
+package com.baeldung.reflection.access.privatefields;
+
+import java.lang.reflect.Field;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+public class AccessPrivateFieldsUnitTest {
+
+    @Test
+    public void whenGetIntegerFields_thenSuccess() throws Exception {
+        Person person = new Person();
+
+        Field ageField = person.getClass()
+            .getDeclaredField("age");
+        ageField.setAccessible(true);
+
+        byte age = ageField.getByte(person);
+        Assertions.assertEquals(30, age);
+
+        Field uidNumberField = person.getClass()
+            .getDeclaredField("uidNumber");
+        uidNumberField.setAccessible(true);
+
+        short uidNumber = uidNumberField.getShort(person);
+        Assertions.assertEquals(5555, uidNumber);
+
+        Field pinCodeField = person.getClass()
+            .getDeclaredField("pinCode");
+        pinCodeField.setAccessible(true);
+
+        int pinCode = pinCodeField.getInt(person);
+        Assertions.assertEquals(452002, pinCode);
+
+        Field contactNumberField = person.getClass()
+            .getDeclaredField("contactNumber");
+        contactNumberField.setAccessible(true);
+
+        long contactNumber = contactNumberField.getLong(person);
+        Assertions.assertEquals(123456789L, contactNumber);
+
+    }
+
+    @Test
+    public void whenDoAutoboxing_thenSuccess() throws Exception {
+        Person person = new Person();
+
+        Field pinCodeField = person.getClass()
+            .getDeclaredField("pinCode");
+        pinCodeField.setAccessible(true);
+
+        Integer pinCode = pinCodeField.getInt(person);
+        Assertions.assertEquals(452002, pinCode);
+    }
+
+    @Test
+    public void whenDoWidening_thenSuccess() throws Exception {
+        Person person = new Person();
+
+        Field pinCodeField = person.getClass()
+            .getDeclaredField("pinCode");
+        pinCodeField.setAccessible(true);
+
+        Long pinCode = pinCodeField.getLong(person);
+        Assertions.assertEquals(452002L, pinCode);
+    }
+
+    @Test
+    public void whenGetFloatingTypeFields_thenSuccess() throws Exception {
+        Person person = new Person();
+
+        Field heightField = person.getClass()
+            .getDeclaredField("height");
+        heightField.setAccessible(true);
+
+        float height = heightField.getFloat(person);
+        Assertions.assertEquals(6.1242f, height);
+
+        Field weightField = person.getClass()
+            .getDeclaredField("weight");
+        weightField.setAccessible(true);
+
+        double weight = weightField.getDouble(person);
+        Assertions.assertEquals(75.2564, weight);
+    }
+
+    @Test
+    public void whenGetCharacterFields_thenSuccess() throws Exception {
+        Person person = new Person();
+
+        Field genderField = person.getClass()
+            .getDeclaredField("gender");
+        genderField.setAccessible(true);
+
+        char gender = genderField.getChar(person);
+        Assertions.assertEquals('M', gender);
+    }
+
+    @Test
+    public void whenGetBooleanFields_thenSuccess() throws Exception {
+        Person person = new Person();
+
+        Field activeField = person.getClass()
+            .getDeclaredField("active");
+        activeField.setAccessible(true);
+
+        boolean active = activeField.getBoolean(person);
+        Assertions.assertTrue(active);
+    }
+
+    @Test
+    public void whenGetObjectFields_thenSuccess() throws Exception {
+        Person person = new Person();
+
+        Field nameField = person.getClass()
+            .getDeclaredField("name");
+        nameField.setAccessible(true);
+
+        String name = (String) nameField.get(person);
+        Assertions.assertEquals("John", name);
+    }
+
+    @Test
+    public void givenInt_whenGetStringField_thenIllegalArgumentException() throws Exception {
+        Person person = new Person();
+        Field nameField = person.getClass()
+            .getDeclaredField("name");
+        nameField.setAccessible(true);
+
+        Assertions.assertThrows(IllegalArgumentException.class, () -> nameField.getInt(person));
+    }
+
+    @Test
+    public void givenInt_whenGetLongField_thenIllegalArgumentException() throws Exception {
+        Person person = new Person();
+        Field contactNumberField = person.getClass()
+            .getDeclaredField("contactNumber");
+        contactNumberField.setAccessible(true);
+
+        Assertions.assertThrows(IllegalArgumentException.class, () -> contactNumberField.getInt(person));
+    }
+
+    @Test
+    public void whenFieldNotSetAccessible_thenIllegalAccessException() throws Exception {
+        Person person = new Person();
+        Field nameField = person.getClass()
+            .getDeclaredField("name");
+
+        Assertions.assertThrows(IllegalAccessException.class, () -> nameField.get(person));
+    }
+
+    @Test
+    public void whenAccessingWrongProperty_thenNoSuchFieldException() throws Exception {
+        Person person = new Person();
+
+        Assertions.assertThrows(NoSuchFieldException.class, () -> person.getClass()
+            .getDeclaredField("firstName"));
+    }
+
+    @Test
+    public void whenAccessingNullProperty_thenNullPointerException() throws Exception {
+        Person person = new Person();
+
+        Assertions.assertThrows(NullPointerException.class, () -> person.getClass()
+            .getDeclaredField(null));
+    }
+
+}

core-java-modules/core-java-security-2/src/main/java/com/baeldung/pem/JavaSecurityPemUtils.java

@@ -0,0 +1,48 @@
+package com.baeldung.pem;
+
+import org.apache.commons.codec.binary.Base64;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.nio.file.Files;
+import java.security.GeneralSecurityException;
+import java.security.KeyFactory;
+import java.security.interfaces.RSAPrivateKey;
+import java.security.interfaces.RSAPublicKey;
+import java.security.spec.PKCS8EncodedKeySpec;
+import java.security.spec.X509EncodedKeySpec;
+
+public class JavaSecurityPemUtils {
+
+    public static RSAPrivateKey readPKCS8PrivateKey(File file) throws GeneralSecurityException, IOException {
+        String key = new String(Files.readAllBytes(file.toPath()), Charset.defaultCharset());
+
+        String privateKeyPEM = key
+                .replace("-----BEGIN PRIVATE KEY-----", "")
+                .replaceAll(System.lineSeparator(), "")
+                .replace("-----END PRIVATE KEY-----", "");
+
+        byte[] encoded = Base64.decodeBase64(privateKeyPEM);
+
+        KeyFactory keyFactory = KeyFactory.getInstance("RSA");
+        PKCS8EncodedKeySpec keySpec = new PKCS8EncodedKeySpec(encoded);
+        return (RSAPrivateKey) keyFactory.generatePrivate(keySpec);
+    }
+
+    public static RSAPublicKey readX509PublicKey(File file) throws GeneralSecurityException, IOException {
+        String key = new String(Files.readAllBytes(file.toPath()), Charset.defaultCharset());
+
+        String publicKeyPEM = key
+                .replace("-----BEGIN PUBLIC KEY-----", "")
+                .replaceAll(System.lineSeparator(), "")
+                .replace("-----END PUBLIC KEY-----", "");
+
+        byte[] encoded = Base64.decodeBase64(publicKeyPEM);
+
+        KeyFactory keyFactory = KeyFactory.getInstance("RSA");
+        X509EncodedKeySpec keySpec = new X509EncodedKeySpec(encoded);
+        return (RSAPublicKey) keyFactory.generatePublic(keySpec);
+    }
+
+}

core-java-modules/core-java-security-2/src/main/resources/pem/private-key-pkcs8.pem

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCyO0YiTxLEP44S
+IGk/b9MlQAXS6nC4oYyTrAfxHCi/zxW/MmtWbY0K2JxOTkVSD5QbmvwkCutXi0k9
+EdDK+orAXg2KSy686O/cfIh/iho6FmNPyEOd7UF+/5wWpknrUaTQyMA2H9Pmr2/E
+RH/tN1Q0cqmhFX41WUo3lsRT81DkVCNVeJx+zDGHpjp+XY8gWpPYJ+MP4WQE9TWJ
+P2rIlgcDfwhG/A21yK0WAJ5nB0Y+jGI8+HVYdjxXGlRUG//YmxS2sH+sAhsapmjE
+Aha+KMk972jVNjdWU7OT0BJnUB5q286Kv6INUnk6kqYufNzjpCAY9SyMjKjpKN71
+3Gka2gZBAgMBAAECggEAFlPam12wiik0EQ1CYhIOL3JvyFZaPKbwR2ebrxbJ/A1j
+OgqE69TZgGxWWHDxui/9a9/kildb2CG40Q+0SllMnICrzZFRj5TWx5ZKOz//vRsk
+4c/CuLwKInC/Cw9V30bhEM61VZJzJ0j/BWVXaU4vHEro+ScKIoDHDWOzwJiQn6m9
+C+Ti5lFpax3hx8ZrgPqmBCFYNvErrWkOr7mCYl0jS+E22c68yn8+LjdlF1LWUa6N
+zutk3MPj5UwEyR0h7EZReCeGkPTMQNyOBhDcmAtlEno4fjtZzUDHRjh8/QpG1Mz/
+alavvrkjswc1DmRUOdgiYu+Waxan5noBhxEAvd/hyQKBgQDjYJD0n+m0tUrpNtX0
++mdzHstClHrpx5oNxs4sIBjCoCwEXaSpeY8+JxCdnZ6n29mLZLq/wPXxZ3EJcOSZ
+PYUvZJfV/IUvoLPFbtT3ILzDTcAAeHj2GAOpzYP8J1JSFsc78ZjKMF1XeNjXcq8T
+XNXoWfY7N/fShoycVeG42JJCFwKBgQDIqvHL0QfJ8r6yM8Efj7Zq6Wa4C9okORes
+8UVWfBoO6UOWvpK+D9IjnaEisJcnEalwNi8/eKudR9hfvmzATV+t3YJIgktto3TT
+BWLsEyniNU4vSTl7GPBrV2xabWogbChlt7TXUfw6YogaBKm43snYXBbJFc+NcpQH
+ONB5igppZwKBgGDyYHvc3wGsttb/CXTde1RLUfD+a/XXpCixlmCcAtKhBoOKBdY4
+vUmL0HrTpLz/cR8NAM8XkAWwzDJxTxbDc1EEu/SCKatoAp5wph8Ed1dyhCXvN+v9
+yzoQJXFStrfHfIVjenji7DmKjjI2dM11rMLX8LPJJkI+Gh/iQk7VEG9bAoGAH/aS
+sztleTZwR6RUw7k5fkgVM4W3xoNNkR+RQthbsjpXqMBMUXflqgSmsQbd3LxEd/o5
+hmurMk9KWN3VJsBsWB5rbS9L4nfh2OcHvcDDsCN7g66vODtduEthl/nLqMRxnton
+NRD7EzW0pihN/IOINS1d98PAnrA8gfX7xxBE3ksCgYBvoljHGjvy3bPJ++vDGKJK
+y6JuEeRVzgdPXEb60uU+BR7kdh+MMsZLmgfFTgza3R+/xeZcC/cuOPsbzeooRQi/
+9NpKwSCXjVNk9nglUWBoPRh4uYqrArWn+HoR7MI/BxeRJm5e1+ii8P19Y9joX5s0
+Q3OLn8GeH56ClJmNiWDhsA==
+-----END PRIVATE KEY-----

core-java-modules/core-java-security-2/src/main/resources/pem/public-key.pem

@@ -0,0 +1,9 @@
+-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsjtGIk8SxD+OEiBpP2/T
+JUAF0upwuKGMk6wH8Rwov88VvzJrVm2NCticTk5FUg+UG5r8JArrV4tJPRHQyvqK
+wF4NiksuvOjv3HyIf4oaOhZjT8hDne1Bfv+cFqZJ61Gk0MjANh/T5q9vxER/7TdU
+NHKpoRV+NVlKN5bEU/NQ5FQjVXicfswxh6Y6fl2PIFqT2CfjD+FkBPU1iT9qyJYH
+A38IRvwNtcitFgCeZwdGPoxiPPh1WHY8VxpUVBv/2JsUtrB/rAIbGqZoxAIWvijJ
+Pe9o1TY3VlOzk9ASZ1AeatvOir+iDVJ5OpKmLnzc46QgGPUsjIyo6Sje9dxpGtoG
+QQIDAQAB
+-----END PUBLIC KEY-----

core-java-modules/core-java-security-2/src/test/java/com/baeldung/pem/JavaSecurityPemUtilsUnitTest.java

@@ -0,0 +1,33 @@
+package com.baeldung.pem;
+
+
+import org.junit.jupiter.api.Test;
+
+import java.io.File;
+import java.security.interfaces.RSAPrivateKey;
+import java.security.interfaces.RSAPublicKey;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+public class JavaSecurityPemUtilsUnitTest {
+
+    @Test
+    public void whenReadPublicKeyFromPEMFile_thenSuccess() throws Exception {
+        File pemFile = new File(JavaSecurityPemUtilsUnitTest.class.getResource("/pem/public-key.pem").getFile());
+
+        RSAPublicKey publicKey = JavaSecurityPemUtils.readX509PublicKey(pemFile);
+
+        assertEquals("X.509", publicKey.getFormat());
+        assertEquals("RSA", publicKey.getAlgorithm());
+    }
+
+    @Test
+    public void whenReadPrivateKeyFromPEMFile_thenSuccess() throws Exception {
+        File pemFile = new File(JavaSecurityPemUtilsUnitTest.class.getResource("/pem/private-key-pkcs8.pem").getFile());
+
+        RSAPrivateKey privateKey = JavaSecurityPemUtils.readPKCS8PrivateKey(pemFile);
+
+        assertEquals("PKCS#8", privateKey.getFormat());
+        assertEquals("RSA", privateKey.getAlgorithm());
+    }
+}

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

@@ -9,7 +9,6 @@ This module contains articles about the Stream API in Java.
 - [Iterable to Stream in Java](https://www.baeldung.com/java-iterable-to-stream)
 - [How to Iterate Over a Stream With Indices](https://www.baeldung.com/java-stream-indices)
 - [Stream Ordering in Java](https://www.baeldung.com/java-stream-ordering)
-- [Introduction to Protonpack](https://www.baeldung.com/java-protonpack)
 - [Java Stream Filter with Lambda Expression](https://www.baeldung.com/java-stream-filter-lambda)
 - [Counting Matches on a Stream Filter](https://www.baeldung.com/java-stream-filter-count)
 - [Summing Numbers with Java Streams](https://www.baeldung.com/java-stream-sum)

core-java-modules/core-java-string-operations-2/README.md

@@ -10,7 +10,6 @@ This module contains articles about string operations.
 - [Java String equalsIgnoreCase()](https://www.baeldung.com/java-string-equalsignorecase)
 - [Case-Insensitive String Matching in Java](https://www.baeldung.com/java-case-insensitive-string-matching)
 - [L-Trim and R-Trim Alternatives in Java](https://www.baeldung.com/java-trim-alternatives)
-- [Java Convert PDF to Base64](https://www.baeldung.com/java-convert-pdf-to-base64)
 - [Encode a String to UTF-8 in Java](https://www.baeldung.com/java-string-encode-utf-8)
 - [Guide to Character Encoding](https://www.baeldung.com/java-char-encoding)
 - [Convert Hex to ASCII in Java](https://www.baeldung.com/java-convert-hex-to-ascii) #remove additional readme file

core-java-modules/core-java-string-operations-3/pom.xml

@@ -0,0 +1,61 @@
+<?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>
+    <artifactId>core-java-string-operations-3</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <name>core-java-string-operations-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>
+        <dependency>
+            <groupId>org.assertj</groupId>
+            <artifactId>assertj-core</artifactId>
+            <version>${assertj.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.maven</groupId>
+            <artifactId>maven-artifact</artifactId>
+            <version>${maven-artifact.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.gradle</groupId>
+            <artifactId>gradle-core</artifactId>
+            <version>${gradle-core.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-core</artifactId>
+            <version>${jackson-core.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.vdurmont</groupId>
+            <artifactId>semver4j</artifactId>
+            <version>${semver4j.version}</version>
+        </dependency>
+    </dependencies>
+
+    <properties>
+        <assertj.version>3.6.1</assertj.version>
+        <maven-artifact.version>3.6.3</maven-artifact.version>
+        <gradle-core.version>6.1.1</gradle-core.version>
+        <jackson-core.version>2.11.1</jackson-core.version>
+        <semver4j.version>3.1.0</semver4j.version>
+    </properties>
+
+	<repositories>
+	      <repository>
+	          <id>gradle-repo</id>
+	          <url>https://repo.gradle.org/gradle/libs-releases-local/</url>
+	      </repository>
+	</repositories>
+</project>

core-java-modules/core-java-string-operations-3/src/main/java/com/baeldung/versioncomparison/VersionCompare.java

@@ -0,0 +1,25 @@
+package com.baeldung.versioncomparison;
+
+public class VersionCompare {
+
+    public static int compareVersions(String version1, String version2) {
+        int comparisonResult = 0;
+        
+        String[] version1Splits = version1.split("\\.");
+        String[] version2Splits = version2.split("\\.");
+
+        int maxLengthOfVersionSplits = Math.max(version1Splits.length, version2Splits.length);
+        for (int i = 0; i < maxLengthOfVersionSplits; i++){
+            Integer v1 = i < version1Splits.length ? Integer.parseInt(version1Splits[i]) : 0;
+            Integer v2 = i < version2Splits.length ? Integer.parseInt(version2Splits[i]) : 0;
+            int compare = v1.compareTo(v2);
+            if (compare != 0) {
+                comparisonResult = compare;
+                break;
+            }
+        }
+
+        return comparisonResult;
+    }
+
+}

core-java-modules/core-java-string-operations-3/src/test/java/com/baeldung/versioncomparison/VersionComparisonUnitTest.java

@@ -0,0 +1,136 @@
+package com.baeldung.versioncomparison;
+
+import org.junit.Test;
+
+import com.fasterxml.jackson.core.Version;
+import com.vdurmont.semver4j.Semver;
+import com.vdurmont.semver4j.Semver.VersionDiff;
+
+import org.apache.maven.artifact.versioning.ComparableVersion;
+import org.gradle.util.VersionNumber;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class VersionComparisonUnitTest {
+    
+    @Test
+    public void givenVersionStrings_whenUsingMavenArtifact_thenCompareVersions() {
+        ComparableVersion version1_1 = new ComparableVersion("1.1");
+        ComparableVersion version1_2 = new ComparableVersion("1.2");
+        ComparableVersion version1_3 = new ComparableVersion("1.3");
+
+        assertTrue(version1_1.compareTo(version1_2) < 0);
+        assertTrue(version1_3.compareTo(version1_2) > 0);
+        
+        ComparableVersion version1_1_0 = new ComparableVersion("1.1.0"); 
+        assertEquals(0, version1_1.compareTo(version1_1_0));
+
+        ComparableVersion version1_1_alpha = new ComparableVersion("1.1-alpha");
+        assertTrue(version1_1.compareTo(version1_1_alpha) > 0);
+        
+        ComparableVersion version1_1_beta = new ComparableVersion("1.1-beta");
+        ComparableVersion version1_1_milestone = new ComparableVersion("1.1-milestone");
+        ComparableVersion version1_1_rc = new ComparableVersion("1.1-rc");
+        ComparableVersion version1_1_snapshot = new ComparableVersion("1.1-snapshot");
+        
+        assertTrue(version1_1_alpha.compareTo(version1_1_beta) < 0);
+        assertTrue(version1_1_beta.compareTo(version1_1_milestone) < 0);
+        assertTrue(version1_1_rc.compareTo(version1_1_snapshot) < 0);
+        assertTrue(version1_1_snapshot.compareTo(version1_1) < 0);        
+        
+        ComparableVersion version1_1_c = new ComparableVersion("1.1-c");
+        ComparableVersion version1_1_z = new ComparableVersion("1.1-z");
+        ComparableVersion version1_1_1 = new ComparableVersion("1.1.1");
+        
+        assertTrue(version1_1_c.compareTo(version1_1_z) < 0);
+        assertTrue(version1_1_z.compareTo(version1_1_1) < 0);
+    }
+    
+    @Test
+    public void givenVersionStrings_whenUsingGradle_thenCompareVersions() {
+        VersionNumber version1_1 = VersionNumber.parse("1.1");
+        VersionNumber version1_2 = VersionNumber.parse("1.2");
+        VersionNumber version1_3 = VersionNumber.parse("1.3");
+
+        assertTrue(version1_1.compareTo(version1_2) < 0);
+        assertTrue(version1_3.compareTo(version1_2) > 0);
+        
+        VersionNumber version1_1_0 = VersionNumber.parse("1.1.0");
+        assertEquals(0, version1_1.compareTo(version1_1_0));
+        
+        VersionNumber version1_1_1_1_alpha = VersionNumber.parse("1.1.1.1-alpha");
+        assertTrue(version1_1.compareTo(version1_1_1_1_alpha) < 0);
+        
+        VersionNumber version1_1_beta = VersionNumber.parse("1.1.0.0-beta"); 
+        assertTrue(version1_1_beta.compareTo(version1_1_1_1_alpha) < 0);
+
+        VersionNumber version1_1_1_snapshot = VersionNumber.parse("1.1.1-snapshot");
+        assertTrue(version1_1_1_1_alpha.compareTo(version1_1_1_snapshot) < 0);
+    }
+    
+    @Test
+    public void givenVersionStrings_whenUsingJackson_thenCompareVersions() {
+        Version version1_1 = new Version(1, 1, 0, null, null, null);
+        Version version1_2 = new Version(1, 2, 0, null, null, null);
+        Version version1_3 = new Version(1, 3, 0, null, null, null);
+        
+        assertTrue(version1_1.compareTo(version1_2) < 0);
+        assertTrue(version1_3.compareTo(version1_2) > 0);
+        
+        Version version1_1_1 = new Version(1, 1, 1, null, null, null);
+        assertTrue(version1_1.compareTo(version1_1_1) < 0);
+        
+        Version version1_1_maven = new Version(1, 1, 0, null, "org.apache.maven", null);
+        Version version1_1_gradle = new Version(1, 1, 0, null, "org.gradle", null);
+        assertTrue(version1_1_maven.compareTo(version1_1_gradle) < 0);
+        
+        Version version1_1_snapshot = new Version(1, 1, 0, "snapshot", null, null);
+        assertEquals(0, version1_1.compareTo(version1_1_snapshot));
+        
+        assertTrue(version1_1_snapshot.isSnapshot());
+    }
+    
+    @Test
+    public void givenVersionStrings_whenUsingSemver_thenCompareVersions() {
+        Semver version1_1 = new Semver("1.1.0");
+        Semver version1_2 = new Semver("1.2.0");
+        Semver version1_3 = new Semver("1.3.0");
+
+        assertTrue(version1_1.compareTo(version1_2) < 0);
+        assertTrue(version1_3.compareTo(version1_2) > 0);
+        
+        Semver version1_1_alpha = new Semver("1.1.0-alpha");
+        assertTrue(version1_1.isGreaterThan(version1_1_alpha));
+        
+        Semver version1_1_beta = new Semver("1.1.0-beta");
+        Semver version1_1_milestone = new Semver("1.1.0-milestone");
+        Semver version1_1_rc = new Semver("1.1.0-rc");
+        Semver version1_1_snapshot = new Semver("1.1.0-snapshot");
+        
+        assertTrue(version1_1_alpha.isLowerThan(version1_1_beta));
+        assertTrue(version1_1_beta.compareTo(version1_1_milestone) < 0);
+        assertTrue(version1_1_rc.compareTo(version1_1_snapshot) < 0);
+        assertTrue(version1_1_snapshot.compareTo(version1_1) < 0);        
+        
+        assertTrue(version1_1.isEqualTo("1.1.0"));
+        
+        assertEquals(VersionDiff.MAJOR, version1_1.diff("2.1.0"));
+        assertEquals(VersionDiff.MINOR, version1_1.diff("1.2.3"));
+        assertEquals(VersionDiff.PATCH, version1_1.diff("1.1.1"));
+        
+        assertTrue(version1_1.isStable());
+        assertFalse(version1_1_alpha.isStable());
+    }
+
+    @Test
+    public void givenVersionStrings_whenUsingCustomVersionCompare_thenCompareVersions() {
+        assertTrue(VersionCompare.compareVersions("1.0.1", "1.1.2") < 0);
+        assertTrue(VersionCompare.compareVersions("1.0.1", "1.10") < 0);
+        assertTrue(VersionCompare.compareVersions("1.1.2", "1.0.1") > 0);
+        assertTrue(VersionCompare.compareVersions("1.1.2", "1.2") < 0); 
+        assertEquals(0, VersionCompare.compareVersions("1.3.0", "1.3")); 
+    }
+    
+}

core-java-modules/pom.xml

@@ -85,6 +85,7 @@
         <module>core-java-lambdas</module>
         <module>core-java-lang</module>
         <module>core-java-lang-2</module>
+        <module>core-java-lang-3</module>
         <module>core-java-lang-math</module>
         <module>core-java-lang-math-2</module>
         <module>core-java-lang-oop-constructors</module>
@@ -110,6 +111,7 @@
         <module>core-java-perf</module>
 
         <module>core-java-reflection</module>
+        <module>core-java-reflection-2</module>
 
         <module>core-java-security</module>
         <module>core-java-security-2</module>
@@ -124,6 +126,7 @@
         <module>core-java-string-conversions-2</module>
         <module>core-java-string-operations</module>
         <module>core-java-string-operations-2</module>
+        <module>core-java-string-operations-3</module>
         <module>core-java-strings</module>
         <module>core-java-sun</module>
 

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

@@ -7,7 +7,6 @@ This module contains articles about core features in the Kotlin language.
 - [Infix Functions in Kotlin](https://www.baeldung.com/kotlin-infix-functions)
 - [Lambda Expressions in Kotlin](https://www.baeldung.com/kotlin-lambda-expressions)
 - [Creating Java static final Equivalents in Kotlin](https://www.baeldung.com/kotlin-java-static-final)
-- [Initializing Arrays in Kotlin](https://www.baeldung.com/kotlin-initialize-array)
 - [Lazy Initialization in Kotlin](https://www.baeldung.com/kotlin-lazy-initialization)
 - [Comprehensive Guide to Null Safety in Kotlin](https://www.baeldung.com/kotlin-null-safety)
 - [Kotlin Scope Functions](https://www.baeldung.com/kotlin-scope-functions)

core-kotlin-modules/core-kotlin-lang-2/src/test/kotlin/com/baeldung/arrayinitialization/ArrayInitializationTest.kt

@@ -1,49 +0,0 @@
-package com.baeldung.arrayinitialization
-
-import org.junit.Test
-import kotlin.test.assertEquals
-
-class ArrayInitializationTest {
-
-    @Test
-    fun givenArrayOfStrings_thenValuesPopulated() {
-        val strings = arrayOf("January", "February", "March")
-
-        assertEquals(3, strings.size)
-        assertEquals("March", strings[2])
-    }
-
-    @Test
-    fun givenArrayOfIntegers_thenValuesPopulated() {
-        val integers = intArrayOf(1, 2, 3, 4)
-
-        assertEquals(4, integers.size)
-        assertEquals(1, integers[0])
-    }
-
-    @Test
-    fun givenArrayOfNulls_whenPopulated_thenValuesPresent() {
-        val array = arrayOfNulls<Number>(5)
-
-        for (i in array.indices) {
-            array[i] = i * i
-        }
-
-        assertEquals(16, array[4])
-    }
-
-    @Test
-    fun whenGeneratorUsed_thenValuesPresent() {
-        val generatedArray = IntArray(10) { i -> i * i }
-
-        assertEquals(81, generatedArray[9])
-    }
-
-    @Test
-    fun whenStringGenerated_thenValuesPresent() {
-        val generatedStringArray = Array(10) { i -> "Number of index: $i"  }
-
-        assertEquals("Number of index: 0", generatedStringArray[0])
-    }
-
-}

guava-2/README.md

@@ -4,3 +4,4 @@ This module contains articles a Google Guava
 
 ### Relevant Articles: 
 - [Introduction to Guava Throwables](https://www.baeldung.com/guava-throwables)
+- [Guava CharMatcher](https://www.baeldung.com/guava-string-charmatcher)

guava-2/src/test/java/com/baeldung/guava/charmatcher/GuavaCharMatcherUnitTest.java

@@ -0,0 +1,113 @@
+package com.baeldung.guava.charmatcher;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
+
+import java.nio.charset.Charset;
+import java.nio.charset.CharsetEncoder;
+
+import org.junit.Test;
+
+import com.google.common.base.CharMatcher;
+import com.google.common.base.Predicate;
+
+public class GuavaCharMatcherUnitTest {
+
+    @Test
+    public void whenRemoveSpecialCharacters_thenRemoved() {
+        final String input = "H*el.lo,}12";
+        final CharMatcher matcher = CharMatcher.javaLetterOrDigit();
+        final String result = matcher.retainFrom(input);
+
+        assertEquals("Hello12", result);
+    }
+
+    @Test
+    public void whenRemoveNonASCIIChars_thenRemoved() {
+        final String input = "あhello₤";
+
+        String result = CharMatcher.ascii().retainFrom(input);
+        assertEquals("hello", result);
+
+        result = CharMatcher.inRange('0', 'z').retainFrom(input);
+        assertEquals("hello", result);
+    }
+
+    @Test
+    public void whenValidateString_thenValid() {
+        final String input = "hello";
+
+        boolean result = CharMatcher.javaLowerCase().matchesAllOf(input);
+        assertTrue(result);
+
+        result = CharMatcher.is('e').matchesAnyOf(input);
+        assertTrue(result);
+
+        result = CharMatcher.javaDigit().matchesNoneOf(input);
+        assertTrue(result);
+    }
+
+    @Test
+    public void whenTrimString_thenTrimmed() {
+        final String input = "---hello,,,";
+
+        String result = CharMatcher.is('-').trimLeadingFrom(input);
+        assertEquals("hello,,,", result);
+
+        result = CharMatcher.is(',').trimTrailingFrom(input);
+        assertEquals("---hello", result);
+
+        result = CharMatcher.anyOf("-,").trimFrom(input);
+        assertEquals("hello", result);
+    }
+
+    @Test
+    public void whenCollapseFromString_thenCollapsed() {
+        final String input = "       hel    lo      ";
+
+        String result = CharMatcher.is(' ').collapseFrom(input, '-');
+        assertEquals("-hel-lo-", result);
+
+        result = CharMatcher.is(' ').trimAndCollapseFrom(input, '-');
+        assertEquals("hel-lo", result);
+    }
+
+    @Test
+    public void whenReplaceFromString_thenReplaced() {
+        final String input = "apple-banana.";
+
+        String result = CharMatcher.anyOf("-.").replaceFrom(input, '!');
+        assertEquals("apple!banana!", result);
+
+        result = CharMatcher.is('-').replaceFrom(input, " and ");
+        assertEquals("apple and banana.", result);
+    }
+
+    @Test
+    public void whenCountCharInString_thenCorrect() {
+        final String input = "a, c, z, 1, 2";
+
+        int result = CharMatcher.is(',').countIn(input);
+        assertEquals(4, result);
+
+        result = CharMatcher.inRange('a', 'h').countIn(input);
+        assertEquals(2, result);
+    }
+
+    @Test
+    public void whenRemoveCharsNotInCharset_thenRemoved() {
+        final Charset charset = Charset.forName("cp437");
+        final CharsetEncoder encoder = charset.newEncoder();
+
+        final Predicate<Character> inRange = new Predicate<Character>() {
+            @Override
+            public boolean apply(final Character c) {
+                return encoder.canEncode(c);
+            }
+        };
+
+        final String result = CharMatcher.forPredicate(inRange).retainFrom("helloは");
+        assertEquals("hello", result);
+    }
+
+}

guava-collections/README.md

@@ -14,4 +14,3 @@ This module contains articles about Google Guava collections
 - [Guava – Lists](https://www.baeldung.com/guava-lists)
 - [Guide to Guava MinMaxPriorityQueue and EvictingQueue](https://www.baeldung.com/guava-minmax-priority-queue-and-evicting-queue)
 - [Guide to Guava Table](https://www.baeldung.com/guava-table)
-- [Guava CharMatcher](https://www.baeldung.com/guava-string-charmatcher)

guava-collections/src/test/java/com/baeldung/guava/joinsplit/GuavaStringUnitTest.java

@@ -4,20 +4,19 @@ import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.containsString;
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertThat;
-import static org.junit.Assert.assertTrue;
 
-import java.nio.charset.Charset;
-import java.nio.charset.CharsetEncoder;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
 
-import com.google.common.collect.*;
 import org.junit.Test;
 
-import com.google.common.base.CharMatcher;
 import com.google.common.base.Function;
 import com.google.common.base.Joiner;
-import com.google.common.base.Predicate;
 import com.google.common.base.Splitter;
+import com.google.common.collect.Iterables;
+import com.google.common.collect.Lists;
+import com.google.common.collect.Maps;
 
 public class GuavaStringUnitTest {
 
@@ -113,102 +112,4 @@ public class GuavaStringUnitTest {
         assertEquals(4, result.size());
         assertThat(result, contains("a", "b", "c", "d,e"));
     }
-
-    @Test
-    public void whenRemoveSpecialCharacters_thenRemoved() {
-        final String input = "H*el.lo,}12";
-        final CharMatcher matcher = CharMatcher.javaLetterOrDigit();
-        final String result = matcher.retainFrom(input);
-
-        assertEquals("Hello12", result);
-    }
-
-    @Test
-    public void whenRemoveNonASCIIChars_thenRemoved() {
-        final String input = "あhello₤";
-
-        String result = CharMatcher.ascii().retainFrom(input);
-        assertEquals("hello", result);
-
-        result = CharMatcher.inRange('0', 'z').retainFrom(input);
-        assertEquals("hello", result);
-    }
-
-    @Test
-    public void whenValidateString_thenValid() {
-        final String input = "hello";
-
-        boolean result = CharMatcher.javaLowerCase().matchesAllOf(input);
-        assertTrue(result);
-
-        result = CharMatcher.is('e').matchesAnyOf(input);
-        assertTrue(result);
-
-        result = CharMatcher.javaDigit().matchesNoneOf(input);
-        assertTrue(result);
-    }
-
-    @Test
-    public void whenTrimString_thenTrimmed() {
-        final String input = "---hello,,,";
-
-        String result = CharMatcher.is('-').trimLeadingFrom(input);
-        assertEquals("hello,,,", result);
-
-        result = CharMatcher.is(',').trimTrailingFrom(input);
-        assertEquals("---hello", result);
-
-        result = CharMatcher.anyOf("-,").trimFrom(input);
-        assertEquals("hello", result);
-    }
-
-    @Test
-    public void whenCollapseFromString_thenCollapsed() {
-        final String input = "       hel    lo      ";
-
-        String result = CharMatcher.is(' ').collapseFrom(input, '-');
-        assertEquals("-hel-lo-", result);
-
-        result = CharMatcher.is(' ').trimAndCollapseFrom(input, '-');
-        assertEquals("hel-lo", result);
-    }
-
-    @Test
-    public void whenReplaceFromString_thenReplaced() {
-        final String input = "apple-banana.";
-
-        String result = CharMatcher.anyOf("-.").replaceFrom(input, '!');
-        assertEquals("apple!banana!", result);
-
-        result = CharMatcher.is('-').replaceFrom(input, " and ");
-        assertEquals("apple and banana.", result);
-    }
-
-    @Test
-    public void whenCountCharInString_thenCorrect() {
-        final String input = "a, c, z, 1, 2";
-
-        int result = CharMatcher.is(',').countIn(input);
-        assertEquals(4, result);
-
-        result = CharMatcher.inRange('a', 'h').countIn(input);
-        assertEquals(2, result);
-    }
-
-    @Test
-    public void whenRemoveCharsNotInCharset_thenRemoved() {
-        final Charset charset = Charset.forName("cp437");
-        final CharsetEncoder encoder = charset.newEncoder();
-
-        final Predicate<Character> inRange = new Predicate<Character>() {
-            @Override
-            public boolean apply(final Character c) {
-                return encoder.canEncode(c);
-            }
-        };
-
-        final String result = CharMatcher.forPredicate(inRange).retainFrom("helloは");
-        assertEquals("hello", result);
-    }
-
 }

image-processing/pom.xml

@@ -60,6 +60,27 @@
             <artifactId>tesseract-platform</artifactId>
             <version>${tesseract-platform.version}</version>
         </dependency>
+        <dependency>
+            <groupId>org.imgscalr</groupId>
+            <artifactId>imgscalr-lib</artifactId>
+            <version>${imgscalr-version}</version>
+        </dependency>
+        <dependency>
+            <groupId>net.coobird</groupId>
+            <artifactId>thumbnailator</artifactId>
+            <version>${thumbnailator-version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.github.downgoon</groupId>
+            <artifactId>marvin</artifactId>
+            <version>${marvin-version}</version>
+            <type>pom</type>
+         </dependency>
+        <dependency>
+            <groupId>com.github.downgoon</groupId>
+            <artifactId>MarvinPlugins</artifactId>
+            <version>${marvin-version}</version>
+        </dependency>
     </dependencies>
     
     <properties>
@@ -69,6 +90,9 @@
         <tess4j.version>4.5.1</tess4j.version>
         <tesseract-platform.version>4.1.0-1.5.2</tesseract-platform.version>
         <opencv.version>3.4.2-0</opencv.version>
+        <imgscalr-version>4.2</imgscalr-version>
+        <thumbnailator-version>0.4.11</thumbnailator-version>
+        <marvin-version>1.5.5</marvin-version>
     </properties>
 
 </project>

image-processing/src/main/java/com/baeldung/image/resize/core/Graphics2DExample.java

@@ -0,0 +1,25 @@
+package com.baeldung.image.resize.core;
+
+import java.awt.Graphics2D;
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+public class Graphics2DExample {
+
+    static BufferedImage resizeImage(BufferedImage originalImage, int targetWidth, int targetHeight) {
+        BufferedImage resizedImage = new BufferedImage(targetWidth, targetHeight, BufferedImage.TYPE_INT_RGB);
+        Graphics2D graphics2D = resizedImage.createGraphics();
+        graphics2D.drawImage(originalImage, 0, 0, targetWidth, targetHeight, null);
+        graphics2D.dispose();
+        return resizedImage;
+    }
+
+    public static void main(String[] args) throws IOException {
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = resizeImage(originalImage, 200, 200);
+        ImageIO.write(outputImage, "jpg", new File("src/main/resources/images/sampleImage-resized-graphics2d.jpg"));
+    }
+}

image-processing/src/main/java/com/baeldung/image/resize/core/ImageScaledInstanceExample.java

@@ -0,0 +1,24 @@
+package com.baeldung.image.resize.core;
+
+import java.awt.Image;
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+public class ImageScaledInstanceExample {
+    static BufferedImage resizeImage(BufferedImage originalImage, int targetWidth, int targetHeight) {
+        Image resultingImage = originalImage.getScaledInstance(targetWidth, targetHeight, Image.SCALE_DEFAULT);
+        BufferedImage bufferedImage = new BufferedImage(targetWidth, targetHeight, BufferedImage.TYPE_INT_RGB);
+        bufferedImage.getGraphics()
+            .drawImage(resultingImage, 0, 0, null);
+        return bufferedImage;
+    }
+
+    public static void main(String[] args) throws IOException {
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = resizeImage(originalImage, 200, 200);
+        ImageIO.write(outputImage, "jpg", new File("src/main/resources/images/sampleImage-resized-scaledinstance.jpg"));
+    }
+}

image-processing/src/main/java/com/baeldung/image/resize/imgscalr/ImgscalrExample.java

@@ -0,0 +1,24 @@
+package com.baeldung.image.resize.imgscalr;
+
+import java.awt.image.BufferedImage;
+import java.io.File;
+
+import javax.imageio.ImageIO;
+
+import org.imgscalr.Scalr;
+
+public class ImgscalrExample {
+    public static BufferedImage simpleResizeImage(BufferedImage originalImage, int targetWidth) {
+        return Scalr.resize(originalImage, targetWidth);
+    }
+
+    public static BufferedImage resizeImage(BufferedImage originalImage, int targetWidth, int targetHeight) {
+        return Scalr.resize(originalImage, Scalr.Method.AUTOMATIC, Scalr.Mode.AUTOMATIC, targetWidth, targetHeight, Scalr.OP_ANTIALIAS);
+    }
+
+    public static void main(String[] args) throws Exception {
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = resizeImage(originalImage, 200, 200);
+        ImageIO.write(outputImage, "jpg", new File("src/main/resources/images/sampleImage-resized-imgscalr.jpg"));
+    }
+}

image-processing/src/main/java/com/baeldung/image/resize/marvin/MarvinExample.java

@@ -0,0 +1,29 @@
+package com.baeldung.image.resize.marvin;
+
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+import org.marvinproject.image.transform.scale.Scale;
+
+import marvin.image.MarvinImage;
+
+public class MarvinExample {
+    static BufferedImage resizeImage(BufferedImage originalImage, int targetWidth, int targetHeight) {
+        MarvinImage image = new MarvinImage(originalImage);
+        Scale scale = new Scale();
+        scale.load();
+        scale.setAttribute("newWidth", targetWidth);
+        scale.setAttribute("newHeight", targetHeight);
+        scale.process(image.clone(), image, null, null, false);
+        return image.getBufferedImageNoAlpha();
+    }
+
+    public static void main(String args[]) throws IOException {
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = resizeImage(originalImage, 200, 200);
+        ImageIO.write(outputImage, "jpg", new File("src/main/resources/images/sampleImage-resized-marvin.jpg"));
+    }
+}

image-processing/src/main/java/com/baeldung/image/resize/thumbnailator/ThumbnailatorExample.java

@@ -0,0 +1,31 @@
+package com.baeldung.image.resize.thumbnailator;
+
+import java.awt.image.BufferedImage;
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+import net.coobird.thumbnailator.Thumbnails;
+
+public class ThumbnailatorExample {
+    static BufferedImage resizeImage(BufferedImage originalImage, int targetWidth, int targetHeight) throws IOException {
+        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
+        Thumbnails.of(originalImage)
+            .size(targetWidth, targetHeight)
+            .outputFormat("JPEG")
+            .outputQuality(0.90)
+            .toOutputStream(outputStream);
+        byte[] data = outputStream.toByteArray();
+        ByteArrayInputStream inputStream = new ByteArrayInputStream(data);
+        return ImageIO.read(inputStream);
+    }
+
+    public static void main(String[] args) throws Exception {
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = resizeImage(originalImage, 200, 200);
+        ImageIO.write(outputImage, "jpg", new File("src/main/resources/images/sampleImage-resized-thumbnailator.jpg"));
+    }
+}

image-processing/src/main/java/com/baeldung/imageprocessing/addingtext/AddText.java

@@ -0,0 +1,220 @@
+package com.baeldung.imageprocessing.addingtext;
+
+import ij.IJ;
+import ij.ImagePlus;
+import ij.process.ImageProcessor;
+
+import java.awt.*;
+import java.awt.font.GlyphVector;
+import java.awt.font.TextAttribute;
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+import java.text.AttributedString;
+
+import javax.imageio.ImageIO;
+
+public class AddText {
+    public static void main(String[] args) throws IOException {
+        String imagePath = AddText.class.getClassLoader().getResource("lena.jpg").getPath();
+        
+        ImagePlus resultPlus= signImageImageProcessor("www.baeldung.com", imagePath);
+        resultPlus.show();
+        
+        ImagePlus resultGraphics = new ImagePlus("", signImageGraphics("www.baeldung.com", imagePath));
+        resultGraphics.show();
+
+        ImagePlus resultGraphicsWithIterator = new ImagePlus("", signImageGraphicsWithIterator("www.baeldung.com", imagePath));
+        resultGraphicsWithIterator.show();
+
+        ImagePlus resultGraphicsCentered = new ImagePlus("", signImageCenter("www.baeldung.com", imagePath));
+        resultGraphicsCentered.show();
+
+        ImagePlus resultGraphicsBottomRight = new ImagePlus("", signImageBottomRight("www.baeldung.com", imagePath));
+        resultGraphicsBottomRight.show();
+
+        ImagePlus resultGraphicsTopLeft= new ImagePlus("", signImageTopLeft("www.baeldung.com", imagePath));
+        resultGraphicsTopLeft.show();
+
+        ImagePlus resultGraphicsAdaptBasedOnImage= new ImagePlus("", signImageAdaptBasedOnImage("www.baeldung.com", imagePath));
+        resultGraphicsAdaptBasedOnImage.show();
+    }
+
+    private static ImagePlus signImageImageProcessor(String text, String path) {
+        ImagePlus image = IJ.openImage(path);
+        Font font = new Font("Arial", Font.BOLD, 18);
+        
+        ImageProcessor ip = image.getProcessor();
+        ip.setColor(Color.GREEN);
+        ip.setFont(font);
+        ip.drawString(text, 0, 20);
+        
+        return image;
+    }
+
+    private static BufferedImage signImageGraphics(String text, String path) throws IOException {
+        BufferedImage image = ImageIO.read(new File(path));
+        Font font = new Font("Arial", Font.BOLD, 18);
+        
+        Graphics g = image.getGraphics();
+        g.setFont(font);
+        g.setColor(Color.GREEN);
+        g.drawString(text, 0, 20);
+
+        return image;
+    }
+    
+
+    private static BufferedImage signImageGraphicsWithIterator(String text, String path) throws IOException {
+        BufferedImage image = ImageIO.read(new File(path));
+        Font font = new Font("Arial", Font.BOLD, 18);
+        
+        AttributedString attributedText = new AttributedString(text);
+        attributedText.addAttribute(TextAttribute.FONT, font);
+        attributedText.addAttribute(TextAttribute.FOREGROUND, Color.GREEN);
+        
+        Graphics g = image.getGraphics();
+        g.drawString(attributedText.getIterator(), 0, 20);
+
+        return image;
+    }
+    
+    /**
+     * Draw a String centered in the middle of a Rectangle.
+     *
+     * @param g The Graphics instance.
+     * @param text The String to draw.
+     * @param rect The Rectangle to center the text in.
+     * @throws IOException 
+     */
+    public static BufferedImage signImageCenter(String text, String path) throws IOException {
+        
+        BufferedImage image = ImageIO.read(new File(path));
+        Font font = new Font("Arial", Font.BOLD, 18);
+        
+        AttributedString attributedText = new AttributedString(text);
+        attributedText.addAttribute(TextAttribute.FONT, font);
+        attributedText.addAttribute(TextAttribute.FOREGROUND, Color.GREEN);
+        
+        Graphics g = image.getGraphics();
+
+        FontMetrics metrics = g.getFontMetrics(font);
+        int positionX = (image.getWidth() - metrics.stringWidth(text)) / 2;
+        int positionY = (image.getHeight() - metrics.getHeight()) / 2 + metrics.getAscent();
+        
+        g.drawString(attributedText.getIterator(), positionX, positionY);
+                
+        return image;
+    } 
+    
+    /**
+     * Draw a String centered in the middle of a Rectangle.
+     *
+     * @param g The Graphics instance.
+     * @param text The String to draw.
+     * @param rect The Rectangle to center the text in.
+     * @throws IOException 
+     */
+    public static BufferedImage signImageBottomRight(String text, String path) throws IOException {
+        
+        BufferedImage image = ImageIO.read(new File(path));
+        
+        Font font = new Font("Arial", Font.BOLD, 18);
+        
+        AttributedString attributedText = new AttributedString(text);
+        attributedText.addAttribute(TextAttribute.FONT, font);
+        attributedText.addAttribute(TextAttribute.FOREGROUND, Color.GREEN);
+        
+        Graphics g = image.getGraphics();
+
+        FontMetrics metrics = g.getFontMetrics(font);
+        int positionX = (image.getWidth() - metrics.stringWidth(text));
+        int positionY = (image.getHeight() - metrics.getHeight()) + metrics.getAscent();
+        
+        g.drawString(attributedText.getIterator(), positionX, positionY);
+                
+        return image;
+    }
+
+    /**
+     * Draw a String centered in the middle of a Rectangle.
+     *
+     * @param g The Graphics instance.
+     * @param text The String to draw.
+     * @param rect The Rectangle to center the text in.
+     * @throws IOException 
+     */
+    public static BufferedImage signImageTopLeft(String text, String path) throws IOException {
+        
+        BufferedImage image = ImageIO.read(new File(path));
+        
+        Font font = new Font("Arial", Font.BOLD, 18);
+        
+        AttributedString attributedText = new AttributedString(text);
+        attributedText.addAttribute(TextAttribute.FONT, font);
+        attributedText.addAttribute(TextAttribute.FOREGROUND, Color.GREEN);
+        
+        Graphics g = image.getGraphics();
+
+        FontMetrics metrics = g.getFontMetrics(font);
+        int positionX = 0;
+        int positionY = metrics.getAscent();
+        
+        g.drawString(attributedText.getIterator(), positionX, positionY);
+                
+        return image;
+    }
+    
+    /**
+     * Draw a String centered in the middle of a Rectangle.
+     *
+     * @param g The Graphics instance.
+     * @param text The String to draw.
+     * @param rect The Rectangle to center the text in.
+     * @throws IOException 
+     */
+    public static BufferedImage signImageAdaptBasedOnImage(String text, String path) throws IOException {
+        
+        BufferedImage image = ImageIO.read(new File(path));
+        
+        Font font = createFontToFit(new Font("Arial", Font.BOLD, 80), text, image);
+        
+        AttributedString attributedText = new AttributedString(text);
+        attributedText.addAttribute(TextAttribute.FONT, font);
+        attributedText.addAttribute(TextAttribute.FOREGROUND, Color.GREEN);
+        
+        Graphics g = image.getGraphics();
+        
+        FontMetrics metrics = g.getFontMetrics(font);
+        int positionX = (image.getWidth() - metrics.stringWidth(text));
+        int positionY = (image.getHeight() - metrics.getHeight()) + metrics.getAscent();
+        
+        g.drawString(attributedText.getIterator(), positionX, positionY);
+                
+        return image;
+    }
+    
+    public static Font createFontToFit(Font baseFont, String text, BufferedImage image) throws IOException
+    {              
+        Font newFont = baseFont;
+        
+        FontMetrics ruler = image.getGraphics().getFontMetrics(baseFont);
+        GlyphVector vector = baseFont.createGlyphVector(ruler.getFontRenderContext(), text);
+        
+        Shape outline = vector.getOutline(0, 0);
+        
+        double expectedWidth = outline.getBounds().getWidth();
+        double expectedHeight = outline.getBounds().getHeight();
+        
+        boolean textFits = image.getWidth() >= expectedWidth && image.getHeight() >= expectedHeight;
+        
+        if(!textFits) {
+            double widthBasedFontSize = (baseFont.getSize2D()*image.getWidth())/expectedWidth;
+            double heightBasedFontSize = (baseFont.getSize2D()*image.getHeight())/expectedHeight;
+            
+            double newFontSize = widthBasedFontSize < heightBasedFontSize ? widthBasedFontSize : heightBasedFontSize;
+            newFont = baseFont.deriveFont(baseFont.getStyle(), (float)newFontSize);
+        }
+        return newFont;
+    }
+}

image-processing/src/test/java/com/baeldung/image/resize/core/Graphics2DExampleUnitTest.java

@@ -0,0 +1,71 @@
+package com.baeldung.image.resize.core;
+
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+import org.junit.Test;
+
+public class Graphics2DExampleUnitTest {
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenImageGeneratedWithoutError() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = Graphics2DExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenOutputImageSizeIsValid() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        assertNotEquals(originalImage.getWidth(), targetWidth);
+        assertNotEquals(originalImage.getHeight(), targetHeight);
+        BufferedImage outputImage = Graphics2DExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertEquals(outputImage.getWidth(), targetWidth);
+        assertEquals(outputImage.getHeight(), targetHeight);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetWidthIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 0;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = Graphics2DExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetHeightIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 0;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = Graphics2DExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageDoesNotExist_thenErrorIsNotThrownAndImageIsGenerated() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage outputImage = Graphics2DExample.resizeImage(null, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+        assertEquals(outputImage.getWidth(), targetWidth);
+        assertEquals(outputImage.getHeight(), targetHeight);
+    }
+}

image-processing/src/test/java/com/baeldung/image/resize/core/ImageScaledInstanceExampleUnitTest.java

@@ -0,0 +1,69 @@
+package com.baeldung.image.resize.core;
+
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+import org.junit.Test;
+
+public class ImageScaledInstanceExampleUnitTest {
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenImageGeneratedWithoutError() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ImageScaledInstanceExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenOutputImageSizeIsValid() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        assertNotEquals(originalImage.getWidth(), targetWidth);
+        assertNotEquals(originalImage.getHeight(), targetHeight);
+        BufferedImage outputImage = ImageScaledInstanceExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertEquals(outputImage.getWidth(), targetWidth);
+        assertEquals(outputImage.getHeight(), targetHeight);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetWidthIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 0;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ImageScaledInstanceExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetHeightIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 0;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ImageScaledInstanceExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenOriginalImageDoesNotExist_thenErrorIsThrown() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage outputImage = ImageScaledInstanceExample.resizeImage(null, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+}

image-processing/src/test/java/com/baeldung/image/resize/imgscalr/ImgscalrExampleUnitTest.java

@@ -0,0 +1,69 @@
+package com.baeldung.image.resize.imgscalr;
+
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+import org.junit.Test;
+
+public class ImgscalrExampleUnitTest {
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenImageGeneratedWithoutError() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ImgscalrExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenOutputImageSizeIsValid() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        assertNotEquals(originalImage.getWidth(), targetWidth);
+        assertNotEquals(originalImage.getHeight(), targetHeight);
+        BufferedImage outputImage = ImgscalrExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertEquals(outputImage.getWidth(), targetWidth);
+        assertEquals(outputImage.getHeight(), targetHeight);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenTargetWidthIsZero_thenImageIsCreated() throws IOException {
+        int targetWidth = 0;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ImgscalrExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenTargetHeightIsZero_thenImageIsCreated() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 0;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ImgscalrExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenOriginalImageDoesNotExist_thenErrorIsThrown() {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage outputImage = ImgscalrExample.resizeImage(null, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+}

image-processing/src/test/java/com/baeldung/image/resize/marvin/MarvinExampleUnitTest.java

@@ -0,0 +1,68 @@
+package com.baeldung.image.resize.marvin;
+
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+import org.junit.Test;
+
+public class MarvinExampleUnitTest {
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenImageGeneratedWithoutError() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = MarvinExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenOutputImageSizeIsValid() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        assertNotEquals(originalImage.getWidth(), targetWidth);
+        assertNotEquals(originalImage.getHeight(), targetHeight);
+        BufferedImage outputImage = MarvinExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertEquals(outputImage.getWidth(), targetWidth);
+        assertEquals(outputImage.getHeight(), targetHeight);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetWidthIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 0;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = MarvinExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetHeightIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 0;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = MarvinExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenOriginalImageDoesNotExist_thenErrorIsThrown() {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage outputImage = MarvinExample.resizeImage(null, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+}

image-processing/src/test/java/com/baeldung/image/resize/thumbnailator/ThumbnailatorExampleUnitTest.java

@@ -0,0 +1,68 @@
+package com.baeldung.image.resize.thumbnailator;
+
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+
+import javax.imageio.ImageIO;
+
+import org.junit.Test;
+
+public class ThumbnailatorExampleUnitTest {
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenImageGeneratedWithoutError() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ThumbnailatorExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNotNull(outputImage);
+    }
+
+    @Test(expected = Test.None.class)
+    public void whenOriginalImageExistsAndTargetSizesAreNotZero_thenOutputImageSizeIsValid() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        assertNotEquals(originalImage.getWidth(), targetWidth);
+        assertNotEquals(originalImage.getHeight(), targetHeight);
+        BufferedImage outputImage = ThumbnailatorExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertEquals(outputImage.getWidth(), targetWidth);
+        assertEquals(outputImage.getHeight(), targetHeight);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetWidthIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 0;
+        int targetHeight = 200;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ThumbnailatorExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenTargetHeightIsZero_thenErrorIsThrown() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 0;
+        BufferedImage originalImage = ImageIO.read(new File("src/main/resources/images/sampleImage.jpg"));
+        BufferedImage outputImage = ThumbnailatorExample.resizeImage(originalImage, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+
+    @Test(expected = Exception.class)
+    public void whenOriginalImageDoesNotExist_thenErrorIsThrown() throws IOException {
+        int targetWidth = 200;
+        int targetHeight = 200;
+        BufferedImage outputImage = ThumbnailatorExample.resizeImage(null, targetWidth, targetHeight);
+
+        assertNull(outputImage);
+    }
+}

libraries-6/README.md

@@ -14,4 +14,5 @@ Remember, for advanced libraries like [Jackson](/jackson) and [JUnit](/testing-m
 - [Introduction to Functional Java](https://www.baeldung.com/java-functional-library)
 - [A Guide to the Reflections Library](https://www.baeldung.com/reflections-library)
 - [Exactly Once Processing in Kafka](https://www.baeldung.com/kafka-exactly-once)
+- [Introduction to Protonpack](https://www.baeldung.com/java-protonpack)
 - More articles [[<-- prev]](/libraries-5)

libraries-6/src/test/java/com/baeldung/protonpack/ProtonpackUnitTest.java

@@ -10,8 +10,6 @@ import org.junit.Test;
 import java.util.List;
 import java.util.Optional;
 import java.util.Set;
-import java.util.concurrent.atomic.AtomicInteger;
-import java.util.function.Function;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 

libraries-security/src/main/java/com/baeldung/pem/BouncyCastlePemUtils.java

@@ -0,0 +1,71 @@
+package com.baeldung.pem;
+
+import org.bouncycastle.asn1.pkcs.PrivateKeyInfo;
+import org.bouncycastle.asn1.x509.SubjectPublicKeyInfo;
+import org.bouncycastle.openssl.PEMParser;
+import org.bouncycastle.openssl.jcajce.JcaPEMKeyConverter;
+import org.bouncycastle.util.io.pem.PemObject;
+import org.bouncycastle.util.io.pem.PemReader;
+
+import java.io.File;
+import java.io.FileReader;
+import java.io.IOException;
+import java.security.KeyFactory;
+import java.security.NoSuchAlgorithmException;
+import java.security.interfaces.RSAPrivateKey;
+import java.security.interfaces.RSAPublicKey;
+import java.security.spec.InvalidKeySpecException;
+import java.security.spec.PKCS8EncodedKeySpec;
+import java.security.spec.X509EncodedKeySpec;
+
+public class BouncyCastlePemUtils {
+
+    public static RSAPublicKey readX509PublicKey(File file) throws InvalidKeySpecException, IOException, NoSuchAlgorithmException {
+        KeyFactory factory = KeyFactory.getInstance("RSA");
+
+        try (FileReader keyReader = new FileReader(file);
+             PemReader pemReader = new PemReader(keyReader)) {
+
+            PemObject pemObject = pemReader.readPemObject();
+            byte[] content = pemObject.getContent();
+            X509EncodedKeySpec pubKeySpec = new X509EncodedKeySpec(content);
+            return (RSAPublicKey) factory.generatePublic(pubKeySpec);
+        }
+    }
+
+    public static RSAPublicKey readX509PublicKeySecondApproach(File file) throws IOException {
+        try (FileReader keyReader = new FileReader(file)) {
+
+            PEMParser pemParser = new PEMParser(keyReader);
+            JcaPEMKeyConverter converter = new JcaPEMKeyConverter();
+            SubjectPublicKeyInfo publicKeyInfo = SubjectPublicKeyInfo.getInstance(pemParser.readObject());
+
+            return (RSAPublicKey) converter.getPublicKey(publicKeyInfo);
+        }
+    }
+
+    public static RSAPrivateKey readPKCS8PrivateKey(File file) throws InvalidKeySpecException, IOException, NoSuchAlgorithmException {
+        KeyFactory factory = KeyFactory.getInstance("RSA");
+
+        try (FileReader keyReader = new FileReader(file);
+             PemReader pemReader = new PemReader(keyReader)) {
+
+            PemObject pemObject = pemReader.readPemObject();
+            byte[] content = pemObject.getContent();
+            PKCS8EncodedKeySpec privKeySpec = new PKCS8EncodedKeySpec(content);
+            return (RSAPrivateKey) factory.generatePrivate(privKeySpec);
+        }
+    }
+
+    public static RSAPrivateKey readPKCS8PrivateKeySecondApproach(File file) throws IOException {
+        try (FileReader keyReader = new FileReader(file)) {
+
+            PEMParser pemParser = new PEMParser(keyReader);
+            JcaPEMKeyConverter converter = new JcaPEMKeyConverter();
+            PrivateKeyInfo privateKeyInfo = PrivateKeyInfo.getInstance(pemParser.readObject());
+
+            return (RSAPrivateKey) converter.getPrivateKey(privateKeyInfo);
+        }
+    }
+
+}