BREAKING: Overhaul of URL APIs

[lauzadis]

An upcoming release of the AWS SDK for Kotlin changes various APIs which deal with URLs.

Release Date

This feature will ship with the v0.37.0-beta release planned for 11/24/2023.

What’s changing

The URL APIs are completely rewritten to clarify content encoding, when data is in which state, and to reduce the number of times data is encoded/decoded, among other things.

Several classes are moved out of aws.smithy.kotlin.runtime.util into more appropriate packages like text and collections.

How to Migrate

Because this is an overhaul of the entire API surface, it’s difficult to provide a general migration runbook. In general, if you’re explicitly using any URL APIs, you’ll need to update them to comply with the changes. The general API footprint remains the same, but there may be some changes required for advanced use-cases.

Feedback

If you have any questions concerning this change, please feel free to engage with us in this discussion. If you encounter a bug with these changes, please file an issue.