OpenHarmony中的fastjson gson应该这样用

【问题背景】

随着越来越多的开发者开始投入北向应用的开发，无数的人开始问我：鸿蒙三方库是否有fastjson，是否有gson，当前json和对象的转换要怎么搞。

作为程序员，我的每个项目都逃不掉fastjson/gson等三方库，关键是看当前项目已经用了哪个，一般我也不会再自己新引入json库。那么在OpenHarmony/HarmonyOS应用开发中，我的第一直觉告诉我，之前做网页/node开发时，貌似也没说有个fastjson/gson三方库。于是当时我找了下，其实在arkts开发时，沿用了js里自带的JSON,parse和JSON,stringify方法可以实现json和对象的转换，我也看了下早期确实有个开源三方库OpenHarmony-SIG/ohos_gson，我也看了下源代码，实现方式是参考gson的java代码，使用js重写。有人做过验证ohos_gson与JSON的转换的时间评测，结果是ohos_gson花费的时间是JSON的20倍以上。为了避免更多的应用入坑，因此ohos_gson到目前一直没发布到ohpm中心仓，所以别人一问我fastjson/gson的三方库的事情，我都答复用JSON去解决问题。

但是似乎问题没有完全解决，开发者越多，场景就越多。还是有很同学在反馈，说JSON并不能像fastjson/gson满足所有的需求，主要是以下几问题：
1.JSON.parse转过来的对象，不能带方法。比如class 中有个getName(){return this.firstName + this.lastName}，这个方法就不能调用
2.JSON接收的json字段名称必须与本地对象属性名一致，能否重命名。
3.对象转JSON的时候，能否控制某些敏感字段不对外暴露。
4.属性是map或其他复杂结构体时，无法转换实现json与对象的互转

【解决方案】

对着上述的问题，我尝试google了一把，毕竟上述这些问题应该在web/node的开发场景下也会遇到。于是在更多的回复中，我看到业界建议更多的是用class-transformer来解决。这个库本身在OpenHarmony/HarmonyOS上正常跑，一行代码不用改，在三方库中心仓上可以直接下载到最新的0.51版本。
针对上述几个问题，我尝试了写了几段代码，验证了下，结果都是OK的。当然首先，需要

ohpm install class-transformer

那么接下来，我将给出代码，如何使用class-transformer来解决:
问题1：JSON.parse转过来的对象，不能带方法。
如以下代码所示，plainToClass可以把json转成对象后，可以调用getFullName的自定义方法

import { plainToClass } from 'class-transformer';class User {id: number;firstName: string;lastName: string;constructor() {this.id=0this.firstName=""this.lastName=""}getFullName() {return this.firstName + ' ' + this.lastName;}}let json = "{"id": 3,"firstName": "Tracy","lastName": "Mcgrady"}"JSON.parse(json)let user:User = plainToClass(User, JSON.parse(json))console.info(user.getFullName())   //输出Tracy Mcgrady

问题2：JSON接收的json字段名称必须与本地对象属性名一致，能否重命名。

这种场景还是很常见，比如网络传送的数据与应用本身持久化或者显示的数据，名字就是可能存在不同。这里需要用到@Expose注解来重命名，如以下代码可以把id转成uid，同时可以更改自定义方法getFullName的名字

import { classToPlain, Expose, plainToClass } from 'class-transformer';interface tranUser {uid: number,firstName: string,lastName: string}class User {constructor() {this.id= 0this.firstName= ""this.lastName= ""}@Expose({ name: 'uid' })id: number;firstName: string;lastName: string;@Expose({ name: 'fullName' })getFullName() {return this.firstName + ' ' + this.lastName;}}let json = "{"uid": 10,"firstName": "CCC","lastName": "Khudoiberdiev"}"let fromPlainUser:tranUser = JSON.parse(json)let user:User = plainToClass(User,fromPlainUser)console.info(JSON.stringify(user))// 输出{"id":10,"firstName":"CCC","lastName":"Khudoiberdiev"}console.info(JSON.stringify(classToPlain(user,{})))//输出{"uid":10,"firstName":"CCC","lastName":"Khudoiberdiev","fullName":"CCC Khudoiberdiev"}

3.对象转JSON的时候，能否控制某些敏感字段不对外暴露。

使用exclude注解可以搞定

import { classToPlain, Exclude } from 'class-transformer';class User {id: number;firstName: string;lastName: string;@Exclude()password: string;constructor() {this.id = 0this.firstName = "Tracy"this.lastName = "Macgrady"this.password = "12345"}}let user: User = new User()

4.属性是map或其他复杂结构体时，无法转换实现json与对象的互转

使用transform注解自定义方法转换搞定

import { classToPlain, plainToClass, Transform, TransformationType, TransformFnParams } from 'class-transformer';//关键方法：把对象转成Maptrans(value: TransformFnParams): Map<string, string> | object {if (value.type === TransformationType.PLAIN_TO_CLASS) {let map: Map<string, string> = new Map()for (let x of Object.keys(value.value)) {map.set(x, value.value[x])}return map}else {return value.value}}class User {id: number;firstName: string;lastName: string;@Transform((value: TransformFnParams) => this.trans(value), {})tags: Map<string, string> = new Map()constructor() {this.id = 0this.firstName = ""this.lastName = ""}}let json = "{"id": 3,"firstName": "Tracy","lastName": "Mcgrady","tags":{"key1":"value1","key2":"value2"}}"JSON.parse(json)let user: User = plainToClass(User, JSON.parse(json))console.info(user.tags.size.toString())\\输出2console.info(user.tags.get("key2"))\\输出value2console.info(JSON.stringify(user))\\输出 {"tags":{},"id":3,"firstName":"Tracy","lastName":"Mcgrady"}console.info(JSON.stringify(classToPlain(user, {})))\\输出{"tags":{"key1":"value1","key2":"value2"},"id":3,"firstName":"Tracy","lastName":"Mcgrady"}

【总结】
目前来看，使用系统自带JSON+三方库class-transformer，是可以满足类似gson/fastjson绝大部分的需求

此外，建议大家审视下自己设计的类和json是否合理，尽量避免使用复杂的转换。

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

鸿蒙（HarmonyOS NEXT）最新学习路线