SpringBoot中RSocket如何使用

本篇文章給大家分享的是有關(guān)SpringBoot中RSocket如何使用，小編覺得挺實用的，因此分享給大家學習，希望大家閱讀完這篇文章后可以有所收獲，話不多說，跟著小編一起來看看吧。

1. 概述

RSocket 應用層協(xié)議支持Reactive Streams 語義， 例如：用RSocket作為HTTP的一種替代方案。在本教程中， 我們將看到RSocket 用在spring boot中，特別是spring boot 如何幫助抽象出更低級別的RSocket API。

2. 依賴

讓我們從添加spring-boot-starter-rsocket 依賴開始：

<dependency>  <groupId>org.springframework.boot</groupId>  <artifactId>spring-boot-starter-rsocket</artifactId></dependency>

這個依賴會傳遞性的拉取RSocket 相關(guān)的依賴，比如：rsocket-core 和rsocket-transport-netty

3.示例的應用程序

現(xiàn)在繼續(xù)我們的簡單應用程序。為了突出RSocket 提供的交互模式，我打算創(chuàng)建一個交易應用程序， 交易應用程序包括客戶端和服務器。

3.1. 服務器設(shè)置

首先，我們設(shè)置由springboot應用程序引導的RSocket server 服務器。 因為有spring-boot-starter-rsocket dependency 依賴，所以springboot會自動配置RSocket server 。 跟平常一樣， 可以用屬性驅(qū)動的方式修改RSocket server 默認配置值。例如：通過增加如下配置在application.properties 中，來修改RSocket 端口

spring.rsocket.server.port=7000

也可以根據(jù)需要進一步修改服務器的其他屬性

3.2.設(shè)置客戶端

接下來，我們來設(shè)置客戶端，也是一個springboot應用程序。雖然springboot自動配置大部分RSocket相關(guān)的組件，但還要自定義一些對象來完成設(shè)置。

@Configurationpublic class ClientConfiguration {  @Bean  public RSocket rSocket() {    return RSocketFactory     .connect()     .mimeType(MimeTypeUtils.APPLICATION_JSON_VALUE, MimeTypeUtils.APPLICATION_JSON_VALUE)     .frameDecoder(PayloadDecoder.ZERO_COPY)     .transport(TcpClientTransport.create(7000))     .start()     .block();  }  @Bean  RSocketRequester rSocketRequester(RSocketStrategies rSocketStrategies) {    return RSocketRequester.wrap(rSocket(), MimeTypeUtils.APPLICATION_JSON, rSocketStrategies);  }}

這兒我們正在創(chuàng)建RSocket 客戶端并且配置TCP端口為：7000。注意： 該服務端口我們在前面已經(jīng)配置過。 接下來我們定義了一個RSocket的裝飾器對象RSocketRequester 。 這個對象在我們跟RSocket server 交互時會為我們提供幫助。 定義這些對象配置后，我們還只是有了一個骨架。在接下來，我們將暴露不同的交互模式， 并看看springboot在這個地方提供幫助的。

4.springboot RSocket 中的Request/Response

我們從Request/Response 開始，HTTP 也使用這種通信方式，這也是最常見的、最相似的交互模式。 在這種交互模式里， 由客戶端初始化通信并發(fā)送一個請求。之后，服務器端執(zhí)行操作并返回一個響應給客戶端--這時通信完成。 在我們的交易應用程序里， 一個客戶端詢問一個給定的股票的當前的市場數(shù)據(jù)。 作為回復，服務器會傳遞請求的數(shù)據(jù)。

4.1.服務器

在服務器這邊，我們首先應該創(chuàng)建一個controller 來持有我們的處理器方法。 我們會使用@MessageMapping 注解來代替像SpringMVC中的@RequestMapping 或者@GetMapping 注解

@Controllerpublic class MarketDataRSocketController {  private final MarketDataRepository marketDataRepository;  public MarketDataRSocketController(MarketDataRepository marketDataRepository) {    this.marketDataRepository = marketDataRepository;  }  @MessageMapping("currentMarketData")  public Mono<MarketData> currentMarketData(MarketDataRequest marketDataRequest) {    return marketDataRepository.getOne(marketDataRequest.getStock());  }}

來研究下我們的控制器。 我們將使用@Controller 注解來定義一個控制器來處理進入RSocket的請求。 另外，注解@MessageMapping 讓我們定義我們感興趣的路由和如何響應一個請求。 在這個示例中， 服務器監(jiān)聽路由currentMarketData ， 并響應一個單一的結(jié)果Mono<MarketData> 給客戶端。

4.2. 客戶端

接下來， 我們的RSocket客戶端應該詢問一只股票的價格并得到一個單一的響應。 為了初始化請求， 我們該使用RSocketRequester 類，如下：

