К основному содержанию
скилл CX Codex

spring-webflux — скилл для Claude Code: установка и возможности

Скилл для Claude Code помогает писать реактивный код на Spring WebFlux в Spring Boot 3.x. Подключается к задачам с Mono, Flux, WebClient и R2DBC.

MIT 102 установок ★ 50 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add claude-dev-suite/claude-dev-suite --skill spring-webflux -a claude-code
Открыть на GitHub

Что делает spring-webflux

Скилл подсказывает, как строить приложения на Spring WebFlux: работать с Mono и Flux, выбирать реактивные операторы и обрабатывать ошибки. Он также охватывает вызовы внешних API через WebClient и функциональные HTTP-эндпоинты.

В материалах есть примеры интеграции с R2DBC и тестирования реактивного кода. Для обычного блокирующего MVC предназначен другой скилл — spring-web.

Агент подключает этот скилл к запросам о реактивном Spring, StepVerifier или неблокирующей обработке. Разрешённые инструменты: Read, Grep, Glob, Write и Edit.

Какие задачи решает

  • создать обработчик Spring WebFlux с Mono и Flux
  • собрать запрос к внешнему API через WebClient
  • обработать сбои в реактивной цепочке
  • настроить функциональные HTTP-эндпоинты

Примеры запросов агенту

  • Сделай реактивный обработчик пользователей на Mono и Flux.
  • Покажи запрос к внешнему API через WebClient с обработкой ошибок.
  • Настрой функциональные эндпоинты и интеграцию с R2DBC.

Как установить spring-webflux

1Через Skills CLI (Vercel)

npx skills add claude-dev-suite/claude-dev-suite --skill spring-webflux -a claude-code

2Вручную: положить файлы

~/.claude/skills/spring-webflux/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/spring-webflux/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о spring-webflux

Как установить spring-webflux в Claude Code?

Выполни npx skills add claude-dev-suite/claude-dev-suite --skill spring-webflux -a claude-code. Файл скилла находится по пути ~/.claude/skills/spring-webflux/SKILL.md.

Что делает spring-webflux?

Скилл помогает писать реактивный код для Spring Boot 3.x: работать с Mono и Flux, использовать WebClient, настраивать функциональные эндпоинты и обрабатывать ошибки.

Чем spring-webflux отличается от spring-web?

spring-webflux посвящён реактивной разработке. Для традиционного блокирующего MVC предназначен spring-web.

Исходный текст

SKILL.md · MIT
---
name: spring-webflux
description: |
  Spring WebFlux for reactive programming in Spring Boot 3.x. Covers Mono/Flux,
  reactive operators, WebClient, functional endpoints, R2DBC integration,
  reactive error handling, and testing. Use for non-blocking high-concurrency apps.

  USE WHEN: user mentions "spring webflux", "reactive Spring", "Mono", "Flux",
  "WebClient reactive", "functional endpoints", "R2DBC", "non-blocking",
  "StepVerifier", "reactive streams"

  DO NOT USE FOR: traditional blocking MVC - use `spring-web` skill,
  simple REST APIs - use `spring-rest` skill,
  batch processing - use `spring-batch` skill
allowed-tools: Read, Grep, Glob, Write, Edit
---
# Spring WebFlux

> **Full Reference**: See [advanced.md](advanced.md) for SSE with Sinks, Testing with StepVerifier, and Context Propagation patterns.

## Quick Start

```java
@RestController
@RequestMapping("/api/users")
@RequiredArgsConstructor
public class UserController {

    private final UserService userService;

    @GetMapping("/{id}")
    public Mono<UserResponse> getUser(@PathVariable Long id) {
        return userService.findById(id);
    }

    @GetMapping
    public Flux<UserResponse> getAllUsers() {
        return userService.findAll();
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Mono<UserResponse> createUser(@RequestBody Mono<CreateUserRequest> request) {
        return request.flatMap(userService::create);
    }
}
```

---

## Mono & Flux Basics

### Mono (0 or 1 element)

