初体验
Spring Cloud旨在为一些常见的场景提供一些开箱即用的功能,它是基于Spring Boot构建的。本文将作为Spring Cloud的应用入门篇讲解如何快速的利用Spring Cloud搭建起一套可运行的开发环境。
Eureka
Eureka是Netflix提供的一套基于Rest的服务发现框架,它包含服务端和客户端。服务端用来提供服务注册服务,客户端可以通过服务端进行服务注册和从服务端获取服务提供者信息。Spring Cloud把它集成进来了。需要使用Eureka Server可以新建一个Maven工程,指定项目的parent为spring-cloud-starter-parent
,下面介绍的所有的相关工程的parent都定义为spring-cloud-starter-parent
。
<parent>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-parent</artifactId>
<version>Finchley.SR1</version>
</parent>
然后添加添加spring-cloud-starter-netflix-eureka-server
依赖。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>
然后在配置类上添加@org.springframework.cloud.netflix.eureka.server.EnableEurekaServer
。
@SpringBootApplication
@EnableEurekaServer
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
然后可以通过application.properties或application.yml定义一些配置信息,比如通过server.port
指定Web服务器的端口号,Eureka Server也会包含客户端的信息,用于Eureka Server和Eureka Server之间的通信,但是当我们的Eureka Server只有一台时,我们作为服务端的时候通常是不需要把它自己作为一个服务注册到服务器上的,此时可以通过eureka.client.registerWithEureka=false
定义其不在服务端注册,通过eureka.client.fetchRegistry=false
定义不从服务器拿服务信息,否则默认会访问http://localhost:8761/eureka/
服务地址进行服务注册和获取服务信息。然后只有一台时指定defaultZone为它本身。
server.port: 8761
eureka:
client:
registerWithEureka: false
fetchRegistry: false
serviceUrl:
defaultZone: http://localhost:${server.port}/eureka/
通过运行上面的Application.java启动了Eureka Server后就可以通过Eureka Server的IP和端口号访问Eureka Server的控制台查看上面注册的服务了,比如对于上面的配置可以在本机访问http://localhost:8761
,然后可以看到类似如下这样的界面。
服务提供者
服务提供者需要在Eureka Server上注册服务,所以服务提供者本身将作为一个Eureka Client,我们需要在依赖中添加Eureka Client的依赖。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
我们的服务会希望通过SpringMVC对外发布,提供Rest服务,所以我们添加如下依赖。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
服务提供者需要在application.properties或application.yml中通过spring.application.name
指定服务提供者的名称,到时候客户端将通过该名称来寻找服务提供者。需要通过eureka.client.serviceUrl.defaultZone
指定默认使用的Eureka Server的地址,不指定时默认是http://localhost:8761/eureka/
。可以通过eureka.instance.preferIpAddress=true
指定需要获取当前服务提供者的hostname时返回当前的IP地址。每个服务提供者的实例需要有一个全局的唯一标识,可以通过eureka.instance.instanceId
来指定,下面的配置指定了实例ID为${spring.cloud.client.ip-address}:${server.port}
,其中spring.cloud.client.ip-address
将被自动替换为当前机器的IP地址。
spring.application.name=spring-cloud-service-provider
server.port=8900
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
eureka.instance.preferIpAddress=true
eureka.instance.instanceId=${spring.cloud.client.ip-address}:${server.port}
服务提供者可以作为一个普通的Spring Boot应用启动,无需特别的配置信息。
@SpringBootApplication
@EnableHystrixDashboard
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
具体的服务实现就是开发一个普通的@RestController
类,并配置对应的映射路径,比如下面代码中建立了一个具体的服务实现,通过请求/hello
可以请求到下面的sayHelloWorld()
,将响应对方hello world。
@RestController
@RequestMapping("hello")
public class HelloController {
@GetMapping
public String sayHelloWorld() {
return "hello world. -- " + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
}
}
服务调用者
服务调用者需要从Eureka Server上获取提供某种服务的服务提供者信息,它从Eureka Server获取到了服务提供者的信息后会缓存在本地,这样即使Eureka Server后续挂了,服务调用者也能从本地缓存获取服务提供者信息并进行调用。服务调用者对应于Eureka Server而言,也是一个Eureka Client。需要添加Eureka Client的依赖。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
在笔者的示例中需要使用OpenFeign作为Rest客户端实现,所以添加如下依赖。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
在笔者示例中的服务调用者本身又是需要向外部提供Rest服务的,所以还添加了spring-boot-starter-web
依赖。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
作为Eureka Client,需要配置Eureka Server的地址,然后因为我们的应用是作为调用者的,如果它不需要作为服务提供者对外提供服务,可以配置eureka.client.registerWithEureka=false
。当然了,如果你想在Eureka Server上看到当前有哪些Eureka Client与它相连,而不管它是作为服务提供者还是服务调用者,那可以都在Eureka Server上进行注册。
eureka.client.registerWithEureka=false
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
OpenFeign作为Rest客户端,需要为客户端声明一个接口,然后使用Rest的相关注解,也可以是SpringMVC的注解。需要在接口上标注@FeignClient
,同时通过其value属性指定服务提供者(或者说指定需要的服务),这里就配置为服务提供者应用配置在application.properties中的spring.application.name
。然后在接口方法上使用@RequestMapping
指定接口对应的远程服务提供者发布的路径(相对路径)。
@FeignClient("spring-cloud-service-provider")
public interface HelloService {
@GetMapping("hello")
String helloWorld();
}
然后在配置类上添加@EnableFeignClients
,其会自动扫描配置类所在的package及其子package下的@FeignClient
类,并把它们注册为一个bean。不想使用默认扫描包,也可以通过@EnableFeignClients
进行配置。以前的版本中还需要在配置类中添加@EnableDiscoveryClient
,现在已经不需要了。
@SpringBootApplication
@EnableFeignClients
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
然后就可以在需要的地方把@FeignClient
标注的接口作为一个普通的bean进行注册了,比如下面定义了一个HelloController,其注入了标注了@FeignClient
的HelloService,其helloWorld()
对应请求的是HelloService的helloWorld()
,其进而会访问一个spring-cloud-service-provider
服务提供者的/hello
路径获取返回结果。
@RestController
@RequestMapping("hello")
public class HelloController {
@Autowired
private HelloService helloService;
@GetMapping
public String helloWorld() {
return this.helloService.helloWorld();
}
}
看到了我们在服务调用端新建的HelloService接口,你会不会想可以把该接口定义为一个公用接口,可以同时由服务提供方和服务调用方实现呢?Spring Cloud官方是不建议我们这么做的,因为这会增加服务调用方和服务提供方之间的耦合性。不使用相同的接口,客户端接口可以只定义部分其需要的接口方法或者将服务提供方多个Controller提供的接口定义到同一个客户端接口中。
以上就是Spring Cloud初体验的全部内容,笔者通过介绍Eureka Server、Eureka Client和OpenFeign介绍了服务的注册、发现和Rest客户端自动实现,将它们结合起来组成了一个基本的Spring Cloud应用的示例。Eureka包含Eureka Server和Eureka Client,其中Eureka Client又分Application Service和Application Client,它们之间的关系可以用下面这张图来表示。
(注:本文是基于Spring cloud Finchley.SR1所写)
相关推荐
最简单的 SpringCloud 教程—— 服务的注册与发现(Eureka) 1.创建服务注册中心 (Eureka Server) 2.创建一个服务提供者 (Eureka Client)
SpringCloud——分布式配置中心(Spring Cloud Config)之高可用的分布式配置中心
SpringCloud——消息总线(Bus)之Spring Cloud Bus将分布式系统的节点与轻量级消息代理链接。
SpringCloud——分布式跟踪(Sleuth)之Spring Cloud Sleuth 主要功能就是在分布式系统中提供追踪解决方案。
SpringCloud——断路器(Hystrix)之Ribbon使用断路器和Feign使用断路器
SpringCloud——路由器和过滤器(Zuul)之微服务网关的实现
SpringCloud——服务注册(consul)之Consul通过HTTP API和DNS提供服务发现服务。
Zookeeper作为注册中心搭建SpringCloud实现服务注册及发现
SpringCloud系列Demo代码,每个子项目都是SpringCloud的一个知识点或者说技能点且都有对应的博客介绍,代码开箱即用适合新手学习或老司机复习。 SpringCloud系列Demo代码,每个子项目都是SpringCloud的一个知识点...
基于SpringCloud的快递驿站系统源码 基于SpringCloud的快递驿站系统源码 基于SpringCloud的快递驿站系统源码 基于SpringCloud的快递驿站系统源码 基于SpringCloud的快递驿站系统源码 基于SpringCloud的...
Spring boot 是 Spring 的一套快速配置脚手架,可以基于spring boot 快速开发单个微服务,Spring Cloud是一个基于Spring Boot实现的云应用开发工具;Spring boot专注于快速、方便集成的单个个体,Spring Cloud是关注...
spring boot , spring cloud alibaba, spring cloub 版本选型
基于spring cloud 和vue全家桶的开源电商源码基于spring cloud 和vue全家桶的开源电商源码基于spring cloud 和vue全家桶的开源电商源码基于spring cloud 和vue全家桶的开源电商源码基于spring cloud 和vue全家桶的...
Spring Cloud 提供完全的微服务技术体系,可以帮护开发者快速实现架构升级。SpringCloud 是目前最火热的构建微服务体系的解决方案。
简单的spring cloud项目,适合新手学习使用
一篇很好的springCloud学习的思维导读,详细的介绍了,springCloud的搭建步骤以及各组件的说明讲解 涵盖 Eureka服务注册与发现 Zookeeper服务注册与发现 Consul服务注册与发现 Ribbon负载均衡服务调用 OpenFeign...
(完整版)基于SpringCloud微服务系统设计方案.pdf(完整版)基于SpringCloud微服务系统设计方案.pdf(完整版)基于SpringCloud微服务系统设计方案.pdf(完整版)基于SpringCloud微服务系统设计方案.pdf(完整版)基于Spring...
课程的源码是尚硅谷的springcloud教程源码,SpringCloud各种核心组件,到最终的微服务架构总结,帮助大家快速入门、上手并精通微服务框架SpringCloud。 课程中对比了 Dubbo 和 SpringCloud,并深入讲授SpringCloud...
基于SpringCloud的趋势投资分析系统 基于SpringCloud的趋势投资分析系统 基于SpringCloud的趋势投资分析系统 基于SpringCloud的趋势投资分析系统 基于SpringCloud的趋势投资分析系统 基于SpringCloud的趋势投资...
22.分布式配置中心Spring Cloud Config初窥 23.Spring Cloud Config服务端配置细节(一) 24.Spring Cloud Config服务端配置细节(二)之加密解密 25.Spring Cloud Config客户端配置细节 26.Spring Cloud Bus之...