@RestControllerpublic class MarketDataRestController {  private final RSocketRequester rSocketRequester;  public MarketDataRestController(RSocketRequester rSocketRequester) {    this.rSocketRequester = rSocketRequester;  }  @GetMapping(value = "/current/{stock}")  public Publisher<MarketData> current(@PathVariable("stock") String stock) {    return rSocketRequester     .route("currentMarketData")     .data(new MarketDataRequest(stock))     .retrieveMono(MarketData.class);  }}

注意：在示例中，RSocket 客戶端也是一個REST 風格的controller ，以此來訪問我們的RSocket 服務器。因此，我們使用@RestController 和@GetMapping 注解來定義我們的請求/響應端點。 在端點方法中， 我們使用的是類RSocketRequester 并指定了路由。 事實上，這個是服務器端RSocket 所期望的路由，然后我們傳遞請求數(shù)據(jù)。最后，當調(diào)用retrieveMono() 方法時，springboot會幫我們初始化一個請求/響應交互。

5.Spring Boot RSocket 中的Fire And Forget 模式

接下來我們將查看Fire And Forget 交互模式。正如名字提示的一樣，客戶端發(fā)送一個請求給服務器，但是不期望服務器的返回響應回來。 在我們的交易程序中， 一些客戶端會作為數(shù)據(jù)資源服務，并且推送市場數(shù)據(jù)給服務器端。

5.1.服務器端

我們來創(chuàng)建另外一個端點在我們的服務器應用程序中，如下：

@MessageMapping("collectMarketData")public Mono<Void> collectMarketData(MarketData marketData) {  marketDataRepository.add(marketData);  return Mono.empty();}

我們又一次定義了一個新的@MessageMapping 路由為collectMarketData 。此外， Spring Boot自動轉(zhuǎn)換傳入的負載為一個MarketData 實例。 但是，這兒最大的不同是我們返回一個Mono<Void> ，因為客戶端不需要服務器的返回。

5.2. 客戶端

來看看我們?nèi)绾纬跏蓟覀兊膄ire-and-forget 模式的請求。 我們將創(chuàng)建另外一個REST風格的端點，如下：

@GetMapping(value = "/collect")public Publisher<Void> collect() {  return rSocketRequester   .route("collectMarketData")   .data(getMarketData())   .send();}

這兒我們指定路由和負載將是一個MarketData 實例。 由于我們使用send() 方法來代替retrieveMono() ，所有交互模式變成了fire-and-forget 模式。

6.Spring Boot RSocket 中的Request Stream

請求流是一種更復雜的交互模式， 這個模式中客戶端發(fā)送一個請求，但是在一段時間內(nèi)從服務器端獲取到多個響應。 為了模擬這種交互模式， 客戶端會詢問給定股票的所有市場數(shù)據(jù)。

6.1.服務器端

我們從服務器端開始。 我們將添加另外一個消息映射方法，如下：

@MessageMapping("feedMarketData")public Flux<MarketData> feedMarketData(MarketDataRequest marketDataRequest) {  return marketDataRepository.getAll(marketDataRequest.getStock());}

正如所見， 這個處理器方法跟其他的處理器方法非常類似。 不同的部分是我們返回一個Flux<MarketData> 來代替Mono<MarketData> 。 最后我們的RSocket服務器會返回多個響應給客戶端。

6.2.客戶端

在客戶端這邊， 我們該創(chuàng)建一個端點來初始化請求/響應通信，如下：

@GetMapping(value = "/feed/{stock}", produces = MediaType.TEXT_EVENT_STREAM_VALUE)public Publisher<MarketData> feed(@PathVariable("stock") String stock) {  return rSocketRequester   .route("feedMarketData")   .data(new MarketDataRequest(stock))   .retrieveFlux(MarketData.class);}

我們來研究下RSocket請求。 首先我們定義了路由和請求負載。 然后，我們定義了使用retrieveFlux() 調(diào)用的響應期望。這部分決定了交互模式。 另外注意：由于我們的客戶端也是REST 風格的服務器，客戶端也定義了響應媒介類型MediaType.TEXT_EVENT_STREAM_VALUE 。

7.異常的處理

現(xiàn)在讓我們看看在服務器程序中，如何以聲明式的方式處理異常。 當處理請求/響應式， 我可以簡單的使用@MessageExceptionHandler 注解，如下：

@MessageExceptionHandlerpublic Mono<MarketData> handleException(Exception e) {  return Mono.just(MarketData.fromException(e));}

這里我們給異常處理方法標記注解為@MessageExceptionHandler 。作為結(jié)果， 這個方法將處理所有類型的異常， 因為Exception 是所有其他類型的異常的超類。 我們也可以明確地創(chuàng)建更多的不同類型的，不同的異常處理方法。 這當然是請求/響應模式，并且我們返回的是Mono<MarketData> 。我們期望這里的響應類型跟我們的交互模式的返回類型相匹配。

以上就是SpringBoot中RSocket如何使用，小編相信有部分知識點可能是我們?nèi)粘９ぷ鲿姷交蛴玫降?。希望你能通過這篇文章學到更多知識。更多詳情敬請關(guān)注億速云行業(yè)資訊頻道。