摘要: 原創出處:www.bysocket.com 泥瓦匠BYSocket 希望轉載，保留摘要，謝謝！

“真正的進步，不在於學習，而在於反思”

 
「Spring Cloud Eureka 入門系列」

本文提綱
1.  springcloud-eureka-sample 工程介紹
2. 執行 springcloud-eureka-client-customer 服務消費者工程
3. 詳解 springcloud-eureka-client-customer 服務消費者工程

一、springcloud-eureka-sample 工程介紹
 
還是回到Eureka 叢集簡單架構圖：



第一小節《Spring Cloud Eureka 入門 （一）服務註冊中心詳解》實現了 Eureka Server 作為註冊中心，
第二小節《Spring Cloud Eureka 入門 （二）服務提供者詳解》是 Provider Service B 的案例，實現了 Eureka Cleint 作為服務提供者，包括其服務的註冊和心跳的功能。
本小節，是 Provider Service A 的案例，實現了 Eureka Cleint 作為服務消費者，包括其服務的註冊和心跳的功能，還有其服務發現和通過 Ribbon 進行服務呼叫的功能。

springcloud-eureka-client-customer  服務消費者工程，他本身也是一個服務提供者。即具有服務提供功能和服務消費功能。下面去執行該工程

二、執行 springcloud-eureka-client-customer 服務消費者工程
執行環境：JDK 7 或 8，Maven 3.0+
技術棧：Spring Cloud Dalston.SR1、 spring-cloud-netflix 1.3.1、Spring Boot 1.5.4

自然，我們先得去上一小節《Spring Cloud Eureka 入門 （一）服務註冊中心詳解》 ，把註冊中心工程啟動完畢。

1. git clone 下載工程 springcloud-learning-example
專案地址見 GitHub - https://github.com/JeffLi1993/springcloud-learning-example： 
 
 
2. Maven 編譯安裝這個工程：

cd springcloud-learning-example
mvn clean install

3. 執行 Eureka 工程 springcloud-eureka-client-customer
啟動 springcloud-eureka-client-customer 工程啟動類 CustomerApplication，啟動服務註冊中心工程。
EurekaServerApplication 類路徑：/springcloud-learning-example/springcloud-eureka-sample/springcloud-eureka-client-customer/src/main/java/org/spring/springcloud/CustomerApplication.java
 
控制檯 Console 看到這類資訊，代表啟動成功：

2017
 
-07-12 18:19:21.725  INFO 11314 --- [nfoReplicator-0] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_CUSTOMER-SERVICE/10.18.29.64:customer-service:8081: registering service...
2017-07-12 18:19:21.814  INFO 11314 --- [nfoReplicator-0] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_CUSTOMER-SERVICE/10.18.29.64:customer-service:8081 - registration status: 204
2017-07-12 18:19:21.916  INFO 11314 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8081 (http)
2017-07-12 18:19:21.918  INFO 11314 --- [           main] .s.c.n.e.s.EurekaAutoServiceRegistration : Updating port to 8081
2017-07-12 18:19:21.925  INFO 11314 --- [           main] o.s.springcloud.CustomerApplication      : Started CustomerApplication in 17.075 seconds (JVM running for 18.141)

可以看出，註冊了應用名為 CUSTOMER-SERVICE 的應用，該服務提供者的工程埠為 8081

4. 訪問 Eureka 註冊中心視覺化介面
開啟瀏覽器，訪問 http://localhost:8888/ ，如圖所示：



可以看到，服務提供者向服務註冊中心註冊自己的例項，展示了應用名和埠資訊等。
5.訪問服務消費者案例
開啟瀏覽器，訪問 http://localhost:8081/customer，如圖所示： 
 



可以看出，下面一句訊息 Hello,Provider! ，是服務消費者呼叫服務提供者獲取的資訊。
 

三、詳解 springcloud-eureka-client-customer 服務消費者工程
1.springcloud-eureka-client-customer 工程目錄結構

├── pom.xml
└── src
    └── main
        ├── java
        │   └── org
        │       └── spring
        │           ├── springcloud
        │           │    └──  CustomerApplication.java
        │           └── web
        │                └──  CustomerController.java
        └── resources
            └── application.yml

ProviderApplication.java Eureka Discovery Client 啟動類，啟動服務消費者工程，本身也會註冊到註冊中心，也能發現其他服務。
CustomerController.java 服務消費者 HelloWorld 案例
application.yml 配置檔案
 

2. pom.xml 配置

<?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.0http://maven.apache.org/xsd/ma ... gt%3B
    <modelVersion>4.0.0</modelVersion>
    <groupId>springcloud</groupId>
    <artifactId>springcloud-eureka-client-customer</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>springcloud-eureka-client-customer :: 服務消費者</name>
    <!-- Spring Boot 啟動父依賴 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.4.RELEASE</version>
    </parent>
    <dependencies>
        <!-- Spring Cloud Netflix Eureka 依賴 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka</artifactId>
        </dependency>
        <!-- Spring Boot Test 依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <dependencyManagement>
        <dependencies>
            <!-- Spring Cloud Netflix 依賴 -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-netflix</artifactId>
                <version>1.3.1.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

使用的依賴是
- spring-cloud-netflix 1.3.1 是 Spring Cloud Dalston.SR1 版本。
- spring-cloud-starter-eureka Eureka Client 模組依賴，包含了客戶端 client 的依賴，還有 Ribbon 的依賴，如：org.springframework.cloud:spring-cloud-netflix-eureka-client:1.3.1.RELEASE
org.springframework.cloud:spring-cloud-starter-ribbon:1.3.1.RELEASE
 

3. application.yml 配置

server:
  port: 8081 # 服務埠
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8888/eureka/ # 服務註冊中心地址
spring:
  application:
    name: customer-service # 服務名稱
- server.port 設定工程服務埠
- eureka.client.service-url.defaultZone 設定服務註冊中心地址

4.服務消費者應用啟動類

/**
 * Spring Boot Eureka Server 應用啟動類
 *
 * Created by bysocket on 21/06/17.
 */
@EnableDiscoveryClient // Eureka Discovery Client 標識
@SpringBootApplication // Spring Boot 應用標識
public class CustomerApplication {
    @Bean
    @LoadBalanced
    RestTemplate restTemplate() {
        return new RestTemplate();
    }
    public static void main(String args) {
        // 程式啟動入口
        // 啟動嵌入式的 Tomcat 並初始化 Spring 環境及其各 Spring 元件
        SpringApplication.run(CustomerApplication.class,args);
    }
}

@EnableDiscoveryClient 標誌該應用作為 Eureka Client ，並會自動化讀取 Eureka 相關配置。還有向服務註冊中心發現服務並進行呼叫。
@LoadBalanced 標誌著 RestTemplate 是通過 Ribbon 客戶端負載均衡去呼叫服務提供者叢集的。即可以在獲取的服務提供者例項列表中，通過 Ribbon 進行選擇某例項，然後呼叫該服務例項。

6.服務消費者 Hello World 案例

/**
 * Customer HelloWorld 案例
 * <p>
 * Created by bysocket on 06/22/17.
 */
@RestController
public class CustomerController {
    private static final Logger LOGGER = LoggerFactory.getLogger(CustomerController.class);
    @Autowired
    private RestTemplate restTemplate; // HTTP 訪問操作類
    @RequestMapping("/customer")
    public String customer() {
        String providerMsg = restTemplate.getForEntity("http://PROVIDER-SERVICE/provider",
                String.class).getBody();
        return "Hello,Customer! msg from provider : <br/><br/> " + providerMsg;
    }
}

可以看到注入了 RestTemplate 物件，它是 HTTP 訪問操作類。
然後 customer 方法，通過 restTemplate 通過 HTTP 協議呼叫服務提供者暴露的 provider 介面，並獲取服務提供者的結果。然後組裝輸出。

四、小結
此小章節介紹瞭如何 Eureka 作為服務消費者，並向服務註冊中心註冊自己例項，更重要的是發現其他服務，並呼叫其他服務。 
這是 Spring Cloud Eureka 入門系列完結：