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