实战SpringCloud响应式微服务系列教程(第八章)构建响应式RESTful服务

简介: 实战SpringCloud响应式微服务系列教程(第八章)构建响应式RESTful服务

1.使用springboot2.1.4构建RESTful风格服务

Springboot的设计是用来简化Spring应用程序的初始搭建和开发过程,为了实现这种简化效果,Springboot继承了众多第三方库,并大量使用约定优于配置的设计理念,通过特定的方式使得开发人员不再需要定义繁杂而且多余的配置内容。

1.1基于Springboot的第一个RESTful服务

微服务架构推崇采用RESTful风格实现服务之间的交互。关于RESTful,很多开发人员在知识体系上的一些误解和不足。我们先对RESTful风格做一个简单的介绍,然后详细阐述使用 SpringBoot构建单个RESTful服务的过程。

(1)RESTful风格简介

REST提出了一组建构约束条件和原则,满足这些约束条件和原则的设计风格就是RESTful。

现实世界中的事物都可以被认为一种资源,我们可以根据这些约束条件和原则设计以资源为中心的服务。REST中最重要的一条原则就是客户端和服务器之间的交互无状态性。

从客户端到服务器的每个请求都必须包含理解该请求所必需的信息,无状态请求可以由任何可用服务实现响应,十分适合微服务架构的运行环境。所以RESTful代表的实际上是一种风格,而不是一种设计和架构模式,更不是一种具体的技术体系。

关于RESTful另一个比较容易忽视的核心概念是HATEOAS(Hypermedia as the Engine of Application State,基于超媒体的应用状态引擎)。要解释HATEOAS的概念,先要解释什么是超媒体。

我们已经知道什么是超链接以及什么是超文本,其中超文本的特有优势是拥有超链接。如果把超链接映入到多媒体中,就得到了超媒体。因此关键要素还是超链接。使用过超媒体作为应用引擎状态,意思就是应用引擎的状态变更由客户端访问不同的超媒体资源来驱动。

使用HATEOAS表现服务请求响应的风格如下,可以看到这里多了_links属性,其中有一个self.href链接指向当前user资源。

GET http://api.example.com/users/tianyalan
Content-type:application/json
{
   _links:{
      self:{
         href:"/users/tianyalan"
       }
   }
  "id":"tianyalan",
   "name":"tianyalan",
   "email":"tianyalan@email.com"
}

HATEOAS在spring boot和spring cloud中应用也非常广泛,例如springboot提供了应用监控组件Actuator,通过Actuator可以获取springboot应用程序当前的运行状态,我们将在后续章节中详细介绍Actuator组件。

Actuator组件对外暴露的也是一些http端点,访问这些端点返回的数据跟常见的RESTful风格有所不同,这就是HATEOAS风格,所以可以参考相关资料进一步了解。

(2)引入spring-boot-starter-web工程

spring boot提供了一系列starter工程来简化各组件之间的依赖关系。

例如在springboot中开发基于RESTful风格的端点时,通常会引入spring-boot-starter-web这个工程,而打开这个工程会发现里面实际上只定义了如下所示的一些pom依赖,其中包括所有我们能够预见到的组件,例如非常经典的spring-web,spring-webmvc组件,可以看到spring-boot-starter-web还是基于这两个组件构建web请求响应流程的。

另外还包含了基于JSON序列化和反序列化的jackson-databind组件,以及启动内置tomcat服务器的spring-boot-starter-tomcat组件。

  • org.springframework.boot:spring-boot-starter
  • org.springframework.boot:spring-boot-starter-tomcat
  • org.springframework.boot:spring-boot-starter-validation
  • org.springframework.boot:spring-web
  • org.springframework.boot:spring-webmvc
  • org.fasterxml.jackson.core:jackson-databind

引入spring-boot-starter-web就像引入一个普通的maven依赖一样,代码如下:

   org.springframework.boot

   spring-boot-starter-web

一旦spring-boot-starter-web组件引入完毕,我们就可以充分利用springboot的自动装配机制开发单个服务。

(3)Application类

