Hprose 序列化

概述

Hprose 提供了一套自己的序列化格式用来实现高效的跨语言跨平台的数据存储和交换。该序列化格式，在 hprose for Java 中被实现为以下几个对象：

• HproseTags
• HproseMode
• HproseClassManager
• HproseWriter
• HproseReader
• HproseFormatter

HproseTags 对象中包含了所有的 Hprose 序列化和 RPC 标记定义。Hprose 的使用者通常不需要关心该对象，因此这里不对该对象做详细介绍。

HproseMode 是一个枚举类型，表示序列化模式。其中包含了三个值：

• FieldMode
• PropertyMode
• MemberMode

FieldMode 模式下只序列化 Java 类中的字段，包括私有字段，但是静态字段和 transient 字段不会序列化。

PropertyMode 模式下只序列化 Java 类中的 public 可读写属性。

MemberMode 模式下序列化 Java 类中的 public 可读写属性和字段，但不包括静态字段和 transient 字段。

HproseClassManager 用于管理自定义类型与其它语言之间的映射关系。

HproseWriter 用于进行细粒度的 Hprose 序列化操作。

HproseReader 用于进行细粒度的 Hprose 反序列化操作。

HproseFormatter 用于进行粗粒度的 Hprose 序列化和反序列化操作。

这些类都包含在 hprose.io 包中。下面我们将对这几个类进行详细的介绍。

HproseClassManager

register 方法

HproseClassManager.register(class, alias);

当 Hprose 序列化对象时，需要知道对象的类名，但有时候，我们在不同的语言中定义的类名可能不同，但结构相同或相近，我们希望这些定义不同的类的对象可以相互传递。那么就需要使用该方法来进行注册，注册成统一的别名之后，就可以相互传递了。

其中 class 表示要注册的类，alias 表示注册的别名。例如：

package hprose.example;

class User {
    public String name;
    public int age;
}
...
HproseClassManager.register(User, 'User');

在很多语言中，类名是有名称空间（NameSpace）的，例如上面的代码中，就是这样一个类：hprose.example.User，但也有写没有名称空间的概念，或者名称空间和类之间的分隔符不是用 .，而是用 : 或者 \ 等符号。比如假设我们在 PHP 中定义了一个 My\Model\User 类，但是并没有执行这个注册，我们又希望能够跟它交互，我们可以这样注册：

HproseClassManager.register(User, 'My_Model_User');

注意上面的别名中，不是使用 . 做分隔符的，而是使用 _，Hprose 会自动将 _ 转换为对应语言的分隔符，对于不支持名称空间的语言，则直接对应 My_Model_User 这个名字，这样既可以支持没有名称空间的语言，也可以支持具有名称空间的语言。