Crafting Rails4 Applications読み回 1. Creating Our Own Renderer
Download as PPTX, PDF2 likes7,565 views
Crafting Rails4 Applications読み回 1. Creating Our Own Renderer
- 1. Crafting Rails4 Applications 1. Creating Our Own Renderer
- 4. rails plugin new pdf_renderer • Rails pluginのgenerator Treeで出したディレクトリツリー ライブラリ本体 テスト用ディレクトリ
- 7. Rake tasks • Plugin用のRakeタスクがちょいちょい – Rake releaseでRubygemsにpushできるらしい – testの実行はrake test
- 8. Dummy application • 基本的に普通のRailsプロジェクトと同じ – アプリケーション名はdummy • rails new dummy でできるファイル群とほぼ同じ – 一応diffしてみたけれども，確かにほとんど同じ
- 10. actionpack/lib/action_controller/metal/renderers.rb • とりあえず眺めてみると， – ActionController::Renderers::_renderersにSetが入ってい る – _renderersはActionController::Renderers::add()で追加で きる • add(key, &block)の中では_render_option_#{key}を define_methodしているだけ – デフォルトで:json, :js, :xmlが定義されている • 何気にJSONPのオプション（callback: true）も用意されていた
- 11. PDF Renderer作ろうぜ • こういうのを作りたい • rendererを拡張すれば，Railsの流儀に従ってい い感じにPDF出力できるじゃん！！
- 12. Pluginにgemのdependency追加 • Pluginでgemを使う場合，Gemfileではなくgemspecに書く – 書いた後は普通にbundleすればdependしたgemが入る pdf_renderer.gemspec • この辺の定義はGemfileにあった Gemfile この記述でgemspecのdependencyを読み込んでいるみたい
- 14. 振る舞いとテストまで書いてみる
- 15. 動作確認・開発の方法 • test/dummyにcdすれば，普通にrails sできる – 普通のRailsアプリと同様に開発できるよー lib/pdf_renderer.rb この記述で:pdfをrender()が解釈できるようになる
- 16. MIME typeの設定 • テストを見ると，content-type: application/pdfが勝手に付与されて いるが，これはたまたまPDFの設定がデフォルトであったから Actionpack/lib/action_dispatch/http/mime_types.rb • もしここに設定されていないcontent-typeを指定したい 場合，config/initializers/mime_types.rbに書けば良い Rails newデフォルトのconfig/initializers/mime_types.rb スマホ向けの出し分けなんかで触ったことある人もいるのでは？
- 17. Rendererを潜る
- 18. Render()の流れ 引数を展開して正規化されたoptions hashを作る Renderのoptionが色々な形式に対応しているのはこの辺がやってる render(:new)とか，render(partial: true)みたいなものを受けて，正しい Action_nameに変換したりする HTTP bodyに関係の無い部分をoptionsに沿って処理する． status: 401とかそういうの view_renderer.render(view_context, options)を呼び出す view_contextはActionView::Baseのインスタンス
- 20. Controller -> Viewへの値渡しについて • Rails 2.3系まで – ViewがControllerのインスタンス変数を取りに行って いた • Rails 3.0から – ControllerからViewに渡すインスタンス変数を明示的 に指定できるようになった こうするとViewにインスタンス変数が渡らなくなる
- 21. 拡張するぜ
- 23. もっと拡張
- 28. render と render_to_string • 違いは見ればわかるよね？ – pdf_rendererみたいにrenderした中身をstring取得したい時には便利 – render_to_stringは，DoubleRenderErrorは発生しない （ActionController::Rendering#renderに実装されているため） – 同じ理由でrender_to_stringはctionController::Instrumentationによっ てベンチマークされない
- 29. 話を戻すと • render_to_string({}) – _normalize_options()でoptions = template: ”#{controller_name}/#{action_name}” を生成している
- 32. まとめ • PDFフォーマットのファイルを返す pdf_rendererを作る中で，Railsのrendering stackを追ってみたよ • Rendering stackはモジュール化されているの で，renderや_normalize_optionsなどのエント リポイントで任意の処理を追加することができ るぞ