grpc / grpc/grpc-java

Tracking Issue for setOnCloseHandler being Experimental

Abierto
#8,467 3 comentarios 0 reacciones 0 asignados Ver en GitHub
experimental API
Lenguaje dominante
Java
Estrellas
12.1k
Forks
4k
Merge medio
2 d 17 h
PR fusionados (30 d)
37

Descripción

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

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Comienza con el issue #5895 y el PR #8452, y luego revisa la API propuesta ServerCallStreamObserver.setOnFinishHandler(...) y su debate sobre nombres alternativos. Confirma la denominación final y el estado de la API experimental, y actualiza este issue de seguimiento solo si el trabajo enlazado deja pendiente alguna decisión o acción de seguimiento.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
grpc, java
Área
api, backend
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
20/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.