add kotlin docs alibaba#294

README.md

@@ -106,7 +106,7 @@ dependencies {
 }
 ```
 
-# 2 简单使用
+# 2. 简单使用
 
 在`fastjson v2`中，`package`和`1.x`不一样，是`com.alibaba.fastjson2`。如果你之前用的是`fastjson1`，大多数情况直接更包名就即可。
 
@@ -229,8 +229,8 @@ User user = obj.getObject("key", User.class);
 val array = ... // JSONArray
 val obj = ... // JSONObject
 
-val user = array.getObject<User>(0)
-val user = obj.getObject<User>("key")
+val user = array.to<User>(0)
+val user = obj.to<User>("key")
 ```
 
 #### 2.5.3 转为`JavaBean`
@@ -251,7 +251,7 @@ List<User> users = array.toJavaList(User.class);
 val array = ... // JSONArray
 val obj = ... // JSONObject
 
-val user = obj.toObject<User>() // User
+val user = obj.to<User>() // User
 val users = array.toList<User>() // List<User>
 ```
 

README_EN.md

@@ -106,7 +106,7 @@ dependencies {
 }
 ```
 
-# 2 Usage
+# 2. Usage
 
 The package name of `fastjson v2` is different from `fastjson v1`. It is `com.alibaba.fastjson2`. If you used `fastjson v1` before, simply change the package name.
 
@@ -229,8 +229,8 @@ User user = obj.getObject("key", User.class);
 val array = ... // JSONArray
 val obj = ... // JSONObject
 
-val user = array.getObject<User>(0)
-val user = obj.getObject<User>("key")
+val user = array.to<User>(0)
+val user = obj.to<User>("key")
 ```
 
 #### 2.5.3 Convert to JavaBean
@@ -251,7 +251,7 @@ List<User> users = array.toJavaList(User.class);
 val array = ... // JSONArray
 val obj = ... // JSONObject
 
-val user = obj.toObject<User>() // User
+val user = obj.to<User>() // User
 val users = array.toList<User>() // List<User>
 ```
 

docs/kotlin_cn.md

@@ -0,0 +1,171 @@
+# 1. 使用准备
+
+如果项目使用`Kotlin`，可以使用`fastjson-kotlin`模块，使用方式上采用`kotlin`的特性。
+
+### 1.1 添加依赖
+
+`Maven`:
+
+```xml
+
+<dependency>
+    <groupId>com.alibaba.fastjson2</groupId>
+    <artifactId>fastjson2-kotlin</artifactId>
+    <version>2.0.4</version>
+</dependency>
+```
+
+`Gradle`:
+
+```kotlin
+dependencies {
+    implementation("com.alibaba.fastjson2:fastjson2-kotlin:2.0.4")
+}
+```
+
+### 1.2 导包工作
+
+每当调用`fastjson-kotlin`里的函数时，需要完成导包工作，**否则会提示找不到相应函数**。
+
+例如:
+
+```kotlin
+import com.alibaba.fastjson2.to
+import com.alibaba.fastjson2.into
+```
+
+如果使用的函数很多时，可以使用通配符导入。
+
+```kotlin
+import com.alibaba.fastjson2.*
+```
+
+# 2. 简单使用
+
+这里，我们对函数名为`to`和`into`做了统一。
+
+- 使用`to`时利用`::Class.java`，适用于不含泛型的类。
+- 使用`into`时利用`TypeReference`，适用于含泛型的类。
+
+首先实例定义一个公共类
+
+```kotlin
+class User(
+    var id: Int,
+    var name: String
+)
+```
+
+### 2.1 将`JSON`解析为`JSONObject`
+
+```kotlin
+val text = "..." // String
+val data = text.parseObject()
+
+val bytes = ... // ByteArray
+val data = bytes.parseObject() // JSONObject
+```
+
+### 2.2 将`JSON`解析为`JSONArray`
+
+`Kotlin`:
+
+```kotlin
+val text = "..." // String
+val data = text.parseArray() // JSONArray
+```
+
+### 2.2 实例指定类的`TypeReference`
+
+```kotlin
+val refer = reference<User>()
+```
+
+### 2.3 将`JSON`解析为实例对象
+
+无泛型实例:
+
+```kotlin
+val text = "..." // String
+val data = text.to<User>() // User
+```
+
+含泛型实例:
+
+```kotlin
+val text = "..." // String
+val data = text.into<List<User>>() // List<User>
+val data = text.into<Map<String, User>>() // Map<String, User>
+```
+
+### 2.4 将实例对象序列化为`JSON`
+
+序列化为字符串:
+
+```kotlin
+val data = "..." // Any
+val text = text.toJSONString() // String
+```
+
+序列化为字节数据:
+
+```kotlin
+val data = "..." // Any
+val bytes = text.toJSONByteArray() // ByteArray
+```
+
+### 2.5 使用`JSONObject`、`JSONArray`
+
+#### 2.5.1 获取简单属性
+
+```kotlin
+val text = "..."
+val data = JSON.parseObject(text) // JSONObject
+
+val id = data.getIntValue("id") // Int
+val name = data.getString("name") // String
+```
+
+#### 2.5.2 读取实例对象
+
+无泛型实例:
+
+```kotlin
+val obj = ... // JSONObject
+val array = ... // JSONArray
+
+val user = array.to<User>(0)
+val user = obj.to<User>("key")
+```
+
+含泛型实例:
+
+```kotlin
+val obj = ... // JSONObject
+val array = ... // JSONArray
+
+val user = array.into<List<User>>(0)
+val user = obj.into<List<User>>("key")
+```
+
+#### 2.5.3 转为实例对象
+
+无泛型实例:
+
+```kotlin
+val obj = ... // JSONObject
+val array = ... // JSONArray
+
+val user = obj.to<User>() // User
+val users = array.toList<User>() // List<User>
+```
+
+含泛型实例:
+
+```kotlin
+val obj = ... // JSONObject
+val array = ... // JSONArray
+
+val user = obj.into<HashMap<String, User>>() // HashMap<String, User>
+val users = array.into<ArrayList<User>>() // ArrayList<User>
+```

kotlin/src/main/kotlin/com/alibaba/fastjson2/JSON.kt

@@ -110,7 +110,7 @@ inline fun <reified T> URL?.to(
  * E.g.
  * ```
  *   val url = ...
- *   val data = in.url<User>()
+ *   val data = in.into<User>()
  * ```
  *
  * @return [T]?

kotlin/src/main/kotlin/com/alibaba/fastjson2/JSONArray.kt

@@ -13,7 +13,7 @@ package com.alibaba.fastjson2
  */
 @Suppress("HasPlatformType")
 inline fun <reified T> JSONArray.to() =
-    to<T>(T::class.java)
+    to(T::class.java)
 
 /**
  * Implemented using [TypeReference]