diff --git a/docs/src/main/paradox/release-notes/10.2.x.md b/docs/src/main/paradox/release-notes/10.2.x.md index 2e9a349d843..0a3c94ae03b 100644 --- a/docs/src/main/paradox/release-notes/10.2.x.md +++ b/docs/src/main/paradox/release-notes/10.2.x.md @@ -1,14 +1,15 @@ # 10.2.x Release Notes -We have released 10.2.0-M1, the first milestone leading up to version 10.2.0 of Akka HTTP. +Among other things, 10.2.0-RC1 contains: -Among other things, 10.2.0-M1 contains: - -* Improved API's and documentation to improve the experience working with Akka 2.6 and the new Actor API's. Akka HTTP 10.2.0 will keep supporting Akka 2.5. +* APIs and documentation now provide a seemless experience with Akka 2.6 and the new Actor APIs. Akka HTTP 10.2.x will still be supporting Akka 2.5 to ease incremental updating. * Some new features, including the ability to [attach attributes to requests and responses](https://doc.akka.io/docs/akka-http/10.2.0-M1/common/http-model.html#attributes). +* Allow client setting overrides for target hosts via configuration [#2574](https://github.com/akka/akka-http/pull/2574) * Improved default configuration, such as [disabling transparent HEAD support by default](https://github.com/akka/akka-http/issues/2088). * Various bug fixes, such as around [percent-encoding URI queries](https://github.com/akka/akka-http/pull/3003) and [parsing headers with unicode characters](https://github.com/akka/akka-http/issues/1484). * Various improvements to HTTP/2 support, driven by [Akka gRPC](https://doc.akka.io/docs/akka-grpc). +* Support for Akka Coordinated Shutdown [#3142](https://github.com/akka/akka-http/pull/3142) +* Remove legacy host connection pool including settings and tests [#3188](https://github.com/akka/akka-http/pull/3188) ### Migration notes @@ -26,10 +27,15 @@ we release 10.2.0 proper. * Silence outgoing request stream error [#2905](https://github.com/akka/akka-http/pull/2905) * Add SameSite attribute to Cookies [#2928](https://github.com/akka/akka-http/pull/2928) * Only catch NonFatal Exceptions [#2853](https://github.com/akka/akka-http/pull/2853) +* Add coordinated shutdown support [#3142](https://github.com/akka/akka-http/pull/3142) * Percent-encode illegal chars when creating URI query [#3003](https://github.com/akka/akka-http/pull/3003) * Add the remote address in parse errors when possible [#2899](https://github.com/akka/akka-http/pull/2899) * Remove `UseHttp2` [#2896](https://github.com/akka/akka-http/pull/2896) +* Hide body and headers by default in `HttpRequest#toString` and `HttpResponse#toString` [#2560](https://github.com/akka/akka-http/pull/2560) * Fix headers javadsl scaladoc [#2932](https://github.com/akka/akka-http/pull/2932) +* Allow client setting overrides for target hosts in config [#2574](https://github.com/akka/akka-http/pull/2574) +* Fix EOL detection for body part parsing [#2581](https://github.com/akka/akka-http/pull/2581) +* Update javadsl bindAndHandle to take a Java function and System [#3223](https://github.com/akka/akka-http/pull/3223) * Identify Content-Type `charset` parameter even if not lower case [#2926](https://github.com/akka/akka-http/pull/2926) * Prevent initialization NPE which might fail all retries quickly [#2958](https://github.com/akka/akka-http/pull/2958) * Add exclusion for Extension issues when building against Akka 2.6 [#2945](https://github.com/akka/akka-http/pull/2945) @@ -40,19 +46,42 @@ we release 10.2.0 proper. * Better support for the new Actors API [#3036](https://github.com/akka/akka-http/pull/3036) * Parse empty query `?` to `Query.empty` [#3042](https://github.com/akka/akka-http/pull/3042) * Make sure to cancel response entity on failure [#3046](https://github.com/akka/akka-http/pull/3046) -* add `akka.http.server.remote-address-attribute` [#2924](https://github.com/akka/akka-http/pull/2924) +* Add `akka.http.server.remote-address-attribute` [#2924](https://github.com/akka/akka-http/pull/2924) * Make `transparent-head-requests` opt-in [#3063](https://github.com/akka/akka-http/pull/3063) +* Continue more gracefully when encountering multiple Host headers in a response [#3158](https://github.com/akka/akka-http/pull/3158) * Allow customizing parsing errors [#3049](https://github.com/akka/akka-http/pull/3049) +* Don't extend from Char => Boolean for CharPredicate [#3107](https://github.com/akka/akka-http/pull/3107) * Add server-side streamCancellationDelay to mitigate cancellation race conditions [#2116](https://github.com/akka/akka-http/pull/2116) +* Improve error message about unconsumed entity [#3109](https://github.com/akka/akka-http/pull/3109) +* Header rendering with less indirection [#3106](https://github.com/akka/akka-http/pull/3106) +* Remove deprecated methods taking implicit materializers [#3119](https://github.com/akka/akka-http/pull/3119) +* Simplify `superPool` and `clientFlow` [#3156](https://github.com/akka/akka-http/pull/3156) +* Deprecate Remote-Address header [#3174](https://github.com/akka/akka-http/pull/3174) +* Move `max-content-length` definition from top to server/client [#3098](https://github.com/akka/akka-http/pull/3098) +* Add test for failure propagation into websocket flows [#3276](https://github.com/akka/akka-http/pull/3276) +* Deprecate UpgradeToWebSocket [#3278](https://github.com/akka/akka-http/pull/3278), [#3296](https://github.com/akka/akka-http/pull/3296) #### akka-http * Allow names as alternative to directive combiners [#3085](https://github.com/akka/akka-http/pull/3085) * Names for symbolic enhancements [#3082](https://github.com/akka/akka-http/pull/3082) * Allow names to match paths [#3089](https://github.com/akka/akka-http/pull/3089) +* Remove deprecated FormFieldDirectives methods [#3120](https://github.com/akka/akka-http/pull/3120) +* Remove magnets usage from formField directives [#3289](https://github.com/akka/akka-http/pull/3289) +* Provide Route.toFunction as alternative to Route.asyncHandler [#3115](https://github.com/akka/akka-http/pull/3115) +* New `handle` directive to create Route from function [#3239](https://github.com/akka/akka-http/pull/3239) +* Allow 'bindAndHandleAsync' to take a 'Route' [#3237](https://github.com/akka/akka-http/pull/3237) +* Make X-Real-IP take precedence over Remote-Address [#3173](https://github.com/akka/akka-http/pull/3173) +* Allow passing a companion object to headerValueByType [#3279](https://github.com/akka/akka-http/pull/3279) +* Replace magnetic parameter overloads by boilerplate-generated overloads [#2971](https://github.com/akka/akka-http/pull/2971) +* Deprecate directives taking `Symbol` as argument [#3291](https://github.com/akka/akka-http/pull/3291) +* Remove uploadedFile (deprecated in 10.0.11) [#3118](https://github.com/akka/akka-http/pull/3118) +* Deprecate internal parts of coding infrastructure [#3262](https://github.com/akka/akka-http/pull/3262) +* Deprecate HttpApp [#3162](https://github.com/akka/akka-http/pull/3162) #### akka-http-marshallers +* Only show unmarshalling error details when 'verbose-error-messages' is on [#3265](https://github.com/akka/akka-http/pull/2365) * Jackson: Better JSON validation error when unmarshalling [#2901](https://github.com/akka/akka-http/pull/2901) #### akka-http-testkit @@ -61,25 +90,38 @@ we release 10.2.0 proper. * Update to Scalatest 3.1.0 [#2851](https://github.com/akka/akka-http/pull/2851) * Handle test exceptions separately from regular exceptions [#2949](https://github.com/akka/akka-http/pull/2949) * Simplify implicits for RouteTest [#3060](https://github.com/akka/akka-http/pull/3060) +* Fix more Scala 2.13 warnings [#3130](https://github.com/akka/akka-http/pull/3130) #### docs +* Use typed ActorSystem in examples [#3242](https://github.com/akka/akka-http/pull/3242) +* Routing DSL style guide [#3099](https://github.com/akka/akka-http/pull/3099) +* Routing DSL compared with Play routes [#3079](https://github.com/akka/akka-http/pull/3979) * Small typo in docs/src/main/paradox/common/marshalling.md [#2864](https://github.com/akka/akka-http/pull/2864) * Add warning on usage on extractClientIP [#2922](https://github.com/akka/akka-http/pull/2922) * Show `RequestBuilding` in client examples [#2968](https://github.com/akka/akka-http/pull/2968) +* Don't claim that SNI is a security feature [#3257](https://github.com/akka/akka-http/pull/3257) * Update documentation and examples to Akka 2.6 [#2996](https://github.com/akka/akka-http/pull/2996) * Link to major/minor Akka docs [#3048](https://github.com/akka/akka-http/pull/3048) +* Actor interop Java example [#3078](https://github.com/akka/akka-http/pull/3078) * Make Case class extraction example work with 2.13 [#3092](https://github.com/akka/akka-http/pull/3092) +* Fix more Scala 2.13 warnings [#3130](https://github.com/akka/akka-http/pull/3130) * Update extractClientIP.md wrt `remote-address-attribute` [#3083](https://github.com/akka/akka-http/pull/3083) * Make `HttpServerWithActorsSample` more 2.6-style [#3077](https://github.com/akka/akka-http/pull/3077) +* Show symbolic Akka version for dependencies [#3121](https://github.com/akka/akka-http/pull/3121) +* Support native ALPN in JDK >=8u251 [#3117](https://github.com/akka/akka-http/pull/3117) #### akka-http2-support +* Initial HTTP/2 client implementation bits [#3166](https://github.com/akka/akka-http/pull/3166) * Potential fix for idle timeouts in http2 [#2776](https://github.com/akka/akka-http/pull/2776) +* Frame parsing: improve handling of unknown values [#3101](https://github.com/akka/akka-http/pull/3101) +* Support native ALPN in JDK >=8u251 [#3117](https://github.com/akka/akka-http/pull/3117) * Fix HeaderCompression updating table size without giving notice to peer [#2891](https://github.com/akka/akka-http/pull/2891) * Reduce http2 buffer debug logging [#3025](https://github.com/akka/akka-http/pull/3025) * Accept RST on an already-half-closed HTTP/2 stream [#2976](https://github.com/akka/akka-http/pull/2976) * Gracefully discard unsupported h2 SETTINGS [#3053](https://github.com/akka/akka-http/pull/3053) +* Make the HTTP/2 Stream ID an attribute [#3224](https://github.com/akka/akka-http/pull/3224) #### akka-http-caching @@ -89,5 +131,8 @@ we release 10.2.0 proper. * Fix project-info links to API docs [#2857](https://github.com/akka/akka-http/pull/2857) * Drop Scala 2.11 [#2589](https://github.com/akka/akka-http/pull/2589) +* Build with Scala 2.13 by default [#3126](https://github.com/akka/akka-http/pull/3126) * Better diagnostics when validatePullRequest fails weirdly [#2904](https://github.com/akka/akka-http/pull/2904) * Test against published snapshots instead of source deps [#3055](https://github.com/akka/akka-http/pull/3055) +* Enable some fatal warnings for docs [#3114](https://github.com/akka/akka-http/pull/3114) +* Add sbt-reproducible-builds [#3165](https://github.com/akka/akka-http/pull/3165)