{ "componentChunkName": "component---src-templates-blog-post-jsx", "path": "/post/knowhow-of-chatwork-api-with-activeresource/", "result": {"data":{"site":{"siteMetadata":{"title":"WEB EGG","author":"Leko - CTO at Yuimedi"}},"markdownRemark":{"id":"3cda4013-cb40-5267-8058-c1e30ba41070","excerpt":"れこです。 久々にRubyの記事です。 仕事でよくChatWorkを使用するので、いい加減オレオレAPIクライアントじゃなくてちゃんとしたのを作ろう ということで、ActiveResourceを利用したAPIクライアントを作ってみました。 ActiveResourceは基本的にRuby on Rails…","html":"

れこです。
\n久々にRubyの記事です。

\n

仕事でよくChatWorkを使用するので、いい加減オレオレAPIクライアントじゃなくてちゃんとしたのを作ろう
\nということで、ActiveResourceを利用したAPIクライアントを作ってみました。

\n

ActiveResourceは基本的にRuby on Railsで作られたアプリケーション用のAPIクライアントなのですが、汎用的に作られているのでChatWorkのAPIにも対応できました。
\nということで他のAPIにもActiveResourceを利用するために備忘録を残しておきます

\n\n

作ったもの

\n

gem化してGithubに上げてあります。

\n
\n

GitHub – Leko/activeresource-chatwork: ActiveResource classes for ChatWork API

\n
\n

gemの作り方については、こちらの記事がとても参考になりました。

\n

リクエスト/レスポンスの共通部分

\n

ChatWorkのAPIは、リクエストはx-www-form-urlencodedに対しレスポンスはapplication/jsonという特殊な要件なので、
\nActiveResource::Formats::JsonFormatを拡張したフォーマッタを作成しました。

\n

リポジトリのlib/chatwork/base.rbに定義してます。コードはこんな感じ。

\n
class FormToJsonParser\n  include ActiveResource::Formats::JsonFormat\n\n  def mime_type\n    'application/x-www-form-urlencoded'\n  end\n\n  def decode(json)\n    ActiveSupport::JSON.decode(json)\n  end\nend\n\nclass Base < ActiveResource::Base\n  self.format = FormToJsonParser.new\n\n  # ...\n\n  def to_json(options = {})\n    json = if include_root_in_json\n             super({ root: self.class.element_name }.merge(options))\n           else\n             super(options)\n           end\n    hash = JSON.parse(json)\n\n    URI.encode_www_form(hash)\n  end\nend
\n

URL末尾から.json等のフォーマットを消したい

\n

ActiveResource::Base#format_extensionを読んでいたら発見。

\n
class Base < ActiveResource::Base\n  self.include_format_in_path = false\nend
\n

で対応できました。

\n

ネストしたリソースを扱いたい

\n

ChatWorkは/v1/rooms/:room_id/messages/:message_idのように、ネストしたルーティングが必要になります。
\nActiveResourceにはActiveRecordのようにリレーションの機能があるようですが、一部要件を満たせなかった(※後述)ので、下記の記事も参考にしつつ試してみました。

\n
\n

ActiveResource : Passing prefix options
\nちなみに情報が古いのかupdate_attributesに関しては上手く動きませんでした。

\n
\n

リポジトリのlib/chatwork/message.rbに実装例が有りますが、大枠としては

\n\n

has_many的なものは

\n
has_many :members, class_name: 'chatwork/member'
\n

で定義できます。
\nclass_nameオプションを渡さないと、クラスが定義されている名前空間によらずトップレベルの名前空間が指定されてしまうので注意です。
\n注意点として、この方法ではクエリパラメータを渡すことが出来ません 解決方法は後述します。

\n

belongs_to的なものは、残念ながらChatWorkでは意図したとおりに動きません。
\nこれも後述します。

\n

利用方法はテストを見ていただくほうが早いと思います。

\n

クエリパラメータが必要なhas_manyを作りたい

\n

has_manyはオプション引数を受け取ってくれないので、クエリパラメータが必要な場合、has_manyを利用することが出来ません。
\nということでリレーションが使えないならメソッドを自作します。
\n実装にあたり、下記の記事がとても参考になりました。

\n
\n

wholemeal: Active Resource - Associations and Nested Resources

\n
\n

lib/chatwork/room.rbに定義してます。

\n
def messages(params = {})\n    Message.all(params: subroute_params(params))\n  end
\n

という感じに、リレーションっぽいメソッド名で.allや.find、.first等を使用してそれっぽく見せてます。
\nちなみに多用すると N+1のHTTPリクエスト という甚大なボトルネックが生まれます。
\nまぁHTTP+ActiveResourceではSQL+ActiveRecordのような柔軟さは実現できないので、性能に難が出ない程度にすっぱり諦めた方が良いと思います。。。

\n

レスポンスに主キーがなくてもbelongs_toしたい

\n

おそらくActiveResourceは

\n
# /users/1.json\n{ id: 1, name: 'xxx' }\n\n# /users/1/comments.json\n{ id: 100, user_id: 1, content: 'xxx' }
\n

のようなものを想定しているため、レスポンスの中にuser_idに相当するフィールドがないとcommentsからuserを見ることが出来ません。

\n

ChatWorkでの例に置き換えると、
\n/rooms/:room_id/membersのレスポンスにroom_idが含まれていないので、belongs_toでは紐付けが出来ません。
\nbelongs_toはパスを生成する時にレスポンスの中身しか見てくれないないようです。なぜかprefix_optionsを見てくれません。
\nということでメソッドを自作します。

\n

lib/chatwork/nest_of_room.rbに定義してます。

\n
module ChatWork\n  module NestOfRoom\n    def room\n      Room.find(prefix_options[:room_id])\n    end\n  end\nend\n\nmodule ChatWork\n  class Member < Base\n    include ChatWork::NestOfRoom\n  end\nend
\n

という感じで、prefix_optionsを使ってRoom.findすれば、レスポンスにroom_idが無くてもなんとかできます。

\n

Railsのルーティングに反するURLに対応したい

\n

/v1/my/tasksのように、Railsのルーティングに対応してないURLもなんとかしたい。
\nActiveResourceにはカスタムメソッドの機能があります。

\n
# {ActiveResource::Baseを継承したクラス}.{HTTPメソッド(小文字)}(:パス, オプション)\nChatWork::My.get(:tasks, status: 'open')
\n

という感じで、ただのHTTPクライアント的な使い方もできるようです。
\n戻り値が配列だったらArray、戻り値がオブジェクトならHashのインスタンスが返るようです。
\nこのままではActiveResourceのメソッド郡が使えないのでなんとかしたい。。。

\n

カスタムメソッドでもActiveResource::Baseのインスタンスを返したい

\n

カスタムメソッドを使うとHashかArrayになってしまうので、なんとかしたい。
\nActiveResource::Base.newはHashを受け取るので、受け取ったレスポンスをそのまま渡せます。
\nつまりゴリ押しです。もしかしたら相当するオプションが有るのかもしれません。

\n

lib/chatwork/my.rbに定義してます

\n
def self.tasks(params = {})\n      get(:tasks, params).map { |t| ChatWork::Task.new(t, true) }\n    end
\n

これを応用すれば、レスポンスを任意のクラスに変換できそうです。
\n件数の多いAPIだと.newのオーバーヘッドが地味にありそうなので、ご利用は計画的に。

\n

主キーに相当するフィールド名を上書きしたい

\n

デフォルトだとレスポンス内のidというフィールドを主キーと見なす、という作りになっています。
\nChatWorkでいえば、/roomsのレスポンス内の主キーはroom_idというフィールド名になっています。
\nこのままではフィールド名が噛み合わずsaveやdestroyの挙動に支障をきたします。

\n

これを上書きするには、primary_keyというプロパティを変更します。

\n
self.primary_key = 'room_id'
\n

こうすれば、レスポンス内部にidというキーがなくてもマッピングしてくれました。

\n

まとめ

\n

やはりRailsでないアプリケーションにActiveResourceを対応させるのは少々無理が生じるようです。
\nそれでもChatWorkのURL構造はだいぶRailsにRESTfulな感じなので、比較的軽度に収まりました。
\nもしオレオレ全開なAPIに対応するとしたら、カスタムメソッドを多用することになりそうだなぁ、、、と感じました。

\n

この内容が、少しでもActiveResourceでRails以外のAPIクライアントを作るときの助けになれば幸いです。

","timeToRead":10,"frontmatter":{"title":"ActiveResourceでChatWorkのAPIクライアントを作る際にハマったところと解決策","tags":["ActiveResource","ChatWork","Ruby"],"date":"September 26, 2016","featuredImage":null}}},"pageContext":{"slug":"/knowhow-of-chatwork-api-with-activeresource/","previous":{"fields":{"slug":"/event-report-of-isucon-2016/"},"frontmatter":{"title":"ISUCON 2016に参加してスコア40700点で予選敗退した","tags":["ISUCON"]}},"next":{"fields":{"slug":"/automate-deploy-to-rubygems-with-circleci/"},"frontmatter":{"title":"RubygemsへのデプロイをCircleCIで自動化してみた","tags":["CircleCI","Ruby","Rubygems"]}}}}, "staticQueryHashes": ["2585454260","2954598359"]}