使用springboot的首要条件是构建一个Application启动类。代码如下:

@SpringBootApplication
public class SoulApplication {
    public static void main(String[] args) {
        SpringApplication.run(SoulApplication.class, args);
    }
}

结构比较固化。

显然以上代码关键的是@SpringBootApplication注解。springboot使用@SpringBootApplication注解来告诉spring容器具备该注解的类是整个spring容器中所有 javaBean对象的入口,而具备该注解的类在springboot中就是Application类。

在上面代码中,SoulApplication类就是整个容器的Application类。

@SpringBootApplication注解在指定Application类的同时,还会自动扫描与当前类同级以及子包下的@Component、@Service、@Repository、@Controller、@Entity等注解,并把这些注解对应的类转换为Bean对象全部加载到Spring容器中管理起来。
@SpringBootApplication注解的定义如下,我们可以看到该注解实际上由三个注解组合而成,分别是@Configuration、@EnableAutoConfigguration和@ComponentScan。
@Target(ElementType.TYPE)
@Retenation(RetentionPolicy.PUNTIME)
@Documented
@Inherited
@Configuration
@EnableAutoConfigguration
@ComponentScan
public @interface SpringBootApplication

在Spring 中@Configuration比较常见,提供javaConfig配置类实现。而@ComponentScan则扫描@Component等注解,帮相关的javaBean定义批量加载到IOC容器中。@EnableAutoConfigguration最终会使用JDK提供的SPI机制来实现类的动态加载。

关于@EnableAutoConfigguration注解更多的可以参考相关的资料。

我们还注意到在上面的代码示例中包含一个main函数并执行了ApplicationContext对象,我们可以根据需求对该ApplicationContext对象做响应处理。

(4)Controller类

Application类提供了Springboot程序的入口,相当于应用程序拥有了最基本的骨架。接下来我们就可以添加各种业务相关的访问入口,表现在RESTful风格上也就是一系列的Controller类所代表的的HTTP端点。

这里的Controller和springMvc的Controller在概念上是一致的。最简单的Controller如下:

@RestController
public class HelloController{
     @GetMapping("/")
     public String index(){
          return "Hello Spring Boot";
     }
}

以上代码包含了@RestController@GetMapping("/")两个注解。我们知道在springMvc中包含了@Controller注解用来表示当前类是一个servlet。

@RestController继承了@Controller,它告诉Springboot这是一个基于RESTful风格的HTTP端点,并会自动使用JSON实现HTTP请求和响应的序列化和反序列化操作。至于@GetMapper类似@RequestMapping,指定请求方式为GET。这里不做多余介绍。

以下代码展示了一个典型的Controller,在Controller中通过静态的业务代码完成了根据商品编号,获取商品信息的业务流程。

这里用到了两层Mapping注解,在服务层级定义了服务的版本和路径,分别为v1和products;而在操作级别有定义了HTTP请求方法的具体路径及参数信息。

@RestController
@RequestMapping("/v1/products")
public class Productontroller{
     @GetMapping("/{productCode}")
     public Product getProduct(@PathVariable String productCode){
          Product product = new Product();
          product .setId(1L);
   product .setPrice(100F);
   product .setProductCode("product001");
   product .setProductName("product");
   return product;
     }
}

系列章节目录

实战SpringCloud响应式微服务系列教程(第一章)

实战SpringCloud响应式微服务系列教程(第二章)

实战SpringCloud响应式微服务系列教程(第三章)

实战SpringCloud响应式微服务系列教程(第四章)

实战SpringCloud响应式微服务系列教程(第五章)

实战SpringCloud响应式微服务系列教程(第六章)

实战SpringCloud响应式微服务系列教程(第七章)

