1.
node.jsによるAPIサーバ構築
h_mori
13年4月18日木曜日

2.
自己紹介
• 森 英寿（プログラマ）
hidetoshi.mori
@h_mori
SOICHA/TweetMe
ATND暦/生存連絡
13年4月18日木曜日

3.
背景
• iOSアプリから利用するAPIサーバ構築
• API認証基盤を作る
• PushNotificationを発行
13年4月18日木曜日

4.
node.jsを利用した経緯
• MongoDBのRESTオプションによる構築
• 後から認証基盤を追加実装
• 後からPushNotificationを実装
13年4月18日木曜日

5.
データモデル
• DataList (トランザクション)
• User (アカウント情報) ※追加
• Device (端末情報) ※追加
• Group (ユーザカテゴリ) ※追加
13年4月18日木曜日

6.
サーバ構成
• MongoDB
• restify
• Mongoose
13年4月18日木曜日

7.
MongoDB？
• NoSQL
• ドキュメント指向DB（スキーマレス）
• where, like検索, 集計関数も可能
13年4月18日木曜日

8.
苦手なこと
• トランザクション制御
（アトミック性は保証）
• リレーショナル、一意制約等
13年4月18日木曜日

9.
DB構造
• DBS ＞ Collection ＞ Object
(Database) (Scheme) (Record)
13年4月18日木曜日

10.
メリット
• 起動オプションにREST I/Fがある
• JSONとの親和性が高い
• WebAPI化しやすい
13年4月18日木曜日

11.
有用なケース
• トランザクション制御が不要
• 大量書き込みが想定される
• データの一意制約が不要
13年4月18日木曜日

12.
導入
• $ brew install mongodb
• $ port install mongodb
• mongodb.orgからDLして任意のフォルダに展開
13年4月18日木曜日

13.
DBサーバ起動
• $ ./bin/mongod -dbpath=db/ --rest
※RESTオプション付き
※28017ポートでWebAPIが起動
13年4月18日木曜日

14.
DBクライアント
• $ ./bin/mongo
GUI clientも存在するがメリットは薄い
13年4月18日木曜日

15.
URLアクセス
• curl 'http://localhost:28017/testdb/hoge'
• curl -d "{'user':'test'}" 'http://localhost:28017/testdb/hoge'
13年4月18日木曜日

16.
restify ？
• RESTに特化したnode.jsモジュール
• Expressを軽量化したようなもの
13年4月18日木曜日

17.
restifyの主な機能
• Routing
• Header Parser / Error handler
• JSONP/JSON support
• GZIP support
• URL-encoder
• multipart form
13年4月18日木曜日

18.
restify導入
• $ npm install restify
• var restify = require('restify');
13年4月18日木曜日

19.
Routing
var restify = require('restify');
var server = restify.createServer();
server.use(restify.queryParser());
function send(req, res, next) {
res.send('hello ' + req.params.name);
return next();
}
server.post('/hello', function create(req, res, next) {
res.send(201, Math.random().toString(36).substr(3, 8));
return next();
});
server.get('/hello/:name', send);
server.head('/hello/:name', send);
server.del('hello/:name', function rm(req, res, next) {
res.send(204);
return next();
});
13年4月18日木曜日

20.
Mongoose ？
• MongoDB用ドライバ
• Object Modeling Tool (O/Rマッパ)
• DBコネクションのバッファリング
• Validator、Defaults、Index等の定義可
13年4月18日木曜日

21.
Mongooseの使用例
var UserSchema = new mongoose.Schema({
email:{
type: String,
unique: true,
index: true
},
password:String,
created_at:{type: Date, default: Date.now},
updated_at:{type: Date, default: Date.now}
});
UserSchema.pre('save', function(next) {
this.updated_at = Date.now();
next();
});
var User = mongoose.model('user', UserSchema);
13年4月18日木曜日

22.
Mongoose導入
• $ npm install mongoose
• var mongoose = require('mongoose');
13年4月18日木曜日

23.
cloud9 IDE
• ブラウザベースIDE
• クラウド上にプライベート領域を作れる
(github,bitbucket,heroku等と連携)
• Node.js、PHP、Java、Ruby等をサポート
13年4月18日木曜日

24.
cloud9 IDE 導入
• ローカル環境にインストールも可能
• $ git clone https://github.com/ajaxorg/
cloud9.git cloud9
• sudo ./cloud9/bin/cloud9.sh
13年4月18日木曜日

25.
cloud9 IDEの起動
• ./bin/cloud9.sh -w {workspace_dir} で起動
• http://localhost:3131 にアクセス
13年4月18日木曜日

26.
認証方式
• SSL + Basic認証 + sha1(solt)
13年4月18日木曜日

27.
restify.authorizationParser
• server.use(restify.authorizationParser());
• req.authorization オブジェクト
{
scheme: <Basic|Signature|...>,
credentials: <Undecoded value of header>,
basic: {
username: $user
password: $password
}
}
13年4月18日木曜日

28.
認証基盤の実装
server.use(function authenticate(req, res, next) {
if (!req.authorization.basic) {
res.header('WWW-Authenticate', 'Basic realm=""');
res.send(401);
return next(false);
}
User.findOne({email:req.username}, function (err, user) {
if (err) { return next(err); }
if (!user && user.password !== req.authorization.basic.password) {
return next(new restify.NotAuthorizedError());
}
return next();
});
});
13年4月18日木曜日

29.
実装上の注意
• I/O系関数は処理順序を保証しない
var user = User.findOne({email:req.params.email});
user.password = req.params.password;
user.save();
res.send(user);
13年4月18日木曜日

30.
実装上の注意
• 必ずコールバックにて処理
User.findOne({email:req.params.email}, function(err, user) {
user.password = req.params.password;
user.save(function(arr, data)) {
res.send(data);
});
}
13年4月18日木曜日

31.
実装上の注意
• 複雑な処理の同期が必要な場合は外部
モジュールを検討する
‣ async.js
‣ node-fibers
‣ flow-js
‣ step
13年4月18日木曜日

32.
実装して思ったこと
• 非同期処理が不要な場合node.jsは向かない
（client, middlewareにロジックを置く場合は有）
• MongoDBと簡易JsonAPIは相性がいい
• node.jsと関連モジュールはまだまだ過渡期
13年4月18日木曜日