ドメイン名のルーティング

0.28.0 以降、fibjsmq.Routing オブジェクトはドメイン名ルーティングとして HOST メソッドをサポートします。

1
2
3
4
5
6
7
8
9
10
11
12
const mq = require('mq')

const rt = new mq.Routing();

// support *.fibjs.org in Routing
rt.host('*.fibjs.org', ...)
// support api.fibjs.org in Routing
rt.host('api.fibjs.org', ...)
// support fibjs.org in Routing
rt.host('fibjs.org', ...)

rt.append('host', 'fibjs.org', ...)

いくつかの例を見てみましょう。

簡単な例

単純なファイルハンドラー

ドメイン名 fibjs.org がアプリケーションが配置されているマシンにバインドされていると仮定します (テスト目的で、ローカルでホストを変更することによってこのバインド効果を実現することもできます) file.fibjs.org。FILE_DIR にファイルリソースをダウンロードできることを期待しています。マシン上のディレクトリにある場合は、次のようにすることができます。

1
2
3
4
5
6
const mq = require('mq')
const http = require('http')

const fileRoutes = new mq.Routing();
// support file.fibjs.org in Routing
fileRoutes.host('file.fibjs.org', http.fileHandler(FILE_DIR))

フロントエンドリソースホスト

典型的なシナリオは、コンパイルされたフロントエンドアプリケーションがマシンに公開される (たとえば、/home/frontend/assets/ディレクトリに保存される) というものです。

1
2
3
4
5
/home/frontend/assets/index.html
/home/frontend/assets/200.html
/home/frontend/assets/app.839ca9.js
/home/frontend/assets/common.537a50.js
/home/frontend/assets/chunk.d45858.js

これらのリソースを festatic.fibjs.org を通じて取得したい場合は、次のように記述できます。

1
fileRoutes.host('festatic.fibjs.org', http.fileHandlers('/home/frontend/assets/'))

APIサーバー

マシン上に API サーバーがあり、それらをapi.fibjs.orgこのドメイン名に統合したいとしますが、次のような異なるパスを割り当てたいとします。

APIサーバー	使用法	パス
http://127.0.0.1:3001	ユーザーサービス	/ユーザー
http://127.0.0.1:8080	ビズ1	/biz1
http://127.0.0.1:9007	ビズ2	/biz2

次に、次のことができます。

1
2
3
4
5
6
7
8
9
10
const mq = require('mq')

const apiRoutes = new mq.Routing();

// proxyTo 是代理请求到对应 origin 的函数
apiRoutes.host('api.fibjs.org', {
    '/user': (req) => proxyTo(req, `http://127.0.0.1:3001`),
    '/biz1': (req) => proxyTo(req, `http://127.0.0.1:8080`),
    '/biz2': (req) => proxyTo(req, `http://127.0.0.1:9007`),
})

さらに、「/biz1」パスで http POST リクエストのみを受け入れるようにしたい場合は、次のようにすることができます。

1
2
3
4
5
6
7
8
9
const mq = require('mq')

const apiRoutes = new mq.Routing();

apiRoutes.host('api.fibjs.org', {
    '/user': (req) => proxyTo(req, `http://127.0.0.1:3001`),
    '/biz1': apiRoutes.post((req) => proxyTo(req, `http://127.0.0.1:8080`)),
    '/biz2': (req) => proxyTo(req, `http://127.0.0.1:9007`),
})

api.fibjs.org は現在のマシンにバインドされている必要があることに注意してください

複雑な例

他の宣言がない場合、次の例では、次の関数が存在します。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// 生成带特定 host 的请求
function getRequest({
    path = '/',
    host = 'www.fibjs.org'
}) {
    const req = new http.Request()

    req.value = path
    req.addHeader('host', host)
    return req
}

// 以 method 尝试对 routes 发起一个 header: host=host 的请求
function invokePathFromHost (path, host, method = 'GET') {
    const req = getRequest({ path, host })
    req.method = method

    mq.invoke(routes, req)

    const result = req.response.body.readAll()
    return result ? result.toString() : result
}

ドメイン名の流用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
const mq = require('mq')
const http = require('http')
const assert = require('assert')

const routes = new mq.Routing();

routes.host('api.fibjs.org', [
    {
        '/user/information': req => req.response.json({name: 'xicilion'}),
    },
    req => req.response.body.rewind()
])

// routes.host 方法可以多次调用
routes.host('*.fibjs.org', [
    {
        '/': req => req.response.json({message: 'I am in root'}),
        '/index.html': req => req.response.body.write(`<html><body>hello fibjs</body></html>`),
        '/index.js': req => req.response.body.write(`console.log('hello world')`),
        '*': (req, domain) => {
            req.response.json({message: 'I am fallback'})
        }
    },
    req => req.response.body.rewind()
])

assert.equal( invokePathFromHost('/', 'www.fibjs.org'), `{"message":"I am in root"}` )
assert.equal( invokePathFromHost('/index.html', 'static.fibjs.org'), `<html><body>hello fibjs</body></html>` )
assert.equal( invokePathFromHost('/index.js', 'static.fibjs.org'), `console.log('hello world')` )
assert.equal( invokePathFromHost('/user/information', 'api.fibjs.org'), JSON.stringify({name: 'xicilion'}) )

try {
    invokePathFromHost('/', 'fibjs.org')
} catch (error) {
    assert.equal(error, 'Error: Routing: unknown routing: fibjs.org')
}

次に、上記の例のルートを http(s)Server にマウントするだけで、動作を開始できます。サーバーがマシンのデフォルトポート (通常は 80) をリッスンする場合、トラフィック分散は、ドメイン名さまざまなルートのゲートウェイサービスが設定されています。これは、同じ機能を実行するには、nginx/apache/tomcat/iis などの従来のゲートウェイサービスをインストールする必要がなく、fibjs の mq.Routing のみを使用できることを意味します。

👉 [ fibjs での X509 証明書の使用]

開発ガイド

基本モジュール

組み込みオブジェクト

コミュニティモジュール