Skip to content

spring-boot-runtime-config.md

Latest commit

 

History

History
74 lines (56 loc) · 2.52 KB

spring-boot-runtime-config.md

File metadata and controls

74 lines (56 loc) · 2.52 KB
Raw

Spring Boot Runtime Configuration

This document is the source of truth for the Spring Boot runtime configuration used by:

  • spring-boot/server/spring-boot-server-autoconfigure
  • spring-boot/server/rest/spring-boot-starter-server-rest
  • spring-boot/server/rest/spring-boot-server-rest
  • spring-boot/server/rest/spring-boot-server-integration-tests
  • spring-boot/server/rest/spring-boot-server-rest-sut
  • examples/spring-boot/rest/server
  • examples/spring-boot/rest/client

Configuration Properties

Property Default Purpose
spring.a2a.executor.core-pool-size 5 Core size of the internal executor.
spring.a2a.executor.max-pool-size 50 Maximum size of the internal executor.
spring.a2a.executor.keep-alive-seconds 60 Idle timeout for extra executor threads.
spring.a2a.executor.queue-capacity 100 Queue size for the internal executor.
spring.a2a.blocking.agent-timeout-seconds 30 Timeout for agent-side blocking operations.
spring.a2a.blocking.consumption-timeout-seconds 5 Timeout for event consumption operations.
spring.a2a.agent-card.cache.max-age 3600 Agent card cache max age in seconds.

Shared Runtime Example

Use this as the baseline runtime configuration for server modules:

spring:
  a2a:
    executor:
      core-pool-size: 5
      max-pool-size: 50
      keep-alive-seconds: 60
      queue-capacity: 100
    blocking:
      agent-timeout-seconds: 30
      consumption-timeout-seconds: 5
    agent-card:
      cache:
        max-age: 3600

Legacy a2a.* keys are still accepted by the runtime config provider for backward compatibility, but new configuration should use spring.a2a.*.

Bean Override Model

Application beans override the defaults when they are present in the Spring context.

Runtime Beans

  • TaskStore
  • MainEventBus
  • QueueManager
  • MainEventBusProcessor
  • PushNotificationConfigStore
  • PushNotificationSender
  • RequestHandler

Executor Beans

  • a2aInternalExecutor
  • a2aEventConsumerExecutor

Configuration Provider Chain

A2AConfigProvider reads Spring Environment properties first and falls back to the classpath defaults loaded by DefaultValuesConfigProvider.

Notes

  • This module set does not require Servlet APIs for the core runtime.
  • RequestHandler is created only when the application provides an AgentExecutor.
  • The auto-configuration is registered through META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports.