域名路由
從0.28.0 開始,fibjs的mq.Routing 物件支援HOST 方法作為網域路由.
1
2
3
4
5
6
7
8
9
10
11
12const 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', ...)
我們來看一些例子.
簡單例子
簡單的fileHandlers
假設網域fibjs.org 已經被綁定到我們應用所在的機器(出於測試目的, 你也可以透過在本地修改Hosts 達到這一綁定效果), 而我們希望透過可以下載機器上file.fibjs.orgFILE_DIR 目錄的檔案資源, 我們可以這樣做:
1
2
3
4
5
6const 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))
前端資源host
典型的場景是, 編譯好的前端應用可能會發佈到機器上, 例如存到了/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 獲得這些資源, 則可以這樣寫:
1fileRoutes.host('festatic.fibjs.org', http.fileHandlers('/home/frontend/assets/'))
api 伺服器
假設你的機器上存在api 伺服器, 你希望將他們統一到api.fibjs.org這個網域, 但分配不同的path , 如:
| API Server | Usage | Path |
|---|---|---|
| http://127.0.0.1:3001 | User Service | /user |
| http://127.0.0.1:8080 | Biz1 | /biz1 |
| http://127.0.0.1:9007 | Biz2 | /biz2 |
那你可以:
1
2
3
4
5
6
7
8
9
10const 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
9const 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
36const 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')
}
接下來,你只需要將上例中的routes 掛載到一個http(s)Server, 它就可以開始工作了. 如果這個server 監聽了所在機器的預設連接埠(一般是80), 則一個根據網域名稱分流不同路由的網關服務就搭建好了—— 這意味著, 完成同樣的功能, 你可以僅使用fibjs 的mq.Routing 而不一定非要安裝nginx/apache/tomcat/iis 等傳統網關服務.