akka/akka-core

Document best practices or provide a way to do TCP connection pooling

Open

#25,038 opened on May 2, 2018

View on GitHub
 (0 comments) (1 reaction) (0 assignees)Scala (13,277 stars) (3,547 forks)batch import
1 - triagedhelp wantedt:stream

Description

When building a TCP client using Akka Streams outgoingConnection it is common to want to reuse connections. Most of the time a higher level protocol should be used but there are cases e.g. when developing a client for an existing TCP protocol such as a database driver / SMTP client when connection pooling would be useful. Might not be possible to make this generic enough but adding something to the cookbook would be useful.

Contributor guide

Tech stack
None
Domain
backenddocumentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
4
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
3-5 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
Akka StreamsScalaTCP networking
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
20
Research direction
Investigate the existing Akka Streams documentation and source code for TCP connection handling. Look at the Akka Streams cookbook and the outgoingConnection API. Consider common patterns for connection pooling in Akka and how to document them. No linked PRs or comments are present, so the research should start from the Akka Streams documentation and source.
Document best practices or provide a way to do TCP connection pooling · akka/akka-core#25038 | Good First Issue