序列化

序列化包裝器

二進位物件
陣列
BOOST_STRONG_TYPEDEF
集合大小
名稱-值對
組合

有時為了支援某些底層資料的序列化，建立一個臨時物件會比較方便。這允許封存類別針對此類型定義特殊處理方式。程式庫包含數種類似用途的類型。

某些封存需要以特殊方式處理包裝器，因此這些包裝器類別的 is_wrapper 特性會設定為 true。

二進位物件

二進位物件只是一系列以原始二進位資料儲存的位元組。這通常用於大量的「輕量級」資料，例如像素圖或嵌入式二進位檔案。標頭檔 binary_object.hpp 包含建構函式


boost::serialization::binary_object(void * t, size_t size);
boost::serialization::make_binary_object(void * t, size_t size);

它會建構一個可以像其他物件一樣被序列化的臨時二進位物件。其預設序列化方式是使用封存類別的原生函式 save_binary 和 load_binary。請注意，它不會配置任何儲存空間或建立任何物件。其唯一目的是將資料大小和位址作為一對傳遞給封存類別。

陣列

陣列是連續的同質資料類型序列，例如內建 C 陣列、boost::array<T> 或 std::vector<T>。此包裝器的目的是支援提供針對相同類型連續物件序列進行最佳化序列化的封存類型（例如二進位封存）。標頭檔 array.hpp 包含函式


template <T>
boost::serialization::make_array(T* t, std::size_t size);

它會建構一個臨時的 array 物件


template<class T>
class array
{
public:    
    typedef T value_type;
    array(value_type* t, std::size_t s);
    value_type* address() const;
    std::size_t count() const;
};

它可以像其他物件一樣被序列化。其預設序列化方式是序列化每個陣列元素。請注意，它不會配置任何儲存空間或建立任何物件。其唯一目的是將資料類型、大小和位址傳遞給封存類別。可以為連續同質資料陣列提供最佳化實作的封存類型應覆載 array 的序列化。

xml 存檔類別包含類似於以下的程式碼：


// special treatment for name-value pairs.
template<class T>
xml_oarchive & operator&(const boost::serialization::nvp<T> & t)
{
    // write an xml start tag
    start_tag(t.name());

    // serialize the data as usual
    *this & t.value();

    // write an xml end tag
    end_tag(t.name());
}

指定為 XML 資料項目名稱最明顯且最方便的名稱是——驚喜！——C++ 類別資料成員的名稱。所以我們的序列化程式碼看起來像這樣：


ar & make_nvp("my_variable", my_variable);

為了簡化輸入並提高可讀性，定義了一個巨集，以便我們可以這樣寫：


ar & BOOST_SERIALIZATION_NVP(my_variable);

類似地，存在一個巨集定義，允許我們這樣寫：


BOOST_SERIALIZATION_BASE_OBJECT_NVP(my_base_class)

請注意，這些巨集必須在類別的命名空間中使用，並且在參數中不要限定命名空間。

demo_gps.hpp 包含所有資料成員的 NVP 包裝器。demo_xml.cpp 將資料儲存和載入到 XML 存檔中。這裡是與我們的教學範例相對應的 XML 存檔範例。

組合

包裝器應該設計成可以根據需要組合。例如，要將二進位資料作為名稱-值對傳遞，請使用：


ar & make_nvp("named_binary_object", make_binary_object(address, size));

序列化

序列化包裝器

二進位物件

陣列

BOOST_STRONG_TYPEDEF

集合大小

名稱-值對

組合

`BOOST_STRONG_TYPEDEF`