Exposing Maximum Connections Per Route in Ktor HttpClient Apache Engine

Answer

Yes – exposing the maximum connections per route for the Apache engine through the HttpClient configuration API is advisable, provided the default value is kept at the current hard‑coded 20 to preserve existing behavior.

Confirmed facts (from the research brief)

• The Apache engine allows customization of the underlying Apache HttpAsyncClient via an engine { } block.
• The property that controls the per‑route limit is maxConnectionsPerRoute.
• A related property, maxConnections, caps the total number of concurrent connections across all routes.
• Default values in many Ktor releases are low (≈2‑5) which can cause request queuing under high concurrency.

Likely explanation / recommendation

Making maxConnectionsPerRoute configurable gives developers the ability to tune concurrency for specific hosts without affecting the global pool. Keeping the default at 20 ensures that existing applications see no change in behavior, satisfying the backward‑compatibility requirement. The setting should be scoped to the Apache engine so that other engines (CIO, Darwin, etc.) simply ignore it or raise a clear configuration error if mistakenly applied.

Steps to expose the setting

1. Add an optional maxConnectionsPerRoute parameter to the Apache engine configuration block.
2. When the parameter is omitted, use the hard‑coded value 20 (the current default).
3. When supplied, pass the value to the underlying HttpAsyncClient builder (setMaxConnPerRoute or equivalent).
4. Validate that maxConnectionsPerRoute ≤ maxConnections (if both are set) and log a warning otherwise.
5. Document the property alongside existing engine options and note that it only affects the Apache engine.

Interaction with other engines

• CIO engine uses its own coroutine‑based pool and does not have a per‑route limit; the property would be ignored.
• Darwin (Apple) engine relies on URLSession, which manages connections internally; exposing the property would have no effect.
• Thus the new setting is engine‑specific and does not introduce cross‑engine side effects.

Missing diagnostic detail

To confirm that the default of 20 matches your actual Ktor version, please specify the Ktor version you are using (e.g., 2.3.0, 2.2.0). If the version differs, the default may need adjustment.