Update generics.md

docs/uts/generics.md

@@ -90,7 +90,80 @@ function testArray<T extends Array<unknown>>(arg: T): T {
 
 ### 安卓平台使用泛型注意事项
 
-ts本质是擦除类型的。在强类型语言中，传递泛型时如将泛型类型作为值使用，需通过特殊方式将泛型类型作为值使用，可以根据传入来动态决定返回类型。[详见](../plugin/uts-for-android.html#lost-generics)
+ts本质是擦除类型的。在强类型语言中，传递泛型时如将泛型类型作为值使用，需通过特殊方式将泛型类型作为值使用，可以根据传入来动态决定返回类型:
+
+如果在UTS中声明一个包含泛型声明的方法，可能会出现泛型丢失，原因是因为普通的kotlin 方法没有实现泛型的传递
+
+错误的kt代码：
+
+```kotlin
+fun <T> getArtListByres(): A<T>? {
+   var aRet = UTSAndroid.consoleDebugError(JSON.parse<A<T>>("{\"x\":111,\"y\":\"aaa\",\"t\":{\"name\":\"zhangsan\"}}"), " at pages/index/index.uvue:27");
+   return aRet;
+}
+```
+
+期望得到的正确的kt代码：
+
+```ts
+inline fun <reified T> getArtListByres(): A<T>? {
+    var aRet = UTSAndroid.consoleDebugError(JSON.parse<A<T>>("{\"x\":111,\"y\":\"aaa\",\"t\":{\"name\":\"zhangsan\"}}"), " at pages/index/index.uvue:27");
+    return aRet;
+}
+```
+
+为了解决这种情况，我们可以在UTS中 添加android方法注解，来告诉编译器生成正确的代码：
+
+```kotlin
+@UTSAndroid.keyword("inline")
+@UTSAndroid.keyword('reified')
+export function request<T>(options : RequestOptions<T>) : RequestTask {
+	//xxx
+}
+```
+
+
+**注意：不要在`inline`方法中创建局部function，比如request的success回调、Promise的回调，原因是kotlin语言的限制（inline方法展开到内联位置，也会把局部方法展开过去，这是不允许的），由此把使用局部function的逻辑封装到非内联的方法中，绕过此限制。**  
+
+下面是可以完整的示例：
+
+```
+@UTSAndroid.keyword("inline")
+@UTSAndroid.keyword("reified")
+export function boxRequest<T>(url : string) : Promise<T> {
+	return innerRequest<T>(url, UTSAndroid.getGenericClassName<T>(), UTSAndroid.getGenericType<T>())
+}
+
+function innerRequest<T>(url : string, clzName : string, type : Type) : Promise<T> {
+	return new Promise<T>((resolve, reject) => {
+		uni.request<string>({
+			url: url,
+			method: "GET",
+			success: (e : RequestSuccess<string>) => {
+				const result = JSON.parse<T>(e.data!, type)
+				if (result != null) {
+					resolve(result)
+				} else if ("java.lang.Object".equals(clzName, true)) {// 解决泛型是any，但后端返回string的情况。
+					resolve(e.data! as T)
+				} else{
+					reject("parsing failure")
+				}
+			},
+			fail(e : RequestFail) {
+				reject(e)
+			},
+		} as RequestOptions<string>)
+	});
+}
+```
+调用代码：
+```
+const respone = await boxRequest<CustomType>("xxxx")
+```
+
+此示例中，网络请求泛型为`string`在4.25版本以下会导致错误，此问题已在4.25进行修复 [issue](https://issues.dcloud.net.cn/pages/issues/detail?id=4010)
+
+
 
 ### iOS 平台使用泛型注意事项