谈Android中DTO -> VO的重要性

标题虽然仅指DTO->VO,其实更准确的说,应该是各种DTO、DAO等都需要转VO ,本文仅以DTO为例。


不管你在使用MVC,MVP还是MVVM,这篇文章会让你的M层赋有更佳的职能。

Clean架构的Mapper

在去年尝试Android-CleanArchitecture时,data模块和presentation模块里有2个Mapper类,用于把UserEntity转成User,以及User转成UserModel,最终V层使用的是UserModel对象。

当时很难理解的是为何一个User要转来转去,现在回头来看,对象的映射转换是一个良好的架构所必需的要素,不管是MVC,MVP还是MVVM。

VO 、DTO在Android

1、 VO

value object值对象
ViewObject表现层对象

主要对应界面显示的数据对象。对于一个WEB页面,或者SWT、SWING的一个界面,用一个VO对象对应整个界面的值。

Android中即:UI层的View需要的对象。

2、 DTO

Data Transfer Object数据传输对象

指用于展示层与服务层之间的数据传输对象。

Android中即:接口中返回的数据结构JSON转换后的对象。

痛点

可能我们一般会忽略VO层,只有DTO层,即:View展示的Model对象和接口返回的Model是同一个对象,即DTO。

这样做看起来,省略了VO层也没什么问题,但是我告诉你,在开发过程的所遇到的一些痛点,都和缺少VO层脱离不了关系:

1、你是否经常担心View在使用Model时,Model或Model的某个字段为null?

什么?你说你在C / P层或者domain中进行了安全性的null校验?

但是你不觉得在C/P或domain层处理这种安全校验是一种“脏代码”吗? 这样会加重C/P或domain层的负担,降低其可读性。

这种 “糙活” 应该是由更上游的M层来处理!

2、接口返回的数据结构或字段突然变更了!!

这太常见了!!需求变更等等因素都会引起这个问题。

你在改变DTO字段的同时,还要同时改变所以使用该DTO的View处的代码!

3、接口返回的数据结构不是我想要的啊!!!

因为后台人员的各种原因,导致接口返回的数据结构根本不是我们想要的,而你在和后台撕逼失败后,你是否在苦恼该如何处理这蛋疼的数据结构?

更痛苦的是这条和第2条一并出现时,我想你一定是这样的:

4、接口文档迟迟没有!!

在开发过程中,你的View已经写好,但是接口文档迟迟还没有给出,即使给出,变更的几率也会非常大!

即使你们有接口评审这个环节,但是仍不能100%保证最后的数据结构和字段名称都是像接口评审时敲定的那样!

上述的4个痛点,我相信在你的开发过程中经常会遇到,而解决之道在于:

你需要添加一个VO层,以及DTO->VO层的映射Mapper !

一个映射例子

有这样一个接口:

@GET
Observable<UserListDTO> getUserList()

public final class UserListDTO {
   public int version;  // 一个与View无关的属性
   public List<UserDTO> userList;

   static class UserDTO {
      public String uid;
      public String user_name;
      public String gender;
   }
}

你需要拿到UserList然后展现到RecyclerView上。

