Connect `use`

[azu]

Connectのアーキテクチャ

URL: https://github.com/senchalabs/connect

どう書ける?

var connect = require('connect')
var http = require('http')

var app = connect()

// gzip/deflate outgoing responses
var compression = require('compression')
app.use(compression())

// store session state in browser cookie
var cookieSession = require('cookie-session')
app.use(cookieSession({
    keys: ['secret1', 'secret2']
}))

// parse urlencoded request bodies into req.body
var bodyParser = require('body-parser')
app.use(bodyParser.urlencoded())

// respond to all requests
app.use(function(req, res){
  res.end('Hello from Connect!\n');
})

//create node.js http server and listen on port
http.createServer(app).listen(3000)

どういう仕組み? #57

• .use(middlware) はmiddlewareをstackに追加する
• https://github.com/senchalabs/connect/blob/05fae3d9c9a6fa44d1bb274789645a92fbaac17b/index.js#L107-L107
• リクエストがきたら、stack.forEach(middleware => middleware(req, res, next)) する

  どういう事に向いてる?

• TBD

  この仕組みを使ってるもの

• https://github.com/wooorm/mdast

---

チェックリスト

• [x] どう書ける?
• [x] どういう仕組み?
• [x] どういう用途に向いている?
• [x] どういう用途に向いていない?
• [x] この仕組みを使ってるもの
• [x] 実装してみよう
• [x] エコシステム

[azu]

Node.jsのモジュールで.use(plugin)的なものが結構多い気がするけど、 これは何が起源なんだろ? connectが最初なのかな?

[ledsun]

connectのuseはRack DSL起源ではないでしょうか？ 実践Node.js プログラミングのP149に

Connect ミドルウェアのコンセプトは、もともと Ruby の Rack フレームワークの影響を受けている。
だから Rack と非常によく似たモジュールインタフェースを提供するが、Node はストリーミング方式なので
API は共通ではない。

という記述がありました。

Ruby - Rack解説 - Rackの構造とRack DSL - Qiitaに、useメソッドを使うと

run Rack::ETag.new(
  Rack::Deflater.new(
    Rack::Directory.new 'public'
  )
)

を次のように書ける

use Rack::ETag
use Rack::Deflater
run Rack::Directory.new 'public'

という例がありました。とてもconnectぽいと思います。

[azu]

@ledsun ありがとうございます。なるほど。 たしかにconnectのはrackに影響受けてそうですね。

package.jsonのkeywordsにもrackがあったりしました

• https://github.com/senchalabs/connect/blob/643a88490a76ad2738d8ba54614277e514e09b64/package.json#L16

[azu]

コールドリーディング v2

• Connect とは (詠む会向け資料) - Null.ly

[azu]

middleware patternと呼ばれる事がある感じ

• javascript - Middleware design pattern in Node.js: Connect - Stack Overflow
• Nixtu: Middleware Pattern in JavaScript

[azu]

connectはmiddleware間の依存関係とか定義ないので、色々自分でガンバってやる必要があって、細かいのは実装でやってね的な感じっぽいな

• express 3.0 で cookieSession を使うときは cookieParser も明示的に呼べ - たごもりすメモ

[azu]

Node.js - 逆引きメモ：expressの使い方 - Qiitaはmiddlewareの考え方が簡単にまとまってる。

• A short guide to Connect Middleware

[azu]

rackの実装

• Rackのuseとrunを紐解く - yktwwwの日記

[azu]

ミドルウェアとは何かを一言で言うと，「別なアプリケーションをラップして，リクエストやレスポンスを加工したり，処理を切り換えたりするRackアプリケーション」です -- http://gihyo.jp/dev/serial/01/ruby/0025

[azu]

このミドルウェアの連鎖をミドルウェアスタックといいます。 -- 第3回　WSGIミドルウェアの作成：WSGIとPythonでスマートなWebアプリケーション開発を｜gihyo.jp … 技術評論社

Rack middlewareの仕組みの元ネタはPythonのWSGI middlewareという感じなのかな

[azu]

Connectに統一しよう #48

[azu]

この仕組みエラーハンドリングがイマイチピンとこないという大変そう

やっぱり実際大変なのかな

• RailsでAPIをつくるときのエラー処理 - Qiita

[azu]

middlewareスタックなやつ、直接オブジェクトを変更しないで、抽象オブジェクトを入れて編集させれば矛盾ある変更とかの検知ができるようになる気がする

[azu]

ひとまず書けたのでCloseします

• https://azu.gitbooks.io/javascript-plugin-architecture/content/ja/connect/index.html

微妙に曖昧なところもあるので Pull Request歓迎です

[azu]

• r7kamura/stackable-fetcher

middlewareの仕組み