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

feign/README.md

@@ -0,0 +1,8 @@
+## Feign
+
+This module contains articles about Feign
+
+### Relevant Articles:
+
+- [Intro to Feign](https://www.baeldung.com/intro-to-feign)
+

feign/pom.xml

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+    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.feign</groupId>
+    <artifactId>feign</artifactId>
+	<name>feign</name>
+
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>parent-modules</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+        <relativePath>..</relativePath>
+    </parent>
+
+    <dependencies>
+        <dependency>
+            <groupId>io.github.openfeign</groupId>
+            <artifactId>feign-core</artifactId>
+            <version>${feign.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>io.github.openfeign</groupId>
+            <artifactId>feign-okhttp</artifactId>
+            <version>${feign.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>io.github.openfeign</groupId>
+            <artifactId>feign-gson</artifactId>
+            <version>${feign.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>io.github.openfeign</groupId>
+            <artifactId>feign-slf4j</artifactId>
+            <version>${feign.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>${lombok.version}</version>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <pluginManagement>
+            <plugins>
+                <plugin>
+                    <groupId>org.springframework.boot</groupId>
+                    <artifactId>spring-boot-maven-plugin</artifactId>
+                    <version>${spring-boot-maven-plugin.version}</version>
+                </plugin>
+            </plugins>
+        </pluginManagement>
+    </build>
+
+    <properties>
+        <feign.version>9.4.0</feign.version>
+        <spring-boot-maven-plugin.version>1.4.2.RELEASE</spring-boot-maven-plugin.version>
+    </properties>
+
+</project>

feign/src/main/java/com/baeldung/feign/BookControllerFeignClientBuilder.java

@@ -0,0 +1,25 @@
+package com.baeldung.feign;
+
+import com.baeldung.feign.clients.BookClient;
+import feign.Feign;
+import feign.Logger;
+import feign.gson.GsonDecoder;
+import feign.gson.GsonEncoder;
+import feign.okhttp.OkHttpClient;
+import feign.slf4j.Slf4jLogger;
+import lombok.Getter;
+
+@Getter
+public class BookControllerFeignClientBuilder {
+    private BookClient bookClient = createClient(BookClient.class, "http://localhost:8081/api/books");
+
+    private static <T> T createClient(Class<T> type, String uri) {
+        return Feign.builder()
+            .client(new OkHttpClient())
+            .encoder(new GsonEncoder())
+            .decoder(new GsonDecoder())
+            .logger(new Slf4jLogger(type))
+            .logLevel(Logger.Level.FULL)
+            .target(type, uri);
+    }
+}

feign/src/main/java/com/baeldung/feign/clients/BookClient.java

@@ -0,0 +1,21 @@
+package com.baeldung.feign.clients;
+
+import com.baeldung.feign.models.Book;
+import com.baeldung.feign.models.BookResource;
+import feign.Headers;
+import feign.Param;
+import feign.RequestLine;
+
+import java.util.List;
+
+public interface BookClient {
+    @RequestLine("GET /{isbn}")
+    BookResource findByIsbn(@Param("isbn") String isbn);
+
+    @RequestLine("GET")
+    List<BookResource> findAll();
+
+    @RequestLine("POST")
+    @Headers("Content-Type: application/json")
+    void create(Book book);
+}

feign/src/main/java/com/baeldung/feign/models/Book.java

@@ -0,0 +1,18 @@
+package com.baeldung.feign.models;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+@Data
+@ToString
+@NoArgsConstructor
+@AllArgsConstructor
+public class Book {
+    private String isbn;
+    private String author;
+    private String title;
+    private String synopsis;
+    private String language;
+}

feign/src/main/java/com/baeldung/feign/models/BookResource.java

@@ -0,0 +1,14 @@
+package com.baeldung.feign.models;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+@Data
+@ToString
+@NoArgsConstructor
+@AllArgsConstructor
+public class BookResource {
+    private Book book;
+}

feign/src/main/resources/logback.xml

@@ -0,0 +1,13 @@
+<?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>
+
+    <root level="INFO">
+        <appender-ref ref="STDOUT" />
+    </root>
+</configuration>

feign/src/test/java/com/baeldung/feign/clients/BookClientLiveTest.java

@@ -0,0 +1,65 @@
+package com.baeldung.feign.clients;
+
+import com.baeldung.feign.BookControllerFeignClientBuilder;
+import com.baeldung.feign.models.Book;
+import com.baeldung.feign.models.BookResource;
+import lombok.extern.slf4j.Slf4j;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+
+import java.util.List;
+import java.util.UUID;
+import java.util.stream.Collectors;
+
+import static org.hamcrest.CoreMatchers.containsString;
+import static org.hamcrest.CoreMatchers.is;
+import static org.junit.Assert.assertThat;
+import static org.junit.Assert.assertTrue;
+
+/**
+ * Consumes https://github.com/Baeldung/spring-hypermedia-api
+ */
+@Slf4j
+@RunWith(JUnit4.class)
+public class BookClientLiveTest {
+    private BookClient bookClient;
+
+    @Before
+    public void setup() {
+        BookControllerFeignClientBuilder feignClientBuilder = new BookControllerFeignClientBuilder();
+        bookClient = feignClientBuilder.getBookClient();
+    }
+
+    @Test
+    public void givenBookClient_shouldRunSuccessfully() throws Exception {
+        List<Book> books = bookClient.findAll()
+            .stream()
+            .map(BookResource::getBook)
+            .collect(Collectors.toList());
+        assertTrue(books.size() > 2);
+        log.info("{}", books);
+    }
+
+    @Test
+    public void givenBookClient_shouldFindOneBook() throws Exception {
+        Book book = bookClient.findByIsbn("0151072558")
+            .getBook();
+        assertThat(book.getAuthor(), containsString("Orwell"));
+        log.info("{}", book);
+    }
+
+    @Test
+    public void givenBookClient_shouldPostBook() throws Exception {
+        String isbn = UUID.randomUUID()
+            .toString();
+        Book book = new Book(isbn, "Me", "It's me!", null, null);
+        bookClient.create(book);
+
+        book = bookClient.findByIsbn(isbn)
+            .getBook();
+        assertThat(book.getAuthor(), is("Me"));
+        log.info("{}", book);
+    }
+}