A type-safe HTTP client for Android and the JVM
New
OptionalConverterFactory
is now public to allow installing it before other converters which consume all types (e.g., Moshi, Gson, Jackson, etc.).Fixed
ClassCastException
.New
Support using Unit
as a response type. This can be used for non-body HTTP methods like HEAD
or body-containing HTTP methods like GET
where the body will be discarded without deserialization.
kotlinx.serialization converter!
This was imported from github.com/JakeWharton/retrofit2-kotlinx-serialization-converter/ and remains unchanged from its 1.0.0 release.
The Maven coordinates are com.squareup.retrofit2:converter-kotlinx-serialization
.
JAXB 3 converter!
The Maven coordinates are com.squareup.retrofit2:converter-jaxb3
.
@Header
, @Headers
, and @HeaderMap
can now set non-ASCII values through the allowUnsafeNonAsciiValues
annotation property. These are not technically compliant with the HTTP specification, but are often supported or required by services.
Publish a BOM of all modules. The Maven coordinates are com.squareup.retrofit2:retrofit-bom
.
Invocation
now exposes the service Class<?>
and the instance on which the method was invoked. This disambiguates the source when service inheritence is used.
A response type keeper annotation processor is now available for generating shrinker rules for all referenced types in your service interface. In some cases, it's impossible for static shrinker rules to keep the entirety of what Retrofit needs at runtime. This annotation processor generates those additional rules. For more info see its README.
Changed
Call
, Response
, etc.) which are used via reflection at runtime.Retrofit.create
function now has a non-null lower bound. Even if you specified a nullable type before this function would never return null.Throwable
subtypes (not just Exception
subtypes) to avoid Java's UndeclaredThrowableException
when thrown synchronously.suspend fun
functions that return Call<Body>
. These are never correct, and should declare a return type of Body
directly.create(ObjectMapper, MediaType)
overload to supply the value of the Content-Type
header for your format.Fixed