This release contains all of the changes from 1.7.0-RC and is compatible with Kotlin 2.0.
Please note that for reasons explained in the 1.7.0-RC changelog, it may not be possible to use it with the Kotlin 1.9.x
compiler plugin. Yet, it is still fully backward compatible with previous versions.
The only difference with 1.7.0-RC is that the classDiscriminatorMode property in JsonBuilder is marked as experimental,
as it should have been when it was introduced (#2680).
1.7.0-RC
This is a release candidate for the next version. It is based on Kotlin 2.0.0-RC3 and is fully compatible with a stable Kotlin 2.0 release.
Due to a potential breaking change (see below), it requires a compiler plugin with a version at least of 2.0.0-RC1.
Important change: priority of PolymorphicSerializer for interfaces during call to serializer() function
Non-sealed interfaces in kotlinx.serialization are always serializable with a polymorphic serializer,
even if they do not have @Serializable annotation. This also means that serializersModule.serializer<SomeInterface>() call will return you a serializer capable of polymorphism. This function was written in a way that it unconditionally returns a PolymorphicSerializer if type argument is a non-sealed interface. This caused problems with SerializersModule functionality, because actual module was not taken into consideration, and therefore it was impossible to override serializer for interface using 'contextual serialization' feature. The problem is described in detail here. To overcome these problems, we had to change the behavior of this function regarding interfaces. It now looks into SerializersModule first if T is a non-sealed interface, and only if there is no registered contextual serializer for T, it returns a polymorphic serializer.
Behavior before 1.7.0-RC:
interface SomeInterface
val module = SerializersModule {
contextual(SomeInterface::class, CustomSomeInterfaceSerializer)
}
// Prints PolymorphicSerializer<SomeInterface>:
println(module.serializer<SomeInterface>())
Behavior in 1.7.0-RC, 1.7.0, and higher:
interface SomeInterface
val module = SerializersModule {
contextual(SomeInterface::class, CustomSomeInterfaceSerializer)
}
// Prints CustomSomeInterfaceSerializer:
println(module.serializer<SomeInterface>())
We expect minimal impact from this change, but be aware of it anyway.
Implementation details are available in this PR.
Due to the serializer() function being also a compiler intrinsic, code
of kotlinx.serialization compiler plugin also accommodates this change in the 2.0 branch. To get a consistent result from both plugin and runtime, kotlinx.serialization compiler plugin should be at least of 2.0.0-RC1 version.To verify so, 1.7.0-RC runtime will be rejected by older plugins.
This release contains all of the changes from 1.7.0-RC and is compatible with Kotlin 2.0.
Please note that for reasons explained in the 1.7.0-RC changelog, it may not be possible to use it with the Kotlin 1.9.x
compiler plugin. Yet, it is still fully backwards compatible with previous versions.
The only difference with 1.7.0-RC is that classDiscriminatorMode property in JsonBuilder is marked as experimental,
as it should have been when it was introduced (#2680).
1.7.0-RC / 2024-05-16
This is a release candidate for the next version. It is based on Kotlin 2.0.0-RC3 and is fully compatible with a stable Kotlin 2.0 release.
Due to a potential breaking change (see below), it requires a compiler plugin with a version at least of 2.0.0-RC1.
Important change: priority of PolymorphicSerializer for interfaces during call to serializer() function
Non-sealed interfaces in kotlinx.serialization are always serializable with a polymorphic serializer,
even if they do not have @Serializable annotation. This also means that serializersModule.serializer<SomeInterface>() call will return you a serializer capable of polymorphism.
This function was written in a way that it unconditionally returns a PolymorphicSerializer if type argument is a non-sealed interface.
This caused problems with SerializersModule functionality, because actual module was not taken into consideration, and therefore it was impossible
to override serializer for interface using 'contextual serialization' feature. The problem is described in details here.
To overcome these problems, we had to change the behavior of this function regarding interfaces. It now looks into SerializersModule first if T is a non-sealed interface,
and only if there is no registered contextual serializer for T, it returns a polymorphic serializer.
Behavior before 1.7.0-RC:
interface SomeInterface
val module = SerializersModule {
contextual(SomeInterface::class, CustomSomeInterfaceSerializer)
}
// Prints PolymorphicSerializer<SomeInterface>:
println(module.serializer<SomeInterface>())
Behavior in 1.7.0-RC, 1.7.0, and higher:
interface SomeInterface
val module = SerializersModule {
contextual(SomeInterface::class, CustomSomeInterfaceSerializer)
}
// Prints CustomSomeInterfaceSerializer:
println(module.serializer<SomeInterface>())
</tr></table>
... (truncated)
Commits
d2dc7d2 Update to Kotlin 2.0 and prepare 1.7.0 release (#2706)
1cac162 Merge remote-tracking branch 'origin/master' into dev
fbd0734 Use @PublishedApi annotation on functions called from plugin-generated code (...
4bf4113 Add bencoding to community-supported formats (#2687)
c487e78 JSON: Fix mutable classDiscriminatorMode in config, and mark experimental i...
Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.
Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot show ignore conditions` will show all of the ignore conditions of the specified dependency
- `@dependabot ignore major version` will close this group update PR and stop Dependabot creating any more for the specific dependency's major version (unless you unignore this specific dependency's major version or upgrade to it yourself)
- `@dependabot ignore minor version` will close this group update PR and stop Dependabot creating any more for the specific dependency's minor version (unless you unignore this specific dependency's minor version or upgrade to it yourself)
- `@dependabot ignore ` will close this group update PR and stop Dependabot creating any more for the specific dependency (unless you unignore this specific dependency or upgrade to it yourself)
- `@dependabot unignore ` will remove all of the ignore conditions of the specified dependency
- `@dependabot unignore ` will remove the ignore condition of the specified dependency and ignore conditions
dependabot[bot]
commented
3 weeks ago
Bumps the core-libs group with 4 updates in the / directory: org.jetbrains.kotlinx:kotlinx-serialization-json, com.nimbusds:nimbus-jose-jwt, org.jetbrains.kotlin.jvm and org.jetbrains.kotlin.plugin.serialization.
Updates
org.jetbrains.kotlinx:kotlinx-serialization-jsonfrom 1.6.2 to 1.7.0Release notes
Sourced from org.jetbrains.kotlinx:kotlinx-serialization-json's releases.
... (truncated)
Changelog
Sourced from org.jetbrains.kotlinx:kotlinx-serialization-json's changelog.
... (truncated)
Commits
d2dc7d2Update to Kotlin 2.0 and prepare 1.7.0 release (#2706)1cac162Merge remote-tracking branch 'origin/master' into devfbd0734Use@PublishedApiannotation on functions called from plugin-generated code (...4bf4113Add bencoding to community-supported formats (#2687)c487e78JSON: Fix mutableclassDiscriminatorModein config, and mark experimental i...385c97dRemove yellow code (#2691)688f64bAdded link to kotlinx-serialization-smile in the formats list (#2689)1f38e22Add additional repositorydd1b76ePrepare Changelog and Readme for 1.7.0-RC releaseb4bf182Raise Require-Kotlin-Version to 2.0.0-RC1Updates
com.nimbusds:nimbus-jose-jwtfrom 9.37.3 to 9.40Changelog
Sourced from com.nimbusds:nimbus-jose-jwt's changelog.
... (truncated)
Commits
4320e1fDisables tests incompatible with BC "fips" profilecaf5b9fChange log edits0fcdc21SignedJWT, EncryptedJWT and PlainJWT must serialise JWTClaimsSet claims with ...cb37910JWEObject.decrypt must reject cipher texts of compressed plain text that are ...f470497Chane log edits for 9.3857f268d[maven-release-plugin] prepare release 9.384409b5f[maven-release-plugin] prepare for next development iteration6820c9dMerged connect2id/nimbus-jose-jwt into masterf14e944Bumped Maven pluginsbd59d30Adds JSONObjectUtils.getEpochSecondAsDate, JWTClaimsSet.parse must handle nul...Updates
org.jetbrains.kotlin.jvmfrom 1.9.22 to 2.0.0Release notes
Sourced from org.jetbrains.kotlin.jvm's releases.
... (truncated)
Changelog
Sourced from org.jetbrains.kotlin.jvm's changelog.
... (truncated)
Commits
e84e835Add changelog for 2.0.0975dea2Add changelog for 2.0.0-RC3b618ee4[FIR] Prohibit referencing java field in case of conflict with property..b239239K2: build outer classes sequence in FirImplicitBodyResolve properlyafc5b49[IR] Assume IrFile has at least one offset entrybe1804c[K/N][tests] Don't attempt to download simulator after first failureb666160K2: fix captureFromExpressionInternal for nullable intersection typesf04f051K2: fix withNullability() for ConeIntersectionTypecda1ad4K2: reproduce KT-679128e0919e[K2/JS] Use declaration session for looking up containing declarationUpdates
org.jetbrains.kotlin.plugin.serializationfrom 1.9.22 to 2.0.0Release notes
Sourced from org.jetbrains.kotlin.plugin.serialization's releases.
... (truncated)
Changelog
Sourced from org.jetbrains.kotlin.plugin.serialization's changelog.
... (truncated)
Commits
e84e835Add changelog for 2.0.0975dea2Add changelog for 2.0.0-RC3b618ee4[FIR] Prohibit referencing java field in case of conflict with property..b239239K2: build outer classes sequence in FirImplicitBodyResolve properlyafc5b49[IR] Assume IrFile has at least one offset entrybe1804c[K/N][tests] Don't attempt to download simulator after first failureb666160K2: fix captureFromExpressionInternal for nullable intersection typesf04f051K2: fix withNullability() for ConeIntersectionTypecda1ad4K2: reproduce KT-679128e0919e[K2/JS] Use declaration session for looking up containing declarationUpdates
org.jetbrains.kotlin.plugin.serializationfrom 1.9.22 to 2.0.0Release notes
Sourced from org.jetbrains.kotlin.plugin.serialization's releases.
... (truncated)
Changelog
Sourced from org.jetbrains.kotlin.plugin.serialization's changelog.
... (truncated)
Commits
e84e835Add changelog for 2.0.0975dea2Add changelog for 2.0.0-RC3b618ee4[FIR] Prohibit referencing java field in case of conflict with property..b239239K2: build outer classes sequence in FirImplicitBodyResolve properlyafc5b49[IR] Assume IrFile has at least one offset entrybe1804c[K/N][tests] Don't attempt to download simulator after first failureb666160K2: fix captureFromExpressionInternal for nullable intersection typesf04f051K2: fix withNullability() for ConeIntersectionTypecda1ad4K2: reproduce KT-679128e0919e[K2/JS] Use declaration session for looking up containing declarationDependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot merge` will merge this PR after your CI passes on it - `@dependabot squash and merge` will squash and merge this PR after your CI passes on it - `@dependabot cancel merge` will cancel a previously requested merge and block automerging - `@dependabot reopen` will reopen this PR if it is closed - `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - `@dependabot show