天天看点

iOS 序列化与反序列化(runtime) 02

//联系人:石虎  QQ: 1224614774昵称:嗡嘛呢叭咪哄

一、runtime: iOS序列化与反序列化利器

1.1 总体思路

观察上面的

initWithCoder

代码我们可以发现,序列化与反序列化中最重要的环节是遍历类的变量,保证不能遗漏。

这里需要特别注意的是:

编解码的范围不能仅仅是自身类的变量,还应当把除NSObject类外的所有层级父类的属性变量也进行编解码!

由此可见,这几乎是个纯体力活。而runtime在遍历变量这件事情上能为我们提供什么帮助呢?我们可以通过runtime在运行时获取自身类的所有变量进行编解码;然后对父类进行递归,获取除NSObject外每个层级父类的属性(非私有变量),进行编解码。

1.2 使用runtime获取变量以及属性

runtime中获取某类的所有变量(属性变量以及实例变量)API:

获取某类的所有属性变量API:

runtime的所有开放API都放在

objc/runtime.h

里面。上面的一些数据类型有些同学可能没见过,这里我们先简单地介绍一下,更详细的介绍请自行查阅其他资料,强烈建议打开

Ivar是runtime对于变量的定义,本质是一个结构体:

struct objc_ivar {
    char *ivar_name;                                   
    char *ivar_type;                                    
    int ivar_offset;
#ifdef __LP64__
    int space;
#endif
} 
typedef struct objc_ivar *Ivar;                
  • ivar_name:变量名,对于一个给定的Ivar,可以通过

    const char *ivar_getName(Ivar v)

    函数获得

    char *

    类型的变量名;
  • ivar_type: 变量类型,在runtime中变量类型用字符串表示,例如用@表示id类型,用i表示int类型...。这不在本文讨论之列。类似地,可以通过

    const char *ivar_getTypeEncoding(Ivar v)

    函数获得变量类型;
  • ivar_offset: 基地址偏移字节数,可以不用理会

    获取所有变量的代码一般长这样子:

    unsigned int numIvars; //成员变量个数
      Ivar *vars = class_copyIvarList(NSClassFromString(@"UIView"), &numIvars);
      NSString *key=nil;
      for(int i = ; i < numIvars; i++) {
          Ivar thisIvar = vars[i];
          key = [NSString stringWithUTF8String:ivar_getName(thisIvar)];  //获取成员变量的名字
          NSLog(@"variable name :%@", key);
          key = [NSString stringWithUTF8String:ivar_getTypeEncoding(thisIvar)]; //获取成员变量的数据类型
          NSLog(@"variable type :%@", key);
      }
      free(vars);//记得释放掉
               
    objc_property_t是runtime对于属性变量的定义,本质上也是一个结构体(事实上OC是对C的封装,大多数类型的本质都是C结构体)。在

    runtime.h

    头文件中只有

    typedef struct objc_property *objc_property_t

    ,并没有更详细的结构体介绍。虽然runtime的源码是开源的,但这里并不打算深入介绍,这并不影响我们今天的主题。与Ivar的应用同理,获取类的属性变量的代码一般长这样子:
    unsigned int outCount, i;   
      objc_property_t *properties = class_copyPropertyList([self class], &outCount);   
      for (i = ; i < outCount; i++) {   
          objc_property_t property = properties[i];   
          NSString *propertyName = [[[NSString alloc] initWithCString:property_getName(property)] ;   
          NSLog(@"property name:%@", propertyName); 
      }   
      free(properties);
               

    1.3 用runtime实现序列化与反序列化

    有了前面两节的铺垫,到这里自然就水到渠成了。我们可以在

    initWithCoder:

    以及

    encoderWithCoder:

    中遍历类的所有变量,取得变量名作为KEY值,最后使用KVC强制取得或者赋值给对象。于是我们可以得到如下的自动序列化与发序列化代码,关键部分有注释:
    @implementation Person
    //解码
    - (id)initWithCoder:(NSCoder *)coder
    {
      unsigned int iVarCount = ;
      Ivar *iVarList = class_copyIvarList([self class], &iVarCount);//取得变量列表,[self class]表示对自身类进行操作
      for (int i = ; i < iVarCount; i++) {
          Ivar var = *(iVarList + i);
          const char * varName = ivar_getName(var);//取得变量名字,将作为key
          NSString *key = [NSString stringWithUTF8String:varName];
          //decode
          id  value = [coder decodeObjectForKey:key];//解码
          if (value) {
              [self setValue:value forKey:key];//使用KVC强制写入到对象中
          }
      }
      free(iVarList);//记得释放内存
      return self;
    }
        //编码
        - (void)encodeWithCoder:(NSCoder *)coder
            {
            unsigned int varCount = ;
            Ivar *ivarList = class_copyIvarList([self class], &varCount);
            for (int i = ; i < varCount; i++) {
                Ivar var = *(ivarList + i);
                const char *varName = ivar_getName(var);
                NSString *key = [NSString stringWithUTF8String:varName];
                id varValue = [self valueForKey:key];//使用KVC获取key对应的变量值
                if (varValue) {
                    [coder encodeObject:varValue forKey:key];
                }
          }
          free(ivarList);
        }
               

    1.4 优化

    上面代码有个缺陷,在获取变量时都是指定当前类,也就是

    [self class]

    。当你的Model对象并不是直接继承自NSObject时容易遗漏掉父类的属性。请牢记3.1节我们提到的:
    编解码的范围不能仅仅是自身类的变量,还应当把除NSObject类外的所有层级父类的属性变量也进行编解码!

因此在上面代码的基础上我们我们需要注意一下细节,设一个指针,先指向本身类,处理完指向SuperClass,处理完再指向SuperClass的SuperClass...。代码如下(这里仅以

encodeWithCoder:

为例,毕竟

initWithCoder:

同理):

- (void)encodeWithCoder:(NSCoder *)coder
{ 
    Class cls = [self class];
    while (cls != [NSObject class]) {//对NSObject的变量不做处理
        unsigned int iVarCount = ;
        Ivar *ivarList = class_copyIvarList([cls class], &iVarCount);/*变量列表,含属性以及私有变量*/  
        for (int i = ; i < iVarCount; i++) { 
            const char *varName = ivar_getName(*(ivarList + i)); 
            NSString *key = [NSString stringWithUTF8String:varName];    
            /*valueForKey只能获取本类所有变量以及所有层级父类的属性,不包含任何父类的私有变量(会崩溃)*/  
            id varValue = [self valueForKey:key];   
            if (varValue) { 
                [coder encodeObject:varValue forKey:key];   
            }   
        }   
        free(ivarList); 
        cls = class_getSuperclass(cls); //指针指向当前类的父类
    }   
}
           

这样真的结束了吗?不是的。当你的跑上面的代码时程序有可能会crash掉,crash的地方在

[self valueForKey:key]

这一句上。原来是这里的KVC无法获取到父类的私有变量(即实例变量)。因此,在处理到父类时不能简单粗暴地使用

class_copyIvarList

,而只能取父类的属性变量。这时候3.2节部分的

class_copyPropertyList

就派上用场了。在处理父类时用后者代替前者。

2016.0804补充

在最近的iOS中打印propertyList会发现有

superClass

description

debugDescription

hash

等四个属性。对这几个属性进行encode操作会导致crash。因此在encode前需要屏蔽掉这些key

于是最终的代码(额~其实还不算最终):

- (id)initWithCoder:(NSCoder *)coder    
{   
    NSLog(@"%s",__func__);  
    Class cls = [self class];   
    while (cls != [NSObject class]) {   
        /*判断是自身类还是父类*/    
        BOOL bIsSelfClass = (cls == [self class]);  
        unsigned int iVarCount = ; 
        unsigned int propVarCount = ;  
        unsigned int sharedVarCount = ;    
        Ivar *ivarList = bIsSelfClass ? class_copyIvarList([cls class], &iVarCount) : NULL;/*变量列表,含属性以及私有变量*/   
        objc_property_t *propList = bIsSelfClass ? NULL : class_copyPropertyList(cls, &propVarCount);/*属性列表*/   
        sharedVarCount = bIsSelfClass ? iVarCount : propVarCount;   

        for (int i = ; i < sharedVarCount; i++) {  
            const char *varName = bIsSelfClass ? ivar_getName(*(ivarList + i)) : property_getName(*(propList + i)); 
            NSString *key = [NSString stringWithUTF8String:varName];   
            id varValue = [coder decodeObjectForKey:key]; 
            NSArray *filters = @[@"superclass", @"description", @"debugDescription", @"hash"];   
            if (varValue && [filters containsObject:key] == NO) { 
                [self setValue:varValue forKey:key];    
            }   
        }   
        free(ivarList); 
        free(propList); 
        cls = class_getSuperclass(cls); 
    }   
    return self;    
}   

- (void)encodeWithCoder:(NSCoder *)coder    
{   
    NSLog(@"%s",__func__);  
    Class cls = [self class];   
    while (cls != [NSObject class]) {   
        /*判断是自身类还是父类*/    
        BOOL bIsSelfClass = (cls == [self class]);  
        unsigned int iVarCount = ; 
        unsigned int propVarCount = ;  
        unsigned int sharedVarCount = ;    
        Ivar *ivarList = bIsSelfClass ? class_copyIvarList([cls class], &iVarCount) : NULL;/*变量列表,含属性以及私有变量*/   
        objc_property_t *propList = bIsSelfClass ? NULL : class_copyPropertyList(cls, &propVarCount);/*属性列表*/ 
        sharedVarCount = bIsSelfClass ? iVarCount : propVarCount;   

        for (int i = ; i < sharedVarCount; i++) {  
            const char *varName = bIsSelfClass ? ivar_getName(*(ivarList + i)) : property_getName(*(propList + i)); 
            NSString *key = [NSString stringWithUTF8String:varName];    
            /*valueForKey只能获取本类所有变量以及所有层级父类的属性,不包含任何父类的私有变量(会崩溃)*/  
            id varValue = [self valueForKey:key];
            NSArray *filters = @[@"superclass", @"description", @"debugDescription", @"hash"];    
            if (varValue && [filters containsObject:key] == NO) { 
                [coder encodeObject:varValue forKey:key];   
            }   
        }   
        free(ivarList); 
        free(propList); 
        cls = class_getSuperclass(cls); 
    }   
}
           

1.5 最终的封装

在逻辑上,上面的代码应该是目前为止比较完美的自动序列化与反序列解决方案了。即使某个类的继承深度极其深,变量极其多,序列化的代码也就以上这些。但是我们回到文章第二节提出的几点场景假设,其中有一点提到:

若你的工程中有很多像Person的自定义类需要做序列化操作呢?

如果是在以上场景下,每个Model类都需要写一次上面的代码。这在一定程度上也造成冗余了。同时,你也会觉得这篇文章的标题就是瞎扯淡,根本就不是一行代码的事。上面的代码冗余,我这种对代码有很强洁癖的程序旺是万万接受不了的。那就再封装一层!这里我采用宏的方式将上述代码浓缩成一行,放到一个叫WZLSerializeKit.h的头文件中:

#define WZLSERIALIZE_CODER_DECODER()     \
\
- (id)initWithCoder:(NSCoder *)coder    \
{   \
    NSLog(@"%s",__func__);  \
    Class cls = [self class];   \
    while (cls != [NSObject class]) {   \
        /*判断是自身类还是父类*/    \
        BOOL bIsSelfClass = (cls == [self class]);  \
        unsigned int iVarCount = ; \
        unsigned int propVarCount = ;  \
        unsigned int sharedVarCount = ;    \
        Ivar *ivarList = bIsSelfClass ? class_copyIvarList([cls class], &iVarCount) : NULL;/*变量列表,含属性以及私有变量*/   \
        objc_property_t *propList = bIsSelfClass ? NULL : class_copyPropertyList(cls, &propVarCount);/*属性列表*/   \
        sharedVarCount = bIsSelfClass ? iVarCount : propVarCount;   \
            \
        for (int i = ; i < sharedVarCount; i++) {  \
            const char *varName = bIsSelfClass ? ivar_getName(*(ivarList + i)) : property_getName(*(propList + i)); \
            NSString *key = [NSString stringWithUTF8String:varName];   \
            id varValue = [coder decodeObjectForKey:key];   \
            NSArray *filters = @[@"superclass", @"description", @"debugDescription", @"hash"]; \
            if (varValue && [filters containsObject:key] == NO) { \
                [self setValue:varValue forKey:key];    \
            }   \
        }   \
        free(ivarList); \
        free(propList); \
        cls = class_getSuperclass(cls); \
    }   \
    return self;    \
}   \
\
- (void)encodeWithCoder:(NSCoder *)coder    \
{   \
    NSLog(@"%s",__func__);  \
    Class cls = [self class];   \
    while (cls != [NSObject class]) {   \
        /*判断是自身类还是父类*/    \
        BOOL bIsSelfClass = (cls == [self class]);  \
        unsigned int iVarCount = ; \
        unsigned int propVarCount = ;  \
        unsigned int sharedVarCount = ;    \
        Ivar *ivarList = bIsSelfClass ? class_copyIvarList([cls class], &iVarCount) : NULL;/*变量列表,含属性以及私有变量*/   \
        objc_property_t *propList = bIsSelfClass ? NULL : class_copyPropertyList(cls, &propVarCount);/*属性列表*/ \
        sharedVarCount = bIsSelfClass ? iVarCount : propVarCount;   \
        \
        for (int i = ; i < sharedVarCount; i++) {  \
            const char *varName = bIsSelfClass ? ivar_getName(*(ivarList + i)) : property_getName(*(propList + i)); \
            NSString *key = [NSString stringWithUTF8String:varName];    \
            /*valueForKey只能获取本类所有变量以及所有层级父类的属性,不包含任何父类的私有变量(会崩溃)*/  \
            id varValue = [self valueForKey:key];   \
            NSArray *filters = @[@"superclass", @"description", @"debugDescription", @"hash"]; \
            if (varValue && [filters containsObject:key] == NO) { \
                [coder encodeObject:varValue forKey:key];   \
            }   \
        }   \
        free(ivarList); \
        free(propList); \
        cls = class_getSuperclass(cls); \
    }   \
}
           

之后需要序列化的地方只要两步:

1、import "WZLSerializeKit.h"

2、调用

WZLSERIALIZE_CODER_DECODER();

即可。两个字:清爽。

此外,

copyWithZone

中同样可以用相同的原理对变量进行自动化copy。同样地,我们也可以用一个宏封装掉

copyWithZone

方法。这里就不再赘述。

值得一提的是,以上代码我已经放到我的Github中,并且提供了CocoaPods支持。使用的时候只需要pod `WZLSerializeKit`。点 此处 跳转到我的Github.

谢谢!!!