optimizely / optimizely/java-sdk
[ENHANCEMENT] Add Support for Custom `HttpRequestExecutor` in `OptimizelyHttpClient`
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- Java
- Estrellas
- 44
- Forks
- 32
- Merge medio
- 8 h 39 min
- PR fusionados (30 d)
- 1
Descripción
Description
Currently, the OptimizelyHttpClient in the Optimizely Java SDK uses a default HttpRequestExecutor provided by Apache HttpComponents library for handling HTTP requests. However, there is no extension point to allow developers to supply a custom HttpRequestExecutor.
Adding the ability to inject a custom HttpRequestExecutor would provide greater flexibility, enabling users to replace or extend the default behavior. For example, the inclusion of tools such as the MicrometerHttpRequestExecutor allows the collection of execution metrics, including latency, errors, and throughput.
While upgrading to Apache HttpComponents 5 would modernize the library and bring advanced features, adding this extension point would still be valuable. It ensures that developers can adapt or enhance the HTTP client behavior for monitoring and observability, regardless of which version of Apache HttpComponents is used.
Benefits
- Increased Observability: Developers can use custom executors, like the
MicrometerHttpRequestExecutor, to capture valuable execution metrics such as request duration, HTTP status distribution, and network errors. These metrics can be sent to monitoring systems like Prometheus or Datadog. - Enhanced Extensibility: A configurable
HttpRequestExecutorprovides an extension point for more advanced use cases, empowering developers to customize the HTTP behavior without requiring changes to the base SDK. - Future-Proof Design: Introducing this flexibility ensures that users have control over HTTP execution behavior, making it easier to adopt library upgrades in the future, including potential transitions to Apache HttpComponents 5.
Detail
- Add a configurable property to
OptimizelyHttpClientto allow injection of a customHttpRequestExecutor. - Provide a fallback to the existing default
HttpRequestExecutorif no custom request executor is supplied. - Update documentation to highlight this new extensibility feature and provide examples of using custom executors such as
MicrometerHttpRequestExecutor.
Examples
Not right now
Risks/Downsides
Not right now
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Empieza por localizar OptimizelyHttpClient y su configuración predeterminada actual de HttpRequestExecutor; después, revisa las pruebas y la documentación relacionadas del cliente HTTP. La tarea estará terminada cuando se pueda proporcionar un executor personalizado, el predeterminado existente siga siendo el fallback y la documentación incluya un ejemplo de uso como MicrometerHttpRequestExecutor.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- java
- Área
- backend, observability
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Estado de actividad
- Estancado
- Claridad
- Bastante claro
- Aptitud para principiantes
- 35/100