JSON::RPC::Spec v1.0.5 をリリースしました
2015年11月16日
おはようございます。
若林(@nqounet)です。
JSON::RPC::Specをアップデートしましたのでお知らせいたします。
JSON::RPC::Specとは
ひとことで言うと、JSON-RPCの仕様のJSON文字列を解釈して結果を返すモジュールです。
詳しくは過去のリリースの時に書いたエントリーをご覧ください。
全くの偶然なのですが、仕事でJSON-RPCの仕様で通信を行う機会がありました。
ただし、通信を暗号化する必要があったり、既存のアプリが持っているデータも使いたいので、アプリの中に組み込めるこのモジュールを使っています。
ただ、実際に使ってみると、要求された仕様で動くように書いていくのは結構大変でした。
特に、任意のエラーを出すことを想定していなかったので、微妙なハックで対応したのですが、とりあえず喉元過ぎれば熱さを忘れるとかいうやつです。
で、それ以外に、どう頑張っても無理そうな事があったので、今回はそれを実現するためにアップデートしました。
アップデート内容の概要
JSON文字列を解釈(parse または parse_without_encode)するとき、その文字列以外にも変数を渡せるようにしました。
その変数は、ディスパッチャを定義(register)で定義する関数で受け取ることができます。
詳細
このモジュールは使うタイミングによってメソッドが分かれています。
ひとつ目はディスパッチャの定義(register)、ふたつ目がJSON文字列を解釈する関数(parse または parse_without_encode)です。
ひとつ目のregisterは、methodによって動作を変えることを想定していて、Router::Simpleの機能を使って各クラス、あるいは関数へ処理を振り分ける定義をします。
1 | $rpc->register('myapp.{action}' => sub { |
モジュールのregisterの説明部分にはこういう書き方をしています。
こうした場合に以下のようなJSON文字列をparseすると、
1 | ``` |
ディスパッチ先(例としては、MyApp::Fooのbar関数)で受け取ることができます。
1 | # https://github.com/nqounet/p5-json-rpc-spec/blob/657ede22dd44be863281e8775602ce7c1e8d20c2/examples/extra_args/lib/MyApp/Foo.pm#L10-L22 |
Mojolicious::Lite のように1枚のファイルに書く場合は不要なのですが、ちゃんとクラスに分けて書こうとすると変数がなかなか渡しづらいので、こういう場面で使えるように考えました。
実際に使おうとしている場面
Mojolicious でシステムを作っているのですが、そのシステムにJSON-RPCの方式で外部からアクセスできるようにしていたのです。
register は アプリ(Mojoliciousを継承しているモジュール) の startup のタイミングで定義しており、実際に処理したいJSON文字列は、コントローラー(Mojolicious::Controllerを継承しているモジュール)に実装しています。
この時、ディスパッチ先でコントローラーが持っているデータを使いたいと思ったら、なかなか難しいことに気づきました。
parseする時にコントローラーを渡すのが最も簡単だったので、今回は素直にこういう実装にしました。
JSON-RPCをアプリに組み込むならJSON::RPC::Spec
JSON::RPC::Specは、バッチについても対応しています。
つまり、完全にJSON-RPCに対応していますので、アプリでJSON-RPCをやるならJSON::RPC::Specが良いと思います。