Source code for Lightrun articles

lightrun/README.md

@@ -0,0 +1,29 @@
+# Lightrun Example Application - Tasks Management
+
+This application exists as an example for the Lightrun series of articles.
+
+## Building
+This application requires [Apache Maven](https://maven.apache.org/) and [Java 17+](https://www.oracle.com/java/technologies/downloads/).
+
+Building the code is done by executing:
+```
+$ mvn install
+```
+from the top level.
+
+## Running
+The application consists of three services:
+* Tasks
+* Users
+* API
+
+These are all Spring Boot applications.
+
+The Tasks and Users services exist as microservices for managing one facet of data. Each uses a database, and utilise a JMS queue between them as well. For convenience this infrastructure is all embedded in the applications.
+
+This does mean that the startup order is important. The JMS queue exists within the Tasks service and is connected to from the Users service. As such, the Tasks service must be started before the others.
+
+Each service can be started either by executing `mvn spring-boot:run` from within the appropriate directory. Alternatively, as Spring Boot applications, the build will produce an executable JAR file within the `target` directory that can be executed as, for example:
+```
+$ java -jar ./target/tasks-service-0.0.1-SNAPSHOT.jar
+```

lightrun/api-service/.gitignore

@@ -0,0 +1,33 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/

lightrun/api-service/pom.xml

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>2.6.7</version>
+		<relativePath/> <!-- lookup parent from repository -->
+	</parent>
+	<groupId>com.baeldung</groupId>
+	<artifactId>api-service</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+	<name>api-service</name>
+	<description>Aggregator Service for LightRun Article</description>
+	<properties>
+		<java.version>17</java.version>
+	</properties>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-actuator</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

lightrun/api-service/src/main/java/com/baeldung/apiservice/ApiServiceApplication.java

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

lightrun/api-service/src/main/java/com/baeldung/apiservice/RequestIdGenerator.java

@@ -0,0 +1,33 @@
+package com.baeldung.apiservice;
+
+import org.slf4j.MDC;
+import org.springframework.stereotype.Component;
+import org.springframework.web.context.request.RequestContextHolder;
+import org.springframework.web.servlet.HandlerInterceptor;
+import org.springframework.web.servlet.ModelAndView;
+
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import java.util.UUID;
+
+@Component
+public class RequestIdGenerator implements HandlerInterceptor {
+    @Override
+    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
+        String requestId = UUID.randomUUID().toString();
+
+        MDC.put(RequestIdGenerator.class.getCanonicalName(), requestId);
+        response.addHeader("X-Request-Id", requestId);
+
+        return true;
+    }
+
+    @Override
+    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
+        MDC.remove(RequestIdGenerator.class.getCanonicalName());
+    }
+
+    public static String getRequestId() {
+        return MDC.get(RequestIdGenerator.class.getCanonicalName());
+    }
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/RestTemplateConfig.java

