Merge branch 'master' of https://github.com/JonCook/tutorials

spring-boot-client/.gitignore

@@ -0,0 +1,5 @@
+/target/
+.settings/
+.classpath
+.project
+

spring-boot-client/README.MD

@@ -0,0 +1,11 @@
+## Spring Boot Client
+
+This module contains articles about Spring Boot Clients
+
+### The Course
+The "REST With Spring" Classes: http://bit.ly/restwithspring
+
+### Relevant Articles:
+
+- [Quick Guide to @RestClientTest in Spring Boot](https://www.baeldung.com/restclienttest-in-spring-boot)
+- [A Java Client for a WebSockets API](https://www.baeldung.com/websockets-api-java-spring-client)

spring-boot-client/pom.xml

@@ -0,0 +1,141 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>com.baeldung</groupId>
+    <artifactId>spring-boot-client</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>spring-boot-client</name>
+    <packaging>war</packaging>
+    <description>This is simple boot client application for Spring boot actuator test</description>
+
+    <parent>
+        <artifactId>parent-boot-2</artifactId>
+        <groupId>com.baeldung</groupId>
+        <version>0.0.1-SNAPSHOT</version>
+        <relativePath>../parent-boot-2</relativePath>
+    </parent>
+
+    <dependencies>
+        
+        <!-- JUnit Jupiter dependencies -->
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <!-- JUnit platform launcher -->
+        <!-- To be able to run tests from IDE directly -->
+        <dependency>
+            <groupId>org.junit.platform</groupId>
+            <artifactId>junit-platform-launcher</artifactId>
+            <version>${junit-platform.version}</version>
+            <scope>test</scope>
+        </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>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.google.guava</groupId>
+            <artifactId>guava</artifactId>
+            <version>${guava.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-websocket</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-messaging</artifactId>
+        </dependency>
+
+    </dependencies>
+
+    <build>
+        <finalName>spring-boot-client</finalName>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+
+        <plugins>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-war-plugin</artifactId>
+            </plugin>
+
+            <plugin>
+                <groupId>pl.project13.maven</groupId>
+                <artifactId>git-commit-id-plugin</artifactId>
+                <version>${git-commit-id-plugin.version}</version>
+            </plugin>
+
+        </plugins>
+
+    </build>
+
+    <profiles>
+        <profile>
+            <id>autoconfiguration</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-surefire-plugin</artifactId>
+                        <executions>
+                            <execution>
+                                <phase>integration-test</phase>
+                                <goals>
+                                    <goal>test</goal>
+                                </goals>
+                                <configuration>
+                                    <excludes>
+                                        <exclude>**/*LiveTest.java</exclude>
+                                        <exclude>**/*IntegrationTest.java</exclude>
+                                        <exclude>**/*IntTest.java</exclude>
+                                    </excludes>
+                                    <includes>
+                                        <include>**/AutoconfigurationTest.java</include>
+                                    </includes>
+                                </configuration>
+                            </execution>
+                        </executions>
+                        <configuration>
+                            <systemPropertyVariables>
+                                <test.mime>json</test.mime>
+                            </systemPropertyVariables>
+                        </configuration>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
+
+    <properties>
+        <guava.version>18.0</guava.version>
+		<junit-platform.version>1.2.0</junit-platform.version>
+		<git-commit-id-plugin.version>2.2.4</git-commit-id-plugin.version>
+    </properties>
+
+</project>

spring-boot-client/src/main/java/org/baeldung/boot/Application.java

@@ -0,0 +1,14 @@
+package org.baeldung.boot;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.ApplicationContext;
+
+@SpringBootApplication
+public class Application {
+    private static ApplicationContext applicationContext;
+
+    public static void main(String[] args) {
+        applicationContext = SpringApplication.run(Application.class, args);
+    }
+}

spring-boot-client/src/main/java/org/baeldung/boot/client/Details.java

@@ -0,0 +1,32 @@
+package org.baeldung.boot.client;
+
+public class Details {
+
+    private String name;
+
+    private String login;
+
+    public Details() {
+    }
+
+    public Details(String name, String login) {
+        this.name = name;
+        this.login = login;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getLogin() {
+        return login;
+    }
+
+    public void setLogin(String login) {
+        this.login = login;
+    }
+}

spring-boot-client/src/main/java/org/baeldung/boot/client/DetailsServiceClient.java

@@ -0,0 +1,20 @@
+package org.baeldung.boot.client;
+
+import org.springframework.boot.web.client.RestTemplateBuilder;
+import org.springframework.stereotype.Service;
+import org.springframework.web.client.RestTemplate;
+
+@Service
+public class DetailsServiceClient {
+
+    private final RestTemplate restTemplate;
+
+    public DetailsServiceClient(RestTemplateBuilder restTemplateBuilder) {
+        restTemplate = restTemplateBuilder.build();
+    }
+
+    public Details getUserDetails(String name) {
+        return restTemplate.getForObject("/{name}/details", Details.class, name);
+    }
+
+}

spring-boot-client/src/main/java/org/baeldung/websocket/client/Message.java

@@ -0,0 +1,24 @@
+package org.baeldung.websocket.client;
+
+public class Message {
+
+    private String from;
+    private String text;
+
+    public String getText() {
+        return text;
+    }
+
+    public String getFrom() {
+        return from;
+    }
+
+    public void setFrom(String from) {
+        this.from = from;
+    }
+
+    public void setText(String text) {
+        this.text = text;
+    }
+
+}

spring-boot-client/src/main/java/org/baeldung/websocket/client/MyStompSessionHandler.java

@@ -0,0 +1,59 @@
+package org.baeldung.websocket.client;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.springframework.messaging.simp.stomp.StompCommand;
+import org.springframework.messaging.simp.stomp.StompHeaders;
+import org.springframework.messaging.simp.stomp.StompSession;
+import org.springframework.messaging.simp.stomp.StompSessionHandlerAdapter;
+
+import java.lang.reflect.Type;
+
+/**
+ * This class is an implementation for <code>StompSessionHandlerAdapter</code>.
+ * Once a connection is established, We subscribe to /topic/messages and 
+ * send a sample message to server.
+ * 
+ * @author Kalyan
+ *
+ */
+public class MyStompSessionHandler extends StompSessionHandlerAdapter {
+
+    private Logger logger = LogManager.getLogger(MyStompSessionHandler.class);
+
+    @Override
+    public void afterConnected(StompSession session, StompHeaders connectedHeaders) {
+        logger.info("New session established : " + session.getSessionId());
+        session.subscribe("/topic/messages", this);
+        logger.info("Subscribed to /topic/messages");
+        session.send("/app/chat", getSampleMessage());
+        logger.info("Message sent to websocket server");
+    }
+
+    @Override
+    public void handleException(StompSession session, StompCommand command, StompHeaders headers, byte[] payload, Throwable exception) {
+        logger.error("Got an exception", exception);
+    }
+
+    @Override
+    public Type getPayloadType(StompHeaders headers) {
+        return Message.class;
+    }
+
+    @Override
+    public void handleFrame(StompHeaders headers, Object payload) {
+        Message msg = (Message) payload;
+        logger.info("Received : " + msg.getText() + " from : " + msg.getFrom());
+    }
+
+    /**
+     * A sample message instance.
+     * @return instance of <code>Message</code>
+     */
+    private Message getSampleMessage() {
+        Message msg = new Message();
+        msg.setFrom("Nicky");
+        msg.setText("Howdy!!");
+        return msg;
+    }
+}

spring-boot-client/src/main/java/org/baeldung/websocket/client/StompClient.java

@@ -0,0 +1,30 @@
+package org.baeldung.websocket.client;
+
+import java.util.Scanner;
+
+import org.springframework.messaging.converter.MappingJackson2MessageConverter;
+import org.springframework.messaging.simp.stomp.StompSessionHandler;
+import org.springframework.web.socket.client.WebSocketClient;
+import org.springframework.web.socket.client.standard.StandardWebSocketClient;
+import org.springframework.web.socket.messaging.WebSocketStompClient;
+
+/**
+ * Stand alone WebSocketStompClient.
+ *
+ */
+public class StompClient {
+
+    private static String URL = "ws://localhost:8080/spring-mvc-java/chat";
+
+    public static void main(String[] args) {
+        WebSocketClient client = new StandardWebSocketClient();
+        WebSocketStompClient stompClient = new WebSocketStompClient(client);
+
+        stompClient.setMessageConverter(new MappingJackson2MessageConverter());
+
+        StompSessionHandler sessionHandler = new MyStompSessionHandler();
+        stompClient.connect(URL, sessionHandler);
+
+        new Scanner(System.in).nextLine(); // Don't close immediately.
+    }
+}

spring-boot-client/src/main/resources/logback.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
+            </pattern>
+        </encoder>
+    </appender>
+
+    <logger name="org.springframework" level="WARN" />
+    <logger name="org.springframework.transaction" level="WARN" />
+
+    <!-- in order to debug some marshalling issues, this needs to be TRACE -->
+    <logger name="org.springframework.web.servlet.mvc" level="WARN" />
+
+    <root level="INFO">
+        <appender-ref ref="STDOUT" />
+    </root>
+</configuration>

spring-boot-client/src/test/java/com/baeldung/websocket/client/MyStompSessionHandlerIntegrationTest.java

@@ -0,0 +1,20 @@
+package com.baeldung.websocket.client;
+
+import org.baeldung.websocket.client.MyStompSessionHandler;
+import org.junit.Test;
+import org.mockito.Mockito;
+import org.springframework.messaging.simp.stomp.StompHeaders;
+import org.springframework.messaging.simp.stomp.StompSession;
+
+public class MyStompSessionHandlerIntegrationTest {
+
+    @Test
+    public void givenValidSession_whenConnected_SendsMessage() {
+        StompSession mockSession = Mockito.mock(StompSession.class);
+        StompHeaders mockHeader = Mockito.mock(StompHeaders.class);
+        MyStompSessionHandler sessionHandler = new MyStompSessionHandler();
+        sessionHandler.afterConnected(mockSession, mockHeader);
+        Mockito.verify(mockSession).subscribe("/topic/messages", sessionHandler);
+        Mockito.verify(mockSession).send(Mockito.anyString(), Mockito.anyObject());
+    }
+}

spring-boot-client/src/test/java/org/baeldung/SpringContextIntegrationTest.java

@@ -0,0 +1,16 @@
+package org.baeldung;
+
+import org.baeldung.boot.Application;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.junit4.SpringRunner;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest(classes = Application.class)
+public class SpringContextIntegrationTest {
+
+    @Test
+    public void whenSpringContextIsBootstrapped_thenNoExceptions() {
+    }
+}

spring-boot-client/src/test/java/org/baeldung/SpringContextTest.java

@@ -0,0 +1,16 @@
+package org.baeldung;
+
+import org.baeldung.boot.Application;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.junit4.SpringRunner;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest(classes = Application.class)
+public class SpringContextTest {
+
+    @Test
+    public void whenSpringContextIsBootstrapped_thenNoExceptions() {
+    }
+}

spring-boot-client/src/test/java/org/baeldung/boot/client/DetailsServiceClientIntegrationTest.java

@@ -0,0 +1,49 @@
+package org.baeldung.boot.client;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.springframework.test.web.client.match.MockRestRequestMatchers.requestTo;
+import static org.springframework.test.web.client.response.MockRestResponseCreators.withSuccess;
+
+import org.baeldung.boot.Application;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.client.RestClientTest;
+import org.springframework.http.MediaType;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.test.web.client.MockRestServiceServer;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+@RunWith(SpringRunner.class)
+@RestClientTest({ DetailsServiceClient.class, Application.class })
+public class DetailsServiceClientIntegrationTest {
+
+    @Autowired
+    private DetailsServiceClient client;
+
+    @Autowired
+    private MockRestServiceServer server;
+
+    @Autowired
+    private ObjectMapper objectMapper;
+
+    @Before
+    public void setUp() throws Exception {
+        String detailsString = objectMapper.writeValueAsString(new Details("John Smith", "john"));
+        this.server.expect(requestTo("/john/details"))
+            .andRespond(withSuccess(detailsString, MediaType.APPLICATION_JSON));
+    }
+
+    @Test
+    public void whenCallingGetUserDetails_thenClientExecutesCorrectCall() throws Exception {
+
+        Details details = this.client.getUserDetails("john");
+
+        assertThat(details.getLogin()).isEqualTo("john");
+        assertThat(details.getName()).isEqualTo("John Smith");
+
+    }
+
+}