但是对于View层来说:

  • 我不想知道你的version是干嘛的
  • 我只需要一个List<User>,User里有idname以及男or女即可
  • 我不想要什么uiduser_namegender等这样后台强加给我的命名或数据类型(即便我们有GSON的@SerializedName注解)
  • 更重要的是我不想拿到一个为null的userList,
  • VO层

    public final class User{
       public String id;
       public String name;
       public boolean isMale;
    }

    Mapper

    public interface Mapper<T>{
       T transform();
    }

    转换过程:

    public final class UserListDTO implements Mapper<List<User>>{
       public int version;
       public List<UserListDTO.UserDTO> userList;
    
       @Override
       public List<User> transform() {
          List<User> list = new ArrayList<>();
          for(UserDTO dto : userList){
             list.add(dto.transform);
          }
          return list;
      }
    
      private static class UserDTO implements Mapper<User>{
         public String uid;
         public String user_name;
         public String gender;
    
         @Override
         public User transform() {
           User user = new User();
           user.id = uid;
           user.name = user_name == null ? "未知" : user_name;
           isMale = "0".equals(gender);
           return user;
         }
      }
    }

    使用

    Api.getService().getUserList()    // Retrofit
                      ....
                    .map(new Func1<UserListDTO, List<User>() {
                        @Override
                        public String call(UserListDTO dto) {
                            return dto.transform;
                        }
                    })
                    .subscribe(...) // 将List<User>指派给V层

    如何解决痛点的?

  • 痛点1:M或M的属性为null?
    V层不用担心会不会拿到的是null,因为已经在DTO的transform()进行安全处理了,在null时也会返回size=0的List<User>。
    同时对User中的name也进行了安全性检查。

  • 痛点2:接口返回的数据结构或字段突然变更
    使用这种Mapper之后,大多数情况,你只需要更改DTO里的transform()的实现即可。

    比如UserDTO的user_name要更改为userName,或者gender不再是"0"为男性等等更改,你只需要在DTO里做如下更改即可:

    @Override 
    public User transform() {
       ...
       user.name = userName;
    }

    VO以及View使用VO的地方则无需更改!


  • 痛点3:接口返回的数据结构不是我想要的?
    没关系,把它转成我们想要的VO对象即可,上文中gender对View来说只需要是男or女即可,不需要知道“gender的值为0时是男性”这种业务逻辑。

    PS: 上述只是一个简单例子,实际场景中,不符合预期的数据结构可能要复杂很多


  • 痛点4:接口文档迟迟没有
    真实开发过程中,我们会先拿到设计稿,有了设计稿后台才开始写接口文档。
    但是如果我们进度太超前,或者某种原因后台人员投入时间过晚,此时我们的接口文档拿到会比较晚。

    如果我们就这样等着后台人员岂不很蠢?!

    好好利用VO把!其实我们根据设计稿就可以明确知道,各个页面所需要的数据模型,此时只要创建一个我们自己需要的VO对象,而View使用该VO展现即可。
    在真正的DTO出来之前,你可以用VO来mock数据、接口;一旦DTO出来,只要在DTO内做一个Mapper即可,VO以及View一般不需要更改!

  • M层还可以做更多:

    假如现在的需求是,User的性别不同,在RecyclerView中显示的View就不同,即属于不同的ItemType,你可能会把这个判断写在:

     @Override
     public int getItemViewType(int position) {
        User user = mDatas.get(position);
        return user.male ? 0 : 1;
     }

    虽然看起来没多少代码,但是实际情况我们遇到的需求往往会很复杂,getItemViewType()里需要写不少逻辑代码,这时你的Adapter里充斥了一些“脏代码”。

    V层应该专注V应该做的事,而不是数据的处理、业务逻辑!

    请放到Mapper里做:

    public final class User{
       ...
       public int itemType;
    }

    private static class UserDTO implements Mapper<User>{
         @Override
         public User transform() {
            ...
            user.itemType = user.isMale ? 0 : 1;
            return user;
          }
      }

    总结:

  • 从实用角度出发:Mapper可以让你的开发过程更高效,更从容面对需求变更、接口变更等外在因素。

  • 从架构角度出发:Mapper的出现可以让M层可以承担更多的职责,来减轻中间层的压力,更利于构造一个V,M的分离的架构。

  • PS:文中转换的方式是构建Mapper接口,使用起来很方便。
    你也可以像Android-CleanArchitecture一样创建独立的Mapper类:在Mapper类进行transform,优点是可以保持DTO与VO的干净和独立;

    最后编辑于
    ©著作权归作者所有,转载或内容合作请联系作者
    • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
      沈念sama阅读 156,757评论 4 359
    • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
      沈念sama阅读 66,478评论 1 289
    • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
      开封第一讲书人阅读 106,540评论 0 237
    • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
      开封第一讲书人阅读 43,593评论 0 203
    • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
      茶点故事阅读 51,903评论 3 285
    • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
      开封第一讲书人阅读 40,329评论 1 210
    • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
      沈念sama阅读 31,659评论 2 309
    • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
      开封第一讲书人阅读 30,383评论 0 195
    • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
      沈念sama阅读 34,055评论 1 238
    • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
      茶点故事阅读 30,337评论 2 241
    • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
      茶点故事阅读 31,864评论 1 256
    • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
      沈念sama阅读 28,227评论 2 251
    • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
      茶点故事阅读 32,820评论 3 231
    • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
      开封第一讲书人阅读 25,999评论 0 8
    • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
      开封第一讲书人阅读 26,750评论 0 192
    • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
      沈念sama阅读 35,365评论 2 269
    • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
      茶点故事阅读 35,260评论 2 258

    推荐阅读更多精彩内容