```java
Mono<String> empty = Mono.empty();
Mono<String> just = Mono.just("Hello");
Mono<String> fromCallable = Mono.fromCallable(() -> expensiveOperation());
Mono<String> defer = Mono.defer(() -> Mono.just(dynamicValue()));
Mono<String> fromOptional = Mono.justOrEmpty(optionalValue);
Mono<String> fromFuture = Mono.fromFuture(completableFuture);
```

### Flux (0 to N elements)

```java
Flux<Integer> just = Flux.just(1, 2, 3);
Flux<Integer> fromIterable = Flux.fromIterable(List.of(1, 2, 3));
Flux<Integer> range = Flux.range(1, 10);
Flux<Long> interval = Flux.interval(Duration.ofSeconds(1));

Flux<Integer> generate = Flux.generate(
    () -> 0,
    (state, sink) -> {
        sink.next(state);
        if (state == 10) sink.complete();
        return state + 1;
    }
);
```

---

## Reactive Operators

### Transformation

```java
// map - transform each element
users.map(user -> new UserResponse(user.getId(), user.getName()));

// flatMap - async transformation (parallel)
users.flatMap(user -> orderRepository.findByUserId(user.getId()));

// flatMapSequential - maintains order
users.flatMapSequential(user -> orderRepository.findByUserId(user.getId()));

// concatMap - sequential, one at a time
users.concatMap(user -> orderRepository.findByUserId(user.getId()));

// switchMap - cancels previous when new arrives
searchTerms.switchMap(term -> searchService.search(term));
```

### Filtering

```java
// filter
users.filter(user -> user.getStatus() == Status.ACTIVE);

// filterWhen - async filter
users.filterWhen(user -> permissionService.canAccess(user.getId()));

// distinct / distinctUntilChanged
items.distinct();
values.distinctUntilChanged();

// take / skip
users.skip((long) page * size).take(size);
```

### Combining

```java
// zip - combine by position
Flux.zip(users, orders, UserWithOrders::new);

// merge - interleave from multiple sources
Flux.merge(source1, source2);

// concat - sequential
Flux.concat(first, second);

// zipWith on Mono
userRepository.findById(userId)
    .zipWith(profileRepository.findByUserId(userId))
    .map(tuple -> new UserWithProfile(tuple.getT1(), tuple.getT2()));
```

### Error Handling

```java
// onErrorReturn - default value on error
userRepository.findById(id).onErrorReturn(new User("default"));

// onErrorResume - fallback Publisher
primaryRepository.findById(id)
    .onErrorResume(e -> fallbackRepository.findById(id));

// onErrorResume with specific type
userRepository.findById(id)
    .onErrorResume(NotFoundException.class, e -> Mono.empty())
    .onErrorResume(TimeoutException.class, e -> cacheRepository.findById(id));

// onErrorMap - transform exception
userRepository.findById(id)
    .onErrorMap(DataAccessException.class,
        e -> new ServiceException("Database error", e));

// retryWhen - advanced retry
userRepository.findById(id)
    .retryWhen(Retry.backoff(3, Duration.ofSeconds(1))
        .filter(e -> e instanceof TransientException));
```

### Side Effects

```java
userRepository.findById(id)
    .doOnSubscribe(s -> log.info("Subscribed"))
    .doOnNext(user -> log.info("Found user: {}", user.getId()))
    .doOnError(e -> log.error("Error: {}", e.getMessage()))
    .doFinally(signalType -> log.info("Finally: {}", signalType));
```

---

## WebClient

### Configuration

```java
@Configuration
public class WebClientConfig {

    @Bean
    public WebClient webClient(WebClient.Builder builder) {
        HttpClient httpClient = HttpClient.create()
            .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 5000)
            .responseTimeout(Duration.ofSeconds(30))
            .doOnConnected(conn -> conn
                .addHandlerLast(new ReadTimeoutHandler(30, TimeUnit.SECONDS))
                .addHandlerLast(new WriteTimeoutHandler(10, TimeUnit.SECONDS)));

        return builder
            .baseUrl("https://api.example.com")
            .clientConnector(new ReactorClientHttpConnector(httpClient))
            .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
            .build();
    }
}
```

