grpc / grpc/grpc-java

Tracking Issue for setOnCloseHandler being Experimental

Ouverte
#8,467 3 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
experimental API
Langage dominant
Java
Étoiles
12.1k
Forks
4k
Merge moyen
2 j 17 h
PR mergées (30 j)
37

Description

To resolve issue #5895 PR #8452 has been created that adds new `ServerCallStreamObserver.setOnFinishHandler(...)` method.
The handler is called by `Listener.onComplete` _when the call is **finished** correctly from the server's point of view: either `onCompleted()` or `onError(Throwable)` has been called, all the messages and trailing metadata have been put on the wire and the stream has been closed_.

Several names were proposed for the handler:
- `onCompleteHandler` : derives name from `Listener`'s method but causes confusion with `StreamObserver.onCompleted()`
- `onSuccessHandler` : my initial idea, yet also confusing as it can be called also after `StreamObserver.onError(...)`
- `onFinishHandler` : current approach, matches well the verb from method's javadoc
- `onFinalizeHandler` : would also probably do well

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Commencez par l’issue #5895 et la PR #8452, puis examinez l’API proposée ServerCallStreamObserver.setOnFinishHandler(...) et sa discussion sur les noms alternatifs. Confirmez le nom final et le statut de l’API expérimentale, et mettez à jour cette issue de suivi uniquement si le travail lié laisse une décision ou une action de suivi en suspens.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
grpc, java
Domaine
api, backend
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
20/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.