Spring Cloud Eureka 入門之服務提供者詳解
本文提綱
1. springcloud-eureka-sample 工程結構
2. 運行 springcloud-eureka-client-provider 服務提供者工程
3. 詳解 springcloud-eureka-client-provider 服務提供者工程
一、工程介紹
接著上一小節《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 UP2017-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: 2042017-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 80802017-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 注冊中心可視化界面
打開瀏覽器,訪問 http://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="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/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> <!-- 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 Client 依賴 -->
- <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: 8080 # 服務端口eureka:
- client:
- service-url:
- defaultZone: http://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);
- }
- }
6.服務提供者 Hello World 案例
- /**
- * Provider HelloWorld 案例
- * <p>
- * Created by bysocket on 06/22/17.
- */@RestControllerpublic 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 作為服務提供者,并向服務注冊中心注冊自己實例。
【本文為51CTO專欄作者“李強強”的原創稿件,轉載請通過51CTO聯系作者獲取授權】