### Usage

```java
@Service
@RequiredArgsConstructor
public class ExternalApiService {

    private final WebClient webClient;

    public Mono<UserDto> getUser(Long id) {
        return webClient.get()
            .uri("/users/{id}", id)
            .retrieve()
            .bodyToMono(UserDto.class);
    }

    public Mono<UserDto> getUserSafe(Long id) {
        return webClient.get()
            .uri("/users/{id}", id)
            .retrieve()
            .onStatus(HttpStatusCode::is4xxClientError, response ->
                response.bodyToMono(ErrorResponse.class)
                    .flatMap(error -> Mono.error(new ClientException(error.getMessage()))))
            .onStatus(HttpStatusCode::is5xxServerError, response ->
                Mono.error(new ServerException("Server error")))
            .bodyToMono(UserDto.class);
    }

    // Parallel calls
    public Mono<AggregatedData> getAggregatedData(Long userId) {
        return Mono.zip(
            getUser(userId),
            getOrders(userId).collectList(),
            getProfile(userId)
        ).map(tuple -> new AggregatedData(tuple.getT1(), tuple.getT2(), tuple.getT3()));
    }
}
```

---

## Functional Endpoints

```java
@Configuration
public class RouterConfig {

    @Bean
    public RouterFunction<ServerResponse> userRoutes(UserHandler handler) {
        return RouterFunctions.route()
            .path("/api/users", builder -> builder
                .GET("", handler::getAll)
                .GET("/{id}", handler::getById)
                .POST("", handler::create)
                .PUT("/{id}", handler::update)
                .DELETE("/{id}", handler::delete)
            )
            .build();
    }
}

@Component
@RequiredArgsConstructor
public class UserHandler {

    private final UserService userService;

    public Mono<ServerResponse> getById(ServerRequest request) {
        Long id = Long.parseLong(request.pathVariable("id"));
        return userService.findById(id)
            .flatMap(user -> ServerResponse.ok()
                .contentType(MediaType.APPLICATION_JSON)
                .bodyValue(user))
            .switchIfEmpty(ServerResponse.notFound().build());
    }

    public Mono<ServerResponse> create(ServerRequest request) {
        return request.bodyToMono(CreateUserRequest.class)
            .flatMap(userService::create)
            .flatMap(user -> ServerResponse.created(
                    URI.create("/api/users/" + user.getId()))
                .bodyValue(user));
    }
}
```

---

## Best Practices

| Do | Don't |
|----|-------|
| Keep chain fully reactive | Use .block() in handlers |
| Use appropriate operators (flatMap vs concatMap) | Mix blocking and reactive |
| Handle errors with onError* operators | Ignore errors |
| Use StepVerifier for testing | Test with .block() |
| Propagate Context for MDC/security | Use ThreadLocal |

## Production Checklist

- [ ] Timeout configured on WebClient
- [ ] Error handling complete
- [ ] Retry logic for transient errors
- [ ] Backpressure strategy defined
- [ ] Context propagation for logging
- [ ] Reactive metrics
- [ ] Test with StepVerifier

## When NOT to Use This Skill

- **Traditional blocking apps** - Use `spring-web` skill
- **Simple CRUD APIs** - Use `spring-rest` skill
- **CPU-bound workloads** - Reactive doesn't help here
- **Team unfamiliar with reactive** - Learning curve is steep

## Anti-Patterns

| Anti-Pattern | Problem | Solution |
|--------------|---------|----------|
| Nothing executes | Publisher not subscribed | Ensure subscribe/return from controller |
| Blocking call | .block() in reactive chain | Avoid block, use operators |
| Context lost | MDC not propagated | Use Context propagation |
| Memory leak | Infinite Flux without backpressure | Use backpressure operators |
| Cold vs Hot confusion | Publisher recreated every subscribe | Use .share() or .cache() |

## Quick Troubleshooting

