Spring Cloud Eureka 入門（二）服務提供者詳解

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

“優秀不是過去是一種心態”

「Spring Cloud Eureka 入門係列」
Spring Cloud Eureka 入門（一）服務注冊中心詳解
Spring Cloud Eureka 入門（二）服務提供者詳解
Spring Cloud Eureka 入門（三）服務消費者詳解

本文提綱
1. springcloud-eureka-sample 工程結構
2. 運行 springcloud-eureka-client-provider 服務提供者工程
3. 詳解 springcloud-eureka-client-provider 服務提供者工程

一、springcloud-eureka-sample 工程結構
接著上一小節《Spring Cloud Eureka 入門（一）服務注冊中心詳解》，我們成功運行了 Spring Cloud Eureka Server 工程作為服務注冊中心工程。這小節，我們寫一個作為客戶端的服務提供者工程，服務提供者向服務中心注冊或者下線服務實例。即圖中的右側 1 ，2 流程：

springcloud-eureka-sample 工程結構
├── springcloud-eureka-client-customer
├── springcloud-eureka-client-provider
└── springcloud-eureka-server
上麵依次是服務消費者工程、服務提供者工程和服務注冊中心工程。

二、運行 springcloud-eureka-client-provider 服務提供者工程
運行環境：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/ ... ample：
git clone https://github.com/JeffLi1993/ ... e.git
2. Maven 編譯安裝這個工程：
cd springcloud-learning-example
mvn clean install
3. 運行 Eureka 工程 springcloud-eureka-client-provider
啟動 springcloud-eureka-client-provider 工程啟動類 ProviderApplication，啟動服務注冊中心工程。
EurekaServerApplication 類路徑：/springcloud-learning-example/springcloud-eureka-sample/springcloud-eureka-client-provider/src/main/java/org/spring/springcloud/ProviderApplication.java

控製台 Console 看到這類信息，代表啟動成功：
2017-07-10 16:03:15.075  INFO 11020 --- [           main] o.s.c.n.e.s.EurekaServiceRegistry        : Registering application provider-service with eureka with status UP
2017-07-10 16:03:15.075  INFO 11020 --- [           main] com.netflix.discovery.DiscoveryClient    : Saw local status change event StatusChangeEvent [timestamp=1499673795075, current=UP, previous=STARTING]
2017-07-10 16:03:15.079  INFO 11020 --- [nfoReplicator-0] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_PROVIDER-SERVICE/10.18.29.31:provider-service:8080: registering service...
2017-07-10 16:03:15.126  INFO 11020 --- [nfoReplicator-0] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_PROVIDER-SERVICE/10.18.29.31:provider-service:8080 - registration status: 204
2017-07-10 16:03:15.183  INFO 11020 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
2017-07-10 16:03:15.185  INFO 11020 --- [           main] .s.c.n.e.s.EurekaAutoServiceRegistration : Updating port to 8080
2017-07-10 16:03:15.191  INFO 11020 --- [           main] o.s.springcloud.ProviderApplication      : Started ProviderApplication in 9.809 seconds (JVM running for 10.981)
可以看出，注冊了應用名為 provider-service 的應用，該服務提供者的工程端口為 8080

4. 訪問 Eureka 注冊中心可視化界麵
打開瀏覽器，訪問 https://localhost:8888/ ，如圖所示：

可以看到，服務提供者向服務注冊中心注冊自己的實例，展示了應用名和端口信息等。

三、詳解 springcloud-eureka-client-provider 服務提供者工程
1.springcloud-eureka-server 工程目錄結構
├── pom.xml
└── src
    └── main
        ├── java
        │   └── org
        │       └── spring
        │           ├── springcloud
        │           │    └──  ProviderApplication.java
        │           └── web
        │                └──  ProviderController.java
        └── resources
            └── application.yml
ProviderApplication.java Eureka Client 啟動類，啟動服務提供者工程
ProviderApplication.java Provider HelloWorld 案例
application.yml 配置文件

2. pom.xml 配置
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/ma ... gt%3B
    <modelVersion>4.0.0</modelVersion>
    <groupId>springcloud</groupId>
    <artifactId>springcloud-eureka-client-provider</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>springcloud-eureka-client-provider :: 服務提供者</name>
    
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.4.RELEASE</version>
    </parent>
    <dependencies>
        
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka</artifactId>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <dependencyManagement>
        <dependencies>
            
            <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: 8080 # 服務端口
eureka:
  client:
    service-url:
      defaultZone: https://localhost:8888/eureka/ # 服務注冊中心地址
spring:
  application:
    name: provider-service # 服務名稱
- server.port 設置工程服務端口
- eureka.client.service-url.defaultZone 設置服務注冊中心地址

4.注冊中心應用啟動類
/**
 * Spring Boot Eureka Server 應用啟動類
 *
 * Created by bysocket on 21/06/17.
 */
@EnableEurekaClient     // Eureka Client 標識
@SpringBootApplication  // Spring Boot 應用標識
public class ProviderApplication {
    public static void main(String args) {
        // 程序啟動入口
        // 啟動嵌入式的 Tomcat 並初始化 Spring 環境及其各 Spring 組件
        SpringApplication.run(ProviderApplication.class,args);
    }
}
@EnableEurekaClient 標誌該應用作為 Eureka Client ，並會自動化讀取 Eureka 相關配置。

6.服務提供者 Hello World 案例
/**
 * Provider HelloWorld 案例
 * <p>
 * Created by bysocket on 06/22/17.
 */
@RestController
public class ProviderController {
    private static final Logger LOGGER = LoggerFactory.getLogger(ProviderController.class);
    @Autowired
    private Registration registration;       // 服務注冊
    @Autowired
    private DiscoveryClient discoveryClient; // 服務發現客戶端
    @RequestMapping("/provider")
    public String provider() {
        ServiceInstance instance = serviceInstance();
        LOGGER.info("provider service, host = " + instance.getHost()
                + ", service_id = " + instance.getServiceId());
        return "Hello,Provider!";
    }
    /**
     * 獲取當前服務的服務實例
     *
     * @return ServiceInstance
     */
    public ServiceInstance serviceInstance() {
        List<ServiceInstance> list = discoveryClient.getInstances(registration.getServiceId());
        if (list != null && list.size() > 0) {
            return list.get(0);
        }
        return null;
    }
}
可以看到注入了 Registration 和 DiscoveryClient 兩個對象：
- Registration 服務注冊接口，包含了獲取服務 ID 的方法。
- DiscoveryClient 服務發現客戶端，具有以下方法：
- String description(); 獲取描述
- ServiceInstance getLocalServiceInstance(); @Deprecated 方法被刪除，推薦不要使用。獲取本地服務實例
- List<ServiceInstance> getInstances(String serviceId); 通過服務 ID，獲取當前服務的服務實例
- List<String> getServices(); 獲取所有服務 ID 列表

四、小結
此小章節介紹了如何 Eureka 作為服務提供者，並向服務注冊中心注冊自己實例。下一小結講下服務消費者詳解具體是如何向服務注冊中心注冊自己，發現其他服務，並調用其他服務的。係列目錄如下：
Spring Cloud Eureka 入門（一）服務注冊中心詳解
Spring Cloud Eureka 入門（二）服務提供者詳解
Spring Cloud Eureka 入門（三）服務消費者詳解

資料：
1.《Spring Cloud微服務實戰》

2. 官方文檔
https://cloud.spring.io/spring- ... EASE/

by 泥瓦匠博客
— https://www.bysocket.com/
— https://github.com/JeffLi1993