pficommonのpfi::text::jsonでシリアライズ/ デシリアライズしてみた

@unnonounoさんが紹介してくださったpficommonのjsonライブラリを試してみました。
pficommonのjsonライブラリはboostみたいにjsonと自分で作ったクラスのオブジェクトとのシリアライズ/デシリアライズができるのがとても魅力です。
その一方で、結構ドキュメントには書いてないことが色々あったので、メモしておきます。

いつものようにコードはgithubにあります。

https://github.com/chezou/pficommon_json_test

今回のポイントは以下の通りです。

1. wafの使い方
2. 基本的なアクセスの仕方
3. stringとjsonの相互変換
4. オブジェクトとのシリアライズ/デシリアライズ

1.wafの使い方

wafはmakeの代わりのビルドシステムで、pythonでビルドします。詳細な使い方はこちらを参考にしてください。
基本的には、wscriptと呼ばれるMakefileのような物をソースコードがあるディレクトリにそれぞれ書きます。
この際、各ディレクトリに置かれたwscriptが再帰的に呼ばれるので、モジュール毎にディレクトリを切り分けている場合は、そのモジュールの必要なライブラリなどを書いておくべきです。

例としてsrcディレクトリにあるwscriptをのせます。

def build(bld): bld.program( source = 'json-test.cpp', target = 'json-test', includes = '. ../include', lib = 'pficommon\_text pficommon\_data', use = 'JSON TEST' )

見れば分かると思いますが、sourceにソースとなるファイル、targetにビルドした後の実行ファイル名、includesにヘッダーファイルの場所を書きます。libにはライブラリ名を列挙します。このとき、複数の場合はスペースで区切ればOKです。

で、できたらこんな感じでビルドします。

./waf configure ./waf

2.基本的なアクセスの仕方

良くあるmapみたいなアクセスをしていって最後にjson_castをします。

cout \<\< json\_cast(js["user"]["id"]) \<\< endl;

3.stringとjsonの相互変換

基本的にはstringstreamを経由します。

実際にはこんな感じでします。

#include \<pficommon/text/json.h\> #include \<sstream\>using namespace pfi::text::json;using namespace std;namespace util{ json string\_to\_json(string str){ json js; stringstream ss(str); ss \>\> js; return js; } string json\_to\_string(json js){ stringstream oss; oss \<\< js; return oss.str(); } }

こんな感じで使います。

json js = util::string\_to\_json("{\"foo\":true, \"bar\": \"buzz\"}"); string str = util::json\_to\_string(js);

4.オブジェクトとのシリアライズ/デシリアライズ

ドキュメントにもありますが、自分で作ったクラスのjsonへのシリアライズをしたい場合は、シリアライズしたい変数をMEMBERマクロで登録しておきます。
boostのような感じですね。

class SouvenirDef {public: pfi::data::optional\<std::string\> name; pfi::data::optional\<int\> price; pfi::data::optional\<bool\> famous; pfi::data::optional\<bool\> funny; template \<class Archive\> void serialize(Archive &ar){ ar & MEMBER(price) & MEMBER(famous) & MEMBER(name) & MEMBER(funny); } };

シリアライズしたいときは、to_jsonを、デシリアライズをしたい時はvia_json_with_defaultを使うと良いでしょう(json_castでやると不足したkeyがあるとbad_castになってしまうので)。

stringstream ss("{\"name\":null,\"famouse\":true}"); Souvenir sv2; ss \>\> via\_json\_with\_default(sv2); cout \<\< to\_json(sv2) \<\< endl;

いくつか注意点・ポイントです。この辺、知っておくと無駄にハマらないかと思います。

• 基本的な型はpfi::data::optionalを使う。使わないとnullをシリアライズできない。シリアライズしたい型はpfi::data::optionalを使う。デシリアライズしたい場合は使わない。

• 配列を表したい時はvector, ハッシュを表したい時はmapを使う。

• pairとmapは使えない。 特に1点目ですが、サンプルコードのSouvenirクラスを見てください。

  class Souvenir { public: std::string name; int price; pfi::data::optional<int> max_price; bool famous; bool funny; template <class Archive> void serialize(Archive &ar){ ar & MEMBER(price) & MEMBER(famous) & MEMBER(name) & MEMBER(funny) & MEMBER(max_price); } };

このmax_priceのようにpfi::data::optionalとすると、変数に値が入っていない場合にto_jsonでシリアライズするとnullになってくれるのですが、以下のように直接クラスの値を参照しようとすると、値の有無が0/1で取得できる形になってしまいます。

[20120320追記]

optionalで宣言した型を取得する場合は、ポインタのように*演算子でアクセスするようです。
boost::optionalが参考になるそうです。@eiichiroi さんありがとうございます！

@chezou pficommonのoptionalの件(jsonと、メンバにoptionalを持つユーザ定義型の相互変換)についてですが、optionalも(デ)シリアライズできるようになっていました。optionalな変数へのアクセス方法を少し変えて貰えれば大丈夫だと思います

— Eiichiro Iwata (@eiichiroi) 2012, 2月 28

@chezou ドキュメントに書かれていなくて申し訳ないのですが、optionalはポインタのようなものです。値を取り出すときには、*(sv2.max_price)のような感じで取り出す必要があります。ポインタと違う点はoptional間で値を共有しない(コピーする)ところです

— Eiichiro Iwata (@eiichiroi) 2012, 2月 28

> [@chezou](https://twitter.com/chezou) 正確な挙動についてはsrc/data/optional.hを、使い方の雰囲気についてはboost optionalでググるとなんとなく分かるかと思います。もし何かうまくいかない点や分からないところがあったら、また教えてください
> 
> — Eiichiro Iwata (@eiichiroi) [2012, 2月 28](https://twitter.com/eiichiroi/status/174541460249645057)

<script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script>

     stringstream ss("{\"name\":null,\"famous\":true,\"max\_price\":1200}"); Souvenir sv2; ss \>\> via\_json\_with\_default(sv2); //max\_priceは型をpfi::data::optional\<int\>にしているため、1/0の値で格納される//アクセスは\*(max\_price)でアクセス cout \<\< "name:" \<\< sv2.name \<\< " price:" \<\< sv2.price \<\< " max\_price:" \<\< \<strong\>\*(sv2.max\_price)\</strong\> \<\< " famous:" \<\< (sv2.famous ? "true" : "false") \<\< " funny:" \<\< (sv2.funny ? "true" : "false") \<\< endl; //max\_priceをjsonにする場合は問題ない cout \<\< to\_json(sv2) \<\< endl;



このため、 **jsonを入力としてデシリアライズしたい場合はpfi::data::optionalを利用しない変数を、シリアライズしてjsonに出力したい場合はpfi::data::optionalを利用した変数にしないといけません。**

きちんと*演算子でアクセスすることで、入出力対象な形で利用できます！

それでは、pficommonで楽しいJSONライフを！