用户定义的类型可以是

别名

[ alias.Addressbook ]
type = "[Contact]"

在这个例子中，别名 "Addressbook" 被赋予联系人列表。

结构

[ struct.PhoneNumber ]
type = "PhoneNumberType"
number = "string"

[ struct.Contact ]
name = "string"
phone = "[PhoneNumber]"

在这个例子中定义了两个结构

• PhoneNumber 包含两个字段，type 和 number
• Contact 也包含两个字段，name 和 phone

结构体序列化为 JSON 对象（{"name":"John Doe","phone":[...]}）

标签联合

[ union.PhoneNumberType ]
Mobile = {}
Home = {}
Custom = { name = "string" }

在这个例子中定义了一个联合类型。Transporter 中的联合类型通常是标签联合。一个 PhoneNumberType::Mobile 的实例将被序列化为仅仅是 "Mobile"。一个设置为 "Work" 的 PhoneNumberType::Custom 的实例将被序列化为 {"Custom":{"name":"Work"}}。

语言支持

目前，Transporter 支持 Rust 和 PHP。在未来不久，计划支持 Elm 和 TypeScript / Javascript。

Rust

在 Rust 中，上述示例大致翻译为（省略了一些 serde 宏）

type Addressbook = Vec<Contact>;

struct PhoneNumber {
    type_: PhoneNumberType,
    number: String,
}

struct Contact {
    name: String,
    phone: Vec<PhoneNumber>,
}

enum PhoneNumberType {
    Mobile,
    Home,
    Custom {
        name: String,
    },
}

PHP

在 PHP 中，上述示例将翻译为类，例如

// Addressbook.php
class Addressbook {
    private $value;

    public function __construct(array $value) {...}
    public function get() : array {...}
    public function set(array $value) {...}
    public function deserialize($input) : Self {...}
}

// PhoneNumber.php
class PhoneNumber {
    private $type;
    private $number;

    public function __construct(array $fields) {...}
    public function getType() : PhoneNumberType {...}
    public function setType(PhoneNumberType $value) {...}
    public function getNumber() : string {...}
    public function setNumber(string $value) {...}
    ...
}

// Contact.php
class Contact {...}

// PhoneNumberType.php
abstract class PhoneNumberType {...}

// PhoneNumberType/Mobile.php
class Mobile extends PhoneNumberType {...}

// PhoneNumberType/Home.php
class Home extends PhoneNumberType {...}

// PhoneNumberType/Custom.php
class Custom extends PhoneNumberType {...}