Intern::Bookmark

はてな教科書サンプルコード

2015年度以降はこちら https://github.com/hatena/perl-Intern-Bookmark

セットアップ

以下のコマンドを実行。

$ script/setup.sh

サーバ起動

以下のコマンドでサーバが起動できる。デフォルトではhttp://localhost:3000/ にアクセスすれば良い。

$ script/appup

OAuthの設定

• script/app.psgiのenable 'Plack::Middleware::HatenaOAuth'と記述しているあたりに必要な情報を登録する必要があります

API

$c

• Hatena::Newbie::Context
• コンテキストという名が示すように、ユーザーからのリクエストにレスポンスを返すまでに最低限必要な一連のメソッドがまとめられている

$c->req

• リクエストオブジェクトを取得する
• Plack::Requestを継承したHatena::Newbie::Request

$c->req->parameters->{key}

• keyに対応するリクエストパラメーターを取得する
• クエリパラメーターやルーティングによって得られたパラメーターなど全てが対象となる

$c->dbh

• データベースハンドラーを取得する
• DBIx::Sunnyを継承したHatena::Newbie::DBI

$c->html

• ファイル名とテンプレート変数を渡すと、レスポンスをHTMLとして設定してくれる

$c->html('index.html', { foo => $bar });

$c->json

• ハッシュリファレンスを渡すと、レスポンスをJSONとして設定してくれる

$c->json({ spam => $egg });

$c->redirect

• URLを渡すと、レスポンスをリダイレクトとして設定してくれる

$c->redirect('/');

$c->res

• レスポンスオブジェクトを取得する
• Plack::Response

$c->route

• ルーティング結果が格納されたハッシュリファレンスを取得する
• ルーティングはHatena::Newbie::Config::Routeで行われる