fankes/moshi
2
0
Fork 0
mirror of https://github.com/fankes/moshi.git synced 2025-12-13 00:31:02 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Prepare for release 1.11.0.

Browse Source
This commit is contained in:
Jesse Wilson
2020-10-04 20:52:00 -04:00
parent 230c3d801f
commit 4d3ca9a174
3 changed files with 71 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

65
CHANGELOG.md
View File

@@ -1,6 +1,67 @@
Change Log
==========
## Version 1.11.0
_2020-10-04_
* New: Kotlin extension functions and properties. Use of these extensions is only possible from
Kotlin, and requires the Kotlin stdlib dependency. This release does not have any Kotlin
requirement and can be used Kotlin-free from Java.
```kotlin
/** Extension alternative to [Types.nextAnnotations()]. */
fun <reified T : Annotation> Set<Annotation>.nextAnnotations(): Set<Annotation>?
/** Extension alternative to [Types.getRawType()]. */
val Type.rawType: Class<*>
/** Extension alternative to [Types.arrayOf()]. */
fun KClass<*>.asArrayType(): GenericArrayType
/** Extension alternative to [Types.arrayOf()]. */
fun Type.asArrayType(): GenericArrayType
```
* New: Experimental Kotlin extensions. These depend on unreleased APIs and may break in a future
release of Kotlin. If you are comfortable with this, add `@ExperimentalStdlibApi` at the callsite
or add this argument to your Kotlin compiler: `"-Xopt-in=kotlin.ExperimentalStdlibApi"`.
```kotlin
/** Returns the adapter for [T]. */
inline fun <reified T> Moshi.adapter(): JsonAdapter<T>
/** Returns the adapter for [ktype]. */
fun <T> Moshi.adapter(ktype: KType): JsonAdapter<T>
/** Adds an adapter for [T]. */
inline fun <reified T> Moshi.Builder.addAdapter(adapter: JsonAdapter<T>): Moshi.Builder
/** Extension alternative to [Types.arrayOf()]. */
fun KType.asArrayType(): GenericArrayType
/** Extension alternative to [Types.subtypeOf()]. */
inline fun <reified T> subtypeOf(): WildcardType
/** Extension alternative to [Types.supertypeOf()]. */
inline fun <reified T> supertypeOf(): WildcardType
```
* New: `JsonReader.nextSource()`. This returns an Okio `BufferedSource` that streams the UTF-8
bytes of a JSON value. Use this to accept JSON values without decoding them, to delegate to
another JSON processor, or for streaming access to very large embedded values.
* New: `Moshi.Builder.addLast()`. Use this when installing widely-applicable adapter factories like
`KotlinJsonAdapterFactory`. Adapters registered with `add()` are preferred (in the order they
were added), followed by all adapters registered with `addLast()` (also in the order they were
added). This precedence is retained when `Moshi.newBuilder()` is used.
* New: `setTag()`, `tag()` methods on `JsonReader` and `JsonWriter`. Use these as a side-channel
between adapters and their uses. For example, a tag may be used to track use of unexpected
data in a custom adapter.
* Fix: Don't crash with a `StackOverflowError` decoding backward-referencing type variables in
Kotlin. This caused problems for parameterized types like `MyInterface<E : Enum<E>>`.
* Upgrade: [Okio 1.17.5][okio_1_7_5].
* Upgrade: [Kotlin 1.4.10][kotlin_1_4_10].
## Version 1.10.0
_2020-08-26_
@@ -418,8 +479,10 @@ _2015-06-16_
[dates_example]: https://github.com/square/moshi/blob/master/examples/src/main/java/com/squareup/moshi/recipes/ReadAndWriteRfc3339Dates.java
[rfc_7159]: https://tools.ietf.org/html/rfc7159
[gson]: https://github.com/google/gson
[jackson]: http://wiki.fasterxml.com/JacksonHome
[kotlin_1_4_10]: https://github.com/JetBrains/kotlin/releases/tag/v1.4.10
[maven_provided]: https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html
[moshi_kotlin_docs]: https://github.com/square/moshi/blob/master/README.md#kotlin
[okio_1_7_5]: https://square.github.io/okio/changelog/#version-1175
[rfc_7159]: https://tools.ietf.org/html/rfc7159