欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

详解springboot WebTestClient的使用

程序员文章站 2024-02-29 16:53:22
在使用springboot进行开发时,单元测试是必要的,当你建立一个spring项目时,它会为我们自己生成一个测试项目,当你的项目开始过程中,测试用例是同时要进行的,我们在...

在使用springboot进行开发时,单元测试是必要的,当你建立一个spring项目时,它会为我们自己生成一个测试项目,当你的项目开始过程中,测试用例是同时要进行的,我们在进行web层的集成测试时,可以使用spring为我们提供的webtestclient工具,非常方便,提供了基于restful的各种类型和状态!

webclient是一个响应式客户端,它提供了resttemplate的替代方法。它公开了一个功能齐全、流畅的api,并依赖于非阻塞i / o,使其能够比resttemplate更高效地支持高并发性。webclient非常适合流式的传输方案,并且依赖于较低级别的http客户端库来执行请求,是可插拔的。

如果在你系统的类路径上有spring webflux,就可以选择使用webclient来调用远程rest服务。相比之下resttemplate,这个客户端具有更多的函数感并且完全reactive响应式的。您可以在spring framework文档webclient的专用 部分中了解有关该内容的更多信息。

webclient使用与webflux服务器应用程序相同的编解码器,并与服务器功能web框架共享公共基本包,一些通用api和基础结构。api公开了reactor flux和mono类型。默认情况下,它使用reactor netty作为http客户端库,但其他人可以通过自定义clienthttpconnector插入。

与resttemplate相比,webclient是:

  • 非阻塞,reactive的,并支持更高的并发性和更少的硬件资源。
  • 提供利用java 8 lambdas的函数api。
  • 支持同步和异步方案。
  • 支持从服务器向上或向下流式传输。

下面测试用例也是spring在github上开源的,大叔作为总结,把它收录在博客里。

package com.example.webclientdemo;

import com.example.webclientdemo.payload.githubrepo;
import com.example.webclientdemo.payload.reporequest;
import org.assertj.core.api.assertions;
import org.junit.fixmethodorder;
import org.junit.test;
import org.junit.runner.runwith;
import org.junit.runners.methodsorters;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.boot.test.context.springboottest;
import org.springframework.http.mediatype;
import org.springframework.test.context.junit4.springrunner;
import org.springframework.test.web.reactive.server.webtestclient;
import reactor.core.publisher.mono;


@runwith(springrunner.class)
@springboottest(webenvironment = springboottest.webenvironment.random_port)
@fixmethodorder(methodsorters.name_ascending)
public class webclientdemoapplicationtests {

  @autowired
  private webtestclient webtestclient;

  @test
  public void test1creategithubrepository() {
    reporequest reporequest = new reporequest("test-webclient-repository", "repository created for testing webclient");

    webtestclient.post().uri("/api/repos")
        .contenttype(mediatype.application_json_utf8)
        .accept(mediatype.application_json_utf8)
        .body(mono.just(reporequest), reporequest.class)
        .exchange()
        .expectstatus().isok()
        .expectheader().contenttype(mediatype.application_json_utf8)
        .expectbody()
        .jsonpath("$.name").isnotempty()
        .jsonpath("$.name").isequalto("test-webclient-repository");
  }

  @test
  public void test2getallgithubrepositories() {
    webtestclient.get().uri("/api/repos")
        .accept(mediatype.application_json_utf8)
        .exchange()
        .expectstatus().isok()
        .expectheader().contenttype(mediatype.application_json_utf8)
        .expectbodylist(githubrepo.class);
  }

  @test
  public void test3getsinglegithubrepository() {
    webtestclient.get()
        .uri("/api/repos/{repo}", "test-webclient-repository")
        .exchange()
        .expectstatus().isok()
        .expectbody()
        .consumewith(response ->
            assertions.assertthat(response.getresponsebody()).isnotnull());
  }

  @test
  public void test4editgithubrepository() {
    reporequest newrepodetails = new reporequest("updated-webclient-repository", "updated name and description");
    webtestclient.patch()
        .uri("/api/repos/{repo}", "test-webclient-repository")
        .contenttype(mediatype.application_json_utf8)
        .accept(mediatype.application_json_utf8)
        .body(mono.just(newrepodetails), reporequest.class)
        .exchange()
        .expectstatus().isok()
        .expectheader().contenttype(mediatype.application_json_utf8)
        .expectbody()
        .jsonpath("$.name").isequalto("updated-webclient-repository");
  }

  @test
  public void test5deletegithubrepository() {
    webtestclient.delete()
        .uri("/api/repos/{repo}", "updated-webclient-repository")
        .exchange()
        .expectstatus().isok();
  }
}

本例主要用来测试响应式的mongodb控件,其中也有一些坑,我们在reactive-mongodb一节里再说!

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。