[UTSJSONObject]去除文档中手动生成的代码，添加注释

uni_modules/uts-tests/utssdk/UTSJSONObject.uts

@@ -2,6 +2,7 @@ import { describe, test, expect, expectNumber, Result } from './tests.uts'
 
 export function testUTSJSONObject() : Result {
   return describe("utsjsonobject", () => {
+
     test('keys', () => {
         let obj = {
           name:"zhangsan",
@@ -9,6 +10,15 @@ export function testUTSJSONObject() : Result {
         }
         expect(UTSJSONObject.keys(obj).length).toEqual(2);
         console.log(UTSJSONObject.keys(obj))
+      // #TEST UTSJSONObject.keys
+      let obj = {
+        name: "zhangsan",
+        age: 11
+      }
+
+      let ret1 = UTSJSONObject.keys(obj).length
+      console.log(ret1) //2
+      // #END
     })
     
     test('toJSONObject', () => {
@@ -38,84 +48,182 @@ export function testUTSJSONObject() : Result {
     
     test('assign-notype', () => {
       // #ifdef APP-ANDROID
-        const target = { a: 1, b: 2 };
-        const source = { b: 4, c: 5 };
-        const returnedTarget = UTSJSONObject.assign(target, source);
-        
-        expect(returnedTarget.toMap().size).toEqual(3);
-        
-        type A = {
-        	username:string
-        	age:number
-        }
-        type C = {
-        	work:number
-        }
-       
-        let b = UTSJSONObject.assign( {
-          username:"张三",
-          age:12
-        } as A,
-        {b:2},
+      // #TEST UTSJSONObject.assign
+      let target = { a: 1, b: 2 };
+      let source = { b: 4, c: 5 };
+      // 得到一个UTSJSONObject对象
+      const returnedTarget = UTSJSONObject.assign(target, source);
+      // #END
+
+      expect(returnedTarget.toMap().size).toEqual(3);
+
+      type A = {
+        username : string
+        age : number
+      }
+      type C = {
+        work : number
+      }
+
+      let b = UTSJSONObject.assign({
+        username: "张三",
+        age: 12
+      } as A,
+        { b: 2 },
         {
-          work:0.002
+          work: 0.002
         } as C)
-        expect(b['age']).toEqual(12);
-        expect(b['username']).toEqual("张三");
-        expect(b['b']).toEqual(2);
-        expect(b['work']).toEqual(0.002);
+      expect(b['age']).toEqual(12);
+      expect(b['username']).toEqual("张三");
+      expect(b['b']).toEqual(2);
+      expect(b['work']).toEqual(0.002);
+
+      // #TEST UTSJSONObject.assign_1
+      type User = {
+        a : number
+        b : number
+      }
+      let target1 = { a: 1, b: 2 };
+      let source1 = { b: 4, c: 5 };
+      // 得到一个User对象
+      const returnedTarget = UTSJSONObject.assign<User>(target1, source1);
+      // #END
+
       // #endif
     })
-    
+
     test('setvalue-after-get', () => {
       // #ifdef APP-ANDROID
-        let obj = {
-          "cars":[
-            {
-              name:"car1",
-              value:100
-            }
-          ]
-        }
-            
-        let cars = obj.getArray<UTSJSONObject>("cars")
-        cars![0].set("value",20)
-        let firstCar = obj.getJSON("cars[0]")
-        expect(firstCar!['value']).toEqual(20);
-        // #endif
+      // #TEST UTSJSONObject.getJSON,UTSJSONObject.getArray
+      let obj = {
+        "cars": [
+          {
+            name: "car1",
+            value: 100
+          }
+        ]
+      }
+
+      let cars = obj.getArray<UTSJSONObject>("cars")
+      cars![0].set("value", 20)
+      let firstCar = obj.getJSON("cars[0]")
+      console.log(firstCar!['value'])//20
+      // #END
+      expect(firstCar!['value']).toEqual(20);
+      // #endif
     })
     
     
     test('get-speed', () => {
       // #ifdef APP-ANDROID
-        const utsObj: UTSJSONObject = {} as any as UTSJSONObject
-        for (let i = 0; i < 100; i++) {
-          utsObj.set('' + i, '' + i)
-        }
-        
-        console.log('--start--')
-        let startTime = Date.now()
-        for (let i = 0; i < 10000; i++) {
-          utsObj.getString('0')
-        }
-        let spendTime = Date.now() - startTime
-        expect(spendTime < 300).toEqual(true);
-        // #endif
+      // #TEST UTSJSONObject.getString
+      const utsObj : UTSJSONObject = {} as any as UTSJSONObject
+      for (let i = 0; i < 100; i++) {
+        utsObj.set('' + i, '' + i)
+      }
+
+      console.log('--start--')
+      let startTime = Date.now()
+      for (let i = 0; i < 10000; i++) {
+        utsObj.getString('0')
+      }
+      // #END
+      let spendTime = Date.now() - startTime
+      expect(spendTime < 300).toEqual(true);
+      // #endif
     })
-    
+
     test('assign-withtype', () => {
       // #ifdef APP-ANDROID
-        type User = {
-          a:number
-          b:number
+      type User = {
+        a : number
+        b : number
+      }
+      const target = { a: 1, b: 2 };
+      const source = { b: 4, c: 5 };
+      const returnedTarget = UTSJSONObject.assign<User>(target, source);
+
+      expect(returnedTarget!.a).toEqual(1);
+      console.log(returnedTarget)
+      // #endif
+    })
+    test('getArray_1', () => {
+      // #ifdef APP-ANDROID
+      // #TEST UTSJSONObject.getArray_1
+      //这个方法用来获取指定元素类型的数组
+      let obj = JSON.parseObject('{"name":"tom","tag":["student","user"]}')
+
+      // 这里得到是 Array<*>
+      let noGenericArray = obj!.getArray("tag")
+      console.log(noGenericArray)
+
+      // 这里得到是 Array<string>
+      let genericArray = obj!.getArray<string>("tag")
+      console.log(genericArray)
+      // #END
+      // #endif
+    })
+
+    test('sample', () => {
+      // #TEST UTSJSONObject.sample_create,UTSJSONObject.get,UTSJSONObject.set
+      const person : UTSJSONObject = {
+        name: 'Tom',
+        printName: () => {
+          // ...
         }
-        const target = { a: 1, b: 2 };
-        const source = { b: 4, c: 5 };
-        const returnedTarget = UTSJSONObject.assign<User>(target, source);
-        
-        expect(returnedTarget!.a).toEqual(1);
-        console.log(returnedTarget)
+      }
+      //返回指定键对应的值，如果对象中不存在此键则返回 null。
+      let name : string = person.get('name') as string
+      //get 方法可以简化为使用下标运算符 `[]` 访问
+      name = person['name'] as string
+      //增加或更新指定键对应的值。
+      person.set('name', 'Tom1')
+      //set 方法可以简化为使用下标运算符 `[]` 赋值
+      person['name'] = 'Tom2'
+      // #END
+
+      // #TEST UTSJSONObject.sample_create1
+
+      // 写法1 推荐
+      let person1 : UTSJSONObject = JSON.parseObject('{"name":"Tom"}')!
+
+      // 写法2 推荐
+      const person2 : UTSJSONObject = JSON.parse<UTSJSONObject>('{"name":"Tom"}')!
+
+
+      // 写法3  如果 as 转换的实际类型不匹配 会导致 crash，建议先通过 `instanceof` 判断类型再进行as转换。
+      const parseRet3 = JSON.parse('{"name":"Tom"}')
+      if (parseRet3 instanceof UTSJSONObject) {
+        const person = parseRet3 as UTSJSONObject
+      }
+
+      // #END
+      // #TEST UTSJSONObject.toMap
+      person1 = JSON.parseObject('{"name":"Tom"}')!
+      person1.toMap().forEach((value, key) => {
+        console.log(key)
+        console.log(value)
+      })
+      // #END
+
+      // #ifdef APP-ANDROID
+       // #TEST UTSJSONObject.convert
+      type User = {
+        name : string,
+        age : number
+      }
+      let jsonObj = {
+        name: "张三",
+        age: 12
+      }
+      // UTSJSONObject => 自定义type
+      let userA = JSON.parse<User>(jsonObj.toJSONString())
+      console.log(userA!.name)
+      // 自定义type => UTSJSONObject
+      let utsJsonA = JSON.parseObject(JSON.stringify(userA))
+      console.log(utsJsonA)
+       // #END
       // #endif
     })
   })
-}
+}
\ No newline at end of file