无需手写,自动生成Flutter/Dart实体类文件

json2entity

一个自动生成Flutter/Dart实体类(源文件)的工具

初次发文,请多多包涵。git

在Java开发中,JSON字符串转实体类,有不少工具,我最经常使用IDEA的Gsonformat插件,把JSON字符串粘贴到文本框,点击生成,一个Java Bean就写好了。 json2entity,就是Dart和Flutter开发的Gsonformat。github

最简用法

$ j2e -j '{"result":1,"msg":"ok"}'
复制代码

terminal输出:shell

$ j2e -j '{"result":1,"msg":"ok"}'
class Model {
 num result;
 String msg;
 Model({
  this.result,
  this.msg
 });

 Model.fromJson(Map < String, dynamic > json):
  result=json['result'],
  msg=json['msg'];
 Map <String, dynamic> toJson() => {
  'result':result,
  'msg':msg
 };
}%
复制代码

怎么样是否是很简单?json

BUT!!! j2e是什么,j2e在哪里 ?bash

j2e 只是json2entity 的别名,使用json2entityj2e, 是等价的。 json2entity是一个Dart package,下面是安装方法。工具

使用前准备

最多只需3步:ui

  1. pubspec.yaml中引入
dev_dependencies:
 json2entity: 1.0.6
复制代码
  1. 激活:
$ pub global activate json2entity
复制代码
  1. 确保"$HOME/.pub-cache/bin"已添加到你的PATH变量中。若是已添加,能够跳过此步。

设置完成后,在你的terminal中输入j2e或者json2entity,而后回车,看看效果吧:this

$ j2e
No input args found
Usage:
        -j, --json                              Input json string
        -f, --file                              Input json from file
        -o, --output                            Input output file path and name
        -v, --[no-]verbose                      Show verbose
        -s, --[no-]json-serializable-support    Indicates whether json-serializable is supported
        -h, --[no-]help                         Help%
复制代码

若是输出如上所示,则已经成功了,在terminal的任何路径,你均可以愉快地使用了。spa

高级用法

输出到文件

没有指定输出,默认输出到终端。插件

若是想输出到文件,可使用-o选项, 使用重定向输出到文件也能够。使用-o,后面的参数会做为文件名和类名:

j2e -j '{"result":1,"msg":"ok"}' -o lib/model/BaseModel

$ j2e -j '{"result":1,"msg":"ok"}' -o lib/model/BaseModel
$ cat lib/model/base_model.dart
class BaseModel {
 num result;
 String msg;
 BaseModel({
  this.result,
  this.msg
 });

 BaseModel.fromJson(Map < String, dynamic > json):
  result=json['result'],
  msg=json['msg'];
 Map <String, dynamic> toJson() => {
  'result':result,
  'msg':msg
 };
}
复制代码

注意,例如这里BaseModel,使用了驼峰格式,这样,对应实体类文件名会转为下划线法:base_model.dart

支持json_serializable

若是你使用了json_serializable. 也是能够的:只须要多一个-s

$ j2e -j '{"result":1,"msg":"ok"}' -s # 输出到stdout
$ j2e -j '{"result":1,"msg":"ok"}' -o lib/model/BaseModel -s # 输出到文件: ./lib/base_model.dart
复制代码

固然,这种状况下,生成的只是部分代码,对应的.g.dart文件,还须要你手动的执行一下build_runner:

$ flutter packages pub run build_runner build
复制代码

从文件读取输入

经过-j从命令行读取输入,每次只能读取一条JSON。若是不能知足你的需求,你可使用-f,从文件批量读取并转换。 输入文件的格式,必须是格式良好的JSON字符串,格式以下:

//input.json
{
    “BaseModel": "{\"result\":1,\"msg\":\"ok\"}",
    "AnswerModel": "{\"result\":1,\"msg\":\"ok\",\"data\":{\"answer\":\"A\"}}"
}
复制代码

-f指定输入文件,-o输出目录,命令以下:

$ j2e -f input.json -o lib/model
$ j2e -f input.json -o lib/model -s
复制代码

其余

生成的实体类,有时候可能还须要一些修改。

例如,生成的实体类,属性名和JSON里的key保持一致。若是key是下划线命名法,你须要的事驼峰命名法,你可能须要手动修改一下。 若是你使用了json_serializable,可使用@JsonKey标注,例如:

@JsonKey(name: 'registration_date_millis')
final int registrationDateMillis;
复制代码

另外,工具只提供了简单的缩进,并不保证缩进完美。能够在生成后使用dartfmt自行格式化:

dartfmt -w <dart-code-path>
复制代码

或者使用IDE格式化代码。

对于一个工具来讲,上面这些已经知足大部分需求了。原本打算写一个IDEA plugin,使用vscode后,就放弃了。并且使用terminal更高大上是否是?

更多示例,请前往个人Github

json2entity使用Dart语言实现,已发布到 Pub | Dart | json2entity

相关文章
相关标签/搜索