java 41 lines · 7 steps

Calling the GitHub API with Spring WebClient

A reactive Spring service that wraps GitHub's REST API with a preconfigured WebClient and typed responses.

Explained by highlit

Spring Intermediate reactive http-client dependency-injection error-handling json-mapping

1@Service
2public class GitHubClient {
3 
  private final WebClient webClient;
5 
  public GitHubClient(WebClient.Builder builder) {
      this.webClient = builder
              .baseUrl("https://api.github.com")
              .defaultHeader(HttpHeaders.ACCEPT, "application/vnd.github+json")
              .build();
  }
12 
  public Mono<Repository> getRepository(String owner, String name) {
      return webClient.get()
              .uri("/repos/{owner}/{name}", owner, name)
              .retrieve()
              .onStatus(HttpStatusCode::is4xxClientError, response ->
                      Mono.error(new RepositoryNotFoundException(owner + "/" + name)))
              .bodyToMono(Repository.class);
  }
21 
  public Flux<Repository> listRepositories(String owner) {
      return webClient.get()
              .uri(uriBuilder -> uriBuilder
                      .path("/users/{owner}/repos")
                      .queryParam("sort", "updated")
                      .queryParam("per_page", 50)
                      .build(owner))
              .retrieve()
              .bodyToFlux(Repository.class);
  }
32 
  public record Repository(
          Long id,
          String name,
          @JsonProperty("full_name") String fullName,
          @JsonProperty("html_url") String url,
          @JsonProperty("stargazers_count") int stars,
          @JsonProperty("private") boolean isPrivate) {
  }
41}

01 / 01

STEP 01

Walkthrough

Space play ←→ step click any line

Three takeaways

1Configuring a WebClient once in the constructor centralizes base URL and headers for every call.
2Mono and Flux let you model single versus multiple results without blocking threads.
3onStatus turns HTTP error codes into meaningful domain exceptions instead of generic failures.

Related explainers

typescript

import { registerLocaleData } from '@angular/common';
import localeFr from '@angular/common/locales/fr';
import localeFrExtra from '@angular/common/locales/extra/fr';
import localeDe from '@angular/common/locales/de';

Locale-aware bootstrapping in Angular

i18n localization dependency-injection

Intermediate 8 steps

rust

use serde::Deserialize;
 
#[derive(Debug, Deserialize)]
#[serde(untagged)]

Parsing flexible JSON shapes with serde

deserialization enums json

Intermediate 6 steps

ruby

require "shellwords"
require "open3"
 
module Backup

Building safe shell commands in Ruby

shell-out subprocess command-injection

Intermediate 7 steps

typescript

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import * as Joi from 'joi';

Validating env config at boot in NestJS

configuration schema-validation environment-variables

Intermediate 8 steps

java

@Component
@Converter
public class EncryptedStringConverter implements AttributeConverter<String, String> {

Transparent column encryption in Spring & JPA

encryption aes-gcm jpa-converter

Advanced 10 steps

typescript

import { Inject, Injectable, Logger } from '@nestjs/common';
import { CACHE_MANAGER } from '@nestjs/cache-manager';
import { Cache } from 'cache-manager';
import { InjectRepository } from '@nestjs/typeorm';