@@ -0,0 +1,20 @@
+package com.baeldung.apiservice;
+
+import org.springframework.boot.web.client.RestTemplateBuilder;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.client.RestTemplate;
+
+@Configuration
+public class RestTemplateConfig {
+    @Bean
+    public RestTemplate restTemplate(RestTemplateBuilder builder) {
+        return builder
+                .additionalInterceptors((request, body, execution) -> {
+                    request.getHeaders().add("X-Request-Id", RequestIdGenerator.getRequestId());
+
+                    return execution.execute(request, body);
+                })
+                .build();
+    }
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/WebConfig.java

@@ -0,0 +1,17 @@
+package com.baeldung.apiservice;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+
+@Configuration
+public class WebConfig implements WebMvcConfigurer {
+    @Autowired
+    private RequestIdGenerator requestIdGenerator;
+
+    @Override
+    public void addInterceptors(InterceptorRegistry registry) {
+        registry.addInterceptor(requestIdGenerator);
+    }
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/http/TaskResponse.java

@@ -0,0 +1,11 @@
+package com.baeldung.apiservice.adapters.http;
+
+import java.time.Instant;
+
+public record TaskResponse(String id,
+                           String title,
+                           Instant created,
+                           UserResponse createdBy,
+                           UserResponse assignedTo,
+                           String status) {
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/http/TasksController.java

@@ -0,0 +1,54 @@
+package com.baeldung.apiservice.adapters.http;
+
+import com.baeldung.apiservice.adapters.tasks.Task;
+import com.baeldung.apiservice.adapters.tasks.TaskRepository;
+import com.baeldung.apiservice.adapters.users.UserRepository;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.*;
+
+@RequestMapping("/")
+@RestController
+public class TasksController {
+    @Autowired
+    private TaskRepository taskRepository;
+    @Autowired
+    private UserRepository userRepository;
+
+    @GetMapping("/{id}")
+    public TaskResponse getTaskById(@PathVariable("id") String id) {
+        Task task = taskRepository.getTaskById(id);
+
+        if (task == null) {
+            throw new UnknownTaskException();
+        }
+
+        return buildResponse(task);
+    }
+
+    private TaskResponse buildResponse(Task task) {
+        return new TaskResponse(task.id(),
+                task.title(),
+                task.created(),
+                getUser(task.createdBy()),
+                getUser(task.assignedTo()),
+                task.status());
+    }
+
+    private UserResponse  getUser(String userId) {
+        if (userId == null) {
+            return null;
+        }
+
+        var user = userRepository.getUserById(userId);
+        if (user == null) {
+            return null;
+        }
+
+        return new UserResponse(user.id(), user.name());
+    }
+    @ExceptionHandler(UnknownTaskException.class)
+    @ResponseStatus(HttpStatus.NOT_FOUND)
+    public void handleUnknownTask() {
+    }
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/http/UnknownTaskException.java

@@ -0,0 +1,4 @@
+package com.baeldung.apiservice.adapters.http;
+
+public class UnknownTaskException extends RuntimeException {
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/http/UserResponse.java

@@ -0,0 +1,4 @@
+package com.baeldung.apiservice.adapters.http;
+
+public record UserResponse(String id, String name) {
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/tasks/Task.java

@@ -0,0 +1,11 @@
+package com.baeldung.apiservice.adapters.tasks;
+
+import java.time.Instant;
+
+public record Task(String id,
+                   String title,
+                   Instant created,
+                   String createdBy,
+                   String assignedTo,
+                   String status) {
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/tasks/TaskRepository.java

@@ -0,0 +1,30 @@
+package com.baeldung.apiservice.adapters.tasks;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Repository;
+import org.springframework.web.client.HttpClientErrorException;
+import org.springframework.web.client.RestTemplate;
+import org.springframework.web.util.UriComponentsBuilder;
+
+@Repository
+public class TaskRepository {
+    @Autowired
+    private RestTemplate restTemplate;
+
+    @Value("${tasks-service.url}")
+    private String tasksService;
+
+    public Task getTaskById(String id) {
+        var uri = UriComponentsBuilder.fromUriString(tasksService)
+                .path(id)
+                .build()
+                .toUri();
+
+        try {
+            return restTemplate.getForObject(uri, Task.class);
+        } catch (HttpClientErrorException.NotFound e) {
+            return null;
+        }
+    }
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/users/User.java

@@ -0,0 +1,4 @@
+package com.baeldung.apiservice.adapters.users;
+
+public record User(String id, String name) {
+}

lightrun/api-service/src/main/java/com/baeldung/apiservice/adapters/users/UserRepository.java

@@ -0,0 +1,31 @@
+package com.baeldung.apiservice.adapters.users;
+
+import com.baeldung.apiservice.adapters.users.User;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Repository;
+import org.springframework.web.client.HttpClientErrorException;
+import org.springframework.web.client.RestTemplate;
+import org.springframework.web.util.UriComponentsBuilder;
+
+@Repository
+public class UserRepository {
+    @Autowired
+    private RestTemplate restTemplate;
+
+    @Value("${users-service.url}")
+    private String usersService;
+
+    public User getUserById(String id) {
+        var uri = UriComponentsBuilder.fromUriString(usersService)
+                .path(id)
+                .build()
+                .toUri();
+
+        try {
+            return restTemplate.getForObject(uri, User.class);
+        } catch (HttpClientErrorException.NotFound e) {
+            return null;
+        }
+    }
+}

lightrun/api-service/src/main/resources/application.properties

@@ -0,0 +1,2 @@
+users-service.url=http://localhost:8081
+tasks-service.url=http://localhost:8082

lightrun/pom.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>com.baelduung</groupId>
+    <artifactId>lightrun-demo</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <packaging>pom</packaging>
+	<name>lightrun</name>
+	<description>Services for LightRun Article</description>
+
+    <modules>
+        <module>tasks-service</module>
+        <module>users-service</module>
+        <module>api-service</module>
+    </modules>
+</project>

lightrun/tasks-service/.gitignore

@@ -0,0 +1,33 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/

lightrun/tasks-service/pom.xml

@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>2.6.7</version>
+		<relativePath/> <!-- lookup parent from repository -->
+	</parent>
+	<groupId>com.baeldung</groupId>
+	<artifactId>tasks-service</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+	<name>tasks-service</name>
+	<description>Tasks Service for LightRun Article</description>
+	<properties>
+		<java.version>17</java.version>
+	</properties>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-actuator</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-artemis</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-jpa</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.flywaydb</groupId>
+			<artifactId>flyway-core</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>com.h2database</groupId>
+			<artifactId>h2</artifactId>
+			<scope>runtime</scope>
+		</dependency>
+        <dependency>
+            <groupId>org.apache.activemq</groupId>
+            <artifactId>artemis-jms-server</artifactId>
+        </dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/ArtemisConfig.java

@@ -0,0 +1,23 @@
+package com.baeldung.tasksservice;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.boot.autoconfigure.jms.artemis.ArtemisConfigurationCustomizer;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class ArtemisConfig implements ArtemisConfigurationCustomizer {
+    @Value("${spring.artemis.host}")
+    private String hostname;
+
+    @Value("${spring.artemis.port}")
+    private int port;
+
+    @Override
+    public void customize(org.apache.activemq.artemis.core.config.Configuration configuration) {
+        try {
+            configuration.addAcceptorConfiguration("remote", "tcp://" + hostname + ":" + port);
+        } catch (Exception e) {
+            throw new RuntimeException("Failed to configure Artemis listener", e);
+        }
+    }
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/TasksServiceApplication.java

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

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/http/CreateTaskRequest.java

@@ -0,0 +1,15 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.adapters.http;
+
+public record CreateTaskRequest(String title, String createdBy) {
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/http/PatchTaskRequest.java

@@ -0,0 +1,17 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.adapters.http;
+
+import java.util.Optional;
+
+public record PatchTaskRequest(Optional<String> status, Optional<String> assignedTo) {
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/http/TaskResponse.java

@@ -0,0 +1,22 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.adapters.http;
+
+import java.time.Instant;
+
+public record TaskResponse(String id,
+                           String title,
+                           Instant created,
+                           String createdBy,
+                           String assignedTo,
+                           String status) {
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/http/TasksController.java

@@ -0,0 +1,86 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.adapters.http;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.stream.Collectors;
+
+import com.baeldung.tasksservice.adapters.repository.TaskRecord;
+import com.baeldung.tasksservice.service.TasksService;
+import com.baeldung.tasksservice.service.UnknownTaskException;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/")
+class TasksController {
+    @Autowired
+    private TasksService tasksService;
+
+    @PostMapping
+    @ResponseStatus(HttpStatus.CREATED)
+    public TaskResponse createTask(@RequestBody CreateTaskRequest body) {
+        var task = tasksService.createTask(body.title(), body.createdBy());
+        return buildResponse(task);
+    }
+
+    @GetMapping
+    public List<TaskResponse> searchTasks(@RequestParam("status") Optional<String> status,
+            @RequestParam("createdBy") Optional<String> createdBy) {
+        var tasks = tasksService.search(status, createdBy);
+
+        return tasks.stream()
+                .map(this::buildResponse)
+                .collect(Collectors.toList());
+    }
+
+    @GetMapping("/{id}")
+    public TaskResponse getTask(@PathVariable("id") String id) {
+        var task = tasksService.getTaskById(id);
+        return buildResponse(task);
+    }
+
+    @DeleteMapping("/{id}")
+    public void deleteTask(@PathVariable("id") String id) {
+        tasksService.deleteTaskById(id);
+    }
+
+    @PatchMapping("/{id}")
+    public TaskResponse patchTask(@PathVariable("id") String id,
+            @RequestBody PatchTaskRequest body) {
+        var task = tasksService.updateTask(id, body.status(), body.assignedTo());
+
+        return buildResponse(task);
+    }
+
+    private TaskResponse buildResponse(final TaskRecord task) {
+        return new TaskResponse(task.getId(), task.getTitle(), task.getCreated(), task.getCreatedBy(),
+                task.getAssignedTo(), task.getStatus());
+    }
+
+    @ExceptionHandler(UnknownTaskException.class)
+    @ResponseStatus(HttpStatus.NOT_FOUND)
+    public void handleUnknownTask() {
+    }
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/http/http-client.env.json

@@ -0,0 +1,5 @@
+{
+  "local-tasks": {
+    "host": "localhost:8082"
+  }
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/http/tasks.http

@@ -0,0 +1,35 @@
+GET http://{{host}}/createdemoapplication1 HTTP/1.1
+
+###
+GET http://{{host}}/unknown HTTP/1.1
+
+###
+GET http://{{host}}?status=PENDING
+
+###
+GET http://{{host}}?createdBy=baeldung
+
+###
+GET http://{{host}}?createdBy=baeldung&status=COMPLETE
+
+###
+DELETE http://{{host}}/createdemoapplication1 HTTP/1.1
+
+###
+DELETE http://{{host}}/unknown HTTP/1.1
+
+###
+POST http://{{host}} HTTP/1.1
+Content-Type: application/json
+
+{
+  "title": "My Task",
+  "createdBy": "graham"
+}
+###
+PATCH http://{{host}}/createdemoapplication1 HTTP/1.1
+Content-Type: application/json
+
+{
+  "status": "COMPLETE"
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/jms/JmsConsumer.java

@@ -0,0 +1,18 @@
+package com.baeldung.tasksservice.adapters.jms;
+
+import org.springframework.stereotype.Service;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.jms.annotation.JmsListener;
+
+import com.baeldung.tasksservice.service.DeletedUserService;
+
+@Service
+public class JmsConsumer {
+    @Autowired
+    private DeletedUserService deletedUserService;
+
+    @JmsListener(destination = "deleted_user")
+    public void receive(String user) {
+        deletedUserService.handleDeletedUser(user);
+    }
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/repository/TaskRecord.java

@@ -0,0 +1,80 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.adapters.repository;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.Id;
+import javax.persistence.Table;
+import java.time.Instant;
+
+@Entity
+@Table(name = "tasks")
+public class TaskRecord {
+    @Id
+    @Column(name = "task_id")
+    private String id;
+    private String title;
+    @Column(name = "created_at")
+    private Instant created;
+    @Column(name = "created_by")
+    private String createdBy;
+    @Column(name = "assigned_to")
+    private String assignedTo;
+    private String status;
+
+    public TaskRecord(final String id, final String title, final Instant created, final String createdBy,
+        final String assignedTo, final String status) {
+        this.id = id;
+        this.title = title;
+        this.created = created;
+        this.createdBy = createdBy;
+        this.assignedTo = assignedTo;
+        this.status = status;
+    }
+
+    private TaskRecord() {
+        // Needed for JPA
+    }
+
+    public String getId() {
+        return id;
+    }
+
+    public String getTitle() {
+        return title;
+    }
+
+    public Instant getCreated() {
+        return created;
+    }
+
+    public String getCreatedBy() {
+        return createdBy;
+    }
+
+    public String getAssignedTo() {
+        return assignedTo;
+    }
+
+    public String getStatus() {
+        return status;
+    }
+
+    public void setAssignedTo(final String assignedTo) {
+        this.assignedTo = assignedTo;
+    }
+
+    public void setStatus(final String status) {
+        this.status = status;
+    }
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/adapters/repository/TasksRepository.java

@@ -0,0 +1,28 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.adapters.repository;
+
+import java.util.List;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface TasksRepository extends JpaRepository<TaskRecord, String> {
+    List<TaskRecord> findByStatus(String status);
+
+    List<TaskRecord> findByCreatedBy(String createdBy);
+
+    List<TaskRecord> findByStatusAndCreatedBy(String status, String createdBy);
+
+    List<TaskRecord> findByAssignedTo(String assignedTo);
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/service/DeletedUserService.java

@@ -0,0 +1,27 @@
+package com.baeldung.tasksservice.service;
+
+import javax.transaction.Transactional;
+
+import com.baeldung.tasksservice.adapters.repository.TaskRecord;
+import com.baeldung.tasksservice.adapters.repository.TasksRepository;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+@Service
+public class DeletedUserService {
+  @Autowired
+  private TasksRepository tasksRepository;
+
+  @Transactional
+  public void handleDeletedUser(String user) {
+    var ownedByUser = tasksRepository.findByCreatedBy(user);
+    tasksRepository.deleteAll(ownedByUser);
+
+    var assignedToUser = tasksRepository.findByAssignedTo(user);
+    for (TaskRecord record : assignedToUser) {
+      record.setAssignedTo(null);
+      record.setStatus("PENDING");
+    }
+  }
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/service/TasksService.java

@@ -0,0 +1,72 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.service;
+
+import javax.transaction.Transactional;
+import java.time.Instant;
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+
+import com.baeldung.tasksservice.adapters.repository.TaskRecord;
+import com.baeldung.tasksservice.adapters.repository.TasksRepository;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+@Service
+public class TasksService {
+    @Autowired
+    private TasksRepository tasksRepository;
+
+    public TaskRecord getTaskById(String id) {
+        return tasksRepository.findById(id).orElseThrow(() -> new UnknownTaskException(id));
+    }
+
+    @Transactional
+    public void deleteTaskById(String id) {
+        var task = tasksRepository.findById(id).orElseThrow(() -> new UnknownTaskException(id));
+        tasksRepository.delete(task);
+    }
+
+    public List<TaskRecord> search(Optional<String> createdBy, Optional<String> status) {
+        if (createdBy.isPresent() && status.isPresent()) {
+            return tasksRepository.findByStatusAndCreatedBy(status.get(), createdBy.get());
+        } else if (createdBy.isPresent()) {
+            return tasksRepository.findByCreatedBy(createdBy.get());
+        } else if (status.isPresent()) {
+            return tasksRepository.findByStatus(status.get());
+        } else {
+            return tasksRepository.findAll();
+        }
+    }
+
+    @Transactional
+    public TaskRecord updateTask(String id, Optional<String> newStatus, Optional<String> newAssignedTo) {
+        var task = tasksRepository.findById(id).orElseThrow(() -> new UnknownTaskException(id));
+
+        newStatus.ifPresent(task::setStatus);
+        newAssignedTo.ifPresent(task::setAssignedTo);
+
+        return task;
+    }
+
+    public TaskRecord createTask(String title, String createdBy) {
+        var task = new TaskRecord(UUID.randomUUID().toString(),
+                title,
+                Instant.now(),
+                createdBy,
+                null,
+                "PENDING");
+        tasksRepository.save(task);
+        return task;
+    }
+}

lightrun/tasks-service/src/main/java/com/baeldung/tasksservice/service/UnknownTaskException.java

@@ -0,0 +1,24 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.tasksservice.service;
+
+public class UnknownTaskException extends RuntimeException {
+    private final String id;
+
+    public UnknownTaskException(final String id) {
+        this.id = id;
+    }
+
+    public String getId() {
+        return id;
+    }
+}

lightrun/tasks-service/src/main/resources/application.properties

@@ -0,0 +1,13 @@
+server.port=8082
+
+spring.artemis.mode=EMBEDDED
+spring.artemis.host=localhost
+spring.artemis.port=61616
+
+spring.artemis.embedded.enabled=true
+
+spring.jms.template.default-destination=my-queue-1
+
+logging.level.org.apache.activemq.audit.base=WARN
+logging.level.org.apache.activemq.audit.message=WARN
+

lightrun/tasks-service/src/main/resources/db/migration/V1_0_0__create-tasks-table.sql

@@ -0,0 +1,13 @@
+CREATE TABLE tasks (
+    task_id VARCHAR(36) PRIMARY KEY,
+    title VARCHAR(100) NOT NULL,
+    created_at DATETIME NOT NULL,
+    created_by VARCHAR(36) NOT NULL,
+    assigned_to VARCHAR(36) NULL,
+    status VARCHAR(20) NOT NULL
+);
+
+INSERT INTO tasks(task_id, title, created_at, created_by, assigned_to, status) VALUES
+    ('createdemoapplication1', 'Create demo applications - Tasks', '2022-05-05 12:34:56', 'baeldung', 'coxg', 'IN_PROGRESS'),
+    ('createdemoapplication2', 'Create demo applications - Users', '2022-05-05 12:34:56', 'baeldung', NULL, 'PENDING'),
+    ('createdemoapplication3', 'Create demo applications - API', '2022-05-05 12:34:56', 'baeldung', NULL, 'PENDING');

lightrun/users-service/.gitignore

@@ -0,0 +1,33 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/

lightrun/users-service/README.md

@@ -0,0 +1,29 @@
+# Lightrun Example Application - Tasks Management
+
+This application exists as an example for the Lightrun series of articles.
+
+## Building
+This application requires [Apache Maven](https://maven.apache.org/) and [Java 17+](https://www.oracle.com/java/technologies/downloads/). It does use the Maven Wrapper, so it can be built with only Java available on the path.
+
+As such, building the code is done by executing:
+```
+$ ./mvnw install
+```
+from the top level.
+
+## Running
+The application consists of three services:
+* Tasks
+* Users
+* API
+
+These are all Spring Boot applications.
+
+The Tasks and Users services exist as microservices for managing one facet of data. Each uses a database, and utilise a JMS queue between them as well. For convenience this infrastructure is all embedded in the applications.
+
+This does mean that the startup order is important. The JMS queue exists within the Tasks service and is connected to from the Users service. As such, the Tasks service must be started before the others.
+
+Each service can be started either by executing `mvn spring-boot:run` from within the appropriate directory. Alternatively, as Spring Boot applications, the build will produce an executable JAR file within the `target` directory that can be executed as, for example:
+```
+$ java -jar ./target/tasks-service-0.0.1-SNAPSHOT.jar
+```

lightrun/users-service/pom.xml

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>2.6.7</version>
+		<relativePath/> <!-- lookup parent from repository -->
+	</parent>
+	<groupId>com.baeldung</groupId>
+	<artifactId>users-service</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+	<name>users-service</name>
+	<description>Users Service for LightRun Article</description>
+	<properties>
+		<java.version>17</java.version>
+	</properties>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-actuator</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-artemis</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-jpa</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.flywaydb</groupId>
+			<artifactId>flyway-core</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>com.h2database</groupId>
+			<artifactId>h2</artifactId>
+			<scope>runtime</scope>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

lightrun/users-service/src/main/java/com/baeldung/usersservice/JmsConfig.java

@@ -0,0 +1,29 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.jms.support.converter.MappingJackson2MessageConverter;
+import org.springframework.jms.support.converter.MessageConverter;
+import org.springframework.jms.support.converter.MessageType;
+
+@Configuration
+public class JmsConfig {
+    @Bean
+    public MessageConverter jacksonJmsMessageConverter() {
+        MappingJackson2MessageConverter converter = new MappingJackson2MessageConverter();
+        converter.setTargetType(MessageType.TEXT);
+        converter.setTypeIdPropertyName("_type");
+        return converter;
+    }
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/UsersServiceApplication.java

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

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/http/CreateUserRequest.java

@@ -0,0 +1,15 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.adapters.http;
+
+public record CreateUserRequest(String name) {
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/http/PatchUserRequest.java

@@ -0,0 +1,17 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.adapters.http;
+
+import java.util.Optional;
+
+public record PatchUserRequest(Optional<String> name) {
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/http/UserResponse.java

@@ -0,0 +1,16 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.adapters.http;
+
+public record UserResponse(String id,
+                           String name) {
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/http/UsersController.java

@@ -0,0 +1,69 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.adapters.http;
+
+import com.baeldung.usersservice.adapters.repository.UserRecord;
+import com.baeldung.usersservice.service.UsersService;
+import com.baeldung.usersservice.service.UnknownUserException;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/")
+class UsersController {
+    @Autowired
+    private UsersService usersService;
+
+    @GetMapping("/{id}")
+    public UserResponse getUser(@PathVariable("id") String id) {
+        var user = usersService.getUserById(id);
+        return buildResponse(user);
+    }
+
+    @DeleteMapping("/{id}")
+    public void deleteUser(@PathVariable("id") String id) {
+        usersService.deleteUserById(id);
+    }
+
+    @PostMapping
+    @ResponseStatus(HttpStatus.CREATED)
+    public UserResponse createUser(@RequestBody CreateUserRequest body) {
+        var user = usersService.createUser(body.name());
+        return buildResponse(user);
+    }
+    
+    @PatchMapping("/{id}")
+    public UserResponse patchUser(@PathVariable("id") String id,
+        @RequestBody PatchUserRequest body) {
+        var user = usersService.updateUser(id, body.name());
+
+        return buildResponse(user);
+    }
+    private UserResponse buildResponse(final UserRecord user) {
+        return new UserResponse(user.getId(), user.getName());
+    }
+
+    @ExceptionHandler(UnknownUserException.class)
+    @ResponseStatus(HttpStatus.NOT_FOUND)
+    public void handleUnknownUser() {
+    }
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/http/http-client.env.json

@@ -0,0 +1,5 @@
+{
+  "local-users": {
+    "host": "localhost:8081"
+  }
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/http/users.http

@@ -0,0 +1,25 @@
+GET http://{{host}}/baeldung HTTP/1.1
+
+###
+GET http://{{host}}/unknown HTTP/1.1
+
+###
+DELETE http://{{host}}/baeldung HTTP/1.1
+
+###
+DELETE http://{{host}}/unknown HTTP/1.1
+
+###
+POST http://{{host}} HTTP/1.1
+Content-Type: application/json
+
+{
+  "name": "Testing"
+}
+###
+PATCH http://{{host}}/coxg HTTP/1.1
+Content-Type: application/json
+
+{
+  "name": "Test Name"
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/jms/JmsSender.java

@@ -0,0 +1,26 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.adapters.jms;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.jms.core.JmsTemplate;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public class JmsSender {
+    @Autowired
+    private JmsTemplate jmsTemplate;
+
+    public void sendDeleteUserMessage(String userId) {
+        jmsTemplate.convertAndSend("deleted_user", userId);
+    }
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/repository/UserRecord.java

@@ -0,0 +1,47 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.adapters.repository;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.Id;
+import javax.persistence.Table;
+
+@Entity
+@Table(name = "users")
+public class UserRecord {
+    @Id
+    @Column(name = "user_id")
+    private String id;
+    private String name;
+
+    public UserRecord(final String id, final String name) {
+        this.id = id;
+        this.name = name;
+    }
+
+    private UserRecord() {
+        // Needed for JPA
+    }
+
+    public String getId() {
+        return id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(final String name) {
+        this.name = name;
+    }
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/adapters/repository/UsersRepository.java

@@ -0,0 +1,19 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.adapters.repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface UsersRepository extends JpaRepository<UserRecord, String> {
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/service/UnknownUserException.java

@@ -0,0 +1,24 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.service;
+
+public class UnknownUserException extends RuntimeException {
+    private final String id;
+
+    public UnknownUserException(final String id) {
+        this.id = id;
+    }
+
+    public String getId() {
+        return id;
+    }
+}

lightrun/users-service/src/main/java/com/baeldung/usersservice/service/UsersService.java

@@ -0,0 +1,61 @@
+/****************************************************************************************************************
+ *
+ *  Copyright (c) 2022 OCLC, Inc. All Rights Reserved.
+ *
+ *  OCLC proprietary information: the enclosed materials contain
+ *  proprietary information of OCLC, Inc. and shall not be disclosed in whole or in
+ *  any part to any third party or used by any person for any purpose, without written
+ *  consent of OCLC, Inc.  Duplication of any portion of these materials shall include this notice.
+ *
+ ******************************************************************************************************************/
+
+package com.baeldung.usersservice.service;
+
+import javax.transaction.Transactional;
+
+import java.time.Instant;
+import java.util.Optional;
+import java.util.UUID;
+
+import com.baeldung.usersservice.adapters.jms.JmsSender;
+import com.baeldung.usersservice.adapters.repository.UserRecord;
+import com.baeldung.usersservice.adapters.repository.UsersRepository;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.jms.core.JmsTemplate;
+import org.springframework.stereotype.Service;
+
+@Service
+public class UsersService {
+    @Autowired
+    private UsersRepository usersRepository;
+
+    @Autowired
+    private JmsSender jmsSender;
+
+    public UserRecord getUserById(String id) {
+        return usersRepository.findById(id).orElseThrow(() -> new UnknownUserException(id));
+    }
+
+    @Transactional
+    public void deleteUserById(String id) {
+        var user = usersRepository.findById(id).orElseThrow(() -> new UnknownUserException(id));
+        usersRepository.delete(user);
+
+        jmsSender.sendDeleteUserMessage(id);
+    }
+
+    @Transactional
+    public UserRecord updateUser(String id, Optional<String> newName) {
+        var user = usersRepository.findById(id).orElseThrow(() -> new UnknownUserException(id));
+
+        newName.ifPresent(user::setName);
+
+        return user;
+    }
+
+    public UserRecord createUser(String name) {
+        var user = new UserRecord(UUID.randomUUID().toString(), name);
+        usersRepository.save(user);
+        return user;
+    }
+}

lightrun/users-service/src/main/resources/application.properties

@@ -0,0 +1,10 @@
+server.port=8081
+
+spring.artemis.host=localhost
+spring.artemis.port=61616
+
+spring.jms.template.default-destination=my-queue-1
+
+logging.level.org.apache.activemq.audit.base=WARN
+logging.level.org.apache.activemq.audit.message=WARN
+

lightrun/users-service/src/main/resources/db/migration/V1_0_0__create-users-table.sql

@@ -0,0 +1,8 @@
+CREATE TABLE users (
+    user_id VARCHAR(36) PRIMARY KEY,
+    name VARCHAR(100) NOT NULL
+);
+
+INSERT INTO users(user_id, name) VALUES
+    ('baeldung', 'Baeldung'),
+    ('coxg', 'Graham');

pom.xml

@@ -1329,6 +1329,7 @@
                  <module>spring-boot-modules/spring-boot-camel</module>	 
                  <module>testing-modules/testing-assertions</module>
                  <module>persistence-modules/fauna</module>
+                 <module>lightrun</module>
             </modules>
         </profile>
 
@@ -1396,6 +1397,7 @@
                 <module>spring-boot-modules/spring-boot-camel</module>
                 <module>testing-modules/testing-assertions</module>
                 <module>persistence-modules/fauna</module>
+                <module>lightrun</module>
             </modules>
         </profile>
     </profiles>