相关文章
|
2月前
|
JSON Java API
利用Spring Cloud Gateway Predicate优化微服务路由策略
Spring Cloud Gateway 的路由配置中,`predicates`​(断言)用于定义哪些请求应该匹配特定的路由规则。 断言是Gateway在进行路由时,根据具体的请求信息如请求路径、请求方法、请求参数等进行匹配的规则。当一个请求的信息符合断言设置的条件时,Gateway就会将该请求路由到对应的服务上。
158 69
利用Spring Cloud Gateway Predicate优化微服务路由策略
|
2月前
|
Java 开发者 微服务
从单体到微服务:如何借助 Spring Cloud 实现架构转型
**Spring Cloud** 是一套基于 Spring 框架的**微服务架构解决方案**,它提供了一系列的工具和组件,帮助开发者快速构建分布式系统,尤其是微服务架构。
247 69
从单体到微服务:如何借助 Spring Cloud 实现架构转型
|
4月前
|
Dubbo Java 应用服务中间件
Spring Cloud Dubbo:微服务通信的高效解决方案
【10月更文挑战第15天】随着信息技术的发展,微服务架构成为企业应用开发的主流。Spring Cloud Dubbo结合了Dubbo的高性能RPC和Spring Cloud的生态系统,提供高效、稳定的微服务通信解决方案。它支持多种通信协议,具备服务注册与发现、负载均衡及容错机制,简化了服务调用的复杂性,使开发者能更专注于业务逻辑的实现。
96 2
|
4月前
|
存储 数据可视化 Java
基于MicrometerTracing门面和Zipkin实现集成springcloud2023的服务追踪
Sleuth将会停止维护,Sleuth最新版本也只支持springboot2。作为替代可以使用MicrometerTracing在微服务中作为服务追踪的工具。
210 1
|
24天前
|
搜索推荐 NoSQL Java
微服务架构设计与实践:用Spring Cloud实现抖音的推荐系统
本文基于Spring Cloud实现了一个简化的抖音推荐系统,涵盖用户行为管理、视频资源管理、个性化推荐和实时数据处理四大核心功能。通过Eureka进行服务注册与发现,使用Feign实现服务间调用,并借助Redis缓存用户画像,Kafka传递用户行为数据。文章详细介绍了项目搭建、服务创建及配置过程,包括用户服务、视频服务、推荐服务和数据处理服务的开发步骤。最后,通过业务测试验证了系统的功能,并引入Resilience4j实现服务降级,确保系统在部分服务故障时仍能正常运行。此示例旨在帮助读者理解微服务架构的设计思路与实践方法。
74 16
|
27天前
|
监控 JavaScript 数据可视化
建筑施工一体化信息管理平台源码,支持微服务架构,采用Java、Spring Cloud、Vue等技术开发。
智慧工地云平台是专为建筑施工领域打造的一体化信息管理平台,利用大数据、云计算、物联网等技术,实现施工区域各系统数据汇总与可视化管理。平台涵盖人员、设备、物料、环境等关键因素的实时监控与数据分析,提供远程指挥、决策支持等功能,提升工作效率,促进产业信息化发展。系统由PC端、APP移动端及项目、监管、数据屏三大平台组成,支持微服务架构,采用Java、Spring Cloud、Vue等技术开发。
|
2月前
|
Java Nacos Sentinel
Spring Cloud Alibaba:一站式微服务解决方案
Spring Cloud Alibaba(简称SCA) 是一个基于 Spring Cloud 构建的开源微服务框架,专为解决分布式系统中的服务治理、配置管理、服务发现、消息总线等问题而设计。
350 13
Spring Cloud Alibaba:一站式微服务解决方案
|
2月前
|
Java 关系型数据库 Nacos
微服务SpringCloud链路追踪之Micrometer+Zipkin
SpringCloud+Openfeign远程调用,并用Mircrometer+Zipkin进行链路追踪
270 20
|
1月前
|
Java 关系型数据库 数据库
微服务SpringCloud分布式事务之Seata
SpringCloud+SpringCloudAlibaba的Seata实现分布式事务,步骤超详细,附带视频教程
50 1
|
2月前
|
负载均衡 Java 开发者
深入探索Spring Cloud与Spring Boot:构建微服务架构的实践经验
深入探索Spring Cloud与Spring Boot:构建微服务架构的实践经验
184 5

热门文章

最新文章