| Problem | Diagnostic | Fix |
|---------|------------|-----|
| Mono/Flux never completes | Check for missing subscribe | Return from controller |
| Context not available | Check propagation | Use Hooks.enableAutomaticContextPropagation() |
| Backpressure overflow | Check buffer size | Use onBackpressure* operators |
| Test times out | Check StepVerifier usage | Use virtual time for delays |
| Memory keeps growing | Check for leaks | Use .limitRate() or .take() |

## Reference Documentation

- [Spring WebFlux](https://docs.spring.io/spring-framework/reference/web/webflux.html)
- [Project Reactor](https://projectreactor.io/docs/core/release/reference/)

## Related Skills

- `spring-r2dbc` - For reactive database access
- `spring-web` - For comparison with MVC
- `spring-websocket` - For reactive WebSocket

© claude-dev-suite · MIT · claude-dev-suite/claude-dev-suite

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
java-spring-boot pluginagentmarketplace Скилл java-spring-boot помогает создавать бэкенд на Spring Boot 3: настраивать REST API, аутентификацию через Spring Security, доступ к базам через Spring Data и мониторинг Actuator. CX Codex +1 11 800установок create-spring-boot-java-project официальный github Скилл create-spring-boot-java-project разворачивает каркас приложения Spring Boot через start.spring.io с готовой конфигурацией базы данных, тестов и Docker. Запускается при запросе на генерацию нового сервиса на Java. CX Codex +1 9 516установок spring-boot-engineer https://github.com/Jeffallan Скилл spring-boot-engineer разворачивает архитектуру Spring Boot 3.x, контроллеры, репозитории Spring Data JPA и правила Spring Security 6. Пригодится при сборке REST API, реактивных сервисов и микросервисов на Java. CX Codex +1 8 900установок create-spring-boot-kotlin-project официальный github Скилл create-spring-boot-kotlin-project для GitHub Copilot, который разворачивает каркас Spring Boot-проекта на Kotlin. Скачивает шаблон со start.spring.io, добавляет зависимости и конфигурацию для Redis, PostgreSQL и MongoDB. CX Codex +1 8 700установок spring-boot-test-patterns giuseppe-trisciuoglio Скилл spring-boot-test-patterns подсказывает агенту, как писать тесты Spring Boot: юнит-тесты с Mockito, срезы @DataJpaTest и @WebMvcTest, интеграционные с Testcontainers. CX Codex +1 4 500установок spring-boot-security-jwt giuseppe-trisciuoglio Скилл spring-boot-security-jwt с готовыми шаблонами JWT-аутентификации для Spring Boot 3.5.x: генерация токенов через JJWT, фильтры, RBAC и OAuth2. CX Codex +1 4 400установок

Из того же набора14

Весь набор →
email-sending Скилл email-sending для Claude Code подключает отправку транзакционных писем, шаблоны и почтовые сервисы. Отправляет welcome-письма, сбросы пароля и уведомления. CX Codex +1 188установок cron-scheduling Скилл cron-scheduling для Claude Code помогает задавать cron-расписания и планировать фоновые задачи в Node.js, Java и Python. Описывает периодические запуски и распределённое планирование. CX Codex +1 162установок iec61131 Разбирает языки PLC, типы данных и организацию программ по IEC 61131-3. Помогает обсуждать стандарты и обмен проектами между платформами. CX Codex +1 154установок plsql Oracle PL/SQL — процедуры, функции, пакеты, триггеры, курсоры, коллекции и обработка исключений. CX Codex +1 106установок socket-io Добавляет в агент паттерны для работы с Socket.IO: комнаты, авторизацию через middleware, типизацию в TypeScript и масштабирование через Redis. CX Codex +1 106установок sonarqube Настраивает проверку качества кода через SonarQube или SonarCloud. Помогает прописать quality gates, файл sonar-project.properties и шаги для CI/CD. CX Codex +1 106установок sqlserver Справочник по диалекту Microsoft SQL Server: типы данных, даты, строки, JSON и автоинкремент. CX Codex +1 102установок nats Объясняет Core NATS, JetStream и обмен запросами с ответом. Подключается к вопросам о NATS, шаблонах subject и связи микросервисов. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой